From 5051498e75a6b48250ef5bf759e5aed2a32d6804 Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Thu, 14 Jun 2018 10:57:50 +0100 Subject: [PATCH 001/152] Initial commit --- js/respec-oai.js | 565 ++++++ js/respec-worker.js | 29 + oas/v3.0.1.html | 4031 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 4625 insertions(+) create mode 100644 js/respec-oai.js create mode 100644 js/respec-worker.js create mode 100644 oas/v3.0.1.html diff --git a/js/respec-oai.js b/js/respec-oai.js new file mode 100644 index 0000000000..b88250472f --- /dev/null +++ b/js/respec-oai.js @@ -0,0 +1,565 @@ +"use strict";var requirejs,require,define;window.respecVersion="21.0.1",function(global,setTimeout){var req,s,head,baseElement,dataMain,src,interactiveScript,currentlyAddingScript,mainScript,subPath,version="2.3.5",commentRegExp=/\/\*[\s\S]*?\*\/|([^:"'=]|^)\/\/.*$/gm,cjsRequireRegExp=/[^.]\s*require\s*\(\s*["']([^'"\s]+)["']\s*\)/g,jsSuffixRegExp=/\.js$/,currDirRegExp=/^\.\//,op=Object.prototype,ostring=op.toString,hasOwn=op.hasOwnProperty,isBrowser=!("undefined"==typeof window||"undefined"==typeof navigator||!window.document),isWebWorker=!isBrowser&&"undefined"!=typeof importScripts,readyRegExp=isBrowser&&"PLAYSTATION 3"===navigator.platform?/^complete$/:/^(complete|loaded)$/,defContextName="_",isOpera="undefined"!=typeof opera&&"[object Opera]"===opera.toString(),contexts={},cfg={},globalDefQueue=[],useInteractive=!1;function commentReplace(e,t){return t||""}function isFunction(e){return"[object Function]"===ostring.call(e)}function isArray(e){return"[object Array]"===ostring.call(e)}function each(e,t){var n;if(e)for(n=0;n-1&&(!e[n]||!t(e[n],n,e));n-=1);}function hasProp(e,t){return hasOwn.call(e,t)}function getOwn(e,t){return hasProp(e,t)&&e[t]}function eachProp(e,t){var n;for(n in e)if(hasProp(e,n)&&t(e[n],n))break}function mixin(e,t,n,r){return t&&eachProp(t,function(t,i){!n&&hasProp(e,i)||(!r||"object"!=typeof t||!t||isArray(t)||isFunction(t)||t instanceof RegExp?e[i]=t:(e[i]||(e[i]={}),mixin(e[i],t,n,r)))}),e}function bind(e,t){return function(){return t.apply(e,arguments)}}function scripts(){return document.getElementsByTagName("script")}function defaultOnError(e){throw e}function getGlobal(e){if(!e)return e;var t=global;return each(e.split("."),function(e){t=t[e]}),t}function makeError(e,t,n,r){var i=new Error(t+"\nhttp://requirejs.org/docs/errors.html#"+e);return i.requireType=e,i.requireModules=r,n&&(i.originalError=n),i}if(void 0===define){if(void 0!==requirejs){if(isFunction(requirejs))return;cfg=requirejs,requirejs=void 0}void 0===require||isFunction(require)||(cfg=require,require=void 0),req=requirejs=function(e,t,n,r){var i,o,a=defContextName;return isArray(e)||"string"==typeof e||(o=e,isArray(t)?(e=t,t=n,n=r):e=[]),o&&o.context&&(a=o.context),(i=getOwn(contexts,a))||(i=contexts[a]=req.s.newContext(a)),o&&i.configure(o),i.require(e,t,n)},req.config=function(e){return req(e)},req.nextTick=void 0!==setTimeout?function(e){setTimeout(e,4)}:function(e){e()},require||(require=req),req.version=version,req.jsExtRegExp=/^\/|:|\?|\.js$/,req.isBrowser=isBrowser,s=req.s={contexts:contexts,newContext:newContext},req({}),each(["toUrl","undef","defined","specified"],function(e){req[e]=function(){var t=contexts[defContextName];return t.require[e].apply(t,arguments)}}),isBrowser&&(head=s.head=document.getElementsByTagName("head")[0],baseElement=document.getElementsByTagName("base")[0],baseElement&&(head=s.head=baseElement.parentNode)),req.onError=defaultOnError,req.createNode=function(e,t,n){var r=e.xhtml?document.createElementNS("http://www.w3.org/1999/xhtml","html:script"):document.createElement("script");return r.type=e.scriptType||"text/javascript",r.charset="utf-8",r.async=!0,r},req.load=function(e,t,n){var r,i=e&&e.config||{};if(isBrowser)return(r=req.createNode(i,t,n)).setAttribute("data-requirecontext",e.contextName),r.setAttribute("data-requiremodule",t),!r.attachEvent||r.attachEvent.toString&&r.attachEvent.toString().indexOf("[native code")<0||isOpera?(r.addEventListener("load",e.onScriptLoad,!1),r.addEventListener("error",e.onScriptError,!1)):(useInteractive=!0,r.attachEvent("onreadystatechange",e.onScriptLoad)),r.src=n,i.onNodeCreated&&i.onNodeCreated(r,i,t,n),currentlyAddingScript=r,baseElement?head.insertBefore(r,baseElement):head.appendChild(r),currentlyAddingScript=null,r;if(isWebWorker)try{setTimeout(function(){},0),importScripts(n),e.completeLoad(t)}catch(r){e.onError(makeError("importscripts","importScripts failed for "+t+" at "+n,r,[t]))}},isBrowser&&!cfg.skipDataMain&&eachReverse(scripts(),function(e){if(head||(head=e.parentNode),dataMain=e.getAttribute("data-main"))return mainScript=dataMain,cfg.baseUrl||-1!==mainScript.indexOf("!")||(src=mainScript.split("/"),mainScript=src.pop(),subPath=src.length?src.join("/")+"/":"./",cfg.baseUrl=subPath),mainScript=mainScript.replace(jsSuffixRegExp,""),req.jsExtRegExp.test(mainScript)&&(mainScript=dataMain),cfg.deps=cfg.deps?cfg.deps.concat(mainScript):[mainScript],!0}),define=function(e,t,n){var r,i;"string"!=typeof e&&(n=t,t=e,e=null),isArray(t)||(n=t,t=null),!t&&isFunction(n)&&(t=[],n.length&&(n.toString().replace(commentRegExp,commentReplace).replace(cjsRequireRegExp,function(e,n){t.push(n)}),t=(1===n.length?["require"]:["require","exports","module"]).concat(t))),useInteractive&&(r=currentlyAddingScript||getInteractiveScript())&&(e||(e=r.getAttribute("data-requiremodule")),i=contexts[r.getAttribute("data-requirecontext")]),i?(i.defQueue.push([e,t,n]),i.defQueueMap[e]=!0):globalDefQueue.push([e,t,n])},define.amd={jQuery:!0},req.exec=function(text){return eval(text)},req(cfg)}function newContext(e){var t,n,r,i,o,a={waitSeconds:7,baseUrl:"./",paths:{},bundles:{},pkgs:{},shim:{},config:{}},s={},l={},c={},u=[],d={},p={},f={},h=1,m=1;function g(e,t,n){var r,i,o,s,l,c,u,d,p,f,h=t&&t.split("/"),m=a.map,g=m&&m["*"];if(e&&(c=(e=e.split("/")).length-1,a.nodeIdCompat&&jsSuffixRegExp.test(e[c])&&(e[c]=e[c].replace(jsSuffixRegExp,"")),"."===e[0].charAt(0)&&h&&(e=h.slice(0,h.length-1).concat(e)),function(e){var t,n;for(t=0;t0&&(e.splice(t-1,2),t-=2)}}(e),e=e.join("/")),n&&m&&(h||g)){i=e.split("/");e:for(o=i.length;o>0;o-=1){if(l=i.slice(0,o).join("/"),h)for(s=h.length;s>0;s-=1)if((r=getOwn(m,h.slice(0,s).join("/")))&&(r=getOwn(r,l))){u=r,d=o;break e}!p&&g&&getOwn(g,l)&&(p=getOwn(g,l),f=o)}!u&&p&&(u=p,d=f),u&&(i.splice(0,d,u),e=i.join("/"))}return getOwn(a.pkgs,e)||e}function b(e){isBrowser&&each(scripts(),function(t){if(t.getAttribute("data-requiremodule")===e&&t.getAttribute("data-requirecontext")===r.contextName)return t.parentNode.removeChild(t),!0})}function y(e){var t=getOwn(a.paths,e);if(t&&isArray(t)&&t.length>1)return t.shift(),r.require.undef(e),r.makeRequire(null,{skipMap:!0})([e]),!0}function v(e){var t,n=e?e.indexOf("!"):-1;return n>-1&&(t=e.substring(0,n),e=e.substring(n+1,e.length)),[t,e]}function w(e,t,n,i){var o,a,s,l,c=null,u=t?t.name:null,p=e,f=!0,b="";return e||(f=!1,e="_@r"+(h+=1)),c=(l=v(e))[0],e=l[1],c&&(c=g(c,u,i),a=getOwn(d,c)),e&&(c?b=n?e:a&&a.normalize?a.normalize(e,function(e){return g(e,u,i)}):-1===e.indexOf("!")?g(e,u,i):e:(c=(l=v(b=g(e,u,i)))[0],b=l[1],n=!0,o=r.nameToUrl(b))),{prefix:c,name:b,parentMap:t,unnormalized:!!(s=!c||a||n?"":"_unnormalized"+(m+=1)),url:o,originalName:p,isDefine:f,id:(c?c+"!"+b:b)+s}}function x(e){var t=e.id,n=getOwn(s,t);return n||(n=s[t]=new r.Module(e)),n}function k(e,t,n){var r=e.id,i=getOwn(s,r);!hasProp(d,r)||i&&!i.defineEmitComplete?(i=x(e)).error&&"error"===t?n(i.error):i.on(t,n):"defined"===t&&n(d[r])}function C(e,t){var n=e.requireModules,r=!1;t?t(e):(each(n,function(t){var n=getOwn(s,t);n&&(n.error=e,n.events.error&&(r=!0,n.emit("error",e)))}),r||req.onError(e))}function E(){globalDefQueue.length&&(each(globalDefQueue,function(e){var t=e[0];"string"==typeof t&&(r.defQueueMap[t]=!0),u.push(e)}),globalDefQueue=[])}function $(e){delete s[e],delete l[e]}function T(){var e,n,i=1e3*a.waitSeconds,c=i&&r.startTime+i<(new Date).getTime(),u=[],p=[],f=!1,h=!0;if(!t){if(t=!0,eachProp(l,function(e){var t=e.map,r=t.id;if(e.enabled&&(t.isDefine||p.push(e),!e.error))if(!e.inited&&c)y(r)?(n=!0,f=!0):(u.push(r),b(r));else if(!e.inited&&e.fetched&&t.isDefine&&(f=!0,!t.prefix))return h=!1}),c&&u.length)return(e=makeError("timeout","Load timeout for modules: "+u,null,u)).contextName=r.contextName,C(e);h&&each(p,function(e){!function e(t,n,r){var i=t.map.id;t.error?t.emit("error",t.error):(n[i]=!0,each(t.depMaps,function(i,o){var a=i.id,l=getOwn(s,a);!l||t.depMatched[o]||r[a]||(getOwn(n,a)?(t.defineDep(o,d[a]),t.check()):e(l,n,r))}),r[i]=!0)}(e,{},{})}),c&&!n||!f||!isBrowser&&!isWebWorker||o||(o=setTimeout(function(){o=0,T()},50)),t=!1}}function S(e){hasProp(d,e[0])||x(w(e[0],null,!0)).init(e[1],e[2])}function A(e,t,n,r){e.detachEvent&&!isOpera?r&&e.detachEvent(r,t):e.removeEventListener(n,t,!1)}function L(e){var t=e.currentTarget||e.srcElement;return A(t,r.onScriptLoad,"load","onreadystatechange"),A(t,r.onScriptError,"error"),{node:t,id:t&&t.getAttribute("data-requiremodule")}}function j(){var e;for(E();u.length;){if(null===(e=u.shift())[0])return C(makeError("mismatch","Mismatched anonymous define() module: "+e[e.length-1]));S(e)}r.defQueueMap={}}return i={require:function(e){return e.require?e.require:e.require=r.makeRequire(e.map)},exports:function(e){if(e.usingExports=!0,e.map.isDefine)return e.exports?d[e.map.id]=e.exports:e.exports=d[e.map.id]={}},module:function(e){return e.module?e.module:e.module={id:e.map.id,uri:e.map.url,config:function(){return getOwn(a.config,e.map.id)||{}},exports:e.exports||(e.exports={})}}},(n=function(e){this.events=getOwn(c,e.id)||{},this.map=e,this.shim=getOwn(a.shim,e.id),this.depExports=[],this.depMaps=[],this.depMatched=[],this.pluginMaps={},this.depCount=0}).prototype={init:function(e,t,n,r){r=r||{},this.inited||(this.factory=t,n?this.on("error",n):this.events.error&&(n=bind(this,function(e){this.emit("error",e)})),this.depMaps=e&&e.slice(0),this.errback=n,this.inited=!0,this.ignore=r.ignore,r.enabled||this.enabled?this.enable():this.check())},defineDep:function(e,t){this.depMatched[e]||(this.depMatched[e]=!0,this.depCount-=1,this.depExports[e]=t)},fetch:function(){if(!this.fetched){this.fetched=!0,r.startTime=(new Date).getTime();var e=this.map;if(!this.shim)return e.prefix?this.callPlugin():this.load();r.makeRequire(this.map,{enableBuildCallback:!0})(this.shim.deps||[],bind(this,function(){return e.prefix?this.callPlugin():this.load()}))}},load:function(){var e=this.map.url;p[e]||(p[e]=!0,r.load(this.map.id,e))},check:function(){if(this.enabled&&!this.enabling){var e,t,n=this.map.id,i=this.depExports,o=this.exports,a=this.factory;if(this.inited){if(this.error)this.emit("error",this.error);else if(!this.defining){if(this.defining=!0,this.depCount<1&&!this.defined){if(isFunction(a)){if(this.events.error&&this.map.isDefine||req.onError!==defaultOnError)try{o=r.execCb(n,a,i,o)}catch(t){e=t}else o=r.execCb(n,a,i,o);if(this.map.isDefine&&void 0===o&&((t=this.module)?o=t.exports:this.usingExports&&(o=this.exports)),e)return e.requireMap=this.map,e.requireModules=this.map.isDefine?[this.map.id]:null,e.requireType=this.map.isDefine?"define":"require",C(this.error=e)}else o=a;if(this.exports=o,this.map.isDefine&&!this.ignore&&(d[n]=o,req.onResourceLoad)){var s=[];each(this.depMaps,function(e){s.push(e.normalizedMap||e)}),req.onResourceLoad(r,this.map,s)}$(n),this.defined=!0}this.defining=!1,this.defined&&!this.defineEmitted&&(this.defineEmitted=!0,this.emit("defined",this.exports),this.defineEmitComplete=!0)}}else hasProp(r.defQueueMap,n)||this.fetch()}},callPlugin:function(){var e=this.map,t=e.id,n=w(e.prefix);this.depMaps.push(n),k(n,"defined",bind(this,function(n){var i,o,l,c=getOwn(f,this.map.id),u=this.map.name,d=this.map.parentMap?this.map.parentMap.name:null,p=r.makeRequire(e.parentMap,{enableBuildCallback:!0});return this.map.unnormalized?(n.normalize&&(u=n.normalize(u,function(e){return g(e,d,!0)})||""),k(o=w(e.prefix+"!"+u,this.map.parentMap,!0),"defined",bind(this,function(e){this.map.normalizedMap=o,this.init([],function(){return e},null,{enabled:!0,ignore:!0})})),void((l=getOwn(s,o.id))&&(this.depMaps.push(o),this.events.error&&l.on("error",bind(this,function(e){this.emit("error",e)})),l.enable()))):c?(this.map.url=r.nameToUrl(c),void this.load()):((i=bind(this,function(e){this.init([],function(){return e},null,{enabled:!0})})).error=bind(this,function(e){this.inited=!0,this.error=e,e.requireModules=[t],eachProp(s,function(e){0===e.map.id.indexOf(t+"_unnormalized")&&$(e.map.id)}),C(e)}),i.fromText=bind(this,function(n,o){var s=e.name,l=w(s),c=useInteractive;o&&(n=o),c&&(useInteractive=!1),x(l),hasProp(a.config,t)&&(a.config[s]=a.config[t]);try{req.exec(n)}catch(e){return C(makeError("fromtexteval","fromText eval for "+t+" failed: "+e,e,[t]))}c&&(useInteractive=!0),this.depMaps.push(l),r.completeLoad(s),p([s],i)}),void n.load(e.name,p,i,a))})),r.enable(n,this),this.pluginMaps[n.id]=n},enable:function(){l[this.map.id]=this,this.enabled=!0,this.enabling=!0,each(this.depMaps,bind(this,function(e,t){var n,o,a;if("string"==typeof e){if(e=w(e,this.map.isDefine?this.map:this.map.parentMap,!1,!this.skipMap),this.depMaps[t]=e,a=getOwn(i,e.id))return void(this.depExports[t]=a(this));this.depCount+=1,k(e,"defined",bind(this,function(e){this.undefed||(this.defineDep(t,e),this.check())})),this.errback?k(e,"error",bind(this,this.errback)):this.events.error&&k(e,"error",bind(this,function(e){this.emit("error",e)}))}n=e.id,o=s[n],hasProp(i,n)||!o||o.enabled||r.enable(e,this)})),eachProp(this.pluginMaps,bind(this,function(e){var t=getOwn(s,e.id);t&&!t.enabled&&r.enable(e,this)})),this.enabling=!1,this.check()},on:function(e,t){var n=this.events[e];n||(n=this.events[e]=[]),n.push(t)},emit:function(e,t){each(this.events[e],function(e){e(t)}),"error"===e&&delete this.events[e]}},(r={config:a,contextName:e,registry:s,defined:d,urlFetched:p,defQueue:u,defQueueMap:{},Module:n,makeModuleMap:w,nextTick:req.nextTick,onError:C,configure:function(e){if(e.baseUrl&&"/"!==e.baseUrl.charAt(e.baseUrl.length-1)&&(e.baseUrl+="/"),"string"==typeof e.urlArgs){var t=e.urlArgs;e.urlArgs=function(e,n){return(-1===n.indexOf("?")?"?":"&")+t}}var n=a.shim,i={paths:!0,bundles:!0,config:!0,map:!0};eachProp(e,function(e,t){i[t]?(a[t]||(a[t]={}),mixin(a[t],e,!0,!0)):a[t]=e}),e.bundles&&eachProp(e.bundles,function(e,t){each(e,function(e){e!==t&&(f[e]=t)})}),e.shim&&(eachProp(e.shim,function(e,t){isArray(e)&&(e={deps:e}),!e.exports&&!e.init||e.exportsFn||(e.exportsFn=r.makeShimExports(e)),n[t]=e}),a.shim=n),e.packages&&each(e.packages,function(e){var t;t=(e="string"==typeof e?{name:e}:e).name,e.location&&(a.paths[t]=e.location),a.pkgs[t]=e.name+"/"+(e.main||"main").replace(currDirRegExp,"").replace(jsSuffixRegExp,"")}),eachProp(s,function(e,t){e.inited||e.map.unnormalized||(e.map=w(t,null,!0))}),(e.deps||e.callback)&&r.require(e.deps||[],e.callback)},makeShimExports:function(e){return function(){var t;return e.init&&(t=e.init.apply(global,arguments)),t||e.exports&&getGlobal(e.exports)}},makeRequire:function(t,n){function o(a,l,c){var u,p;return n.enableBuildCallback&&l&&isFunction(l)&&(l.__requireJsBuild=!0),"string"==typeof a?isFunction(l)?C(makeError("requireargs","Invalid require call"),c):t&&hasProp(i,a)?i[a](s[t.id]):req.get?req.get(r,a,t,o):(u=w(a,t,!1,!0).id,hasProp(d,u)?d[u]:C(makeError("notloaded",'Module name "'+u+'" has not been loaded yet for context: '+e+(t?"":". Use require([])")))):(j(),r.nextTick(function(){j(),(p=x(w(null,t))).skipMap=n.skipMap,p.init(a,l,c,{enabled:!0}),T()}),o)}return n=n||{},mixin(o,{isBrowser:isBrowser,toUrl:function(e){var n,i=e.lastIndexOf("."),o=e.split("/")[0];return-1!==i&&(!("."===o||".."===o)||i>1)&&(n=e.substring(i,e.length),e=e.substring(0,i)),r.nameToUrl(g(e,t&&t.id,!0),n,!0)},defined:function(e){return hasProp(d,w(e,t,!1,!0).id)},specified:function(e){return e=w(e,t,!1,!0).id,hasProp(d,e)||hasProp(s,e)}}),t||(o.undef=function(e){E();var n=w(e,t,!0),i=getOwn(s,e);i.undefed=!0,b(e),delete d[e],delete p[n.url],delete c[e],eachReverse(u,function(t,n){t[0]===e&&u.splice(n,1)}),delete r.defQueueMap[e],i&&(i.events.defined&&(c[e]=i.events),$(e))}),o},enable:function(e){getOwn(s,e.id)&&x(e).enable()},completeLoad:function(e){var t,n,i,o=getOwn(a.shim,e)||{},l=o.exports;for(E();u.length;){if(null===(n=u.shift())[0]){if(n[0]=e,t)break;t=!0}else n[0]===e&&(t=!0);S(n)}if(r.defQueueMap={},i=getOwn(s,e),!t&&!hasProp(d,e)&&i&&!i.inited){if(!(!a.enforceDefine||l&&getGlobal(l)))return y(e)?void 0:C(makeError("nodefine","No define call for "+e,null,[e]));S([e,o.deps||[],o.exportsFn])}T()},nameToUrl:function(e,t,n){var i,o,s,l,c,u,d=getOwn(a.pkgs,e);if(d&&(e=d),u=getOwn(f,e))return r.nameToUrl(u,t,n);if(req.jsExtRegExp.test(e))l=e+(t||"");else{for(i=a.paths,s=(o=e.split("/")).length;s>0;s-=1)if(c=getOwn(i,o.slice(0,s).join("/"))){isArray(c)&&(c=c[0]),o.splice(0,s,c);break}l=o.join("/"),l=("/"===(l+=t||(/^data\:|^blob\:|\?/.test(l)||n?"":".js")).charAt(0)||l.match(/^[\w\+\.\-]+:/)?"":a.baseUrl)+l}return a.urlArgs&&!/^blob\:/.test(l)?l+a.urlArgs(e,l):l},load:function(e,t){req.load(r,e,t)},execCb:function(e,t,n,r){return t.apply(r,n)},onScriptLoad:function(e){if("load"===e.type||readyRegExp.test((e.currentTarget||e.srcElement).readyState)){interactiveScript=null;var t=L(e);r.completeLoad(t.id)}},onScriptError:function(e){var t=L(e);if(!y(t.id)){var n=[];return eachProp(s,function(e,r){0!==r.indexOf("_@r")&&each(e.depMaps,function(e){if(e.id===t.id)return n.push(r),!0})}),C(makeError("scripterror",'Script error for "'+t.id+(n.length?'", needed by: '+n.join(", "):'"'),e,[t.id]))}}}).require=r.makeRequire(),r}function getInteractiveScript(){return interactiveScript&&"interactive"===interactiveScript.readyState?interactiveScript:(eachReverse(scripts(),function(e){if("interactive"===e.readyState)return interactiveScript=e}),interactiveScript)}}(this,"undefined"==typeof setTimeout?void 0:setTimeout),define("deps/require",function(){});var hyperHTML=function(e){var t=document.defaultView,n=1,r=/^area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|source|track|wbr$/i,i="ownerSVGElement",o="http://www.w3.org/2000/svg",a="connected",s="dis"+a,l=/^style|textarea$/i,c="_hyper: "+(Math.random()*new Date|0)+";",u="\x3c!--"+c+"--\x3e",d=t.Event;try{new d("Event")}catch(e){d=function(e){var t=document.createEvent("Event");return t.initEvent(e,!1,!1),t}}var p,f=t.Map||function(){var e=[],t=[];return{get:function(n){return t[e.indexOf(n)]},set:function(n,r){t[e.push(n)-1]=r}}},h=0,m=t.WeakMap||function(){var e=c+h++;return{get:function(t){return t[e]},set:function(t,n){Object.defineProperty(t,e,{configurable:!0,value:n})}}},g=t.WeakSet||function(){var e=new m;return{add:function(t){e.set(t,!0)},has:function(t){return!0===e.get(t)}}},b=Array.isArray||(p={}.toString,function(e){return"[object Array]"===p.call(e)}),y=c.trim||function(){return this.replace(/^\s+|\s+$/g,"")};function v(){return this}var w=function(e,t){var n="_"+e+"$";return{get:function(){return this[n]||(this[e]=t.call(this,e))},set:function(e){Object.defineProperty(this,n,{configurable:!0,value:e})}}},x={},k=[],C=x.hasOwnProperty,E=0,$=function(e,t){e in x||(E=k.push(e)),x[e]=t},T=function(e,t){for(var n=0;n\"'=]+",N="[ "+D+"]+"+_,R="<([A-Za-z]+[A-Za-z0-9:_-]*)((?:",P="(?:=(?:'[^']*?'|\"[^\"]*?\"|<[^>]*?>|"+_+"))?)",M=new RegExp(R+N+P+"+)([ "+D+"]*/?>)","g"),O=new RegExp(R+N+P+"*)([ "+D+"]*/>)","g"),I=L(document),q="append"in I,U="content"in S(document,"template");I.appendChild(j(I,"g")),I.appendChild(j(I,""));var W=1===I.cloneNode(!0).childNodes.length,H="importNode"in document,B=q?function(e,t){e.append.apply(e,t)}:function(e,t){for(var n=t.length,r=0;r"+t+"",B(r,Y.call(n.querySelectorAll(i)))}else n.innerHTML=t,B(r,Y.call(n.childNodes));return r},ee=U?function(e,t){var n=L(e),r=A(e).createElementNS(o,"svg");return r.innerHTML=t,B(n,Y.call(r.childNodes)),n}:function(e,t){var n=L(e),r=S(e,"div");return r.innerHTML=''+t+"",B(n,Y.call(r.firstChild.childNodes)),n};function te(e){this.childNodes=e,this.length=e.length,this.first=e[0],this.last=e[this.length-1]}te.prototype.insert=function(){var e=L(this.first);return B(e,this.childNodes),e},te.prototype.remove=function(){var e=this.first,t=this.last;if(2===this.length)t.parentNode.removeChild(t);else{var n=A(e).createRange();n.setStartBefore(this.childNodes[1]),n.setEndAfter(t),n.deleteContents()}return e};var ne=function(e,t,n){e.unshift(e.indexOf.call(t.childNodes,n))},re=function(e,t,r){return{type:e,name:r,node:t,path:function(e){var t=[],r=void 0;switch(e.nodeType){case n:case 11:r=e;break;case 8:r=e.parentNode,ne(t,r,e);break;default:r=e.ownerElement}for(e=r;r=r.parentNode;e=r)ne(t,r,e);return t}(t)}},ie=function(e,t){for(var n=t.length,r=0;rc){var v=n[p+1],w=null==v?a:o(v,0);if(l===p)e.insertBefore(o(n[l],1),w);else{for(var x=e.ownerDocument.createDocumentFragment();l<=p;)x.appendChild(o(n[l++],1));e.insertBefore(x,w)}}else null==t[s]&&s++,s===c?e.removeChild(o(t[s],-1)):de(e,o(t[s],-1),o(t[c],-1));return n},fe=new g;function he(){}he.prototype=Object.create(null);var me=function(e){return{html:e}},ge=function e(t,n){return"ELEMENT_NODE"in t?t:t.constructor===te?1/n<0?n?t.remove():t.last:n?t.insert():t.first:e(t.render(),n)},be=function(e,t,n){for(var r=new he,i=e.attributes,o=Y.call(i),a=[],s=o.length,l=0;l"},Pe=new m,Me=function(e){var t=void 0,n=void 0,r=void 0,i=void 0,a=void 0;return function(s){s=Q(s);var l=i!==s;return l&&(i=s,r=L(document),n="svg"===e?document.createElementNS(o,"svg"):r,a=Se.bind(n)),a.apply(null,arguments),l&&("svg"===e&&B(r,Y.call(n.childNodes)),t=Ie(r)),t}},Oe=function(e,t){var n=t.indexOf(":"),r=Pe.get(e),i=t;return-1e.apply(void 0,n)),window.parent===window.self)return;var r=n.map(e=>String(JSON.stringify(e.stack||e)));window.parent.postMessage({topic:e,args:r},window.parent.location.origin)},e.sub=n,e.unsub=r;e.name="core/pubsubhub";const t=new Map;function n(e,i,o={once:!1}){return o.once?n(e,function t(...n){r({topic:e,cb:t}),i(...n)}):(t.has(e)?t.get(e).add(i):t.set(e,new Set([i])),{topic:e,cb:i})}function r({topic:e,cb:n}){const r=t.get(e);return r&&r.has(n)?r.delete(n):(console.warn("Already unsubscribed:",e,n),!1)}n("error",e=>{console.error(e,e.stack)}),n("warn",e=>{console.warn(e)})}),function(e){var t={newline:/^\n+/,code:/^( {4}[^\n]+\n*)+/,fences:h,hr:/^ {0,3}((?:- *){3,}|(?:_ *){3,}|(?:\* *){3,})(?:\n+|$)/,heading:/^ *(#{1,6}) *([^\n]+?) *(?:#+ *)?(?:\n+|$)/,nptable:h,blockquote:/^( {0,3}> ?(paragraph|[^\n]*)(?:\n|$))+/,list:/^( *)(bull) [\s\S]+?(?:hr|def|\n{2,}(?! )(?!\1bull )\n*|\s*$)/,html:"^ {0,3}(?:<(script|pre|style)[\\s>][\\s\\S]*?(?:[^\\n]*\\n+|$)|comment[^\\n]*(\\n+|$)|<\\?[\\s\\S]*?\\?>\\n*|\\n*|\\n*|)[\\s\\S]*?(?:\\n{2,}|$)|<(?!script|pre|style)([a-z][\\w-]*)(?:attribute)*? */?>(?=\\h*\\n)[\\s\\S]*?(?:\\n{2,}|$)|(?=\\h*\\n)[\\s\\S]*?(?:\\n{2,}|$))",def:/^ {0,3}\[(label)\]: *\n? *]+)>?(?:(?: +\n? *| *\n *)(title))? *(?:\n+|$)/,table:h,lheading:/^([^\n]+)\n *(=|-){2,} *(?:\n+|$)/,paragraph:/^([^\n]+(?:\n(?!hr|heading|lheading| {0,3}>|<\/?(?:tag)(?: +|\n|\/?>)|<(?:script|pre|style|!--))[^\n]+)*)/,text:/^[^\n]+/};function n(e){this.tokens=[],this.tokens.links={},this.options=e||b.defaults,this.rules=t.normal,this.options.pedantic?this.rules=t.pedantic:this.options.gfm&&(this.options.tables?this.rules=t.tables:this.rules=t.gfm)}t._label=/(?!\s*\])(?:\\[\[\]]|[^\[\]])+/,t._title=/(?:"(?:\\"?|[^"\\])*"|'[^'\n]*(?:\n[^'\n]+)*\n?'|\([^()]*\))/,t.def=u(t.def).replace("label",t._label).replace("title",t._title).getRegex(),t.bullet=/(?:[*+-]|\d+\.)/,t.item=/^( *)(bull) [^\n]*(?:\n(?!\1bull )[^\n]*)*/,t.item=u(t.item,"gm").replace(/bull/g,t.bullet).getRegex(),t.list=u(t.list).replace(/bull/g,t.bullet).replace("hr","\\n+(?=\\1?(?:(?:- *){3,}|(?:_ *){3,}|(?:\\* *){3,})(?:\\n+|$))").replace("def","\\n+(?="+t.def.source+")").getRegex(),t._tag="address|article|aside|base|basefont|blockquote|body|caption|center|col|colgroup|dd|details|dialog|dir|div|dl|dt|fieldset|figcaption|figure|footer|form|frame|frameset|h[1-6]|head|header|hr|html|iframe|legend|li|link|main|menu|menuitem|meta|nav|noframes|ol|optgroup|option|p|param|section|source|summary|table|tbody|td|tfoot|th|thead|title|tr|track|ul",t._comment=//,t.html=u(t.html,"i").replace("comment",t._comment).replace("tag",t._tag).replace("attribute",/ +[a-zA-Z:_][\w.:-]*(?: *= *"[^"\n]*"| *= *'[^'\n]*'| *= *[^\s"'=<>`]+)?/).getRegex(),t.paragraph=u(t.paragraph).replace("hr",t.hr).replace("heading",t.heading).replace("lheading",t.lheading).replace("tag",t._tag).getRegex(),t.blockquote=u(t.blockquote).replace("paragraph",t.paragraph).getRegex(),t.normal=m({},t),t.gfm=m({},t.normal,{fences:/^ *(`{3,}|~{3,})[ \.]*(\S+)? *\n([\s\S]*?)\n? *\1 *(?:\n+|$)/,paragraph:/^/,heading:/^ *(#{1,6}) +([^\n]+?) *#* *(?:\n+|$)/}),t.gfm.paragraph=u(t.paragraph).replace("(?!","(?!"+t.gfm.fences.source.replace("\\1","\\2")+"|"+t.list.source.replace("\\1","\\3")+"|").getRegex(),t.tables=m({},t.gfm,{nptable:/^ *([^|\n ].*\|.*)\n *([-:]+ *\|[-| :]*)(?:\n((?:.*[^>\n ].*(?:\n|$))*)\n*|$)/,table:/^ *\|(.+)\n *\|?( *[-:]+[-| :]*)(?:\n((?: *[^>\n ].*(?:\n|$))*)\n*|$)/}),t.pedantic=m({},t.normal,{html:u("^ *(?:comment *(?:\\n|\\s*$)|<(tag)[\\s\\S]+? *(?:\\n{2,}|\\s*$)|\\s]*)*?/?> *(?:\\n{2,}|\\s*$))").replace("comment",t._comment).replace(/tag/g,"(?!(?:a|em|strong|small|s|cite|q|dfn|abbr|data|time|code|var|samp|kbd|sub|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo|span|br|wbr|ins|del|img)\\b)\\w+(?!:|[^\\w\\s@]*@)\\b").getRegex(),def:/^ *\[([^\]]+)\]: *]+)>?(?: +(["(][^\n]+[")]))? *(?:\n+|$)/}),n.rules=t,n.lex=function(e,t){return new n(t).lex(e)},n.prototype.lex=function(e){return e=e.replace(/\r\n|\r/g,"\n").replace(/\t/g," ").replace(/\u00a0/g," ").replace(/\u2424/g,"\n"),this.token(e,!0)},n.prototype.token=function(e,n){var r,i,o,a,s,l,c,u,d,p,f,h,m;for(e=e.replace(/^ +$/gm,"");e;)if((o=this.rules.newline.exec(e))&&(e=e.substring(o[0].length),o[0].length>1&&this.tokens.push({type:"space"})),o=this.rules.code.exec(e))e=e.substring(o[0].length),o=o[0].replace(/^ {4}/gm,""),this.tokens.push({type:"code",text:this.options.pedantic?o:o.replace(/\n+$/,"")});else if(o=this.rules.fences.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"code",lang:o[2],text:o[3]||""});else if(o=this.rules.heading.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"heading",depth:o[1].length,text:o[2]});else if(n&&(o=this.rules.nptable.exec(e))&&(l={type:"table",header:g(o[1].replace(/^ *| *\| *$/g,"")),align:o[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:o[3]?o[3].replace(/\n$/,"").split("\n"):[]}).header.length===l.align.length){for(e=e.substring(o[0].length),u=0;u ?/gm,""),this.token(o,n),this.tokens.push({type:"blockquote_end"});else if(o=this.rules.list.exec(e)){for(e=e.substring(o[0].length),f=(a=o[2]).length>1,this.tokens.push({type:"list_start",ordered:f,start:f?+a:""}),r=!1,p=(o=o[0].match(this.rules.item)).length,u=0;u1&&s.length>1||(e=o.slice(u+1).join("\n")+e,u=p-1)),i=r||/\n\n(?!\s*$)/.test(l),u!==p-1&&(r="\n"===l.charAt(l.length-1),i||(i=r)),m=void 0,(h=/^\[[ xX]\] /.test(l))&&(m=" "!==l[1],l=l.replace(/^\[[ xX]\] +/,"")),this.tokens.push({type:i?"loose_item_start":"list_item_start",task:h,checked:m}),this.token(l,!1),this.tokens.push({type:"list_item_end"});this.tokens.push({type:"list_end"})}else if(o=this.rules.html.exec(e))e=e.substring(o[0].length),this.tokens.push({type:this.options.sanitize?"paragraph":"html",pre:!this.options.sanitizer&&("pre"===o[1]||"script"===o[1]||"style"===o[1]),text:o[0]});else if(n&&(o=this.rules.def.exec(e)))e=e.substring(o[0].length),o[3]&&(o[3]=o[3].substring(1,o[3].length-1)),d=o[1].toLowerCase().replace(/\s+/g," "),this.tokens.links[d]||(this.tokens.links[d]={href:o[2],title:o[3]});else if(n&&(o=this.rules.table.exec(e))&&(l={type:"table",header:g(o[1].replace(/^ *| *\| *$/g,"")),align:o[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:o[3]?o[3].replace(/(?: *\| *)?\n$/,"").split("\n"):[]}).header.length===l.align.length){for(e=e.substring(o[0].length),u=0;u?@\[\]\\^_`{|}~])/,autolink:/^<(scheme:[^\s\x00-\x1f<>]*|email)>/,url:h,tag:"^comment|^|^<[a-zA-Z][\\w-]*(?:attribute)*?\\s*/?>|^<\\?[\\s\\S]*?\\?>|^|^",link:/^!?\[(label)\]\(href(?:\s+(title))?\s*\)/,reflink:/^!?\[(label)\]\[(?!\s*\])((?:\\[\[\]]?|[^\[\]\\])+)\]/,nolink:/^!?\[(?!\s*\])((?:\[[^\[\]]*\]|\\[\[\]]|[^\[\]])*)\](?:\[\])?/,strong:/^__([^\s][\s\S]*?[^\s])__(?!_)|^\*\*([^\s][\s\S]*?[^\s])\*\*(?!\*)|^__([^\s])__(?!_)|^\*\*([^\s])\*\*(?!\*)/,em:/^_([^\s][\s\S]*?[^\s_])_(?!_)|^_([^\s_][\s\S]*?[^\s])_(?!_)|^\*([^\s][\s\S]*?[^\s*])\*(?!\*)|^\*([^\s*][\s\S]*?[^\s])\*(?!\*)|^_([^\s_])_(?!_)|^\*([^\s*])\*(?!\*)/,code:/^(`+)\s*([\s\S]*?[^`]?)\s*\1(?!`)/,br:/^ {2,}\n(?!\s*$)/,del:h,text:/^[\s\S]+?(?=[\\/g,">").replace(/"/g,""").replace(/'/g,"'")}function c(e){return e.replace(/&(#(?:\d+)|(?:#x[0-9A-Fa-f]+)|(?:\w+));?/gi,function(e,t){return"colon"===(t=t.toLowerCase())?":":"#"===t.charAt(0)?"x"===t.charAt(1)?String.fromCharCode(parseInt(t.substring(2),16)):String.fromCharCode(+t.substring(1)):""})}function u(e,t){return e=e.source||e,t=t||"",{replace:function(t,n){return n=(n=n.source||n).replace(/(^|[^\[])\^/g,"$1"),e=e.replace(t,n),this},getRegex:function(){return new RegExp(e,t)}}}function d(e,t){return p[" "+e]||(/^[^:]+:\/*[^/]*$/.test(e)?p[" "+e]=e+"/":p[" "+e]=e.replace(/[^/]*$/,"")),e=p[" "+e],"//"===t.slice(0,2)?e.replace(/:[\s\S]*/,":")+t:"/"===t.charAt(0)?e.replace(/(:\/*[^/]*)[\s\S]*/,"$1")+t:e+t}r._escapes=/\\([!"#$%&'()*+,\-./:;<=>?@\[\]\\^_`{|}~])/g,r._scheme=/[a-zA-Z][a-zA-Z0-9+.-]{1,31}/,r._email=/[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+(@)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+(?![-_])/,r.autolink=u(r.autolink).replace("scheme",r._scheme).replace("email",r._email).getRegex(),r._attribute=/\s+[a-zA-Z:_][\w.:-]*(?:\s*=\s*"[^"]*"|\s*=\s*'[^']*'|\s*=\s*[^\s"'=<>`]+)?/,r.tag=u(r.tag).replace("comment",t._comment).replace("attribute",r._attribute).getRegex(),r._label=/(?:\[[^\[\]]*\]|\\[\[\]]?|`[^`]*`|[^\[\]\\])*?/,r._href=/\s*(<(?:\\[<>]?|[^\s<>\\])*>|(?:\\[()]?|\([^\s\x00-\x1f()\\]*\)|[^\s\x00-\x1f()\\])*?)/,r._title=/"(?:\\"?|[^"\\])*"|'(?:\\'?|[^'\\])*'|\((?:\\\)?|[^)\\])*\)/,r.link=u(r.link).replace("label",r._label).replace("href",r._href).replace("title",r._title).getRegex(),r.reflink=u(r.reflink).replace("label",r._label).getRegex(),r.normal=m({},r),r.pedantic=m({},r.normal,{strong:/^__(?=\S)([\s\S]*?\S)__(?!_)|^\*\*(?=\S)([\s\S]*?\S)\*\*(?!\*)/,em:/^_(?=\S)([\s\S]*?\S)_(?!_)|^\*(?=\S)([\s\S]*?\S)\*(?!\*)/,link:u(/^!?\[(label)\]\((.*?)\)/).replace("label",r._label).getRegex(),reflink:u(/^!?\[(label)\]\s*\[([^\]]*)\]/).replace("label",r._label).getRegex()}),r.gfm=m({},r.normal,{escape:u(r.escape).replace("])","~|])").getRegex(),url:u(/^((?:ftp|https?):\/\/|www\.)(?:[a-zA-Z0-9\-]+\.?)+[^\s<]*|^email/).replace("email",r._email).getRegex(),_backpedal:/(?:[^?!.,:;*_~()&]+|\([^)]*\)|&(?![a-zA-Z0-9]+;$)|[?!.,:;*_~)]+(?!$))+/,del:/^~~(?=\S)([\s\S]*?\S)~~/,text:u(r.text).replace("]|","~]|").replace("|","|https?://|ftp://|www\\.|[a-zA-Z0-9.!#$%&'*+/=?^_`{\\|}~-]+@|").getRegex()}),r.breaks=m({},r.gfm,{br:u(r.br).replace("{2,}","*").getRegex(),text:u(r.gfm.text).replace("{2,}","*").getRegex()}),i.rules=r,i.output=function(e,t,n){return new i(t,n).output(e)},i.prototype.output=function(e){for(var t,n,r,o,a,s="";e;)if(a=this.rules.escape.exec(e))e=e.substring(a[0].length),s+=a[1];else if(a=this.rules.autolink.exec(e))e=e.substring(a[0].length),r="@"===a[2]?"mailto:"+(n=l(this.mangle(a[1]))):n=l(a[1]),s+=this.renderer.link(r,null,n);else if(this.inLink||!(a=this.rules.url.exec(e))){if(a=this.rules.tag.exec(e))!this.inLink&&/^/i.test(a[0])&&(this.inLink=!1),e=e.substring(a[0].length),s+=this.options.sanitize?this.options.sanitizer?this.options.sanitizer(a[0]):l(a[0]):a[0];else if(a=this.rules.link.exec(e))e=e.substring(a[0].length),this.inLink=!0,r=a[2],this.options.pedantic?(t=/^([^'"]*[^\s])\s+(['"])(.*)\2/.exec(r))?(r=t[1],o=t[3]):o="":o=a[3]?a[3].slice(1,-1):"",r=r.trim().replace(/^<([\s\S]*)>$/,"$1"),s+=this.outputLink(a,{href:i.escapes(r),title:i.escapes(o)}),this.inLink=!1;else if((a=this.rules.reflink.exec(e))||(a=this.rules.nolink.exec(e))){if(e=e.substring(a[0].length),t=(a[2]||a[1]).replace(/\s+/g," "),!(t=this.links[t.toLowerCase()])||!t.href){s+=a[0].charAt(0),e=a[0].substring(1)+e;continue}this.inLink=!0,s+=this.outputLink(a,t),this.inLink=!1}else if(a=this.rules.strong.exec(e))e=e.substring(a[0].length),s+=this.renderer.strong(this.output(a[4]||a[3]||a[2]||a[1]));else if(a=this.rules.em.exec(e))e=e.substring(a[0].length),s+=this.renderer.em(this.output(a[6]||a[5]||a[4]||a[3]||a[2]||a[1]));else if(a=this.rules.code.exec(e))e=e.substring(a[0].length),s+=this.renderer.codespan(l(a[2].trim(),!0));else if(a=this.rules.br.exec(e))e=e.substring(a[0].length),s+=this.renderer.br();else if(a=this.rules.del.exec(e))e=e.substring(a[0].length),s+=this.renderer.del(this.output(a[1]));else if(a=this.rules.text.exec(e))e=e.substring(a[0].length),s+=this.renderer.text(l(this.smartypants(a[0])));else if(e)throw new Error("Infinite loop on byte: "+e.charCodeAt(0))}else a[0]=this.rules._backpedal.exec(a[0])[0],e=e.substring(a[0].length),"@"===a[2]?r="mailto:"+(n=l(a[0])):(n=l(a[0]),r="www."===a[1]?"http://"+n:n),s+=this.renderer.link(r,null,n);return s},i.escapes=function(e){return e?e.replace(i.rules._escapes,"$1"):e},i.prototype.outputLink=function(e,t){var n=t.href,r=t.title?l(t.title):null;return"!"!==e[0].charAt(0)?this.renderer.link(n,r,this.output(e[1])):this.renderer.image(n,r,l(e[1]))},i.prototype.smartypants=function(e){return this.options.smartypants?e.replace(/---/g,"—").replace(/--/g,"–").replace(/(^|[-\u2014/(\[{"\s])'/g,"$1‘").replace(/'/g,"’").replace(/(^|[-\u2014/(\[{\u2018\s])"/g,"$1“").replace(/"/g,"”").replace(/\.{3}/g,"…"):e},i.prototype.mangle=function(e){if(!this.options.mangle)return e;for(var t,n="",r=e.length,i=0;i.5&&(t="x"+t.toString(16)),n+="&#"+t+";";return n},o.prototype.code=function(e,t,n){if(this.options.highlight){var r=this.options.highlight(e,t);null!=r&&r!==e&&(n=!0,e=r)}return t?'
'+(n?e:l(e,!0))+"
\n":"
"+(n?e:l(e,!0))+"
"},o.prototype.blockquote=function(e){return"
\n"+e+"
\n"},o.prototype.html=function(e){return e},o.prototype.heading=function(e,t,n){return this.options.headerIds?"'+e+"\n":""+e+"\n"},o.prototype.hr=function(){return this.options.xhtml?"
\n":"
\n"},o.prototype.list=function(e,t,n){var r=t?"ol":"ul";return"<"+r+(t&&1!==n?' start="'+n+'"':"")+">\n"+e+"\n"},o.prototype.listitem=function(e){return"
  • "+e+"
  • \n"},o.prototype.checkbox=function(e){return" "},o.prototype.paragraph=function(e){return"

    "+e+"

    \n"},o.prototype.table=function(e,t){return t&&(t=""+t+""),"\n\n"+e+"\n"+t+"
    \n"},o.prototype.tablerow=function(e){return"\n"+e+"\n"},o.prototype.tablecell=function(e,t){var n=t.header?"th":"td";return(t.align?"<"+n+' align="'+t.align+'">':"<"+n+">")+e+"\n"},o.prototype.strong=function(e){return""+e+""},o.prototype.em=function(e){return""+e+""},o.prototype.codespan=function(e){return""+e+""},o.prototype.br=function(){return this.options.xhtml?"
    ":"
    "},o.prototype.del=function(e){return""+e+""},o.prototype.link=function(e,t,n){if(this.options.sanitize){try{var r=decodeURIComponent(c(e)).replace(/[^\w:]/g,"").toLowerCase()}catch(e){return n}if(0===r.indexOf("javascript:")||0===r.indexOf("vbscript:")||0===r.indexOf("data:"))return n}this.options.baseUrl&&!f.test(e)&&(e=d(this.options.baseUrl,e));try{e=encodeURI(e).replace(/%25/g,"%")}catch(e){return n}var i='
    "},o.prototype.image=function(e,t,n){this.options.baseUrl&&!f.test(e)&&(e=d(this.options.baseUrl,e));var r=''+n+'":">"},o.prototype.text=function(e){return e},a.prototype.strong=a.prototype.em=a.prototype.codespan=a.prototype.del=a.prototype.text=function(e){return e},a.prototype.link=a.prototype.image=function(e,t,n){return""+n},a.prototype.br=function(){return""},s.parse=function(e,t){return new s(t).parse(e)},s.prototype.parse=function(e){this.inline=new i(e.links,this.options),this.inlineText=new i(e.links,m({},this.options,{renderer:new a})),this.tokens=e.reverse();for(var t="";this.next();)t+=this.tok();return t},s.prototype.next=function(){return this.token=this.tokens.pop()},s.prototype.peek=function(){return this.tokens[this.tokens.length-1]||0},s.prototype.parseText=function(){for(var e=this.token.text;"text"===this.peek().type;)e+="\n"+this.next().text;return this.inline.output(e)},s.prototype.tok=function(){switch(this.token.type){case"space":return"";case"hr":return this.renderer.hr();case"heading":return this.renderer.heading(this.inline.output(this.token.text),this.token.depth,c(this.inlineText.output(this.token.text)));case"code":return this.renderer.code(this.token.text,this.token.lang,this.token.escaped);case"table":var e,t,n,r,i="",o="";for(n="",e=0;et)n.splice(t);else for(;n.lengthAn error occurred:

    "+l(e.message+"",!0)+"
    ";throw e}}h.exec=h,b.options=b.setOptions=function(e){return m(b.defaults,e),b},b.getDefaults=function(){return{baseUrl:null,breaks:!1,gfm:!0,headerIds:!0,headerPrefix:"",highlight:null,langPrefix:"language-",mangle:!0,pedantic:!1,renderer:new o,sanitize:!1,sanitizer:null,silent:!1,smartLists:!1,smartypants:!1,tables:!0,xhtml:!1}},b.defaults=b.getDefaults(),b.Parser=s,b.parser=s.parse,b.Renderer=o,b.TextRenderer=a,b.Lexer=n,b.lexer=n.lex,b.InlineLexer=i,b.inlineLexer=i.output,b.parse=b,"undefined"!=typeof module&&"object"==typeof exports?module.exports=b:"function"==typeof define&&define.amd?define("deps/marked",[],function(){return b}):e.marked=b}(this||("undefined"!=typeof window?window:global)),define("core/utils",["exports","core/pubsubhub","deps/marked"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.ISODate=e.name=void 0,e.markdownToHtml=function(e){const t=h(e).replace(l,">").replace(c,"&");return(0,i.default)(t)},e.makeOwnerSwapper=function(e){if(!e)throw new TypeError("Expected instance of Node.");return t=>{if(t.ownerDocument.adoptNode(e),t.firstElementChild)return t.insertBefore(e,t.firstElementChild);t.appendChild(e)}},e.calculateLeftPad=function(e){if("string"!=typeof e)throw new TypeError("Invalid input");var t=e.split("\n").filter(e=>e).reduce((e,t)=>{if(0===e)return e;const n=t.match(o)[0]||"";return Math.min(n.length,e)},1/0);return t===1/0?0:t},e.createResourceHint=function(e){if(!e||"object"!=typeof e)throw new TypeError("Missing options");if(!p.has(e.hint))throw new TypeError("Invalid resources hint");const t=new URL(e.href,document.location),n=document.createElement("link");let r=t.href;switch(n.rel=e.hint,n.rel){case"dns-prefetch":case"preconnect":r=t.origin,(e.corsMode||t.origin!==document.location.origin)&&(n.crossOrigin=e.corsMode||"anonymous");break;case"preload":"as"in e&&"string"==typeof e.as&&(f.has(e.as)||console.warn(`Unknown request destination: ${e.as}`),n.setAttribute("as",e.as))}n.href=r,e.dontRemove||n.classList.add("removeOnSave");return n},e.normalizePadding=h,e.removeReSpec=function(e){Array.from(e.querySelectorAll(".remove, script[data-requiremodule]")).forEach(e=>{e.remove()})},e.joinAnd=function(e=[],t=(e=>e)){const n=e.map(t);switch(n.length){case 0:case 1:return n.toString();case 2:return n.join(" and ");default:const e=n.join(", "),t=e.lastIndexOf(",");return`${e.substr(0,t+1)} and ${e.slice(t+2)}`}},e.xmlEscape=function(e){return e.replace(/&/g,"&").replace(/>/g,">").replace(/"/g,""").replace(/i)return 1;if(i>t)return-1;if(!isNaN(t)&&isNaN(i))return 1;if(isNaN(t)&&!isNaN(i))return-1}return 0},e.concatDate=function(e,t=""){return u.format(e).replace(s,t)},e.toShortIsoDate=function(e){return u.format(e)},e.lead0=function(e){return 1===String(e).length?"0"+e:e},e.parseSimpleDate=function(e){return new Date(e)},e.parseLastModified=function(e){return e?new Date(Date.parse(e)):new Date},e.humanDate=function(e=new Date,t=document.documentElement.lang||"en"){e instanceof Date||(e=new Date(e));const n=[t,"en"],r=e.toLocaleString(n,{day:"2-digit",timeZone:"UTC"}),i=e.toLocaleString(n,{month:"long",timeZone:"UTC"}),o=e.toLocaleString(n,{year:"numeric",timeZone:"UTC"});return`${r} ${i} ${o}`},e.isoDate=function(e){return(e instanceof Date?e:new Date(e)).toISOString()},e.toKeyValuePairs=function(e,t=", ",n="="){return Array.from(Object.entries(e)).map(([e,t])=>`${e}${n}${JSON.stringify(t)}`).join(t)},e.linkCSS=function(e,t){const n=[].concat(t).map(t=>{var n=e.createElement("link");return n.rel="stylesheet",n.href=t,n}).reduce(function(e,t){return e.appendChild(t),e},e.createDocumentFragment());e.head.appendChild(n)},e.runTransforms=function(e,n){var r=[this,e],i=Array.from(arguments);if(i.shift(),i.shift(),r=r.concat(i),n)for(var o=n.split(/\s+/),a=0;anew Date)return i}catch(e){console.error("Failed to use Cache API.",e)}const o=await fetch(e);if(!o.ok&&i)return console.warn(`Returning a stale cached response for ${n}`),i;if(r){const n=o.clone(),i=new Headers(o.headers),a=new Date(Date.now()+t);i.set("Expires",a);const s=new Response(await n.blob(),{headers:i});return await r.put(e,s).catch(console.error),await r.match(e)}return o},e.flatten=function e(t,n){const r="object"==typeof n;const i=Object(n)[Symbol.iterator]&&"function"==typeof n.values;const o=r?i?[...n.values()].reduce(e,[]):Object.values(n):[n];return[...t,...o]};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/utils";i.default.setOptions({sanitize:!1,gfm:!0});const o=/^[\ |\t]*/,a=/\s+$/gm,s=/\-/g,l=/>/gm,c=/&/gm;const u=e.ISODate=new Intl.DateTimeFormat(["en-ca-iso8601"],{timeZone:"UTC",year:"numeric",month:"2-digit",day:"2-digit"}),d=new Set(["a","abbr","acronym","b","bdo","big","br","button","cite","code","dfn","em","i","img","input","kbd","label","map","object","q","samp","script","select","small","span","strong","sub","sup","textarea","time","tt","var"]),p=new Set(["dns-prefetch","preconnect","preload","prerender"]),f=new Set(["document","embed","font","image","manifest","media","object","report","script","serviceworker","sharedworker","style","worker","xslt",""]);function h(e=""){if(!e)return"";if("string"!=typeof e)throw TypeError("Invalid input");if("\n"===e)return"\n";function t(e){return null!==e&&e.nodeType===Node.TEXT_NODE}var n=""+e,r=(new DOMParser).parseFromString(n,"text/html");Array.from(r.body.children).filter(e=>!d.has(e.localName)).filter(e=>"pre"!==e.localName).filter(e=>"table"!==e.localName).forEach(e=>{e.innerHTML=h(e.innerHTML)}),Array.from(r.body.childNodes).filter(e=>t(e)&&""===e.textContent.trim()).forEach(e=>e.parentElement.replaceChild(r.createTextNode("\n"),e)),t(r.body.firstChild)||Array.from(r.body.firstChild.children).filter(e=>"table"!==e.localName).forEach(e=>{e.innerHTML=h(e.innerHTML)}),r.normalize();const i=r.body.innerText.replace(/^\ *\n/,"").split("\n").filter(e=>e&&e.startsWith(" "))[0];var o=i?i.match(/\ +/)[0].length:0;if(o){Array.from(r.body.childNodes).filter(e=>"pre"!==e.localName).filter(t).filter(e=>{const t=e.previousElementSibling,n=t?t.localName:e.parentElement.localName;return!d.has(n)||e.textContent.trim().includes("\n")}).reduce((e,t)=>{let n="";const r=t.previousElementSibling,i=r?r.localName:t.parentElement.localName;return/^[\t\ ]/.test(t.textContent)&&d.has(i)&&(n=t.textContent.match(/^\s+/)[0]),t.textContent=n+t.textContent.replace(e,""),e},new RegExp("^ {1,"+o+"}","gm"));const e=new RegExp(`\\ {${o}}$`,"gm");Array.from(r.body.querySelectorAll("pre")).map(e=>e.previousSibling).filter(t).reduce((t,n)=>(e.test(n.textContent)&&(n.textContent=n.textContent.substr(0,n.textContent.length-t)),t),o)}return a.test(r.body.innerHTML)?r.body.innerHTML.trimRight()+"\n":r.body.innerHTML}}),define("core/post-process",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0;e.name="core/post-process";let n;e.done=new Promise(e=>{n=e});(0,t.sub)("plugins-done",async e=>{const t=[];if(Array.isArray(e.postProcess)){const n=await Promise.all(e.postProcess.filter(e=>"function"==typeof e).map(t=>Promise.resolve(t(e,document))));t.push(...n)}"function"==typeof e.afterEnd&&t.push(await Promise.resolve(e.afterEnd(e,document))),n(t)},{once:!0})}),define("core/pre-process",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0;e.name="core/pre-process";let n;e.done=new Promise(e=>{n=e});(0,t.sub)("start-all",async e=>{const t=[];if(Array.isArray(e.preProcess)){const n=await Promise.all(e.preProcess.filter(e=>"function"==typeof e).map(t=>Promise.resolve(t(e,document))));t.push(...n)}n(t)},{once:!0})}),define("core/include-config",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/include-config";const n={},r=e=>Object.assign(n,e);(0,t.sub)("start-all",r),(0,t.sub)("amend-user-config",r),(0,t.sub)("end-all",()=>{const e=document.createElement("script");e.id="initialUserConfig",e.type="application/json",e.innerHTML=JSON.stringify(n,null,2),document.head.appendChild(e)})}),define("core/override-configuration",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/override-configuration";(0,t.sub)("start-all",function(e){const n=document.location.search.replace(/;/g,"&"),r=new URLSearchParams(n),i=Array.from(r.entries()).filter(([e,t])=>!!e&&!!t).map(([e,t])=>{const n=decodeURIComponent(e),r=decodeURIComponent(t.replace(/%3D/g,"="));let i;try{i=JSON.parse(r)}catch(e){i=r}return{key:n,value:i}}).reduce((e,{key:t,value:n})=>(e[t]=n,e),{});Object.assign(e,i),(0,t.pub)("amend-user-config",i)},{once:!0})}),define("core/respec-ready",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/respec-ready";const n=new Promise(e=>{(0,t.sub)("end-all",e,{once:!0})});Object.defineProperty(document,"respecIsReady",{get:()=>n})}),define("core/base-runner",["exports","core/utils","core/post-process","core/pre-process","core/pubsubhub","core/include-config","core/override-configuration","core/respec-ready"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.runAll=async function(e){(0,i.pub)("start-all",respecConfig),a&&performance.mark(o+"-start");await r.done;const l=e.filter(e=>e&&e.run).map(s);for(const e of l)try{await e(respecConfig)}catch(e){console.error(e)}(0,i.pub)("plugins-done",respecConfig),await n.done,(0,i.pub)("end-all",respecConfig),(0,t.removeReSpec)(document),a&&(performance.mark(o+"-end"),performance.measure(o,o+"-start",o+"-end"))};const o=e.name="core/base-runner",a=performance.mark&&performance.measure;function s(e){const t=e.name||"";return t||console.warn("Plugin lacks name:",e),n=>new Promise(async(r,i)=>{const o=setTimeout(()=>{const n=`Plugin ${t} took too long.`;console.error(n,e),i(new Error(n))},15e3);a&&performance.mark(t+"-start");try{e.run.length<=1?(await e.run(n),r()):e.run(n,document,r)}catch(e){i(e)}finally{clearTimeout(o)}a&&(performance.mark(t+"-end"),performance.measure(t,t+"-start",t+"-end"))})}});var shortcut={all_shortcuts:{},add:function(e,t,n){var r={type:"keydown",propagate:!1,disable_in_input:!1,target:document,keycode:!1};if(n)for(var i in r)void 0===n[i]&&(n[i]=r[i]);else n=r;var o=n.target;"string"==typeof n.target&&(o=document.getElementById(n.target));e=e.toLowerCase();var a=function(r){var i,o;if((r=r||window.event,n.disable_in_input)&&(r.target?o=r.target:r.srcElement&&(o=r.srcElement),3==o.nodeType&&(o=o.parentNode),"INPUT"==o.tagName||"TEXTAREA"==o.tagName))return;r.keyCode?i=r.keyCode:r.which&&(i=r.which);var a=String.fromCharCode(i).toLowerCase();188==i&&(a=","),190==i&&(a=".");var s=e.split("+"),l=0,c={"`":"~",1:"!",2:"@",3:"#",4:"$",5:"%",6:"^",7:"&",8:"*",9:"(",0:")","-":"_","=":"+",";":":","'":'"',",":"<",".":">","/":"?","\\":"|"},u={esc:27,escape:27,tab:9,space:32,return:13,enter:13,backspace:8,scrolllock:145,scroll_lock:145,scroll:145,capslock:20,caps_lock:20,caps:20,numlock:144,num_lock:144,num:144,pause:19,break:19,insert:45,home:36,delete:46,end:35,pageup:33,page_up:33,pu:33,pagedown:34,page_down:34,pd:34,left:37,up:38,right:39,down:40,f1:112,f2:113,f3:114,f4:115,f5:116,f6:117,f7:118,f8:119,f9:120,f10:121,f11:122,f12:123},d={shift:{wanted:!1,pressed:!1},ctrl:{wanted:!1,pressed:!1},alt:{wanted:!1,pressed:!1},meta:{wanted:!1,pressed:!1}};r.ctrlKey&&(d.ctrl.pressed=!0),r.shiftKey&&(d.shift.pressed=!0),r.altKey&&(d.alt.pressed=!0),r.metaKey&&(d.meta.pressed=!0);for(var p,f=0;p=s[f],f1?u[p]==i&&l++:n.keycode?n.keycode==i&&l++:a==p?l++:c[a]&&r.shiftKey&&(a=c[a])==p&&l++;if(l==s.length&&d.ctrl.pressed==d.ctrl.wanted&&d.shift.pressed==d.shift.wanted&&d.alt.pressed==d.alt.wanted&&d.meta.pressed==d.meta.wanted&&(t(r),!n.propagate))return r.cancelBubble=!0,r.returnValue=!1,r.stopPropagation&&(r.stopPropagation(),r.preventDefault()),!1};this.all_shortcuts[e]={callback:a,target:o,event:n.type},o.addEventListener?o.addEventListener(n.type,a,!1):o.attachEvent?o.attachEvent("on"+n.type,a):o["on"+n.type]=a}},Zx,t0,u0,Dha,Eha,mta,nta,eXa,fXa;define("shortcut",(Zx=this,function(){return Zx.shortcut})),define("deps/text",["module"],function(e){var t,n,r,i,o,a=["Msxml2.XMLHTTP","Microsoft.XMLHTTP","Msxml2.XMLHTTP.4.0"],s=/^\s*<\?xml(\s)+version=[\'\"](\d)*.(\d)*[\'\"](\s)*\?>/im,l=/]*>\s*([\s\S]+)\s*<\/body>/im,c="undefined"!=typeof location&&location.href,u=c&&location.protocol&&location.protocol.replace(/\:/,""),d=c&&location.hostname,p=c&&(location.port||void 0),f={},h=e.config&&e.config()||{};function m(e,t){return void 0===e||""===e?t:e}return t={version:"2.0.15",strip:function(e){if(e){var t=(e=e.replace(s,"")).match(l);t&&(e=t[1])}else e="";return e},jsEscape:function(e){return e.replace(/(['\\])/g,"\\$1").replace(/[\f]/g,"\\f").replace(/[\b]/g,"\\b").replace(/[\n]/g,"\\n").replace(/[\t]/g,"\\t").replace(/[\r]/g,"\\r").replace(/[\u2028]/g,"\\u2028").replace(/[\u2029]/g,"\\u2029")},createXhr:h.createXhr||function(){var e,t,n;if("undefined"!=typeof XMLHttpRequest)return new XMLHttpRequest;if("undefined"!=typeof ActiveXObject)for(t=0;t<3;t+=1){n=a[t];try{e=new ActiveXObject(n)}catch(e){}if(e){a=[n];break}}return e},parseName:function(e){var t,n,r,i=!1,o=e.lastIndexOf("."),a=0===e.indexOf("./")||0===e.indexOf("../");return-1!==o&&(!a||o>1)?(t=e.substring(0,o),n=e.substring(o+1)):t=e,-1!==(o=(r=n||t).indexOf("!"))&&(i="strip"===r.substring(o+1),r=r.substring(0,o),n?n=r:t=r),{moduleName:t,ext:n,strip:i}},xdRegExp:/^((\w+)\:)?\/\/([^\/\\]+)/,useXhr:function(e,n,r,i){var o,a,s,l=t.xdRegExp.exec(e);return!l||(o=l[2],s=(a=(a=l[3]).split(":"))[1],a=a[0],(!o||o===n)&&(!a||a.toLowerCase()===r.toLowerCase())&&(!s&&!a||function(e,t,n,r){if(t===r)return!0;if(e===n){if("http"===e)return m(t,"80")===m(r,"80");if("https"===e)return m(t,"443")===m(r,"443")}return!1}(o,s,n,i)))},finishLoad:function(e,n,r,i){r=n?t.strip(r):r,h.isBuild&&(f[e]=r),i(r)},load:function(e,n,r,i){if(i&&i.isBuild&&!i.inlineText)r();else{h.isBuild=i&&i.isBuild;var o=t.parseName(e),a=o.moduleName+(o.ext?"."+o.ext:""),s=n.toUrl(a),l=h.useXhr||t.useXhr;0!==s.indexOf("empty:")?!c||l(s,u,d,p)?t.get(s,function(n){t.finishLoad(e,o.strip,n,r)},function(e){r.error&&r.error(e)}):n([a],function(e){t.finishLoad(o.moduleName+"."+o.ext,o.strip,e,r)}):r()}},write:function(e,n,r,i){if(f.hasOwnProperty(n)){var o=t.jsEscape(f[n]);r.asModule(e+"!"+n,"define(function () { return '"+o+"';});\n")}},writeFile:function(e,n,r,i,o){var a=t.parseName(n),s=a.ext?"."+a.ext:"",l=a.moduleName+s,c=r.toUrl(a.moduleName+s)+".js";t.load(l,r,function(n){var r=function(e){return i(c,e)};r.asModule=function(e,t){return i.asModule(e,c,t)},t.write(e,l,r,o)},o)}},"node"===h.env||!h.env&&"undefined"!=typeof process&&process.versions&&process.versions.node&&!process.versions["node-webkit"]&&!process.versions["atom-shell"]?(n=require.nodeRequire("fs"),t.get=function(e,t,r){try{var i=n.readFileSync(e,"utf8");"\ufeff"===i[0]&&(i=i.substring(1)),t(i)}catch(e){r&&r(e)}}):"xhr"===h.env||!h.env&&t.createXhr()?t.get=function(e,n,r,i){var o,a=t.createXhr();if(a.open("GET",e,!0),i)for(o in i)i.hasOwnProperty(o)&&a.setRequestHeader(o.toLowerCase(),i[o]);h.onXhr&&h.onXhr(a,e),a.onreadystatechange=function(t){var i,o;4===a.readyState&&((i=a.status||0)>399&&i<600?((o=new Error(e+" HTTP status: "+i)).xhr=a,r&&r(o)):n(a.responseText),h.onXhrComplete&&h.onXhrComplete(a,e))},a.send(null)}:"rhino"===h.env||!h.env&&"undefined"!=typeof Packages&&"undefined"!=typeof java?t.get=function(e,t){var n,r,i=new java.io.File(e),o=java.lang.System.getProperty("line.separator"),a=new java.io.BufferedReader(new java.io.InputStreamReader(new java.io.FileInputStream(i),"utf-8")),s="";try{for(n=new java.lang.StringBuffer,(r=a.readLine())&&r.length()&&65279===r.charAt(0)&&(r=r.substring(1)),null!==r&&n.append(r);null!==(r=a.readLine());)n.append(o),n.append(r);s=String(n.toString())}finally{a.close()}t(s)}:("xpconnect"===h.env||!h.env&&"undefined"!=typeof Components&&Components.classes&&Components.interfaces)&&(r=Components.classes,i=Components.interfaces,Components.utils.import("resource://gre/modules/FileUtils.jsm"),o="@mozilla.org/windows-registry-key;1"in r,t.get=function(e,t){var n,a,s,l={};o&&(e=e.replace(/\//g,"\\")),s=new FileUtils.File(e);try{(n=r["@mozilla.org/network/file-input-stream;1"].createInstance(i.nsIFileInputStream)).init(s,1,0,!1),(a=r["@mozilla.org/intl/converter-input-stream;1"].createInstance(i.nsIConverterInputStream)).init(n,"utf-8",n.available(),i.nsIConverterInputStream.DEFAULT_REPLACEMENT_CHARACTER),a.readString(n.available(),l),a.close(),n.close(),t(l.value)}catch(e){throw new Error((s&&s.path||"")+": "+e)}}),t}),define("deps/text!ui/ui.css",[],function(){return'#respec-ui {\n position: fixed;\n display: flex;\n flex-direction: row-reverse;\n top: 20px;\n right: 20px;\n width: 202px;\n text-align: right;\n z-index: 9000;\n}\n\n#respec-pill,\n.respec-info-button {\n background: #fff;\n height: 2.5em;\n color: rgb(120, 120, 120);\n border: 1px solid #ccc;\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\n}\n\n.respec-info-button {\n border: none;\n opacity: 0.75;\n border-radius: 2em;\n margin-right: 1em;\n min-width: 3.5em;\n}\n\n.respec-info-button:focus,\n.respec-info-button:hover {\n opacity: 1;\n transition: opacity 0.2s;\n}\n\n#respec-pill:disabled {\n font-size: 2.8px;\n text-indent: -9999em;\n border-top: 1.1em solid rgba(40, 40, 40, 0.2);\n border-right: 1.1em solid rgba(40, 40, 40, 0.2);\n border-bottom: 1.1em solid rgba(40, 40, 40, 0.2);\n border-left: 1.1em solid #ffffff;\n transform: translateZ(0);\n animation: respec-spin 0.5s infinite linear;\n box-shadow: none;\n}\n\n#respec-pill:disabled,\n#respec-pill:disabled:after {\n border-radius: 50%;\n width: 10em;\n height: 10em;\n}\n\n@keyframes respec-spin {\n 0% {\n transform: rotate(0deg);\n }\n 100% {\n transform: rotate(360deg);\n }\n}\n\n.respec-hidden {\n visibility: hidden;\n opacity: 0;\n transition: visibility 0s 0.2s, opacity 0.2s linear;\n}\n\n.respec-visible {\n visibility: visible;\n opacity: 1;\n transition: opacity 0.2s linear;\n}\n\n#respec-pill:hover,\n#respec-pill:focus {\n color: rgb(0, 0, 0);\n background-color: rgb(245, 245, 245);\n transition: color 0.2s;\n}\n\n#respec-menu {\n position: absolute;\n margin: 0;\n padding: 0;\n font-family: sans-serif;\n background: #fff;\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\n width: 200px;\n display: none;\n text-align: left;\n margin-top: 32px;\n font-size: 0.8em;\n}\n\n#respec-menu:not([hidden]) {\n display: block;\n}\n\n#respec-menu li {\n list-style-type: none;\n margin: 0;\n padding: 0;\n}\n\n.respec-save-buttons {\n display: grid;\n grid-template-columns: repeat(auto-fill, minmax(47%, 2fr));\n grid-gap: 0.5cm;\n padding: 0.5cm;\n}\n\n.respec-save-button:link {\n padding-top: 16px;\n color: rgb(240, 240, 240);\n background: rgb(42, 90, 168);\n justify-self: stretch;\n height: 1cm;\n text-decoration: none;\n text-align: center;\n font-size: inherit;\n border: none;\n border-radius: 0.2cm;\n}\n\n.respec-save-button:link:hover {\n color: white;\n background: rgb(42, 90, 168);\n padding: 0;\n margin: 0;\n border: 0;\n padding-top: 16px;\n}\n\n#respec-ui button:focus,\n#respec-pill:focus,\n.respec-option:focus {\n outline: 0;\n outline-style: none;\n}\n\n#respec-pill-error {\n background-color: red;\n color: white;\n}\n\n#respec-pill-warning {\n background-color: orange;\n color: white;\n}\n\n.respec-warning-list,\n.respec-error-list {\n margin: 0;\n padding: 0;\n list-style: none;\n font-family: sans-serif;\n background-color: rgb(255, 251, 230);\n font-size: 0.85em;\n}\n\n.respec-warning-list > li,\n.respec-error-list > li {\n padding: 0.4em 0.7em;\n}\n\n.respec-warning-list > li::before {\n content: "⚠️";\n padding-right: 0.5em;\n}\n.respec-warning-list p,\n.respec-error-list p {\n padding: 0;\n margin: 0;\n}\n\n.respec-warning-list li {\n color: rgb(92, 59, 0);\n border-bottom: thin solid rgb(255, 245, 194);\n}\n\n.respec-error-list,\n.respec-error-list li {\n background-color: rgb(255, 240, 240);\n}\n\n.respec-error-list li::before {\n content: "💥";\n padding-right: 0.5em;\n}\n\n.respec-error-list li {\n padding: 0.4em 0.7em;\n color: rgb(92, 59, 0);\n border-bottom: thin solid rgb(255, 215, 215);\n}\n\n.respec-error-list li > p {\n margin: 0;\n padding: 0;\n display: inline-block;\n}\n\n#respec-overlay {\n display: block;\n position: fixed;\n z-index: 10000;\n top: 0px;\n left: 0px;\n height: 100%;\n width: 100%;\n background: #000;\n}\n\n.respec-show-overlay {\n transition: opacity 0.2s linear;\n opacity: 0.5;\n}\n\n.respec-hide-overlay {\n transition: opacity 0.2s linear;\n opacity: 0;\n}\n\n.respec-modal {\n display: block;\n position: fixed;\n z-index: 11000;\n margin: auto;\n top: 10%;\n background: #fff;\n border: 5px solid #666;\n min-width: 20%;\n width: 79%;\n padding: 0;\n max-height: 80%;\n overflow-y: auto;\n margin: 0 -0.5cm;\n}\n\n@media screen and (min-width: 78em) {\n .respec-modal {\n width: 62%;\n }\n}\n\n.respec-modal h3 {\n margin: 0;\n padding: 0.2em;\n text-align: center;\n color: black;\n background: linear-gradient(\n to bottom,\n rgba(238, 238, 238, 1) 0%,\n rgba(238, 238, 238, 1) 50%,\n rgba(204, 204, 204, 1) 100%\n );\n font-size: 1em;\n}\n\n.respec-modal .inside div p {\n padding-left: 1cm;\n}\n\n#respec-menu button.respec-option {\n background: white;\n padding: 0 0.2cm;\n border: none;\n width: 100%;\n text-align: left;\n font-size: inherit;\n padding: 1.2em 1.2em;\n}\n\n#respec-menu button.respec-option:hover,\n#respec-menu button:focus {\n background-color: #eeeeee;\n}\n\n.respec-cmd-icon {\n padding-right: 0.5em;\n}\n\n#respec-ui button.respec-option:last-child {\n border: none;\n border-radius: inherit;\n}\n\n.respec-offending-element {\n display: inline-block;\n position: relative;\n background: url(data:image/gif;base64,R0lGODdhBAADAPEAANv///8AAP///wAAACwAAAAABAADAEACBZQjmIAFADs=)\n bottom repeat-x;\n}\n\n@supports (text-decoration-style: wavy) {\n .respec-offending-element {\n background: none;\n text-decoration-line: underline;\n text-decoration-style: wavy;\n text-decoration-color: red;\n }\n}\n\n.respec-button-copy-paste {\n position: absolute;\n display: block;\n padding: 0px 8px;\n height: 28px;\n width: 40px;\n color: #333;\n white-space: nowrap;\n vertical-align: middle;\n cursor: pointer;\n background-color: #eee;\n background-image: linear-gradient(#fcfcfc, #eee);\n border: 1px solid rgb(144, 184, 222);\n border-radius: 0px 0px 3px 0;\n -webkit-user-select: none;\n -moz-user-select: none;\n -ms-user-select: none;\n user-select: none;\n -webkit-appearance: none;\n margin: 0px 127px;\n border-left: 0;\n}\n\np + .respec-button-copy-paste {\n margin: 1px 127px;\n}\n\n#specref-ui {\n margin: 0 2%;\n margin-bottom: 0.5cm;\n}\n\n#specref-ui header {\n font-size: 0.7em;\n background-color: #eee;\n text-align: center;\n padding: 0.2cm;\n margin-bottom: 0.5cm;\n border-radius: 0 0 0.2cm 0.2cm;\n}\n\n#specref-ui header h1 {\n padding: 0;\n margin: 0;\n color: black;\n}\n\n#specref-ui p {\n padding: 0;\n margin: 0;\n font-size: 0.8em;\n text-align: center;\n}\n\n#specref-ui p.state {\n margin: 1cm;\n}\n\n#specref-ui .searchcomponent {\n font-size: 16px;\n display: grid;\n grid-template-columns: auto 2cm;\n}\n#specref-ui .searchcomponent:focus {\n}\n\n#specref-ui input,\n#specref-ui button {\n border: 0;\n padding: 6px 12px;\n}\n\n#specref-ui label {\n font-size: 0.6em;\n grid-column-end: 3;\n text-align: right;\n grid-column-start: 1;\n}\n\n#specref-ui input[type="search"] {\n -webkit-appearance: none;\n font-size: 16px;\n border-radius: 0.1cm 0 0 0.1cm;\n border: 1px solid rgb(204, 204, 204);\n}\n\n#specref-ui button[type="submit"] {\n color: white;\n border-radius: 0 0.1cm 0.1cm 0;\n background-color: rgb(51, 122, 183);\n}\n\n#specref-ui button[type="submit"]:hover {\n background-color: #286090;\n border-color: #204d74;\n}\n\n#specref-ui .result-stats {\n margin: 0;\n padding: 0;\n color: rgb(128, 128, 128);\n font-size: 0.7em;\n font-weight: bold;\n}\n\n#specref-ui .specref-results {\n font-size: 0.8em;\n}\n\n#specref-ui .specref-results dd + dt {\n margin-top: 0.51cm;\n}\n\n#specref-ui .specref-results a {\n text-transform: capitalize;\n}\n#specref-ui .specref-results .authors {\n display: block;\n color: #006621;\n}\n\n@media print {\n #respec-ui {\n display: none;\n }\n}\n'}),t0="undefined"!=typeof window?window:this,u0=function(e,t){var n=[],r=e.document,i=Object.getPrototypeOf,o=n.slice,a=n.concat,s=n.push,l=n.indexOf,c={},u=c.toString,d=c.hasOwnProperty,p=d.toString,f=p.call(Object),h={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType},g=function(e){return null!=e&&e===e.window},b={type:!0,src:!0,noModule:!0};function y(e,t,n){var i,o=(t=t||r).createElement("script");if(o.text=e,n)for(i in b)n[i]&&(o[i]=n[i]);t.head.appendChild(o).parentNode.removeChild(o)}function v(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?c[u.call(e)]||"object":typeof e}var w="3.3.1 -ajax,-ajax/jsonp,-ajax/load,-ajax/parseXML,-ajax/script,-ajax/var/location,-ajax/var/nonce,-ajax/var/rquery,-ajax/xhr,-manipulation/_evalUrl,-event/ajax,-effects,-effects/Tween,-effects/animatedSelector",x=function(e,t){return new x.fn.init(e,t)},k=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;function C(e){var t=!!e&&"length"in e&&e.length,n=v(e);return!m(e)&&!g(e)&&("array"===n||0===t||"number"==typeof t&&t>0&&t-1 in e)}x.fn=x.prototype={jquery:w,constructor:x,length:0,toArray:function(){return o.call(this)},get:function(e){return null==e?o.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=x.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return x.each(this,e)},map:function(e){return this.pushStack(x.map(this,function(t,n){return e.call(t,n,t)}))},slice:function(){return this.pushStack(o.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(n>=0&&n+~]|"+M+")"+M+"*"),F=new RegExp("="+M+"*([^\\]'\"]*?)"+M+"*\\]","g"),z=new RegExp(q),G=new RegExp("^"+O+"$"),V={ID:new RegExp("^#("+O+")"),CLASS:new RegExp("^\\.("+O+")"),TAG:new RegExp("^("+O+"|[*])"),ATTR:new RegExp("^"+I),PSEUDO:new RegExp("^"+q),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+P+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},X=/^(?:input|select|textarea|button)$/i,Z=/^h\d$/i,Y=/^[^{]+\{\s*\[native \w/,Q=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,J=/[+~]/,K=new RegExp("\\\\([\\da-f]{1,6}"+M+"?|("+M+")|.)","ig"),ee=function(e,t,n){var r="0x"+t-65536;return r!=r||n?t:r<0?String.fromCharCode(r+65536):String.fromCharCode(r>>10|55296,1023&r|56320)},te=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ne=function(e,t){return t?"\0"===e?"�":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},re=function(){p()},ie=ye(function(e){return!0===e.disabled&&("form"in e||"label"in e)},{dir:"parentNode",next:"legend"});try{_.apply(L=N.call(x.childNodes),x.childNodes),L[x.childNodes.length].nodeType}catch(e){_={apply:L.length?function(e,t){D.apply(e,N.call(t))}:function(e,t){for(var n=e.length,r=0;e[n++]=t[r++];);e.length=n-1}}}function oe(e,t,r,i){var o,s,c,u,d,h,b,y=t&&t.ownerDocument,k=t?t.nodeType:9;if(r=r||[],"string"!=typeof e||!e||1!==k&&9!==k&&11!==k)return r;if(!i&&((t?t.ownerDocument||t:x)!==f&&p(t),t=t||f,m)){if(11!==k&&(d=Q.exec(e)))if(o=d[1]){if(9===k){if(!(c=t.getElementById(o)))return r;if(c.id===o)return r.push(c),r}else if(y&&(c=y.getElementById(o))&&v(t,c)&&c.id===o)return r.push(c),r}else{if(d[2])return _.apply(r,t.getElementsByTagName(e)),r;if((o=d[3])&&n.getElementsByClassName&&t.getElementsByClassName)return _.apply(r,t.getElementsByClassName(o)),r}if(n.qsa&&!T[e+" "]&&(!g||!g.test(e))){if(1!==k)y=t,b=e;else if("object"!==t.nodeName.toLowerCase()){for((u=t.getAttribute("id"))?u=u.replace(te,ne):t.setAttribute("id",u=w),s=(h=a(e)).length;s--;)h[s]="#"+u+" "+be(h[s]);b=h.join(","),y=J.test(e)&&me(t.parentNode)||t}if(b)try{return _.apply(r,y.querySelectorAll(b)),r}catch(e){}finally{u===w&&t.removeAttribute("id")}}}return l(e.replace(W,"$1"),t,r,i)}function ae(){var e=[];return function t(n,i){return e.push(n+" ")>r.cacheLength&&delete t[e.shift()],t[n+" "]=i}}function se(e){return e[w]=!0,e}function le(e){var t=f.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function ce(e,t){for(var n=e.split("|"),i=n.length;i--;)r.attrHandle[n[i]]=t}function ue(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)for(;n=n.nextSibling;)if(n===t)return-1;return e?1:-1}function de(e){return function(t){return"input"===t.nodeName.toLowerCase()&&t.type===e}}function pe(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function fe(e){return function(t){return"form"in t?t.parentNode&&!1===t.disabled?"label"in t?"label"in t.parentNode?t.parentNode.disabled===e:t.disabled===e:t.isDisabled===e||t.isDisabled!==!e&&ie(t)===e:t.disabled===e:"label"in t&&t.disabled===e}}function he(e){return se(function(t){return t=+t,se(function(n,r){for(var i,o=e([],n.length,t),a=o.length;a--;)n[i=o[a]]&&(n[i]=!(r[i]=n[i]))})})}function me(e){return e&&void 0!==e.getElementsByTagName&&e}n=oe.support={},o=oe.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return!!t&&"HTML"!==t.nodeName},p=oe.setDocument=function(e){var t,i,a=e?e.ownerDocument||e:x;return a!==f&&9===a.nodeType&&a.documentElement?(h=(f=a).documentElement,m=!o(f),x!==f&&(i=f.defaultView)&&i.top!==i&&(i.addEventListener?i.addEventListener("unload",re,!1):i.attachEvent&&i.attachEvent("onunload",re)),n.attributes=le(function(e){return e.className="i",!e.getAttribute("className")}),n.getElementsByTagName=le(function(e){return e.appendChild(f.createComment("")),!e.getElementsByTagName("*").length}),n.getElementsByClassName=Y.test(f.getElementsByClassName),n.getById=le(function(e){return h.appendChild(e).id=w,!f.getElementsByName||!f.getElementsByName(w).length}),n.getById?(r.filter.ID=function(e){var t=e.replace(K,ee);return function(e){return e.getAttribute("id")===t}},r.find.ID=function(e,t){if(void 0!==t.getElementById&&m){var n=t.getElementById(e);return n?[n]:[]}}):(r.filter.ID=function(e){var t=e.replace(K,ee);return function(e){var n=void 0!==e.getAttributeNode&&e.getAttributeNode("id");return n&&n.value===t}},r.find.ID=function(e,t){if(void 0!==t.getElementById&&m){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];for(i=t.getElementsByName(e),r=0;o=i[r++];)if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),r.find.TAG=n.getElementsByTagName?function(e,t){return void 0!==t.getElementsByTagName?t.getElementsByTagName(e):n.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){for(;n=o[i++];)1===n.nodeType&&r.push(n);return r}return o},r.find.CLASS=n.getElementsByClassName&&function(e,t){if(void 0!==t.getElementsByClassName&&m)return t.getElementsByClassName(e)},b=[],g=[],(n.qsa=Y.test(f.querySelectorAll))&&(le(function(e){h.appendChild(e).innerHTML="
    ",e.querySelectorAll("[msallowcapture^='']").length&&g.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||g.push("\\["+M+"*(?:value|"+P+")"),e.querySelectorAll("[id~="+w+"-]").length||g.push("~="),e.querySelectorAll(":checked").length||g.push(":checked"),e.querySelectorAll("a#"+w+"+*").length||g.push(".#.+[+~]")}),le(function(e){e.innerHTML="";var t=f.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&g.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&g.push(":enabled",":disabled"),h.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&g.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),g.push(",.*:")})),(n.matchesSelector=Y.test(y=h.matches||h.webkitMatchesSelector||h.mozMatchesSelector||h.oMatchesSelector||h.msMatchesSelector))&&le(function(e){n.disconnectedMatch=y.call(e,"*"),y.call(e,"[s!='']:x"),b.push("!=",q)}),g=g.length&&new RegExp(g.join("|")),b=b.length&&new RegExp(b.join("|")),t=Y.test(h.compareDocumentPosition),v=t||Y.test(h.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)for(;t=t.parentNode;)if(t===e)return!0;return!1},S=t?function(e,t){if(e===t)return d=!0,0;var r=!e.compareDocumentPosition-!t.compareDocumentPosition;return r||(1&(r=(e.ownerDocument||e)===(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!n.sortDetached&&t.compareDocumentPosition(e)===r?e===f||e.ownerDocument===x&&v(x,e)?-1:t===f||t.ownerDocument===x&&v(x,t)?1:u?R(u,e)-R(u,t):0:4&r?-1:1)}:function(e,t){if(e===t)return d=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e===f?-1:t===f?1:i?-1:o?1:u?R(u,e)-R(u,t):0;if(i===o)return ue(e,t);for(n=e;n=n.parentNode;)a.unshift(n);for(n=t;n=n.parentNode;)s.unshift(n);for(;a[r]===s[r];)r++;return r?ue(a[r],s[r]):a[r]===x?-1:s[r]===x?1:0},f):f},oe.matches=function(e,t){return oe(e,null,null,t)},oe.matchesSelector=function(e,t){if((e.ownerDocument||e)!==f&&p(e),t=t.replace(F,"='$1']"),n.matchesSelector&&m&&!T[t+" "]&&(!b||!b.test(t))&&(!g||!g.test(t)))try{var r=y.call(e,t);if(r||n.disconnectedMatch||e.document&&11!==e.document.nodeType)return r}catch(e){}return oe(t,f,null,[e]).length>0},oe.contains=function(e,t){return(e.ownerDocument||e)!==f&&p(e),v(e,t)},oe.attr=function(e,t){(e.ownerDocument||e)!==f&&p(e);var i=r.attrHandle[t.toLowerCase()],o=i&&A.call(r.attrHandle,t.toLowerCase())?i(e,t,!m):void 0;return void 0!==o?o:n.attributes||!m?e.getAttribute(t):(o=e.getAttributeNode(t))&&o.specified?o.value:null},oe.escape=function(e){return(e+"").replace(te,ne)},oe.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},oe.uniqueSort=function(e){var t,r=[],i=0,o=0;if(d=!n.detectDuplicates,u=!n.sortStable&&e.slice(0),e.sort(S),d){for(;t=e[o++];)t===e[o]&&(i=r.push(o));for(;i--;)e.splice(r[i],1)}return u=null,e},i=oe.getText=function(e){var t,n="",r=0,o=e.nodeType;if(o){if(1===o||9===o||11===o){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=i(e)}else if(3===o||4===o)return e.nodeValue}else for(;t=e[r++];)n+=i(t);return n},(r=oe.selectors={cacheLength:50,createPseudo:se,match:V,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(K,ee),e[3]=(e[3]||e[4]||e[5]||"").replace(K,ee),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||oe.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&oe.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return V.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&z.test(n)&&(t=a(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(K,ee).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=E[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&E(e,function(e){return t.test("string"==typeof e.className&&e.className||void 0!==e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r){var i=oe.attr(r,e);return null==i?"!="===t:!t||(i+="","="===t?i===n:"!="===t?i!==n:"^="===t?n&&0===i.indexOf(n):"*="===t?n&&i.indexOf(n)>-1:"$="===t?n&&i.slice(-n.length)===n:"~="===t?(" "+i.replace(U," ")+" ").indexOf(n)>-1:"|="===t&&(i===n||i.slice(0,n.length+1)===n+"-"))}},CHILD:function(e,t,n,r,i){var o="nth"!==e.slice(0,3),a="last"!==e.slice(-4),s="of-type"===t;return 1===r&&0===i?function(e){return!!e.parentNode}:function(t,n,l){var c,u,d,p,f,h,m=o!==a?"nextSibling":"previousSibling",g=t.parentNode,b=s&&t.nodeName.toLowerCase(),y=!l&&!s,v=!1;if(g){if(o){for(;m;){for(p=t;p=p[m];)if(s?p.nodeName.toLowerCase()===b:1===p.nodeType)return!1;h=m="only"===e&&!h&&"nextSibling"}return!0}if(h=[a?g.firstChild:g.lastChild],a&&y){for(v=(f=(c=(u=(d=(p=g)[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]||[])[0]===k&&c[1])&&c[2],p=f&&g.childNodes[f];p=++f&&p&&p[m]||(v=f=0)||h.pop();)if(1===p.nodeType&&++v&&p===t){u[e]=[k,f,v];break}}else if(y&&(v=f=(c=(u=(d=(p=t)[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]||[])[0]===k&&c[1]),!1===v)for(;(p=++f&&p&&p[m]||(v=f=0)||h.pop())&&((s?p.nodeName.toLowerCase()!==b:1!==p.nodeType)||!++v||(y&&((u=(d=p[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]=[k,v]),p!==t)););return(v-=i)===r||v%r==0&&v/r>=0}}},PSEUDO:function(e,t){var n,i=r.pseudos[e]||r.setFilters[e.toLowerCase()]||oe.error("unsupported pseudo: "+e);return i[w]?i(t):i.length>1?(n=[e,e,"",t],r.setFilters.hasOwnProperty(e.toLowerCase())?se(function(e,n){for(var r,o=i(e,t),a=o.length;a--;)e[r=R(e,o[a])]=!(n[r]=o[a])}):function(e){return i(e,0,n)}):i}},pseudos:{not:se(function(e){var t=[],n=[],r=s(e.replace(W,"$1"));return r[w]?se(function(e,t,n,i){for(var o,a=r(e,null,i,[]),s=e.length;s--;)(o=a[s])&&(e[s]=!(t[s]=o))}):function(e,i,o){return t[0]=e,r(t,null,o,n),t[0]=null,!n.pop()}}),has:se(function(e){return function(t){return oe(e,t).length>0}}),contains:se(function(e){return e=e.replace(K,ee),function(t){return(t.textContent||t.innerText||i(t)).indexOf(e)>-1}}),lang:se(function(e){return G.test(e||"")||oe.error("unsupported lang: "+e),e=e.replace(K,ee).toLowerCase(),function(t){var n;do{if(n=m?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return(n=n.toLowerCase())===e||0===n.indexOf(e+"-")}while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===h},focus:function(e){return e===f.activeElement&&(!f.hasFocus||f.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:fe(!1),disabled:fe(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!r.pseudos.empty(e)},header:function(e){return Z.test(e.nodeName)},input:function(e){return X.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:he(function(){return[0]}),last:he(function(e,t){return[t-1]}),eq:he(function(e,t,n){return[n<0?n+t:n]}),even:he(function(e,t){for(var n=0;n=0;)e.push(r);return e}),gt:he(function(e,t,n){for(var r=n<0?n+t:n;++r1?function(t,n,r){for(var i=e.length;i--;)if(!e[i](t,n,r))return!1;return!0}:e[0]}function we(e,t,n,r,i){for(var o,a=[],s=0,l=e.length,c=null!=t;s-1&&(o[c]=!(a[c]=d))}}else b=we(b===a?b.splice(h,b.length):b),i?i(null,a,b,l):_.apply(a,b)})}function ke(e){for(var t,n,i,o=e.length,a=r.relative[e[0].type],s=a||r.relative[" "],l=a?1:0,u=ye(function(e){return e===t},s,!0),d=ye(function(e){return R(t,e)>-1},s,!0),p=[function(e,n,r){var i=!a&&(r||n!==c)||((t=n).nodeType?u(e,n,r):d(e,n,r));return t=null,i}];l1&&ve(p),l>1&&be(e.slice(0,l-1).concat({value:" "===e[l-2].type?"*":""})).replace(W,"$1"),n,l0,l=i.length>0,u=function(e,t,n,a,u){var d,h,g,b=0,y="0",v=e&&[],w=[],x=c,C=e||l&&r.find.TAG("*",u),E=k+=null==x?1:Math.random()||.1,$=C.length;for(u&&(c=t===f||t||u);y!==$&&null!=(d=C[y]);y++){if(l&&d){for(h=0,t||d.ownerDocument===f||(p(d),n=!m);g=i[h++];)if(g(d,t||f,n)){a.push(d);break}u&&(k=E)}s&&((d=!g&&d)&&b--,e&&v.push(d))}if(b+=y,s&&y!==b){for(h=0;g=o[h++];)g(v,w,t,n);if(e){if(b>0)for(;y--;)v[y]||w[y]||(w[y]=j.call(a));w=we(w)}_.apply(a,w),u&&!e&&w.length>0&&b+o.length>1&&oe.uniqueSort(a)}return u&&(k=E,c=x),v},s?se(u):u))).selector=e}return g},l=oe.select=function(e,t,n,i){var o,l,c,u,d,p="function"==typeof e&&e,f=!i&&a(e=p.selector||e);if(n=n||[],1===f.length){if((l=f[0]=f[0].slice(0)).length>2&&"ID"===(c=l[0]).type&&9===t.nodeType&&m&&r.relative[l[1].type]){if(!(t=(r.find.ID(c.matches[0].replace(K,ee),t)||[])[0]))return n;p&&(t=t.parentNode),e=e.slice(l.shift().value.length)}for(o=V.needsContext.test(e)?0:l.length;o--&&(c=l[o],!r.relative[u=c.type]);)if((d=r.find[u])&&(i=d(c.matches[0].replace(K,ee),J.test(l[0].type)&&me(t.parentNode)||t))){if(l.splice(o,1),!(e=i.length&&be(l)))return _.apply(n,i),n;break}}return(p||s(e,f))(i,t,!m,n,!t||J.test(e)&&me(t.parentNode)||t),n},n.sortStable=w.split("").sort(S).join("")===w,n.detectDuplicates=!!d,p(),n.sortDetached=le(function(e){return 1&e.compareDocumentPosition(f.createElement("fieldset"))}),le(function(e){return e.innerHTML="","#"===e.firstChild.getAttribute("href")})||ce("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),n.attributes&&le(function(e){return e.innerHTML="",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||ce("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),le(function(e){return null==e.getAttribute("disabled")})||ce(P,function(e,t,n){var r;if(!n)return!0===e[t]?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),oe}(e);x.find=E,x.expr=E.selectors,x.expr[":"]=x.expr.pseudos,x.uniqueSort=x.unique=E.uniqueSort,x.text=E.getText,x.isXMLDoc=E.isXML,x.contains=E.contains,x.escapeSelector=E.escape;var $=function(e,t,n){for(var r=[],i=void 0!==n;(e=e[t])&&9!==e.nodeType;)if(1===e.nodeType){if(i&&x(e).is(n))break;r.push(e)}return r},T=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},S=x.expr.match.needsContext;function A(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var L=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,t,n){return m(t)?x.grep(e,function(e,r){return!!t.call(e,r,e)!==n}):t.nodeType?x.grep(e,function(e){return e===t!==n}):"string"!=typeof t?x.grep(e,function(e){return l.call(t,e)>-1!==n}):x.filter(t,e,n)}x.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?x.find.matchesSelector(r,e)?[r]:[]:x.find.matches(e,x.grep(t,function(e){return 1===e.nodeType}))},x.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(x(e).filter(function(){for(t=0;t1?x.uniqueSort(n):n},filter:function(e){return this.pushStack(j(this,e||[],!1))},not:function(e){return this.pushStack(j(this,e||[],!0))},is:function(e){return!!j(this,"string"==typeof e&&S.test(e)?x(e):e||[],!1).length}});var D,_=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/;(x.fn.init=function(e,t,n){var i,o;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(i="<"===e[0]&&">"===e[e.length-1]&&e.length>=3?[null,e,null]:_.exec(e))||!i[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(i[1]){if(t=t instanceof x?t[0]:t,x.merge(this,x.parseHTML(i[1],t&&t.nodeType?t.ownerDocument||t:r,!0)),L.test(i[1])&&x.isPlainObject(t))for(i in t)m(this[i])?this[i](t[i]):this.attr(i,t[i]);return this}return(o=r.getElementById(i[2]))&&(this[0]=o,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(x):x.makeArray(e,this)}).prototype=x.fn,D=x(r);var N=/^(?:parents|prev(?:Until|All))/,R={children:!0,contents:!0,next:!0,prev:!0};function P(e,t){for(;(e=e[t])&&1!==e.nodeType;);return e}x.fn.extend({has:function(e){var t=x(e,this),n=t.length;return this.filter(function(){for(var e=0;e-1:1===n.nodeType&&x.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(o.length>1?x.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?l.call(x(e),this[0]):l.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(x.uniqueSort(x.merge(this.get(),x(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),x.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return $(e,"parentNode")},parentsUntil:function(e,t,n){return $(e,"parentNode",n)},next:function(e){return P(e,"nextSibling")},prev:function(e){return P(e,"previousSibling")},nextAll:function(e){return $(e,"nextSibling")},prevAll:function(e){return $(e,"previousSibling")},nextUntil:function(e,t,n){return $(e,"nextSibling",n)},prevUntil:function(e,t,n){return $(e,"previousSibling",n)},siblings:function(e){return T((e.parentNode||{}).firstChild,e)},children:function(e){return T(e.firstChild)},contents:function(e){return A(e,"iframe")?e.contentDocument:(A(e,"template")&&(e=e.content||e),x.merge([],e.childNodes))}},function(e,t){x.fn[e]=function(n,r){var i=x.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(i=x.filter(r,i)),this.length>1&&(R[e]||x.uniqueSort(i),N.test(e)&&i.reverse()),this.pushStack(i)}});var M=/[^\x20\t\r\n\f]+/g;function O(e){return e}function I(e){throw e}function q(e,t,n,r){var i;try{e&&m(i=e.promise)?i.call(e).done(t).fail(n):e&&m(i=e.then)?i.call(e,t,n):t.apply(void 0,[e].slice(r))}catch(e){n.apply(void 0,[e])}}x.Callbacks=function(e){var t,n;e="string"==typeof e?(t=e,n={},x.each(t.match(M)||[],function(e,t){n[t]=!0}),n):x.extend({},e);var r,i,o,a,s=[],l=[],c=-1,u=function(){for(a=a||e.once,o=r=!0;l.length;c=-1)for(i=l.shift();++c-1;)s.splice(n,1),n<=c&&c--}),this},has:function(e){return e?x.inArray(e,s)>-1:s.length>0},empty:function(){return s&&(s=[]),this},disable:function(){return a=l=[],s=i="",this},disabled:function(){return!s},lock:function(){return a=l=[],i||r||(s=i=""),this},locked:function(){return!!a},fireWith:function(e,t){return a||(t=[e,(t=t||[]).slice?t.slice():t],l.push(t),r||u()),this},fire:function(){return d.fireWith(this,arguments),this},fired:function(){return!!o}};return d},x.extend({Deferred:function(t){var n=[["notify","progress",x.Callbacks("memory"),x.Callbacks("memory"),2],["resolve","done",x.Callbacks("once memory"),x.Callbacks("once memory"),0,"resolved"],["reject","fail",x.Callbacks("once memory"),x.Callbacks("once memory"),1,"rejected"]],r="pending",i={state:function(){return r},always:function(){return o.done(arguments).fail(arguments),this},catch:function(e){return i.then(null,e)},pipe:function(){var e=arguments;return x.Deferred(function(t){x.each(n,function(n,r){var i=m(e[r[4]])&&e[r[4]];o[r[1]](function(){var e=i&&i.apply(this,arguments);e&&m(e.promise)?e.promise().progress(t.notify).done(t.resolve).fail(t.reject):t[r[0]+"With"](this,i?[e]:arguments)})}),e=null}).promise()},then:function(t,r,i){var o=0;function a(t,n,r,i){return function(){var s=this,l=arguments,c=function(){var e,c;if(!(t=o&&(r!==I&&(s=void 0,l=[e]),n.rejectWith(s,l))}};t?u():(x.Deferred.getStackHook&&(u.stackTrace=x.Deferred.getStackHook()),e.setTimeout(u))}}return x.Deferred(function(e){n[0][3].add(a(0,e,m(i)?i:O,e.notifyWith)),n[1][3].add(a(0,e,m(t)?t:O)),n[2][3].add(a(0,e,m(r)?r:I))}).promise()},promise:function(e){return null!=e?x.extend(e,i):i}},o={};return x.each(n,function(e,t){var a=t[2],s=t[5];i[t[1]]=a.add,s&&a.add(function(){r=s},n[3-e][2].disable,n[3-e][3].disable,n[0][2].lock,n[0][3].lock),a.add(t[3].fire),o[t[0]]=function(){return o[t[0]+"With"](this===o?void 0:this,arguments),this},o[t[0]+"With"]=a.fireWith}),i.promise(o),t&&t.call(o,o),o},when:function(e){var t=arguments.length,n=t,r=Array(n),i=o.call(arguments),a=x.Deferred(),s=function(e){return function(n){r[e]=this,i[e]=arguments.length>1?o.call(arguments):n,--t||a.resolveWith(r,i)}};if(t<=1&&(q(e,a.done(s(n)).resolve,a.reject,!t),"pending"===a.state()||m(i[n]&&i[n].then)))return a.then();for(;n--;)q(i[n],s(n),a.reject);return a.promise()}});var U=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;x.Deferred.exceptionHook=function(t,n){e.console&&e.console.warn&&t&&U.test(t.name)&&e.console.warn("jQuery.Deferred exception: "+t.message,t.stack,n)},x.readyException=function(t){e.setTimeout(function(){throw t})};var W=x.Deferred();function H(){r.removeEventListener("DOMContentLoaded",H),e.removeEventListener("load",H),x.ready()}x.fn.ready=function(e){return W.then(e).catch(function(e){x.readyException(e)}),this},x.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--x.readyWait:x.isReady)||(x.isReady=!0,!0!==e&&--x.readyWait>0||W.resolveWith(r,[x]))}}),x.ready.then=W.then,"complete"===r.readyState||"loading"!==r.readyState&&!r.documentElement.doScroll?e.setTimeout(x.ready):(r.addEventListener("DOMContentLoaded",H),e.addEventListener("load",H));var B=function(e,t,n,r,i,o,a){var s=0,l=e.length,c=null==n;if("object"===v(n)){i=!0;for(s in n)B(e,t,s,n[s],!0,o,a)}else if(void 0!==r&&(i=!0,m(r)||(a=!0),c&&(a?(t.call(e,r),t=null):(c=t,t=function(e,t,n){return c.call(x(e),n)})),t))for(;s1,null,!0)},removeData:function(e){return this.each(function(){Q.remove(this,e)})}}),x.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Y.get(e,t),n&&(!r||Array.isArray(n)?r=Y.access(e,t,x.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=x.queue(e,t),r=n.length,i=n.shift(),o=x._queueHooks(e,t);"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,function(){x.dequeue(e,t)},o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Y.get(e,n)||Y.access(e,n,{empty:x.Callbacks("once memory").add(function(){Y.remove(e,[t+"queue",n])})})}}),x.fn.extend({queue:function(e,t){var n=2;return"string"!=typeof e&&(t=e,e="fx",n--),arguments.length\x20\t\r\n\f]+)/i,ue=/^$|^module$|\/(?:java|ecma)script/i,de={option:[1,""],thead:[1,"","
    "],col:[2,"","
    "],tr:[2,"","
    "],td:[3,"","
    "],_default:[0,"",""]};function pe(e,t){var n;return n=void 0!==e.getElementsByTagName?e.getElementsByTagName(t||"*"):void 0!==e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&A(e,t)?x.merge([e],n):n}function fe(e,t){for(var n=0,r=e.length;n-1)i&&i.push(o);else if(c=x.contains(o.ownerDocument,o),a=pe(d.appendChild(o),"script"),c&&fe(a),n)for(u=0;o=a[u++];)ue.test(o.type||"")&&n.push(o);return d}he=r.createDocumentFragment().appendChild(r.createElement("div")),(me=r.createElement("input")).setAttribute("type","radio"),me.setAttribute("checked","checked"),me.setAttribute("name","t"),he.appendChild(me),h.checkClone=he.cloneNode(!0).cloneNode(!0).lastChild.checked,he.innerHTML="",h.noCloneChecked=!!he.cloneNode(!0).lastChild.defaultValue;var ye=r.documentElement,ve=/^key/,we=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,xe=/^([^.]*)(?:\.(.+)|)/;function ke(){return!0}function Ce(){return!1}function Ee(){try{return r.activeElement}catch(e){}}function $e(e,t,n,r,i,o){var a,s;if("object"==typeof t){"string"!=typeof n&&(r=r||n,n=void 0);for(s in t)$e(e,s,n,r,t[s],o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=Ce;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return x().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=x.guid++)),e.each(function(){x.event.add(this,t,i,r,n)})}x.event={global:{},add:function(e,t,n,r,i){var o,a,s,l,c,u,d,p,f,h,m,g=Y.get(e);if(g)for(n.handler&&(n=(o=n).handler,i=o.selector),i&&x.find.matchesSelector(ye,i),n.guid||(n.guid=x.guid++),(l=g.events)||(l=g.events={}),(a=g.handle)||(a=g.handle=function(t){return void 0!==x&&x.event.triggered!==t.type?x.event.dispatch.apply(e,arguments):void 0}),c=(t=(t||"").match(M)||[""]).length;c--;)f=m=(s=xe.exec(t[c])||[])[1],h=(s[2]||"").split(".").sort(),f&&(d=x.event.special[f]||{},f=(i?d.delegateType:d.bindType)||f,d=x.event.special[f]||{},u=x.extend({type:f,origType:m,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&x.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=l[f])||((p=l[f]=[]).delegateCount=0,d.setup&&!1!==d.setup.call(e,r,h,a)||e.addEventListener&&e.addEventListener(f,a)),d.add&&(d.add.call(e,u),u.handler.guid||(u.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,u):p.push(u),x.event.global[f]=!0)},remove:function(e,t,n,r,i){var o,a,s,l,c,u,d,p,f,h,m,g=Y.hasData(e)&&Y.get(e);if(g&&(l=g.events)){for(c=(t=(t||"").match(M)||[""]).length;c--;)if(f=m=(s=xe.exec(t[c])||[])[1],h=(s[2]||"").split(".").sort(),f){for(d=x.event.special[f]||{},p=l[f=(r?d.delegateType:d.bindType)||f]||[],s=s[2]&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;o--;)u=p[o],!i&&m!==u.origType||n&&n.guid!==u.guid||s&&!s.test(u.namespace)||r&&r!==u.selector&&("**"!==r||!u.selector)||(p.splice(o,1),u.selector&&p.delegateCount--,d.remove&&d.remove.call(e,u));a&&!p.length&&(d.teardown&&!1!==d.teardown.call(e,h,g.handle)||x.removeEvent(e,f,g.handle),delete l[f])}else for(f in l)x.event.remove(e,f+t[c],n,r,!0);x.isEmptyObject(l)&&Y.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=x.event.fix(e),l=new Array(arguments.length),c=(Y.get(this,"events")||{})[s.type]||[],u=x.event.special[s.type]||{};for(l[0]=s,t=1;t=1))for(;c!==this;c=c.parentNode||this)if(1===c.nodeType&&("click"!==e.type||!0!==c.disabled)){for(o=[],a={},n=0;n-1:x.find(i,this,null,[c]).length),a[i]&&o.push(r);o.length&&s.push({elem:c,handlers:o})}return c=this,l\x20\t\r\n\f]*)[^>]*)\/>/gi,Se=/\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&x(e).children("tbody")[0]||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function _e(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Ne(e,t){var n,r,i,o,a,s,l,c;if(1===t.nodeType){if(Y.hasData(e)&&(o=Y.access(e),a=Y.set(t,o),c=o.events)){delete a.handle,a.events={};for(i in c)for(n=0,r=c[i].length;n1&&"string"==typeof g&&!h.checkClone&&Ae.test(g))return e.each(function(i){var o=e.eq(i);b&&(t[0]=g.call(this,i,o.html())),Re(o,t,n,r)});if(p&&(o=(i=be(t,e[0].ownerDocument,!1,e,r)).firstChild,1===i.childNodes.length&&(i=o),o||r)){for(l=(s=x.map(pe(i,"script"),De)).length;d")},clone:function(e,t,n){var r,i,o,a,s,l,c,u=e.cloneNode(!0),d=x.contains(e.ownerDocument,e);if(!(h.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||x.isXMLDoc(e)))for(a=pe(u),r=0,i=(o=pe(e)).length;r0&&fe(a,!d&&pe(e,"script")),u},cleanData:function(e){for(var t,n,r,i=x.event.special,o=0;void 0!==(n=e[o]);o++)if(X(n)){if(t=n[Y.expando]){if(t.events)for(r in t.events)i[r]?x.event.remove(n,r):x.removeEvent(n,r,t.handle);n[Y.expando]=void 0}n[Q.expando]&&(n[Q.expando]=void 0)}}}),x.fn.extend({detach:function(e){return Pe(this,e,!0)},remove:function(e){return Pe(this,e)},text:function(e){return B(this,function(e){return void 0===e?x.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return Re(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||je(this,e).appendChild(e)})},prepend:function(){return Re(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=je(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(x.cleanData(pe(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return x.clone(this,e,t)})},html:function(e){return B(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!Se.test(e)&&!de[(ce.exec(e)||["",""])[1].toLowerCase()]){e=x.htmlPrefilter(e);try{for(;n=0&&(l+=Math.max(0,Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-o-l-s-.5))),l}function Je(e,t,n){var r=Oe(e),i=qe(e,t,r),o="border-box"===x.css(e,"boxSizing",!1,r),a=o;if(Me.test(i)){if(!n)return i;i="auto"}return a=a&&(h.boxSizingReliable()||i===e.style[t]),("auto"===i||!parseFloat(i)&&"inline"===x.css(e,"display",!1,r))&&(i=e["offset"+t[0].toUpperCase()+t.slice(1)],a=!0),(i=parseFloat(i)||0)+Qe(e,t,n||(o?"border":"content"),a,r,i)+"px"}x.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=qe(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=V(t),l=Fe.test(t),c=e.style;if(l||(t=Ze(s)),a=x.cssHooks[t]||x.cssHooks[s],void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:c[t];"string"===(o=typeof n)&&(i=ne.exec(n))&&i[1]&&(n=function(e,t,n,r){var i,o,a=20,s=r?function(){return r.cur()}:function(){return x.css(e,t,"")},l=s(),c=n&&n[3]||(x.cssNumber[t]?"":"px"),u=(x.cssNumber[t]||"px"!==c&&+l)&&ne.exec(x.css(e,t));if(u&&u[3]!==c){for(l/=2,c=c||u[3],u=+l||1;a--;)x.style(e,t,u+c),(1-o)*(1-(o=s()/l||.5))<=0&&(a=0),u/=o;u*=2,x.style(e,t,u+c),n=n||[]}return n&&(u=+u||+l||0,i=n[1]?u+(n[1]+1)*n[2]:+n[2],r&&(r.unit=c,r.start=u,r.end=i)),i}(e,t,i),o="number"),null!=n&&n==n&&("number"===o&&(n+=i&&i[3]||(x.cssNumber[s]?"":"px")),h.clearCloneStyle||""!==n||0!==t.indexOf("background")||(c[t]="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(l?c.setProperty(t,n):c[t]=n))}},css:function(e,t,n,r){var i,o,a,s=V(t);return Fe.test(t)||(t=Ze(s)),(a=x.cssHooks[t]||x.cssHooks[s])&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=qe(e,t,r)),"normal"===i&&t in Ge&&(i=Ge[t]),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),x.each(["height","width"],function(e,t){x.cssHooks[t]={get:function(e,n,r){if(n)return!Be.test(x.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?Je(e,t,r):oe(e,ze,function(){return Je(e,t,r)})},set:function(e,n,r){var i,o=Oe(e),a="border-box"===x.css(e,"boxSizing",!1,o),s=r&&Qe(e,t,r,a,o);return a&&h.scrollboxSize()===o.position&&(s-=Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-parseFloat(o[t])-Qe(e,t,"border",!1,o)-.5)),s&&(i=ne.exec(n))&&"px"!==(i[3]||"px")&&(e.style[t]=n,n=x.css(e,t)),Ye(0,n,s)}}}),x.cssHooks.marginLeft=Ue(h.reliableMarginLeft,function(e,t){if(t)return(parseFloat(qe(e,"marginLeft"))||e.getBoundingClientRect().left-oe(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),x.each({margin:"",padding:"",border:"Width"},function(e,t){x.cssHooks[e+t]={expand:function(n){for(var r=0,i={},o="string"==typeof n?n.split(" "):[n];r<4;r++)i[e+re[r]+t]=o[r]||o[r-2]||o[0];return i}},"margin"!==e&&(x.cssHooks[e+t].set=Ye)}),x.fn.extend({css:function(e,t){return B(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=Oe(e),i=t.length;a1)}}),x.fn.delay=function(t,n){return t=x.fx&&x.fx.speeds[t]||t,n=n||"fx",this.queue(n,function(n,r){var i=e.setTimeout(n,t);r.stop=function(){e.clearTimeout(i)}})},We=r.createElement("input"),He=r.createElement("select").appendChild(r.createElement("option")),We.type="checkbox",h.checkOn=""!==We.value,h.optSelected=He.selected,(We=r.createElement("input")).value="t",We.type="radio",h.radioValue="t"===We.value;var Ke,et=x.expr.attrHandle;x.fn.extend({attr:function(e,t){return B(this,x.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){x.removeAttr(this,e)})}}),x.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return void 0===e.getAttribute?x.prop(e,t,n):(1===o&&x.isXMLDoc(e)||(i=x.attrHooks[t.toLowerCase()]||(x.expr.match.bool.test(t)?Ke:void 0)),void 0!==n?null===n?void x.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=x.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!h.radioValue&&"radio"===t&&A(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(M);if(i&&1===e.nodeType)for(;n=i[r++];)e.removeAttribute(n)}}),Ke={set:function(e,t,n){return!1===t?x.removeAttr(e,n):e.setAttribute(n,n),n}},x.each(x.expr.match.bool.source.match(/\w+/g),function(e,t){var n=et[t]||x.find.attr;et[t]=function(e,t,r){var i,o,a=t.toLowerCase();return r||(o=et[a],et[a]=i,i=null!=n(e,t,r)?a:null,et[a]=o),i}});var tt=/^(?:input|select|textarea|button)$/i,nt=/^(?:a|area)$/i;function rt(e){return(e.match(M)||[]).join(" ")}function it(e){return e.getAttribute&&e.getAttribute("class")||""}function ot(e){return Array.isArray(e)?e:"string"==typeof e&&e.match(M)||[]}x.fn.extend({prop:function(e,t){return B(this,x.prop,e,t,arguments.length>1)},removeProp:function(e){return this.each(function(){delete this[x.propFix[e]||e]})}}),x.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&x.isXMLDoc(e)||(t=x.propFix[t]||t,i=x.propHooks[t]),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=x.find.attr(e,"tabindex");return t?parseInt(t,10):tt.test(e.nodeName)||nt.test(e.nodeName)&&e.href?0:-1}}},propFix:{for:"htmlFor",class:"className"}}),h.optSelected||(x.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),x.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){x.propFix[this.toLowerCase()]=this}),x.fn.extend({addClass:function(e){var t,n,r,i,o,a,s,l=0;if(m(e))return this.each(function(t){x(this).addClass(e.call(this,t,it(this)))});if((t=ot(e)).length)for(;n=this[l++];)if(i=it(n),r=1===n.nodeType&&" "+rt(i)+" "){for(a=0;o=t[a++];)r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=rt(r))&&n.setAttribute("class",s)}return this},removeClass:function(e){var t,n,r,i,o,a,s,l=0;if(m(e))return this.each(function(t){x(this).removeClass(e.call(this,t,it(this)))});if(!arguments.length)return this.attr("class","");if((t=ot(e)).length)for(;n=this[l++];)if(i=it(n),r=1===n.nodeType&&" "+rt(i)+" "){for(a=0;o=t[a++];)for(;r.indexOf(" "+o+" ")>-1;)r=r.replace(" "+o+" "," ");i!==(s=rt(r))&&n.setAttribute("class",s)}return this},toggleClass:function(e,t){var n=typeof e,r="string"===n||Array.isArray(e);return"boolean"==typeof t&&r?t?this.addClass(e):this.removeClass(e):m(e)?this.each(function(n){x(this).toggleClass(e.call(this,n,it(this),t),t)}):this.each(function(){var t,i,o,a;if(r)for(i=0,o=x(this),a=ot(e);t=a[i++];)o.hasClass(t)?o.removeClass(t):o.addClass(t);else void 0!==e&&"boolean"!==n||((t=it(this))&&Y.set(this,"__className__",t),this.setAttribute&&this.setAttribute("class",t||!1===e?"":Y.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;for(t=" "+e+" ";n=this[r++];)if(1===n.nodeType&&(" "+rt(it(n))+" ").indexOf(t)>-1)return!0;return!1}});var at=/\r/g;x.fn.extend({val:function(e){var t,n,r,i=this[0];return arguments.length?(r=m(e),this.each(function(n){var i;1===this.nodeType&&(null==(i=r?e.call(this,n,x(this).val()):e)?i="":"number"==typeof i?i+="":Array.isArray(i)&&(i=x.map(i,function(e){return null==e?"":e+""})),(t=x.valHooks[this.type]||x.valHooks[this.nodeName.toLowerCase()])&&"set"in t&&void 0!==t.set(this,i,"value")||(this.value=i))})):i?(t=x.valHooks[i.type]||x.valHooks[i.nodeName.toLowerCase()])&&"get"in t&&void 0!==(n=t.get(i,"value"))?n:"string"==typeof(n=i.value)?n.replace(at,""):null==n?"":n:void 0}}),x.extend({valHooks:{option:{get:function(e){var t=x.find.attr(e,"value");return null!=t?t:rt(x.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:[],l=a?o+1:i.length;for(r=o<0?l:a?o:0;r-1)&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),x.each(["radio","checkbox"],function(){x.valHooks[this]={set:function(e,t){if(Array.isArray(t))return e.checked=x.inArray(x(e).val(),t)>-1}},h.checkOn||(x.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})}),h.focusin="onfocusin"in e;var st=/^(?:focusinfocus|focusoutblur)$/,lt=function(e){e.stopPropagation()};x.extend(x.event,{trigger:function(t,n,i,o){var a,s,l,c,u,p,f,h,b=[i||r],y=d.call(t,"type")?t.type:t,v=d.call(t,"namespace")?t.namespace.split("."):[];if(s=h=l=i=i||r,3!==i.nodeType&&8!==i.nodeType&&!st.test(y+x.event.triggered)&&(y.indexOf(".")>-1&&(y=(v=y.split(".")).shift(),v.sort()),u=y.indexOf(":")<0&&"on"+y,(t=t[x.expando]?t:new x.Event(y,"object"==typeof t&&t)).isTrigger=o?2:3,t.namespace=v.join("."),t.rnamespace=t.namespace?new RegExp("(^|\\.)"+v.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,t.result=void 0,t.target||(t.target=i),n=null==n?[t]:x.makeArray(n,[t]),f=x.event.special[y]||{},o||!f.trigger||!1!==f.trigger.apply(i,n))){if(!o&&!f.noBubble&&!g(i)){for(c=f.delegateType||y,st.test(c+y)||(s=s.parentNode);s;s=s.parentNode)b.push(s),l=s;l===(i.ownerDocument||r)&&b.push(l.defaultView||l.parentWindow||e)}for(a=0;(s=b[a++])&&!t.isPropagationStopped();)h=s,t.type=a>1?c:f.bindType||y,(p=(Y.get(s,"events")||{})[t.type]&&Y.get(s,"handle"))&&p.apply(s,n),(p=u&&s[u])&&p.apply&&X(s)&&(t.result=p.apply(s,n),!1===t.result&&t.preventDefault());return t.type=y,o||t.isDefaultPrevented()||f._default&&!1!==f._default.apply(b.pop(),n)||!X(i)||u&&m(i[y])&&!g(i)&&((l=i[u])&&(i[u]=null),x.event.triggered=y,t.isPropagationStopped()&&h.addEventListener(y,lt),i[y](),t.isPropagationStopped()&&h.removeEventListener(y,lt),x.event.triggered=void 0,l&&(i[u]=l)),t.result}},simulate:function(e,t,n){var r=x.extend(new x.Event,n,{type:e,isSimulated:!0});x.event.trigger(r,null,t)}}),x.fn.extend({trigger:function(e,t){return this.each(function(){x.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return x.event.trigger(e,t,n,!0)}}),h.focusin||x.each({focus:"focusin",blur:"focusout"},function(e,t){var n=function(e){x.event.simulate(t,e.target,x.event.fix(e))};x.event.special[t]={setup:function(){var r=this.ownerDocument||this,i=Y.access(r,t);i||r.addEventListener(e,n,!0),Y.access(r,t,(i||0)+1)},teardown:function(){var r=this.ownerDocument||this,i=Y.access(r,t)-1;i?Y.access(r,t,i):(r.removeEventListener(e,n,!0),Y.remove(r,t))}}});var ct,ut=/\[\]$/,dt=/\r?\n/g,pt=/^(?:submit|button|image|reset|file)$/i,ft=/^(?:input|select|textarea|keygen)/i;function ht(e,t,n,r){var i;if(Array.isArray(t))x.each(t,function(t,i){n||ut.test(e)?r(e,i):ht(e+"["+("object"==typeof i&&null!=i?t:"")+"]",i,n,r)});else if(n||"object"!==v(t))r(e,t);else for(i in t)ht(e+"["+i+"]",t[i],n,r)}x.param=function(e,t){var n,r=[],i=function(e,t){var n=m(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(Array.isArray(e)||e.jquery&&!x.isPlainObject(e))x.each(e,function(){i(this.name,this.value)});else for(n in e)ht(n,e[n],t,i);return r.join("&")},x.fn.extend({serialize:function(){return x.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=x.prop(this,"elements");return e?x.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!x(this).is(":disabled")&&ft.test(this.nodeName)&&!pt.test(e)&&(this.checked||!le.test(e))}).map(function(e,t){var n=x(this).val();return null==n?null:Array.isArray(n)?x.map(n,function(e){return{name:t.name,value:e.replace(dt,"\r\n")}}):{name:t.name,value:n.replace(dt,"\r\n")}}).get()}}),x.fn.extend({wrapAll:function(e){var t;return this[0]&&(m(e)&&(e=e.call(this[0])),t=x(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){for(var e=this;e.firstElementChild;)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(e){return m(e)?this.each(function(t){x(this).wrapInner(e.call(this,t))}):this.each(function(){var t=x(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=m(e);return this.each(function(n){x(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(e){return this.parent(e).not("body").each(function(){x(this).replaceWith(this.childNodes)}),this}}),x.expr.pseudos.hidden=function(e){return!x.expr.pseudos.visible(e)},x.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},h.createHTMLDocument=((ct=r.implementation.createHTMLDocument("").body).innerHTML="
    ",2===ct.childNodes.length),x.parseHTML=function(e,t,n){return"string"!=typeof e?[]:("boolean"==typeof t&&(n=t,t=!1),t||(h.createHTMLDocument?((i=(t=r.implementation.createHTMLDocument("")).createElement("base")).href=r.location.href,t.head.appendChild(i)):t=r),o=L.exec(e),a=!n&&[],o?[t.createElement(o[1])]:(o=be([e],t,a),a&&a.length&&x(a).remove(),x.merge([],o.childNodes)));var i,o,a},x.offset={setOffset:function(e,t,n){var r,i,o,a,s,l,c=x.css(e,"position"),u=x(e),d={};"static"===c&&(e.style.position="relative"),s=u.offset(),o=x.css(e,"top"),l=x.css(e,"left"),("absolute"===c||"fixed"===c)&&(o+l).indexOf("auto")>-1?(a=(r=u.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(l)||0),m(t)&&(t=t.call(e,n,x.extend({},s))),null!=t.top&&(d.top=t.top-s.top+a),null!=t.left&&(d.left=t.left-s.left+i),"using"in t?t.using.call(e,d):u.css(d)}},x.fn.extend({offset:function(e){if(arguments.length)return void 0===e?this:this.each(function(t){x.offset.setOffset(this,e,t)});var t,n,r=this[0];return r?r.getClientRects().length?(t=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:t.top+n.pageYOffset,left:t.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this[0]){var e,t,n,r=this[0],i={top:0,left:0};if("fixed"===x.css(r,"position"))t=r.getBoundingClientRect();else{for(t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;e&&(e===n.body||e===n.documentElement)&&"static"===x.css(e,"position");)e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=x(e).offset()).top+=x.css(e,"borderTopWidth",!0),i.left+=x.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-x.css(r,"marginTop",!0),left:t.left-i.left-x.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){for(var e=this.offsetParent;e&&"static"===x.css(e,"position");)e=e.offsetParent;return e||ye})}}),x.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,t){var n="pageYOffset"===t;x.fn[e]=function(r){return B(this,function(e,r,i){var o;if(g(e)?o=e:9===e.nodeType&&(o=e.defaultView),void 0===i)return o?o[t]:e[r];o?o.scrollTo(n?o.pageXOffset:i,n?i:o.pageYOffset):e[r]=i},e,r,arguments.length)}}),x.each(["top","left"],function(e,t){x.cssHooks[t]=Ue(h.pixelPosition,function(e,n){if(n)return n=qe(e,t),Me.test(n)?x(e).position()[t]+"px":n})}),x.each({Height:"height",Width:"width"},function(e,t){x.each({padding:"inner"+e,content:t,"":"outer"+e},function(n,r){x.fn[r]=function(i,o){var a=arguments.length&&(n||"boolean"!=typeof i),s=n||(!0===i||!0===o?"margin":"border");return B(this,function(t,n,i){var o;return g(t)?0===r.indexOf("outer")?t["inner"+e]:t.document.documentElement["client"+e]:9===t.nodeType?(o=t.documentElement,Math.max(t.body["scroll"+e],o["scroll"+e],t.body["offset"+e],o["offset"+e],o["client"+e])):void 0===i?x.css(t,n,s):x.style(t,n,i,s)},t,a?i:void 0,a)}})}),x.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,t){x.fn[t]=function(e,n){return arguments.length>0?this.on(t,null,e,n):this.trigger(t)}}),x.fn.extend({hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),x.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)}}),x.proxy=function(e,t){var n,r,i;if("string"==typeof t&&(n=e[t],t=e,e=n),m(e))return r=o.call(arguments,2),(i=function(){return e.apply(t||this,r.concat(o.call(arguments)))}).guid=e.guid=e.guid||x.guid++,i},x.holdReady=function(e){e?x.readyWait++:x.ready(!0)},x.isArray=Array.isArray,x.parseJSON=JSON.parse,x.nodeName=A,x.isFunction=m,x.isWindow=g,x.camelCase=V,x.type=v,x.now=Date.now,x.isNumeric=function(e){var t=x.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},"function"==typeof define&&define.amd&&define("jquery",[],function(){return x});var mt=e.jQuery,gt=e.$;return x.noConflict=function(t){return e.$===x&&(e.$=gt),t&&e.jQuery===x&&(e.jQuery=mt),x},t||(e.jQuery=e.$=x),x},"object"==typeof module&&"object"==typeof module.exports?module.exports=t0.document?u0(t0,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return u0(e)}:u0(t0),define("deps/jquery",function(){}),define("core/jquery-enhanced",["exports","core/pubsubhub","core/utils","deps/jquery"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/jquery-enhanced";window.$=$,window.$.fn.renameElement=function(e){var n=[];return this.each(function(){for(var r=$(this.ownerDocument.createElement(e)),i=0,o=this.attributes.length;i""!==e).reduce((e,t)=>e.add(t),new Set)]},window.$.fn.linkTargets=function(){var e=this[0].closest("[data-link-for]"),t=e?e.dataset.linkFor.toLowerCase():"",n=this.getDfnTitles(),r=[];for(const e of n){r.push({for:t,title:e});const n=e.split(".");2===n.length&&r.push({for:n[0],title:n[1]}),r.push({for:"",title:e})}return r},window.$.fn.makeID=function(e="",t="",n=!1){const r=this[0];if(r.id)return r.id;t||(t=(r.title?r.title:r.textContent).trim());var i=n?t:t.toLowerCase();if((i=i.replace(/[\W]+/gim,"-").replace(/^-+/,"").replace(/-+$/,""))?!/\.$/.test(i)&&/^[a-z]/i.test(i)||(i="x"+i):i="generatedID",e&&(i=`${e}-${i}`),r.ownerDocument.getElementById(i)){let e=0,t=i+"-"+e;for(;r.ownerDocument.getElementById(t);)t=i+"-"+e++;i=t}return r.id=i,i},window.$.fn.allTextNodes=function(e){for(var t=[],n={},r=0,i=e.length;r(e.setAttribute("aria-"+t,n),e),e)}l.id="respec-ui-styles",l.textContent=a.default,l.classList.add("removeOnSave"),document.head.appendChild(l);const u=$(""),d=$("");var p,f;const h=[],m=[],g={};(0,n.sub)("start-all",()=>{document.body.insertAdjacentElement("afterbegin",u[0])},{once:!0}),(0,n.sub)("end-all",()=>{document.body.insertAdjacentElement("afterbegin",u[0])},{once:!0});const b=$("");b.click(function(e){e.stopPropagation(),d[0].hidden?(d[0].classList.remove("respec-hidden"),d[0].classList.add("respec-visible")):(d[0].classList.add("respec-hidden"),d[0].classList.remove("respec-visible")),this.setAttribute("aria-expanded",String(d[0].hidden)),d[0].hidden=!d[0].hidden}).appendTo(u),document.documentElement.addEventListener("click",function(){d[0].hidden||(d[0].classList.remove("respec-visible"),d[0].classList.add("respec-hidden"),d[0].hidden=!0)}),d.appendTo(u);const y=new Map([["controls","respec-menu"],["expanded","false"],["haspopup","true"],["label","ReSpec Menu"]]);function v(e,t,n,r){if(t.push(e),g.hasOwnProperty(n))return void g[n].text(t.length);g[n]=$("").appendTo(u).click(function(){this.setAttribute("aria-expanded","true");for(var e=$("
      "),o=0,a=t.length;o
      ").appendTo(e).find("span").text("["+s.name+"] "+s.message).end().find("a").css({fontSize:"1.1em",color:"#999",cursor:"pointer"}).click(function(){var e=$(this),t=e.text(),n=e.parent().find("pre");"⊞"===t?(e.text("⊟"),n.show()):(e.text("⊞"),n.hide())}).end().find("pre").text(s.stack).css({marginLeft:"0",maxWidth:"100%",overflowY:"hidden",overflowX:"scroll"}).hide().end();else{const t=document.createElement("tmp");t.innerHTML=(0,i.markdownToHtml)(s);const n=document.createElement("li");if(t.firstElementChild===t.lastElementChild)for(;t.firstElementChild&&t.firstElementChild.hasChildNodes();)n.appendChild(t.firstElementChild.firstChild);else n.innerHTML=t.innerHTML;e[0].appendChild(n)}}w.freshModal(r,e,this)});const o=new Map([["expanded","false"],["haspopup","true"],["controls","respec-pill-"+n+"-modal"],["label","Document "+r.toLowerCase()]]);c(g[n][0],o)}c(b[0],y);const w=e.ui={show:function(){try{u[0].hidden=!1}catch(e){console.error(e)}},hide:function(){u[0].hidden=!0},enable:function(){b[0].removeAttribute("disabled")},addCommand:function(e,t,n,r){r=r||"";var i=function(){require([t],function(e){e.show()})},a="respec-button-"+e.toLowerCase().replace(/\s+/,"-"),s=$('
    1. ").click(i).appendTo(d);return n&&o.default.add(n,i),s[0].querySelector("button")},error:function(e){v(e,h,"error","Errors")},warning:function(e){v(e,m,"warning","Warnings")},closeModal:function(e){f&&(f[0].classList.remove("respec-show-overlay"),f[0].classList.add("respec-hide-overlay"),f[0].addEventListener("transitionend",()=>{f.remove(),f=null})),e&&e.setAttribute("aria-expanded","false"),p&&(p.remove(),p=null)},freshModal:function(e,t,n){p&&p.remove(),f&&f.remove(),f=$("
      ");const r=n.id+"-modal",i=r+"-heading";(p=$("")).find("h3").text(e),p.find("h3")[0].id=i;const o=new Map([["labelledby",i]]);c(p[0],o),p.find(".inside").append(t),$(document.body).append(f).append(p),f.click(()=>{this.closeModal(n)}),f[0].classList.toggle("respec-show-overlay"),p[0].hidden=!1}};o.default.add("Esc",function(){w.closeModal()}),o.default.add("Ctrl+Alt+Shift+E",function(){g.error&&g.error.click()}),o.default.add("Ctrl+Alt+Shift+W",function(){g.warning&&g.warning.click()}),window.respecUI=w,(0,n.sub)("error",function(e){w.error(e)}),(0,n.sub)("warn",function(e){w.warning(e)})}),define("core/l10n",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e){e.l10n=i[o]||i.en};var t=Object.assign||function(e){for(var t=1;te.add(t),this.rules)}async lint(e,i=window.document){const a=[...r.get(this).rules].map(r=>(async function(e){(await e).map(async e=>{const t=await e,r=n({},o,t),{description:i,help:a,howToFix:s,name:l,occurrences:c,offendingElements:u}=r,d=`${i} ${s} ${a} ("${l}" x ${c})`;return u.forEach(e=>{e.classList.add("respec-offending-element")}),console.warn(`Linter (${l}):`,i,...u),d}).forEach(async e=>{(0,t.pub)("warn",await e)})})(r.lint(e,i)));await a}};e.default=i;const o={name:"unknown",description:"",occurrences:0,howToFix:"",offendingElements:[],help:""}}),define("core/LinterRule",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0});const t=new WeakMap;e.default=class{constructor(e,n){t.set(this,{name:e,lintingFunction:n})}get name(){return t.get(this).name}lint(e={lint:{[this.name]:!1}},n=document){return r=e,i=this.name,!1!==r.hasOwnProperty("lint")&&!1!==r.lint&&r.lint[i]?[].concat(t.get(this).lintingFunction(e,n)):[];var r,i}}}),define("core/linter-rules/no-headingless-sections",["exports","core/LinterRule","../l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=t)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t`.",help:"See developer console."},nl:{description:"Alle secties moeten beginnen met een `h2-6` element.",howToFix:"Voeg een `h2-6` toe aan de conflicterende sectie of gebruik een `
      `.",help:"Zie de developer console."}},l=n.lang in s?n.lang:"en",c=({firstElementChild:e})=>null===e||!1===/^h[1-6]$/.test(e.localName);e.rule=new i.default(a,function(e,t){const n=Array.from(t.querySelectorAll("section")).filter(c);return n.length?o({name:a,offendingElements:n,occurrences:n.length},s[l]):[]})}),define("core/linter-rules/no-http-props",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;te.endsWith("URI")||"prevED"===e).filter(n=>new URL(e[n],t.location.href).href.startsWith("http://")).reduce((e,t)=>e.concat(t),[]);if(!n.length)return[];const r=o({name:a,occurrences:n.length},s[l]);return r.howToFix+=n.map(e=>"`"+e+"`").join(", ")+".",r})}),define("w3c/l10n",["exports","core/l10n"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="w3c/l10n";const n={en:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."},ko:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."},zh:{status_at_publication:"本章节描述了本文档的发布状态。其它更新版本可能会覆盖本文档。W3C的文档列 表和最新版本可通过W3C技术报告索引访问。"},ja:{status_at_publication:"この節には、公開時点でのこの文書の位置づけが記されている。他の文書によって置き換えられる可能性がある。現時点でのW3Cの発行文書とこのテクニカルレポートの最新版は、下記から参照できる。 W3C technical reports index (https://www.w3.org/TR/)"},nl:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."}};Object.keys(n).reduce((e,t)=>(Object.assign(e[t],n[t]),e),t.l10n)}),define("w3c/linter-rules/privsec-section",["exports","core/LinterRule","../l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=t)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t{const t=/(privacy|security)/im.test(e),n=/(considerations)/im.test(e);return t&&n||t}))&&n.push(o({name:a,occurrences:1},s[l])),n})}),define("core/linter-rules/check-punctuation",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t`"${e}"`).join(", ")}.`}},c=t.lang in l?t.lang:"en";e.rule=new i.default(a,function(e,t){const n=new RegExp(`[${s.join("")}\\]]$|^ *$`,"m"),r=[...t.querySelectorAll("p:not(#back-to-top)")].filter(e=>!n.test(e.textContent.trim()));return r.length?o({name:a,offendingElements:r,occurrences:r.length},l[c]):[]})}),define("core/linter-rules/local-refs-exist",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t p:first-child {\n margin-top: 0;\n}\n\n.section dd > p:last-child {\n margin-bottom: 0;\n}\n\n.section dd {\n margin-bottom: 1em;\n}\n\n.section dl.attrs dd,\n.section dl.eldef dd {\n margin-bottom: 0;\n}\n\n#issue-summary > ul,\n.respec-dfn-list {\n column-count: 2;\n}\n\n#issue-summary li,\n.respec-dfn-list li {\n list-style: none;\n}\n\ndetails.respec-tests-details {\n margin-left: 1em;\n display: inline-block;\n vertical-align: top;\n}\n\ndetails.respec-tests-details > * {\n padding-right: 2em;\n}\n\ndetails.respec-tests-details[open] {\n z-index: 999999;\n position: absolute;\n border: thin solid #cad3e2;\n border-radius: .3em;\n background-color: white;\n padding-bottom: .5em;\n}\n\ndetails.respec-tests-details[open] > summary {\n border-bottom: thin solid #cad3e2;\n padding-left: 1em;\n margin-bottom: 1em;\n line-height: 2em;\n}\n\ndetails.respec-tests-details > ul {\n width: 100%;\n margin-top: -0.3em;\n}\n\ndetails.respec-tests-details > li {\n padding-left: 1em;\n}\n\n@media print {\n .removeOnSave {\n display: none;\n }\n}\n'}),define("core/style",["exports","deps/text!core/css/respec2.css"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){e.noReSpecCSS&&i.remove();n()};var n,r=(n=t)&&n.__esModule?n:{default:n};e.name="core/style";const i=document.createElement("style");i.id="respec-mainstyle",i.textContent=r.default,document.head.appendChild(i)}),define("w3c/style",["exports","core/utils","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,i){if(!e.specStatus){const t="`respecConfig.specStatus` missing. Defaulting to 'base'.";e.specStatus="base",(0,n.pub)("warn",t)}let o="W3C-";switch(e.specStatus.toUpperCase()){case"CG-DRAFT":case"CG-FINAL":case"BG-DRAFT":case"BG-FINAL":o=e.specStatus.toLowerCase();break;case"FPWD":case"LC":case"WD-NOTE":case"LC-NOTE":o+="WD";break;case"WG-NOTE":case"FPWD-NOTE":o+="WG-NOTE.css";break;case"UNOFFICIAL":o+="UD";break;case"FINDING":case"FINDING-DRAFT":case"BASE":o="base.css";break;default:o+=e.specStatus}const a=function(e){let t="";switch(e){case null:case!0:t="2016";break;default:e&&!isNaN(e)&&(t=e.toString().trim())}return t}(e.useExperimentalStyles||"2016");a&&!e.noToc&&(0,n.sub)("end-all",function(){!function(e,t){const n=e.createElement("script");n.addEventListener("load",function(){window.location.hash&&(window.location=window.location)},{once:!0}),n.src=`https://www.w3.org/scripts/TR/${t}/fixup.js`,e.body.appendChild(n)}(r,a)},{once:!0});const s=`https://www.w3.org/StyleSheets/TR/${a?a+"/":""}${o}`;(0,t.linkCSS)(r,s),i()};e.name="w3c/style";const r=[{hint:"preconnect",href:"https://www.w3.org"},{hint:"preload",href:"https://www.w3.org/scripts/TR/2016/fixup.js",as:"script"},{hint:"preload",href:"https://www.w3.org/StyleSheets/TR/2016/base.css",as:"style"},{hint:"preload",href:"https://www.w3.org/StyleSheets/TR/2016/logos/W3C",as:"image"}].map(t.createResourceHint).reduce(function(e,t){return e.appendChild(t),e},document.createDocumentFragment());r.appendChild(function(){const e=document.createElement("link");return e.rel="stylesheet",e.href="https://www.w3.org/StyleSheets/TR/2016/base.css",e.classList.add("removeOnSave"),e}()),document.head.querySelector("meta[name=viewport]")||r.insertBefore(function(){const e=document.createElement("meta");return e.name="viewport",e.content=(0,t.toKeyValuePairs)({width:"device-width","initial-scale":"1","shrink-to-fit":"no"}).replace(/\"/g,""),e}(),r.firstChild),document.head.insertBefore(r,document.head.firstChild)}),define("core/github",["exports","core/l10n","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.fetchAll=o,e.fetchIndex=function(e,t){return o(e.replace(/\{[^}]+\}/,""),t)},e.run=async function(e){if(!e.hasOwnProperty("github")||!e.github)return;if("object"==typeof e.github&&!e.github.hasOwnProperty("repoURL")){const e="Config option `[github](https://github.com/w3c/respec/wiki/github)` is missing property `repoURL`.";return void(0,n.pub)("error",e)}let t;try{t=new URL(e.github.repoURL||e.github,"https://github.com")}catch(e){return void(0,n.pub)("error",`\`respecConf.github\` is not a valid URL? (${t})`)}if("https://github.com"!==t.origin){const e=`\`respecConf.github\` must be HTTPS and pointing to GitHub. (${t})`;return void(0,n.pub)("error",e)}const[r,o]=t.pathname.split("/").filter(e=>e);if(!r||!o){const e="`respecConf.github` URL needs a path with, for example, w3c/my-spec";return void(0,n.pub)("error",e)}const a=e.github.branch||"gh-pages",s={edDraftURI:`https://${r.toLowerCase()}.github.io/${o}/`,githubToken:void 0,githubUser:void 0,githubAPI:`https://api.github.com/repos/${r}/${o}`,issueBase:new URL("./issues/",t).href,otherLinks:[],pullBase:new URL("./pulls/",t).href,shortName:o},l={key:e.l10n.participate,data:[{value:`GitHub ${r}/${o}`,href:t},{value:e.l10n.file_a_bug,href:s.issueBase},{value:e.l10n.commit_history,href:new URL(`./commits/${a}`,t.href).href},{value:e.l10n.pull_requests,href:s.pullBase}]},c={branch:a,repoURL:t.href},u=i({},s,e,{github:c});Object.assign(e,u),e.otherLinks.unshift(l)};var r;(r=t)&&r.__esModule;var i=Object.assign||function(e){for(var t=1;t]+)>\s*;\s*rel="next"/))&&u[1]||null);var c,u;return l?o(l,t,n):n}}),define("core/data-include",["exports","core/pubsubhub","core/utils"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,i){const o=Array.from(r.querySelectorAll("[data-include]")).map(async e=>{const r=e.dataset.include;if(!r)return;const i="include-"+String(Math.random()).substr(2);e.dataset.includeId=i;try{const o=await fetch(r),a=await o.text();!function(e,t,r){const i=document.querySelector(`[data-include-id=${t}]`),o=i.ownerDocument,a=(0,n.runTransforms)(e,i.dataset.oninclude,r),s="string"==typeof i.dataset.includeReplace;let l;switch(i.dataset.includeFormat){case"text":s?(l=o.createTextNode(a),i.parentNode.replaceChild(l,i)):i.textContent=a;break;default:if(i.innerHTML=a,s){for(l=o.createDocumentFragment();i.hasChildNodes();)l.append(i.removeChild(i.firstChild));i.parentNode.replaceChild(l,i)}}o.contains(i)&&(c=i,["data-include","data-include-format","data-include-replace","data-include-id","oninclude"].forEach(e=>c.removeAttribute(e)));var c}(a,i,r)}catch(n){const i=`\`data-include\` failed: \`${r}\` (${n.message}). See console for details.`;console.error("data-include failed for element: ",e,n),(0,t.pub)("error",i)}});Promise.all(o).then(i)};e.name="core/data-include"}),define("core/markdown",["exports","core/utils"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){const r=!!t.querySelector("[data-format=markdown]:not(body)"),s="markdown"===e.format;if(!s&&!r)return n();if(!s)return o(t.body).map(e=>{const t=i(e,e.ownerDocument);return{structuredInternals:t,elem:e}}).forEach(({elem:e,structuredInternals:t})=>{if(e.setAttribute("aria-busy","true"),"section"===t.firstElementChild.localName&&"section"===e.localName){const n=t.firstElementChild;for(n.remove();n.hasChildNodes();)e.appendChild(n.firstChild)}else e.innerHTML="";e.appendChild(t),e.setAttribute("aria-busy","false")}),n();const l=t.getElementById("respec-ui");l.remove();const c=t.createElement("html"),u=t.createElement("body");u.innerHTML=t.body.innerHTML,c.appendChild(u),a(c);const d=u.innerHTML.replace(/

      \s*<\/p>/gm,"");u.innerHTML=d,p=u.querySelectorAll(".nolinks a[href]"),Array.from(p).forEach(e=>{const t=e.ownerDocument.createTextNode(e.textContent);e.parentElement.replaceChild(t,e)});var p;var f=i(u,t);u.appendChild(f),u.insertAdjacentElement("afterbegin",l),t.body.parentNode.replaceChild(u,t.body),n()};e.name="core/markdown";function n(e){return n=>{const r=Array.from(n.querySelectorAll(e));return r.reverse().forEach(e=>{e.innerHTML=(0,t.markdownToHtml)(e.innerHTML)}),r}}class r{constructor(e){this.doc=e,this.root=e.createDocumentFragment(),this.stack=[this.root],this.current=this.root}findPosition(e){return parseInt(e.tagName.charAt(1),10)}findParent(e){let t;for(;e>0;)if(e--,t=this.stack[e])return t}findHeader({firstChild:e}){for(;e;){if(/H[1-6]/.test(e.tagName))return e;e=e.nextSibling}return null}addHeader(e){const t=this.doc.createElement("section"),n=this.findPosition(e);t.appendChild(e),this.findParent(n).appendChild(t),this.stack[n]=t,this.stack.length=n+1,this.current=t}addSection(e,t){const n=this.findHeader(e),r=n?this.findPosition(n):1,i=this.findParent(r);n&&e.removeChild(n),e.appendChild(t(e)),n&&e.insertBefore(n,e.firstChild),i.appendChild(e),this.current=i}addElement(e){this.current.appendChild(e)}}function i(e,t){return function e(n){const i=new r(t);for(;n.firstChild;){const t=n.firstChild;if(t.nodeType===Node.ELEMENT_NODE)switch(t.localName){case"h1":case"h2":case"h3":case"h4":case"h5":case"h6":i.addHeader(t);break;case"section":i.addSection(t,e);break;default:i.addElement(t)}else n.removeChild(t)}return i.root}(e)}const o=n("[data-format='markdown']:not(body)"),a=n("[data-format=markdown]:not(body), section, div, address, article, aside, figure, header, main, body")}),Dha=this,Eha=function(){return function(e){var t={};function n(r){if(t[r])return t[r].exports;var i=t[r]={exports:{},id:r,loaded:!1};return e[r].call(i.exports,i,i.exports,n),i.loaded=!0,i.exports}return n.m=e,n.c=t,n.p="",n(0)}([function(e,t,n){var r=n(1).default,i=n(2).default;t.__esModule=!0;var o=r(n(3)),a=i(n(20)),s=i(n(5)),l=r(n(4)),c=r(n(21)),u=i(n(33));function d(){var e=new o.HandlebarsEnvironment;return l.extend(e,o),e.SafeString=a.default,e.Exception=s.default,e.Utils=l,e.escapeExpression=l.escapeExpression,e.VM=c,e.template=function(t){return c.template(t,e)},e}var p=d();p.create=d,u.default(p),p.default=p,t.default=p,e.exports=t.default},function(e,t){t.default=function(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&(t[n]=e[n]);return t.default=e,t},t.__esModule=!0},function(e,t){t.default=function(e){return e&&e.__esModule?e:{default:e}},t.__esModule=!0},function(e,t,n){var r=n(2).default;t.__esModule=!0,t.HandlebarsEnvironment=u;var i=n(4),o=r(n(5)),a=n(9),s=n(17),l=r(n(19));t.VERSION="4.0.11";t.COMPILER_REVISION=7;t.REVISION_CHANGES={1:"<= 1.0.rc.2",2:"== 1.0.0-rc.3",3:"== 1.0.0-rc.4",4:"== 1.x.x",5:"== 2.0.0-alpha.x",6:">= 2.0.0-beta.1",7:">= 4.0.0"};var c="[object Object]";function u(e,t,n){this.helpers=e||{},this.partials=t||{},this.decorators=n||{},a.registerDefaultHelpers(this),s.registerDefaultDecorators(this)}u.prototype={constructor:u,logger:l.default,log:l.default.log,registerHelper:function(e,t){if(i.toString.call(e)===c){if(t)throw new o.default("Arg not supported with multiple helpers");i.extend(this.helpers,e)}else this.helpers[e]=t},unregisterHelper:function(e){delete this.helpers[e]},registerPartial:function(e,t){if(i.toString.call(e)===c)i.extend(this.partials,e);else{if(void 0===t)throw new o.default('Attempting to register a partial called "'+e+'" as undefined');this.partials[e]=t}},unregisterPartial:function(e){delete this.partials[e]},registerDecorator:function(e,t){if(i.toString.call(e)===c){if(t)throw new o.default("Arg not supported with multiple decorators");i.extend(this.decorators,e)}else this.decorators[e]=t},unregisterDecorator:function(e){delete this.decorators[e]}};var d=l.default.log;t.log=d,t.createFrame=i.createFrame,t.logger=l.default},function(e,t){t.__esModule=!0,t.extend=a,t.indexOf=function(e,t){for(var n=0,r=e.length;n":">",'"':""","'":"'","`":"`","=":"="},r=/[&<>"'`=]/g,i=/[&<>"'`=]/;function o(e){return n[e]}function a(e){for(var t=1;t0?(n.ids&&(n.ids=[n.name]),e.helpers.each(t,n)):i(this);if(n.data&&n.ids){var a=r.createFrame(n.data);a.contextPath=r.appendContextPath(n.data.contextPath,n.name),n={data:a}}return o(t,n)})},e.exports=t.default},function(e,t,n){var r=n(2).default;t.__esModule=!0;var i=n(4),o=r(n(5));t.default=function(e){e.registerHelper("each",function(e,t){if(!t)throw new o.default("Must pass iterator to #each");var n=t.fn,r=t.inverse,a=0,s="",l=void 0,c=void 0;function u(t,r,o){l&&(l.key=t,l.index=r,l.first=0===r,l.last=!!o,c&&(l.contextPath=c+t)),s+=n(e[t],{data:l,blockParams:i.blockParams([e[t],t],[c+t,null])})}if(t.data&&t.ids&&(c=i.appendContextPath(t.data.contextPath,t.ids[0])+"."),i.isFunction(e)&&(e=e.call(this)),t.data&&(l=i.createFrame(t.data)),e&&"object"==typeof e)if(i.isArray(e))for(var d=e.length;a=0?t:parseInt(e,10)}return e},log:function(e){if(e=i.lookupLevel(e),"undefined"!=typeof console&&i.lookupLevel(i.level)<=e){var t=i.methodMap[e];console[t]||(t="log");for(var n=arguments.length,r=Array(n>1?n-1:0),o=1;o *:hover > span.permalink { visibility: visible; }\n"},3:function(e,t,n,r,i){return" float: right;\n"},5:function(e,t,n,r,i){return" visibility: hidden;\n"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{};return"/* --- PERMALINKS --- */\n"+(null!=(o=n.if.call(a,null!=t?t.permalinkHide:t,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"\n.permalink {\n width: 1px;\n height: 1px;\n overflow: visible;\n font-size: 10pt;\n font-style: normal;\n vertical-align: middle;\n margin-left: 4px;\n"+(null!=(o=n.if.call(a,null!=t?t.permalinkEdge:t,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+(null!=(o=n.if.call(a,null!=t?t.permalinkHide:t,{name:"if",hash:{},fn:e.program(5,i,0),inverse:e.noop,data:i}))?o:"")+"}\n\n.permalink a, .permalink a:link, .permalink a:visited, .permalink a:hover, .permalink a:focus, .permalink a:active {\n background:transparent !important;\n text-decoration:none;\n font-weight: bold;\n color:#666 !important;\n}\n\n.permalink abbr {\n border:0;\n}\n"},useData:!0}),n["attribute.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression((n.escapeAttributeName||t&&t.escapeAttributeName||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.name:o,{name:"escapeAttributeName",hash:{},data:i}))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:u)?a.call(c,{name:"qualifiers",hash:{},data:i}):a)+"attribute "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["callback.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"callback "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" = "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" ("+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+");"},useData:!0}),n["const.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"const "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+""+l("function"==typeof(a=null!=(a=n.nullable||(null!=t?t.nullable:t))?a:u)?a.call(c,{name:"nullable",hash:{},data:i}):a)+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" = "+l((n.stringifyIdlConst||t&&t.stringifyIdlConst||u).call(c,null!=(o=null!=t?t.obj:t)?o.value:o,{name:"stringifyIdlConst",hash:{},data:i}))+";\n"},useData:!0}),n["dict-member.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" = "+e.escapeExpression((n.stringifyIdlConst||t&&t.stringifyIdlConst||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.default:o,{name:"stringifyIdlConst",hash:{},data:i}))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:u)?a.call(c,{name:"qualifiers",hash:{},data:i}):a)+""+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.typePad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.default:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["dictionary.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" : "+e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.inheritance:o,t))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.partial||(null!=t?t.partial:t))?a:u)?a.call(c,{name:"partial",hash:{},data:i}):a)+"dictionary "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.inheritance:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+"};"},useData:!0}),n["enum-item.html"]=t({1:function(e,t,n,r,i){return","},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression,u="function";return c((n.idn||t&&t.idn||l).call(s,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+'"'+c(typeof(a=null!=(a=n.name||(null!=t?t.name:t))?a:l)===u?a.call(s,{name:"name",hash:{},data:i}):a)+'"'+(null!=(o=n.if.call(s,null!=t?t.needsComma:t,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"\n"},useData:!0}),n["enum.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"enum "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"};"},useData:!0}),n["extended-attribute.html"]=t({1:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return"'+c("function"==typeof(a=null!=(a=n.name||(null!=t?t.name:t))?a:l)?a.call(s,{name:"name",hash:{},data:i}):a)+""+(null!=(o=n.if.call(s,null!=t?t.rhs:t,{name:"if",hash:{},fn:e.program(2,i,0),inverse:e.noop,data:i}))?o:"")+(null!=(o=(n.jsIf||t&&t.jsIf||l).call(s,null!=t?t.arguments:t,{name:"jsIf",hash:{},fn:e.program(5,i,0),inverse:e.noop,data:i}))?o:"")+""},2:function(e,t,n,r,i){var o;return'='+(null!=(o=(n.extAttrRhs||t&&t.extAttrRhs||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=t?t.rhs:t,{name:"extAttrRhs",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+""},3:function(e,t,n,r,i){return e.escapeExpression(e.lambda(t,t))},5:function(e,t,n,r,i){var o;return"("+(null!=(o=(n.joinNonWhitespace||t&&t.joinNonWhitespace||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=t?t.arguments:t,", ",{name:"joinNonWhitespace",hash:{},fn:e.program(6,i,0),inverse:e.noop,data:i}))?o:"")+")"},6:function(e,t,n,r,i){return e.escapeExpression((n.param||t&&t.param||n.helperMissing).call(null!=t?t:e.nullContext||{},t,{name:"param",hash:{},data:i}))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return c((n.idn||t&&t.idn||l).call(s,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"["+(null!=(o=(n.join||t&&t.join||l).call(s,null!=t?t.extAttrs:t,null!=t?t.sep:t,{name:"join",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"]"+c("function"==typeof(a=null!=(a=n.end||(null!=t?t.end:t))?a:l)?a.call(s,{name:"end",hash:{},data:i}):a)},useData:!0}),n["field.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=e.lambda,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+s((n.pads||t&&t.pads||c).call(l,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["implements.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression,c=e.lambda;return""+l((n.extAttr||t&&t.extAttr||s).call(a,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+l(c(null!=(o=null!=t?t.obj:t)?o.target:o,t))+" implements "+l(c(null!=(o=null!=t?t.obj:t)?o.implements:o,t))+";"},useData:!0}),n["includes.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression,c=e.lambda;return""+l((n.extAttr||t&&t.extAttr||s).call(a,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+l(c(null!=(o=null!=t?t.obj:t)?o.target:o,t))+" includes "+l(c(null!=(o=null!=t?t.obj:t)?o.includes:o,t))+";"},useData:!0}),n["interface.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" : "+e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.inheritance:o,t))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing,d="function";return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l(typeof(a=null!=(a=n.partial||(null!=t?t.partial:t))?a:u)===d?a.call(c,{name:"partial",hash:{},data:i}):a)+l(typeof(a=null!=(a=n.callback||(null!=t?t.callback:t))?a:u)===d?a.call(c,{name:"callback",hash:{},data:i}):a)+"interface "+l(typeof(a=null!=(a=n.mixin||(null!=t?t.mixin:t))?a:u)===d?a.call(c,{name:"mixin",hash:{},data:i}):a)+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.inheritance:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o=typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)===d?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"};"},useData:!0}),n["iterable.html"]=t({1:function(e,t,n,r,i){return"iterable"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+s("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:c)?a.call(l,{name:"qualifiers",hash:{},data:i}):a)+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"<"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+">;\n"},useData:!0}),n["line-comment.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression;return""+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"//"+l("function"==typeof(o=null!=(o=n.comment||(null!=t?t.comment:t))?o:s)?o.call(a,{name:"comment",hash:{},data:i}):o)+"\n"},useData:!0}),n["maplike.html"]=t({1:function(e,t,n,r,i){return"maplike"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+s("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:c)?a.call(l,{name:"qualifiers",hash:{},data:i}):a)+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"<"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+">;\n"},useData:!0}),n["method.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l((n.extAttrInline||t&&t.extAttrInline||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttrInline",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.special||(null!=t?t.special:t))?a:u)?a.call(c,{name:"special",hash:{},data:i}):a)+""+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"("+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+");\n"},useData:!0}),n["multiline-comment.html"]=t({1:function(e,t,n,r,i,o,a){var s=e.escapeExpression;return s((n.idn||t&&t.idn||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=a[1]?a[1].indent:a[1],{name:"idn",hash:{},data:i}))+s(e.lambda(t,t))+"\n"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i,o,a){var s,l,c=null!=t?t:e.nullContext||{},u=n.helperMissing,d=e.escapeExpression;return""+d((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"/*"+d("function"==typeof(l=null!=(l=n.firstLine||(null!=t?t.firstLine:t))?l:u)?l.call(c,{name:"firstLine",hash:{},data:i}):l)+"\n"+(null!=(s=n.each.call(c,null!=t?t.innerLine:t,{name:"each",hash:{},fn:e.program(1,i,0,o,a),inverse:e.noop,data:i}))?s:"")+d((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+d("function"==typeof(l=null!=(l=n.lastLine||(null!=t?t.lastLine:t))?l:u)?l.call(c,{name:"lastLine",hash:{},data:i}):l)+"*/\n"},useData:!0,useDepths:!0}),n["param.html"]=t({1:function(e,t,n,r,i){var o;return" = "+e.escapeExpression((n.stringifyIdlConst||t&&t.stringifyIdlConst||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.default:o,{name:"stringifyIdlConst",hash:{},data:i}))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return""+c((n.extAttrInline||t&&t.extAttrInline||l).call(s,null!=t?t.obj:t,{name:"extAttrInline",hash:{},data:i}))+c("function"==typeof(a=null!=(a=n.optional||(null!=t?t.optional:t))?a:l)?a.call(s,{name:"optional",hash:{},data:i}):a)+""+c((n.idlType||t&&t.idlType||l).call(s,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+c("function"==typeof(a=null!=(a=n.variadic||(null!=t?t.variadic:t))?a:l)?a.call(s,{name:"variadic",hash:{},data:i}):a)+" "+c(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))+""+(null!=(o=n.if.call(s,null!=(o=null!=t?t.obj:t)?o.default:o,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""},useData:!0}),n["typedef.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=e.lambda,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return"typedef "+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";"},useData:!0}),n}),define("w3c/templates/cgbg-sotd",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const t=hyperHTML;return t`

      ${e.l10n.sotd}

      +${e.isPreview?t` +
      + This is a preview +

      + Do not attempt to implement this version of the specification. Do not reference this + version as authoritative in any way. + ${e.edDraftURI?t` + Instead, see ${e.edDraftURI} for the Editor's draft. + `:""} +

      +
      +`:""} +

      + This specification was published by the ${e.wg}. + It is not a W3C Standard nor is it on the W3C Standards Track. + ${e.isCGFinal?t` + Please note that under the + W3C Community Final Specification Agreement (FSA) + other conditions apply. + `:t` + Please note that under the + W3C Community Contributor License Agreement (CLA) + there is a limited opt-out and other conditions apply. + `} + Learn more about + W3C Community and Business Groups. +

      +${e.sotdAfterWGinfo?"":[e.additionalContent]} + ${e.wgPublicList?t` +

      If you wish to make comments regarding this document, please send them to + ${e.wgPublicList}@w3.org + (subscribe, + archives)${e.subjectPrefix?t` + with ${e.subjectPrefix} at the start of your + email's subject`:""}.

      + `:""} +${e.sotdAfterWGinfo?[e.additionalContent]:""} +${[e.additionalSections]}`})}),define("w3c/templates/sotd",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const t=hyperHTML;return t`

      ${e.l10n.sotd}

      +${e.isPreview?t` +
      + This is a preview +

      + Do not attempt to implement this version of the specification. Do not reference this + version as authoritative in any way. + ${e.edDraftURI?t` + Instead, see ${e.edDraftURI} for the Editor's draft. + `:""} +

      +
      +`:""} +${e.isUnofficial?t` +

      + This document is draft of a potential specification. It has no official standing of + any kind and does not represent the support or consensus of any standards organisation. +

      + ${[e.additionalContent]} +`:t` + ${e.isTagFinding?[e.additionalContent]:t` + ${e.isNoTrack?t` +

      + This document is merely a W3C-internal ${e.isMO?"member-confidential":""} document. It + has no official standing of any kind and does not represent consensus of the W3C + Membership. +

      + ${[e.additionalContent]} + `:t` +

      + ${[e.l10n.status_at_publication]} +

      + ${e.isSubmission?t` + ${[e.additionalContent]} + ${e.isMemberSubmission?t` +

      + By publishing this document, W3C acknowledges that the Submitting Members + have made a formal Submission request to W3C for discussion. Publication of this document + by W3C indicates no endorsement of its content by W3C, nor that W3C has, is, or will be + allocating any resources to the issues addressed by it. This document is not the product + of a chartered W3C group, but is published as potential input to + the W3C Process. + A W3C Team Comment has been + published in conjunction with this Member Submission. Publication of acknowledged Member Submissions + at the W3C site is one of the benefits of + W3C Membership. Please consult the requirements associated with Member Submissions of + section 3.3 of the + W3C Patent Policy. Please consult the complete list + of acknowledged W3C Member Submissions. +

      + `:t` + ${e.isTeamSubmission?t` +

      If you wish to make comments regarding this document, please send them to + ${e.wgPublicList}@w3.org + (subscribe, + archives)${e.subjectPrefix?t` + with ${e.subjectPrefix} at the start of your email's subject`:""}.

      +

      Please consult the complete list of Team Submissions.

      + `:""} + `} + `:t` + ${e.sotdAfterWGinfo?"":[e.additionalContent]} + ${e.overrideStatus?"":t` +

      + This document was published by ${[e.wgHTML]} as ${e.anOrA} ${e.longStatus}. + ${e.notYetRec?"This document is intended to become a W3C Recommendation.":""} + ${e.wgPublicList?t` + Comments regarding this document are welcome. Please send them to + ${e.wgPublicList}@w3.org + (subscribe, + archives)${e.subjectPrefix?t` + with ${e.subjectPrefix} at the start of your email's subject`:""}. + `:""} + ${e.isCR?`\n W3C publishes a Candidate Recommendation to indicate that the document is believed to be\n stable and to encourage implementation by the developer community. This Candidate\n Recommendation is expected to advance to Proposed Recommendation no earlier than\n ${e.humanCREnd}.\n `:""} + ${e.isPER?t` + W3C Advisory Committee Members are invited to + send formal review comments on this Proposed + Edited Recommendation to the W3C Team until + ${e.humanPEREnd}. + Members of the Advisory Committee will find the + appropriate review form for this document by + consulting their list of current + WBS questionnaires. + `:""} + ${e.isPR?t` + The W3C Membership and other interested parties are invited to review the document and + send comments to + ${e.wgPublicList}@w3.org + (subscribe, + archives) + through ${e.humanPREnd}. Advisory Committee Representatives should consult their + WBS questionnaires. + Note that substantive technical comments were expected during the Candidate Recommendation + review period that ended ${e.humanCREnd}. + `:""} +

      + `} + ${e.implementationReportURI?t` +

      + Please see the Working Group's implementation + report. +

      + `:""} + ${e.sotdAfterWGinfo?[e.additionalContent]:""} + ${e.notRec?t` +

      + Publication as ${e.anOrA} ${e.textStatus} does not imply endorsement by the W3C + Membership. This is a draft document and may be updated, replaced or obsoleted by other + documents at any time. It is inappropriate to cite this document as other than work in + progress. +

      + `:""} + ${e.isRec?t` +

      + This document has been reviewed by W3C Members, by software developers, and by other W3C + groups and interested parties, and is endorsed by the Director as a W3C Recommendation. + It is a stable document and may be used as reference material or cited from another + document. W3C's role in making the Recommendation is to draw attention to the + specification and to promote its widespread deployment. This enhances the functionality + and interoperability of the Web. +

      + `:""} +

      + ${e.isIGNote?"":t` + This document was produced by + ${e.multipleWGs?"groups":"a group"} + operating under the + W3C Patent Policy. + `} + ${e.recNotExpected?"The group does not expect this document to become a W3C Recommendation.":""} + ${e.isIGNote?"":t` + ${e.multipleWGs?t`W3C maintains ${[e.wgPatentHTML]}`:t` + W3C maintains a public list of any patent + disclosures + `} + made in connection with the deliverables of + ${e.multipleWGs?"each group; these pages also include":"the group; that page also includes"} + instructions for disclosing a patent. An individual who has actual knowledge of a patent + which the individual believes contains + Essential + Claim(s) must disclose the information in accordance with + section + 6 of the W3C Patent Policy. + `} + ${e.isIGNote?t` + The disclosure obligations of the Participants of this group are described in the + charter. + `:""} +

      +

      This document is governed by the 1 February 2018 W3C Process Document. +

      + ${e.addPatentNote?t`

      ${[e.addPatentNote]}

      `:""} + `} + `} + `} +`} +${[e.additionalSections]}`})}),define("w3c/templates/show-logo",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const n=document.createElement("a");if(!e.alt){const e="Found spec logo without an `alt` attribute. See dev console.";n.classList.add("respec-offending-element"),(0,t.pub)("warn",e),console.warn("warn",e,n)}return n.href=e.url||"",n.classList.add("logo"),hyperHTML.bind(n)` + ${e.alt} + `,n.querySelector("img").src=e.src,n})}),define("w3c/templates/show-people",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=((e,t,n=[])=>{const r=hyperHTML,i=[];for(let e=0;e`,o=document.createDocumentFragment(),s=[];if(e.mailto?s.push(r``):e.url?s.push(r`${n}`):s.push(r`${n}`),e.company&&(e.companyURL?s.push(r` (${e.company})`):s.push(r` (${e.company})`)),e.note&&s.push(document.createTextNode(` (${e.note})`)),e.extras){const t=e.extras.filter(e=>e.name&&e.name.trim()).map(a);for(const e of t)s.push(document.createTextNode(", "),e)}return hyperHTML.bind(o)`${s}`,i.appendChild(o),i}function a(e){const t=r``;let n=t;return e.href&&(n=r``,t.appendChild(n)),n.textContent=e.name,t}})}),define("w3c/templates/show-link",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0});const n=hyperHTML;function r(e){return n` +
      + ${e.href?n` + ${e.value||e.href} + `:""} +
      + `}e.default=(e=>{if(!e.key){const n="Found a link without `key` attribute in the configuration. See dev console.";return(0,t.pub)("warn",n),void console.warn("warn",n,e)}return n` +
      ${e.key}:
      + ${e.data?e.data.map(r):r(e)} + `})}),define("w3c/templates/cgbg-headers",["exports","./show-logo","./show-people","./show-link","deps/hyperhtml"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0});var i=s(t),o=s(n),a=s(r);function s(e){return e&&e.__esModule?e:{default:e}}e.default=(e=>{const t=hyperHTML;return t`
      + ${e.logos.map(i.default)} +

      ${e.title}

      + ${e.subtitle?t` +

      ${e.subtitle}

      + `:""} +

      ${e.longStatus}

      +
      + ${e.thisVersion?t` +
      ${e.l10n.this_version}
      +
      ${e.thisVersion}
      + `:""} + ${e.latestVersion?t` +
      ${e.l10n.latest_published_version}
      +
      ${e.latestVersion}
      + `:""} + ${e.edDraftURI?t` +
      ${e.l10n.latest_editors_draft}
      +
      ${e.edDraftURI}
      + `:""} + ${e.testSuiteURI?t` +
      Test suite:
      +
      ${e.testSuiteURI}
      + `:""} + ${e.implementationReportURI?t` +
      Implementation report:
      +
      ${e.implementationReportURI}
      + `:""} + ${e.bugTrackerHTML?t` +
      ${e.l10n.bug_tracker}
      +
      ${[e.bugTrackerHTML]}
      + `:""} + ${e.prevVersion?t` +
      Previous version:
      +
      ${e.prevVersion}
      + `:""} + ${e.isCGFinal?"":t` + ${e.prevED?t` +
      Previous editor's draft:
      +
      ${e.prevED}
      + `:""} + `} +
      ${e.multipleEditors?e.l10n.editors:e.l10n.editor}
      + ${(0,o.default)(e,"Editor",e.editors)} + ${Array.isArray(e.formerEditors)&&e.formerEditors.length>0?t` +
      ${e.multipleFormerEditors?e.l10n.former_editors:e.l10n.former_editor}
      + ${(0,o.default)(e,"Editor",e.formerEditors)} + `:""} + ${e.authors?t` +
      ${e.multipleAuthors?e.l10n.authors:e.l10n.author}
      + ${(0,o.default)(e,"Author",e.authors)} + `:""} + ${e.otherLinks?e.otherLinks.map(a.default):""} +
      + ${e.alternateFormats?t` +

      + ${e.multipleAlternates?"This document is also available in these non-normative formats:":"This document is also available in this non-normative format:"} + ${[e.alternatesHTML]} +

      + `:""} + +
      +
      `})}),define("oai/templates/show-logo",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const n=document.createElement("a");if(!e.alt){const e="Found spec logo without an `alt` attribute. See dev console.";n.classList.add("respec-offending-element"),(0,t.pub)("warn",e),console.warn("warn",e,n)}return n.href=e.url||"",n.classList.add("logo"),hyperHTML.bind(n)` + ${e.alt} + `,n.querySelector("img").src=e.src,n})}),define("oai/templates/show-people",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=((e,t,n=[])=>{const r=hyperHTML,i=[];for(let e=0;e`,o=document.createDocumentFragment(),s=[];if(e.mailto?s.push(r``):e.url?s.push(r`${n}`):s.push(r`${n}`),e.company&&(e.companyURL?s.push(r` (${e.company})`):s.push(r` (${e.company})`)),e.note&&s.push(document.createTextNode(` (${e.note})`)),e.extras){const t=e.extras.filter(e=>e.name&&e.name.trim()).map(a);for(const e of t)s.push(document.createTextNode(", "),e)}return hyperHTML.bind(o)`${s}`,i.appendChild(o),i}function a(e){const t=r``;let n=t;return e.href&&(n=r``,t.appendChild(n)),n.textContent=e.name,t}})}),define("oai/templates/show-link",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0});const n=hyperHTML;function r(e){return n` +
      + ${e.href?n` + ${e.value||e.href} + `:""} +
      + `}e.default=(e=>{if(!e.key){const n="Found a link without `key` attribute in the configuration. See dev console.";return(0,t.pub)("warn",n),void console.warn("warn",n,e)}return n` +
      ${e.key}:
      + ${e.data?e.data.map(r):r(e)} + `})}),define("oai/templates/headers",["exports","./show-logo","./show-people","./show-link","core/pubsubhub","deps/hyperhtml"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0});var o=l(t),a=l(n),s=l(r);function l(e){return e&&e.__esModule?e:{default:e}}e.default=(e=>{const t=hyperHTML;return t`
      + ${e.logos.map(o.default)} + ${function(e){const t=document.querySelector("h1#title")||document.createElement("h1");return t.parentElement?(t.remove(),e.title=t.textContent.trim()):(t.textContent=e.title,t.id="title"),t.classList.add("title","p-name"),null===document.querySelector("title")?document.title=e.title:document.title!==e.title&&(0,i.pub)("warn","The document's title and the `` element differ."),t}(e)} + ${function(e){let t=document.querySelector("h2#subtitle");return t&&t.parentElement?(t.remove(),e.subtitle=t.textContent.trim()):e.subtitle&&((t=document.createElement("h2")).textContent=e.subtitle,t.id="subtitle"),t&&t.classList.add("subtitle"),t}(e)} + <h2>${e.prependW3C?"W3C":""}${e.textStatus} <time class='dt-published' datetime='${e.dashDate}'>${e.publishHumanDate}</time></h2> + <dl> + ${e.isNoTrack?"":t` + <dt>${e.l10n.this_version}</dt> + <dd><a class='u-url' href='${e.thisVersion}'>${e.thisVersion}</a></dd> + <dt>${e.l10n.latest_published_version}</dt> + <dd>${e.latestVersion?t`<a href='${e.latestVersion}'>${e.latestVersion}</a>`:"none"}</dd> + `} + ${e.edDraftURI?t` + <dt>${e.l10n.latest_editors_draft}</dt> + <dd><a href='${e.edDraftURI}'>${e.edDraftURI}</a></dd> + `:""} + ${e.testSuiteURI?t` + <dt>Test suite:</dt> + <dd><a href='${e.testSuiteURI}'>${e.testSuiteURI}</a></dd> + `:""} + ${e.implementationReportURI?t` + <dt>Implementation report:</dt> + <dd><a href='${e.implementationReportURI}'>${e.implementationReportURI}</a></dd> + `:""} + ${e.bugTrackerHTML?t` + <dt>${e.l10n.bug_tracker}</dt> + <dd>${[e.bugTrackerHTML]}</dd> + `:""} + ${e.isED?t` + ${e.prevED?t` + <dt>Previous editor's draft:</dt> + <dd><a href='${e.prevED}'>${e.prevED}</a></dd> + `:""} + `:""} + ${e.showPreviousVersion?t` + <dt>Previous version:</dt> + <dd><a href='${e.prevVersion}'>${e.prevVersion}</a></dd> + `:""} + ${e.prevRecURI?t` + ${e.isRec?t` + <dt>Previous Recommendation:</dt> + <dd><a href='${e.prevRecURI}'>${e.prevRecURI}</a></dd> + `:t` + <dt>Latest Recommendation:</dt> + <dd><a href='${e.prevRecURI}'>${e.prevRecURI}</a></dd> + `} + `:""} + <dt>${e.multipleEditors?e.l10n.editors:e.l10n.editor}</dt> + ${(0,a.default)(e,"Editor",e.editors)} + ${Array.isArray(e.formerEditors)&&e.formerEditors.length>0?t` + <dt>${e.multipleFormerEditors?e.l10n.former_editors:e.l10n.former_editor}</dt> + ${(0,a.default)(e,"Editor",e.formerEditors)} + `:""} + ${e.authors?t` + <dt>${e.multipleAuthors?e.l10n.authors:e.l10n.author}</dt> + ${(0,a.default)(e,"Author",e.authors)} + `:""} + ${e.otherLinks?e.otherLinks.map(s.default):""} + </dl> + ${e.errata?t` + <p> + Please check the <a href="${e.errata}"><strong>errata</strong></a> for any errors or issues + reported since publication. + </p> + `:""} + ${e.isRec?t` + <p> + See also <a href="${`http://www.w3.org/2003/03/Translations/byTechnology?technology=${e.shortName}`}"> + <strong>translations</strong></a>. + </p> + `:""} + ${e.alternateFormats?t` + <p> + ${e.multipleAlternates?"This document is also available in these non-normative formats:":"This document is also available in this non-normative format:"} + ${[e.alternatesHTML]} + </p> + `:""} + ${e.isUnofficial?t` + ${e.additionalCopyrightHolders?t` + <p class='copyright'>${[e.additionalCopyrightHolders]}</p> + `:t` + ${e.overrideCopyright?[e.overrideCopyright]:t` + <p class='copyright'> + This document is licensed under a + <a class='subfoot' href='https://creativecommons.org/licenses/by/3.0/' rel='license'>Creative Commons + Attribution 3.0 License</a>. + </p> + `} + `} + `:t` + ${e.overrideCopyright?[e.overrideCopyright]:t` + <p class='copyright'> + Copyright © + ${e.copyrightStart?`${e.copyrightStart}-`:""}${e.publishYear} + ${e.additionalCopyrightHolders?t` ${[e.additionalCopyrightHolders]} `:""} + ${e.isCCBY?t` + Some Rights Reserved: this document is dual-licensed, + <a rel="license" href="https://creativecommons.org/licenses/by/3.0/">CC-BY</a> and + <a rel="license" href="https://www.w3.org/Consortium/Legal/copyright-documents">W3C Document License</a>. + `:""} + </p> + `} + `} + <hr title="Separator for header"> +</div>`})}),define("oai/headers",["exports","core/utils","handlebars.runtime","core/pubsubhub","templates","w3c/templates/cgbg-sotd","w3c/templates/sotd","w3c/templates/cgbg-headers","oai/templates/headers"],function(e,t,n,r,i,o,a,s,l){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){e.isUnofficial="unofficial"===e.specStatus,e.isUnofficial&&(e.logos=[]);if(e.license="apache2",e.isCCBY="cc-by"===e.license,e.isW3CSoftAndDocLicense="w3c-software-doc"===e.license,["cc-by"].includes(e.license)){let t=`You cannot use license "\`${e.license}\`" with W3C Specs. `;t+='Please set `respecConfig.license: "w3c-software-doc"` instead.',(0,r.pub)("error",t)}e.licenseInfo=k[e.license],e.isCGBG=w.includes(e.specStatus),e.isCGFinal=e.isCGBG&&/G-FINAL$/.test(e.specStatus),e.isBasic="base"===e.specStatus,e.isRegular=!e.isCGBG&&!e.isBasic,e.specStatus||(0,r.pub)("error","Missing required configuration: `specStatus`");e.isRegular&&!e.shortName&&(0,r.pub)("error","Missing required configuration: `shortName`");if(e.testSuiteURI){const t=new URL(e.testSuiteURI,document.location),{host:n,pathname:i}=t;if("github.com"===n&&i.startsWith("/w3c/web-platform-tests/")){const t="Web Platform Tests have moved to a new Github Organization at https://github.com/web-platform-tests. Please update your [`testSuiteURI`](https://github.com/w3c/respec/wiki/testSuiteURI) to point to the "+`new tests repository (e.g., https://github.com/web-platform-tests/${e.shortName} ).`;(0,r.pub)("warn",t)}}e.title=document.title||"No Title",e.subtitle||(e.subtitle="");if(e.publishDate=E(e,"publishDate",document.lastModified),e.publishYear=e.publishDate.getUTCFullYear(),e.publishHumanDate=f.format(e.publishDate),e.isNoTrack=v.includes(e.specStatus),e.isRecTrack=!e.noRecTrack&&y.includes(e.specStatus),e.isMemberSubmission="Member-SUBM"===e.specStatus,e.isMemberSubmission){const t={alt:"W3C Member Submission",href:"https://www.w3.org/Submission/",src:"https://www.w3.org/Icons/member_subm-v.svg",width:"211"};e.logos.push(p({},C,t))}if(e.isTeamSubmission="Team-SUBM"===e.specStatus,e.isTeamSubmission){const t={alt:"W3C Team Submission",href:"https://www.w3.org/TeamSubmission/",src:"https://www.w3.org/Icons/team_subm-v.svg",width:"211"};e.logos.push(p({},C,t))}e.isSubmission=e.isMemberSubmission||e.isTeamSubmission,e.anOrA=x.includes(e.specStatus)?"an":"a",e.isTagFinding="finding"===e.specStatus||"draft-finding"===e.specStatus,e.edDraftURI||(e.edDraftURI="","ED"===e.specStatus&&(0,r.pub)("warn","Editor's Drafts should set edDraftURI."));e.maturity=h[e.specStatus]?h[e.specStatus]:e.specStatus;var n="TR";"Member-SUBM"===e.specStatus?n="Submission":"Team-SUBM"===e.specStatus&&(n="TeamSubmission");e.isRegular&&(e.thisVersion="https://www.w3.org/"+n+"/"+e.publishDate.getUTCFullYear()+"/"+e.maturity+"-"+e.shortName+"-"+(0,t.concatDate)(e.publishDate)+"/");"ED"===e.specStatus&&(e.thisVersion=e.edDraftURI);e.isRegular&&(e.latestVersion="https://www.w3.org/"+n+"/"+e.shortName+"/");e.isTagFinding&&(e.latestVersion="https://www.w3.org/2001/tag/doc/"+e.shortName,e.thisVersion=e.latestVersion+"-"+t.ISODate.format(e.publishDate));if(e.previousPublishDate){e.previousMaturity||e.isTagFinding||(0,r.pub)("error","`previousPublishDate` is set, but not `previousMaturity`."),e.previousPublishDate=E(e,"previousPublishDate");var i=h[e.previousMaturity]?h[e.previousMaturity]:e.previousMaturity;e.isTagFinding?e.prevVersion=e.latestVersion+"-"+t.ISODate.format(e.previousPublishDate):e.isCGBG?e.prevVersion=e.prevVersion||"":e.isBasic?e.prevVersion="":e.prevVersion="https://www.w3.org/TR/"+e.previousPublishDate.getUTCFullYear()+"/"+i+"-"+e.shortName+"-"+(0,t.concatDate)(e.previousPublishDate)+"/"}else/NOTE$/.test(e.specStatus)||"FPWD"===e.specStatus||"FPLC"===e.specStatus||"ED"===e.specStatus||e.noRecTrack||e.isNoTrack||e.isSubmission||(0,r.pub)("error","Document on track but no previous version: Add `previousMaturity`, and `previousPublishDate` to ReSpec's config."),e.prevVersion||(e.prevVersion="");e.prevRecShortname&&!e.prevRecURI&&(e.prevRecURI="https://www.w3.org/TR/"+e.prevRecShortname);e.editors&&0!==e.editors.length||(0,r.pub)("error","At least one editor is required");var o=function(e){e.name||(0,r.pub)("error","All authors and editors must have a name.")};e.editors&&e.editors.forEach(o);e.formerEditors&&e.formerEditors.forEach(o);e.authors&&e.authors.forEach(o);e.multipleEditors=e.editors&&e.editors.length>1,e.multipleFormerEditors=Array.isArray(e.formerEditors)&&e.formerEditors.length>1,e.multipleAuthors=e.authors&&e.authors.length>1,$.each(e.alternateFormats||[],function(e,t){t.uri&&t.label||(0,r.pub)("error","All alternate formats must have a uri and a label.")}),e.multipleAlternates=e.alternateFormats&&e.alternateFormats.length>1,e.alternatesHTML=e.alternateFormats&&(0,t.joinAnd)(e.alternateFormats,function(e){var t=e.hasOwnProperty("lang")&&e.lang?" hreflang='"+e.lang+"'":"";return t+=e.hasOwnProperty("type")&&e.type?" type='"+e.type+"'":"","<a rel='alternate' href='"+e.uri+"'"+t+">"+e.label+"</a>"}),e.bugTracker&&(e.bugTracker.new&&e.bugTracker.open?e.bugTrackerHTML="<a href='"+e.bugTracker.new+"'>"+e.l10n.file_a_bug+"</a> "+e.l10n.open_parens+"<a href='"+e.bugTracker.open+"'>"+e.l10n.open_bugs+"</a>"+e.l10n.close_parens:e.bugTracker.open?e.bugTrackerHTML="<a href='"+e.bugTracker.open+"'>open bugs</a>":e.bugTracker.new&&(e.bugTrackerHTML="<a href='"+e.bugTracker.new+"'>file a bug</a>"));e.copyrightStart&&e.copyrightStart==e.publishYear&&(e.copyrightStart="");for(var a in g)b[a]||(b[a]=g[a]);e.longStatus=b[e.specStatus],e.textStatus=g[e.specStatus],m[e.specStatus]&&(e.rdfStatus=m[e.specStatus]);e.showThisVersion=!e.isNoTrack||e.isTagFinding,e.showPreviousVersion="FPWD"!==e.specStatus&&"FPLC"!==e.specStatus&&"ED"!==e.specStatus&&!e.isNoTrack&&!e.isSubmission,/NOTE$/.test(e.specStatus)&&!e.prevVersion&&(e.showPreviousVersion=!1);e.isTagFinding&&(e.showPreviousVersion=!!e.previousPublishDate);e.notYetRec=e.isRecTrack&&"REC"!==e.specStatus,e.isRec=e.isRecTrack&&"REC"===e.specStatus,e.isRec&&!e.errata&&(0,r.pub)("error","Recommendations must have an errata link.");e.notRec="REC"!==e.specStatus,e.prependW3C=!1,e.isED="ED"===e.specStatus,e.isCR="CR"===e.specStatus,e.isPR="PR"===e.specStatus,e.isPER="PER"===e.specStatus,e.isMO="MO"===e.specStatus,e.isNote=["FPWD-NOTE","WG-NOTE"].includes(e.specStatus),e.isIGNote="IG-NOTE"===e.specStatus,e.dashDate=t.ISODate.format(e.publishDate),e.publishISODate=e.publishDate.toISOString(),e.shortISODate=t.ISODate.format(e.publishDate),Object.defineProperty(e,"wgId",{get(){if(!this.hasOwnProperty("wgPatentURI"))return"";const e=this.wgPatentURI.split("/"),t=e.findIndex(e=>"pp-impl"===e)+1;return e[t]||""}});const s=(e.isCGBG?c.default:u.default)(e);document.body.insertBefore(s,document.body.firstChild),document.body.classList.add("h-entry");var l=document.getElementById("sotd")||document.createElement("section");!e.isCGBG&&e.isNoTrack&&!e.isTagFinding||l.id||(0,r.pub)("error","A custom SotD paragraph is required for your type of document.");l.id=l.id||"sotd",l.classList.add("introductory");var d=[e.wg,e.wgURI,e.wgPatentURI];d.some(e=>Array.isArray(e))&&!d.every(e=>Array.isArray(e))&&(0,r.pub)("error","If one of '`wg`', '`wgURI`', or '`wgPatentURI`' is an array, they all have to be.");e.isCGBG&&!e.wg&&(0,r.pub)("error","[`wg`](https://github.com/w3c/respec/wiki/wg) configuration option is required for this kind of document.");if(Array.isArray(e.wg)){e.multipleWGs=e.wg.length>1,e.wgHTML=(0,t.joinAnd)(e.wg,function(t,n){return"the <a href='"+e.wgURI[n]+"'>"+t+"</a>"});for(var T=[],S=0,A=e.wg.length;S<A;S++)T.push("a <a href='"+e.wgPatentURI[S]+"' rel='disclosure'>public list of any patent disclosures ("+e.wg[S]+")</a>");e.wgPatentHTML=(0,t.joinAnd)(T)}else e.multipleWGs=!1,e.wgHTML="the <a href='"+e.wgURI+"'>"+e.wg+"</a>";"PR"!==e.specStatus||e.crEnd||(0,r.pub)("error",'`specStatus` is "PR" but no `crEnd` is specified (needed to indicate end of previous CR).');"CR"!==e.specStatus||e.crEnd||(0,r.pub)("error",'`specStatus` is "CR", but no `crEnd` is specified in Respec config.');e.crEnd=E(e,"crEnd"),e.humanCREnd=f.format(e.crEnd),"PR"!==e.specStatus||e.prEnd||(0,r.pub)("error",'`specStatus` is "PR" but no `prEnd` is specified.');e.prEnd=E(e,"prEnd"),e.humanPREnd=f.format(e.prEnd),"PER"!==e.specStatus||e.perEnd||(0,r.pub)("error","Status is PER but no perEnd is specified");e.perEnd=E(e,"perEnd"),e.humanPEREnd=f.format(e.perEnd),e.recNotExpected=!!e.recNotExpected||!e.isRecTrack&&"WD"==e.maturity&&"FPWD-NOTE"!==e.specStatus,e.isIGNote&&!e.charterDisclosureURI&&(0,r.pub)("error","IG-NOTEs must link to charter's disclosure section using `charterDisclosureURI`.");""!==e.subjectPrefix&&(e.subjectPrefixEnc=encodeURIComponent(e.subjectPrefix));!e.implementationReportURI&&e.isCR&&(0,r.pub)("error","CR documents must have an [`implementationReportURI`](https://github.com/w3c/respec/wiki/implementationReportURI) that describes [implementation experience](https://www.w3.org/2018/Process-20180201/#implementation-experience).");!e.implementationReportURI&&e.isPR&&(0,r.pub)("warn","PR documents should include an [`implementationReportURI`](https://github.com/w3c/respec/wiki/implementationReportURI) that describes [implementation experience](https://www.w3.org/2018/Process-20180201/#implementation-experience).");e.isTagFinding&&!e.additionalContent&&(0,r.pub)("warn","ReSpec does not support automated SotD generation for TAG findings, please add the prerequisite content in the 'sotd' section");(0,r.pub)("amend-user-config",{publishISODate:e.publishISODate,generatedSubtitle:`${e.longStatus} ${e.publishHumanDate}`})};d(n),d(i),d(o),d(a);var c=d(s),u=d(l);function d(e){return e&&e.__esModule?e:{default:e}}var p=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="oai/headers";const f=new Intl.DateTimeFormat(["en-GB"],{timeZone:"UTC",year:"numeric",month:"long",day:"2-digit"}),h={FPWD:"WD",LC:"WD",FPLC:"WD","FPWD-NOTE":"NOTE","WD-NOTE":"WD","LC-NOTE":"LC","IG-NOTE":"NOTE","WG-NOTE":"NOTE"},m={NOTE:"w3p:NOTE",WD:"w3p:WD",LC:"w3p:LastCall",CR:"w3p:CR",PR:"w3p:PR",REC:"w3p:REC",PER:"w3p:PER",RSCND:"w3p:RSCND"},g={NOTE:"Working Group Note","WG-NOTE":"Working Group Note","CG-NOTE":"Co-ordination Group Note","IG-NOTE":"Interest Group Note","Member-SUBM":"Member Submission","Team-SUBM":"Team Submission",MO:"Member-Only Document",ED:"Editor's Draft",FPWD:"First Public Working Draft",WD:"Working Draft","FPWD-NOTE":"Working Group Note","WD-NOTE":"Working Draft","LC-NOTE":"Working Draft",FPLC:"First Public and Last Call Working Draft",LC:"Last Call Working Draft",CR:"Candidate Recommendation",PR:"Proposed Recommendation",PER:"Proposed Edited Recommendation",REC:"Recommendation",RSCND:"Rescinded Recommendation",unofficial:"Unofficial Draft",base:"Published",finding:"TAG Finding","draft-finding":"Draft TAG Finding","CG-DRAFT":"Draft Community Group Report","CG-FINAL":"Final Community Group Report","BG-DRAFT":"Draft Business Group Report","BG-FINAL":"Final Business Group Report"},b={"FPWD-NOTE":"First Public Working Group Note","LC-NOTE":"Last Call Working Draft"},y=["FPWD","WD","FPLC","LC","CR","PR","PER","REC"],v=["MO","unofficial","base","finding","draft-finding","CG-DRAFT","CG-FINAL","BG-DRAFT","BG-FINAL"],w=["CG-DRAFT","CG-FINAL","BG-DRAFT","BG-FINAL"],x=["ED","IG-NOTE"],k={cc0:{name:"Creative Commons 0 Public Domain Dedication",short:"CC0",url:"https://creativecommons.org/publicdomain/zero/1.0/"},"w3c-software":{name:"W3C Software Notice and License",short:"W3C Software",url:"https://www.w3.org/Consortium/Legal/2002/copyright-software-20021231"},"w3c-software-doc":{name:"W3C Software and Document Notice and License",short:"W3C Software and Document",url:"https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document"},apache2:{name:"Apache 2.0 License",short:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"},"cc-by":{name:"Creative Commons Attribution 4.0 International Public License",short:"CC-BY",url:"https://creativecommons.org/licenses/by/4.0/legalcode"}},C=Object.freeze({id:"",alt:"",href:"",src:"",height:"48",width:"72"});function E(e,n,i=new Date){const o=e[n]?new Date(e[n]):new Date(i);if(Number.isFinite(o.valueOf())){const e=t.ISODate.format(o);return new Date(e)}const a=`[\`${n}\`](https://github.com/w3c/respec/wiki/${n}) `+`is not a valid date: "${e[n]}". Expected format 'YYYY-MM-DD'.`;return(0,r.pub)("error",a),new Date(t.ISODate.format(new Date))}}),define("w3c/abstract",["exports","core/pubsubhub","core/l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(){const e=document.getElementById("abstract");if(!e)return void(0,t.pub)("error",'Document must have one element with `id="abstract"');e.classList.add("introductory");let r=document.querySelector("#abstract>h2");if(r)return;(r=document.createElement("h2")).innerText=n.l10n[n.lang].abstract,e.insertAdjacentElement("afterbegin",r)};e.name="w3c/abstract"}),define("w3c/templates/conformance",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(()=>{const e=hyperHTML;return e`<h2>Conformance</h2> +<p> + As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, + and notes in this specification are non-normative. Everything else in this specification is + normative. +</p> +<p id='respecRFC2119'> + to be interpreted as described in [[!RFC2119]]. +</p>`})}),define("w3c/conformance",["exports","w3c/templates/conformance","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,r){var o=$("#conformance");o.length&&o.prepend((0,i.default)(e).childNodes);(0,n.pub)("end","w3c/conformance"),r()};var r,i=(r=t)&&r.__esModule?r:{default:r};e.name="w3c/conformance"}),define("core/data-transform",["exports","core/utils"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){Array.from(n.querySelectorAll("[data-transform]")).forEach(e=>{e.innerHTML=(0,t.runTransforms)(e.innerHTML,e.dataset.transform),e.removeAttribute("data-transform")}),r()};e.name="core/data-transform"}),define("core/inlines",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){document.normalize(),e.normativeReferences||(e.normativeReferences=new Set);e.informativeReferences||(e.informativeReferences=new Set);e.respecRFC2119||(e.respecRFC2119={});const n=new Map;for(const e of Array.from(document.querySelectorAll("abbr[title]")))n.set(e.textContent,e.title);const r=[...n.keys()];r.sort((e,t)=>t.length-e.length);const i=r.length?`(?:\\b${r.join("\\b)|(?:\\b")}\\b)`:null,o=window.$.fn.allTextNodes.call([document.body],["pre"]),a=new RegExp("(\\bMUST(?:\\s+NOT)?\\b|\\bSHOULD(?:\\s+NOT)?\\b|\\bSHALL(?:\\s+NOT)?\\b|\\bMAY\\b|\\b(?:NOT\\s+)?REQUIRED\\b|\\b(?:NOT\\s+)?RECOMMENDED\\b|\\bOPTIONAL\\b|(?:\\[\\[(?:!|\\\\)?[A-Za-z0-9\\.-]+\\]\\])"+(i?`|${i}`:"")+")");for(const r of o){const i=r.data.split(a);if(1===i.length)continue;const o=document.createDocumentFragment();for(;i.length;){const a=i.shift();let s=null;if(i.length&&(s=i.shift()),o.appendChild(document.createTextNode(a)),s)if(/MUST(?:\s+NOT)?|SHOULD(?:\s+NOT)?|SHALL(?:\s+NOT)?|MAY|(?:NOT\s+)?REQUIRED|(?:NOT\s+)?RECOMMENDED|OPTIONAL/.test(s))s=s.split(/\s+/).join(" "),o.appendChild(hyperHTML`<em class="rfc2119" title="${s}">${s}</em>`),e.respecRFC2119[s]=!0;else if(/^\[\[/.test(s)){let t=s;if(0===(t=(t=t.replace(/^\[\[/,"")).replace(/\]\]$/,"")).indexOf("\\"))o.appendChild(document.createTextNode(`[[${t.replace(/^\\/,"")}]]`));else{let n=!1;0===t.indexOf("!")&&(n=!0,t=t.replace(/^!/,"")),n?e.normativeReferences.add(t):e.informativeReferences.add(t),o.appendChild(document.createTextNode("[")),o.appendChild(hyperHTML`<cite><a class="bibref" href="${`#bib-${t}`}">${t}</a></cite>`),o.appendChild(document.createTextNode("]"))}}else n.has(s)?"ABBR"===r.parentNode.tagName?o.appendChild(document.createTextNode(s)):o.appendChild(hyperHTML`<abbr title="${n.get(s)}">${s}</abbr>`):(0,t.pub)("error",`Found token '${s}' but it does not correspond to anything`)}r.parentNode.replaceChild(o,r)}};e.name="core/inlines"}),mta=this,nta=function(){var e=[],t=[],n={},r={},i={};function o(e){return"string"==typeof e?new RegExp("^"+e+"$","i"):e}function a(e,t){return e===t?t:e===e.toUpperCase()?t.toUpperCase():e[0]===e[0].toUpperCase()?t.charAt(0).toUpperCase()+t.substr(1).toLowerCase():t.toLowerCase()}function s(e,t){return e.replace(t[0],function(n,r){var i,o,s=(i=t[1],o=arguments,i.replace(/\$(\d{1,2})/g,function(e,t){return o[t]||""}));return a(""===n?e[r-1]:n,s)})}function l(e,t,r){if(!e.length||n.hasOwnProperty(e))return t;for(var i=r.length;i--;){var o=r[i];if(o[0].test(t))return s(t,o)}return t}function c(e,t,n){return function(r){var i=r.toLowerCase();return t.hasOwnProperty(i)?a(r,i):e.hasOwnProperty(i)?a(r,e[i]):l(i,r,n)}}function u(e,t,n,r){return function(r){var i=r.toLowerCase();return!!t.hasOwnProperty(i)||!e.hasOwnProperty(i)&&l(i,i,n)===i}}function d(e,t,n){var r=1===t?d.singular(e):d.plural(e);return(n?t+" ":"")+r}return d.plural=c(i,r,e),d.isPlural=u(i,r,e),d.singular=c(r,i,t),d.isSingular=u(r,i,t),d.addPluralRule=function(t,n){e.push([o(t),n])},d.addSingularRule=function(e,n){t.push([o(e),n])},d.addUncountableRule=function(e){"string"!=typeof e?(d.addPluralRule(e,"$0"),d.addSingularRule(e,"$0")):n[e.toLowerCase()]=!0},d.addIrregularRule=function(e,t){t=t.toLowerCase(),e=e.toLowerCase(),i[e]=t,r[t]=e},[["I","we"],["me","us"],["he","they"],["she","they"],["them","them"],["myself","ourselves"],["yourself","yourselves"],["itself","themselves"],["herself","themselves"],["himself","themselves"],["themself","themselves"],["is","are"],["was","were"],["has","have"],["this","these"],["that","those"],["echo","echoes"],["dingo","dingoes"],["volcano","volcanoes"],["tornado","tornadoes"],["torpedo","torpedoes"],["genus","genera"],["viscus","viscera"],["stigma","stigmata"],["stoma","stomata"],["dogma","dogmata"],["lemma","lemmata"],["schema","schemata"],["anathema","anathemata"],["ox","oxen"],["axe","axes"],["die","dice"],["yes","yeses"],["foot","feet"],["eave","eaves"],["goose","geese"],["tooth","teeth"],["quiz","quizzes"],["human","humans"],["proof","proofs"],["carve","carves"],["valve","valves"],["looey","looies"],["thief","thieves"],["groove","grooves"],["pickaxe","pickaxes"],["whiskey","whiskies"]].forEach(function(e){return d.addIrregularRule(e[0],e[1])}),[[/s?$/i,"s"],[/[^\u0000-\u007F]$/i,"$0"],[/([^aeiou]ese)$/i,"$1"],[/(ax|test)is$/i,"$1es"],[/(alias|[^aou]us|tlas|gas|ris)$/i,"$1es"],[/(e[mn]u)s?$/i,"$1s"],[/([^l]ias|[aeiou]las|[emjzr]as|[iu]am)$/i,"$1"],[/(alumn|syllab|octop|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i,"$1i"],[/(alumn|alg|vertebr)(?:a|ae)$/i,"$1ae"],[/(seraph|cherub)(?:im)?$/i,"$1im"],[/(her|at|gr)o$/i,"$1oes"],[/(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|automat|quor)(?:a|um)$/i,"$1a"],[/(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)(?:a|on)$/i,"$1a"],[/sis$/i,"ses"],[/(?:(kni|wi|li)fe|(ar|l|ea|eo|oa|hoo)f)$/i,"$1$2ves"],[/([^aeiouy]|qu)y$/i,"$1ies"],[/([^ch][ieo][ln])ey$/i,"$1ies"],[/(x|ch|ss|sh|zz)$/i,"$1es"],[/(matr|cod|mur|sil|vert|ind|append)(?:ix|ex)$/i,"$1ices"],[/(m|l)(?:ice|ouse)$/i,"$1ice"],[/(pe)(?:rson|ople)$/i,"$1ople"],[/(child)(?:ren)?$/i,"$1ren"],[/eaux$/i,"$0"],[/m[ae]n$/i,"men"],["thou","you"]].forEach(function(e){return d.addPluralRule(e[0],e[1])}),[[/s$/i,""],[/(ss)$/i,"$1"],[/(wi|kni|(?:after|half|high|low|mid|non|night|[^\w]|^)li)ves$/i,"$1fe"],[/(ar|(?:wo|[ae])l|[eo][ao])ves$/i,"$1f"],[/ies$/i,"y"],[/\b([pl]|zomb|(?:neck|cross)?t|coll|faer|food|gen|goon|group|lass|talk|goal|cut)ies$/i,"$1ie"],[/\b(mon|smil)ies$/i,"$1ey"],[/(m|l)ice$/i,"$1ouse"],[/(seraph|cherub)im$/i,"$1"],[/(x|ch|ss|sh|zz|tto|go|cho|alias|[^aou]us|tlas|gas|(?:her|at|gr)o|ris)(?:es)?$/i,"$1"],[/(analy|ba|diagno|parenthe|progno|synop|the|empha|cri)(?:sis|ses)$/i,"$1sis"],[/(movie|twelve|abuse|e[mn]u)s$/i,"$1"],[/(test)(?:is|es)$/i,"$1is"],[/(alumn|syllab|octop|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i,"$1us"],[/(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|quor)a$/i,"$1um"],[/(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)a$/i,"$1on"],[/(alumn|alg|vertebr)ae$/i,"$1a"],[/(cod|mur|sil|vert|ind)ices$/i,"$1ex"],[/(matr|append)ices$/i,"$1ix"],[/(pe)(rson|ople)$/i,"$1rson"],[/(child)ren$/i,"$1"],[/(eau)x?$/i,"$1"],[/men$/i,"man"]].forEach(function(e){return d.addSingularRule(e[0],e[1])}),["adulthood","advice","agenda","aid","alcohol","ammo","anime","athletics","audio","bison","blood","bream","buffalo","butter","carp","cash","chassis","chess","clothing","cod","commerce","cooperation","corps","debris","diabetes","digestion","elk","energy","equipment","excretion","expertise","flounder","fun","gallows","garbage","graffiti","headquarters","health","herpes","highjinks","homework","housework","information","jeans","justice","kudos","labour","literature","machinery","mackerel","mail","media","mews","moose","music","manga","news","pike","plankton","pliers","pollution","premises","rain","research","rice","salmon","scissors","series","sewage","shambles","shrimp","species","staff","swine","tennis","traffic","transporation","trout","tuna","wealth","welfare","whiting","wildebeest","wildlife","you",/[^aeiou]ese$/i,/deer$/i,/fish$/i,/measles$/i,/o[iu]s$/i,/pox$/i,/sheep$/i].forEach(d.addUncountableRule),d},"function"==typeof require&&"object"==typeof exports&&"object"==typeof module?module.exports=nta():"function"==typeof define&&define.amd?define("deps/pluralize",[],function(){return nta()}):mta.pluralize=nta(),define("core/dfn",["exports","deps/pluralize","core/utils"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){e.hasOwnProperty("definitionMap")||(e.definitionMap=Object.create(null));let r;!0===e.pluralize&&(r=function(){const e=new Set;document.querySelectorAll("a:not([href])").forEach(t=>{const r=(0,n.norm)(t.textContent).toLowerCase();e.add(r),t.dataset.lt&&e.add(t.dataset.lt)});const r=new Set;return document.querySelectorAll("dfn:not([data-lt-noDefault])").forEach(e=>{const t=(0,n.norm)(e.textContent).toLowerCase();r.add(t),e.dataset.lt&&e.dataset.lt.split("|").reduce((e,t)=>e.add(t),r)}),function(n){const i=(0,t.plural)(n);return e.has(i)&&!r.has(i)?i:""}}());document.querySelectorAll("dfn").forEach(t=>{const i=t.closest("[data-dfn-for]");i&&i!==t&&!t.dataset.dfnFor&&(t.dataset.dfnFor=i.dataset.dfnFor),t.dataset.dfnFor&&(t.dataset.dfnFor=t.dataset.dfnFor.toLowerCase());const o=$(t),a=o.getDfnTitles({isDefinition:!0});if(r&&!t.hasAttribute("data-lt-no-plural")&&!t.hasAttribute("data-lt-noDefault")){const e=(0,n.norm)(t.textContent).toLowerCase(),i=r(e);i&&(a[0]===e?a.unshift(i):a.push(i),t.dataset.lt=a.filter(t=>t!==e).join("|"))}a.map(t=>(e.definitionMap[t]||(e.definitionMap[t]=[]),e.definitionMap[t])).reduce((e,t)=>(t.push(e),e),o)})};e.name="core/dfn"}),define("w3c/rfc2119",["exports","core/utils"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){const i=n.getElementById("respecRFC2119");if(!i)return r();const o=Object.getOwnPropertyNames(e.respecRFC2119);if(0===o.length)return i.remove(),r();const a=(0,t.joinAnd)(o.sort(),e=>`<em class="rfc2119">${e}</em>`),s=o.length>1,l=`The key word${s?"s ":" "} ${a} ${s?"are":"is"} ${i.innerHTML}`;i.innerHTML=l,r()};e.name="w3c/rfc2119"}),define("deps/text!core/css/examples.css",[],function(){return"/* --- EXAMPLES --- */\ndiv.example-title {\n min-width: 7.5em;\n color: #b9ab2d;\n}\ndiv.example-title span {\n text-transform: uppercase;\n}\naside.example, div.example, div.illegal-example {\n padding: 0.5em;\n margin: 1em 0;\n position: relative;\n clear: both;\n}\ndiv.illegal-example { color: red }\ndiv.illegal-example p { color: black }\naside.example, div.example {\n padding: .5em;\n border-left-width: .5em;\n border-left-style: solid;\n border-color: #e0cb52;\n background: #fcfaee;\n}\n\naside.example div.example {\n border-left-width: .1em;\n border-color: #999;\n background: #fff;\n}\naside.example div.example div.example-title {\n color: #999;\n}\n"}),define("core/examples",["exports","core/pubsubhub","deps/text!core/css/examples.css"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){var a=$("pre.example, pre.illegal-example, aside.example"),s=0;a.length&&($(n).find("head link").first().before($("<style/>").text(i.default)),a.each(function(n,r){var i=$(r),a={number:s,illegal:i.hasClass("illegal-example")};if(i.is("aside")){var l=o(e,i,++s,a);i.prepend(l),(0,t.pub)("example",a)}else{var c=!!i.parents("aside").length;c||s++;for(var u=i.html().split("\n");u.length&&/^\s*$/.test(u[0]);)u.shift();for(;u.length&&/^\s*$/.test(u[u.length-1]);)u.pop();var d=/^(\s+)/.exec(u[0]);if(d)for(var p=new RegExp("^"+d[1]),f=0;f<u.length;f++)u[f]=u[f].replace(p,"");a.content=u.join("\n"),i.html(u.join("\n")),i.removeClass("example illegal-example");var h=$("<div class='example'></div>"),l=o(e,i,c?0:s,a);h.append(l),h.append(i.clone()),i.replaceWith(h),c||(0,t.pub)("example",a)}}));r()};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/examples";var o=function(e,t,n,r){var i=n>0?" "+n:"",o=$(`<div class='example-title'><span>${e.l10n.example}${i}</span></div>`);return r.title=t.attr("title"),r.title&&(o.append($("<span style='text-transform: none'>: "+r.title+"</span>")),t.removeAttr("title")),o.addClass("marker"),o}}),define("deps/text!core/css/issues-notes.css",[],function(){return'/* --- ISSUES/NOTES --- */\ndiv.issue-title, div.note-title , div.ednote-title, div.warning-title {\n padding-right: 1em;\n min-width: 7.5em;\n color: #b9ab2d;\n}\ndiv.issue-title { color: #e05252; }\ndiv.note-title, div.ednote-title { color: #2b2; }\ndiv.warning-title { color: #f22; }\ndiv.issue-title span, div.note-title span, div.ednote-title span, div.warning-title span {\n text-transform: uppercase;\n}\ndiv.note, div.issue, div.ednote, div.warning {\n margin-top: 1em;\n margin-bottom: 1em;\n}\n.note > p:first-child, .ednote > p:first-child, .issue > p:first-child, .warning > p:first-child { margin-top: 0 }\n.issue, .note, .ednote, .warning {\n padding: .5em;\n border-left-width: .5em;\n border-left-style: solid;\n}\ndiv.issue, div.note , div.ednote, div.warning {\n padding: 1em 1.2em 0.5em;\n margin: 1em 0;\n position: relative;\n clear: both;\n}\nspan.note, span.ednote, span.issue, span.warning { padding: .1em .5em .15em; }\n\n.issue {\n border-color: #e05252;\n background: #fbe9e9;\n}\n.note, .ednote {\n border-color: #52e052;\n background: #e9fbe9;\n}\n\n.warning {\n border-color: #f11;\n border-width: .2em;\n border-style: solid;\n background: #fbe9e9;\n}\n\n.warning-title:before{\n content: "⚠"; /*U+26A0 WARNING SIGN*/\n font-size: 3em;\n float: left;\n height: 100%;\n padding-right: .3em;\n vertical-align: top;\n margin-top: -0.5em;\n}\n\nli.task-list-item {\n list-style: none;\n}\n\ninput.task-list-item-checkbox {\n margin: 0 0.35em 0.25em -1.6em;\n vertical-align: middle;\n}\n\n.issue a.respec-gh-label {\n padding: 5px;\n margin: 0 2px 0 2px;\n font-size: 10px;\n text-transform: none;\n text-decoration: none;\n font-weight: bold;\n border-radius: 4px;\n position: relative;\n bottom: 2px;\n}\n\n.issue a.respec-label-dark {\n color: #fff;\n background-color: #000;\n}\n\n.issue a.respec-label-light {\n color: #000;\n background-color: #fff;\n}\n'}),define("core/issues-notes",["exports","core/pubsubhub","deps/text!core/css/issues-notes.css","core/utils","deps/hyperhtml"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){const n=document.querySelectorAll(".issue, .note, .warning, .ednote");if(!n.length)return;const i=e.githubAPI?await async function(e){const{githubAPI:n,githubUser:i,githubToken:o}=e,a=document.querySelectorAll(".issue[data-number]");if(a.length>s){const e=`Your spec contains ${a.length} Github issues, `+`but GitHub only allows ${s} requests. Some issues might not show up.`;(0,t.pub)("warning",e)}const l=[...a].map(e=>Number.parseInt(e.dataset.number,10)).filter(e=>e).map(async e=>{const a=`${n}/issues/${e}`,s={Accept:"application/vnd.github.v3.html+json"};if(i&&o){const e=btoa(`${i}:${o}`),t=`Basic ${e}`;Object.assign(s,{Authorization:t})}const l=new Request(a,{headers:s}),c=await(0,r.fetchAndCache)(l);return async function(e,n){const r={title:"",number:n,state:"",message:""};try{const t=await e.json();Object.assign(r,t)}catch(e){r.message=`Error JSON parsing issue #${n} from GitHub.`}if(!e.ok||r.message){const i=`Error fetching issue #${n} from GitHub. ${r.message} (HTTP Status ${e.status}).`;(0,t.pub)("error",i)}return[n,r]}(c,e)}),c=await Promise.all(l);return new Map(c)}(e):new Map,{head:c}=document;c.insertBefore(hyperHTML`<style>${[o.default]}</style>`,c.querySelector("link")),function(e,n,r){const i=$(e),{issueBase:o,githubAPI:s}=r;var c=!!document.querySelector(".issue[data-number]"),u=0,d=$("<div><h2>"+r.l10n.issue_summary+"</h2><ul></ul></div>"),p=d.find("ul");s&&Array.from(i).filter(({dataset:{number:e}})=>void 0!==e&&"closed"===n.get(Number(e)).state).forEach(e=>{const{dataset:{number:n}}=e,r=`Github issue ${n} was closed on GitHub, so removing from spec`;(0,t.pub)("warn",r),e.remove()});i.filter((e,t)=>t.parentNode).each(function(e,i){var d=$(i),f=d.hasClass("issue"),h=d.hasClass("warning"),m=d.hasClass("ednote"),g=d.hasClass("atrisk"),b="span"===d[0].localName,y=d.attr("data-number"),v={inline:b};if(v.type=f?"issue":h?"warning":m?"ednote":"note",!f||b||c?y&&(v.number=y):(u++,v.number=u),!b){var w,x=$("<div class='"+v.type+(g?" atrisk":"")+"'></div>"),k=$("<div role='heading' class='"+v.type+"-title'><span></span></div>"),C=f?g?r.l10n.feature_at_risk:r.l10n.issue:h?r.l10n.warning:m?r.l10n.editors_note:r.l10n.note;if(i.id?(x[0].id=i.id,i.removeAttribute("id")):x.makeID("issue-container",v.number?`number-${v.number}`:""),k.makeID("h",v.type),v.title=d.attr("title"),f&&(c?y&&(C+=" "+y,!g&&o?k.find("span").wrap($("<a href='"+o+y+"'/>")):g&&r.atRiskBase&&k.find("span").wrap($("<a href='"+r.atRiskBase+y+"'/>")),(w=n.get(Number(y)))&&!v.title&&(v.title=w.title)):C+=" "+u,void 0!==v.number)){var E=$("<li><a></a></li>");E.find("a").attr("href","#"+x[0].id).text(r.l10n.issue+" "+v.number),v.title&&E.append($("<span style='text-transform: none'>: "+v.title+"</span>")),p.append(E)}if(k.find("span").text(C),w&&v.title&&s){const e=Array.from(w.labels).map(e=>{const t=new URL("issues/",r.github.repoURL+"/");return t.searchParams.set("q",`is:issue is:open label:"${e.name}"`),a({},e,{href:t.href})}).map(l).reduce((e,t)=>(e.appendChild(t),e),document.createDocumentFragment());k.append($("<span style='text-transform: none'>: "+v.title+"</span>").append(e)),d.removeAttr("title")}else v.title&&(k.append($("<span style='text-transform: none'>: "+v.title+"</span>")),d.removeAttr("title"));k.addClass("marker"),x.append(k),d.replaceWith(x);var T=d.removeClass(v.type).removeAttr("data-number");w&&!T.text().trim()&&(T=w.body_html),x.append(T);const e=k.parents("section").length+2;k.attr("aria-level",e)}(0,t.pub)(v.type,v)}),$(".issue").length?$("#issue-summary")&&$("#issue-summary").append(d.contents()):$("#issue-summary").length&&((0,t.pub)("warn","Using issue summary (#issue-summary) but no issues found."),$("#issue-summary").remove())}(n,i,e)};var i,o=(i=n)&&i.__esModule?i:{default:i};var a=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="core/issues-notes";const s=60;function l(e){const{color:t,href:n,name:r}=e,i=parseInt(t,16);var o;return hyperHTML`<a + class="${`respec-gh-label respec-label-${isNaN(i)||.2126*((o=i)>>16&255)+.7152*(o>>8&255)+.0722*(o>>0&255)>140?"light":"dark"}`}" + style="${`background-color: #${t}`}" + href="${n}">${r}</a>`}}),define("core/requirements",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){$(".req").each(function(e){e++;var t=$(this),n="Req. "+e;t.prepend("<a href='#"+t.attr("id")+"'>"+n+"</a>: ")}),$("a.reqRef").each(function(){var e,n,r,i=$(this),o=i.attr("href");o&&(e=o.substring(1),(n=$("#"+e)).length?r=n.find("> a").text():(r="Req. not found '"+e+"'",(0,t.pub)("error","Requirement not found in element `a.reqRef`: "+e)),i.text(r))}),r()};e.name="core/requirements"}),define("deps/text!core/css/bp.css",[],function(){return"/* --- Best Practices --- */\ndiv.practice {\n border: solid #bebebe 1px;\n margin: 2em 1em 1em 2em;\n}\n\nspan.practicelab {\n margin: 1.5em 0.5em 1em 1em;\n font-weight: bold;\n font-style: italic;\n background: #dfffff;\n position: relative;\n padding: 0 0.5em;\n top: -1.5em;\n}\n\np.practicedesc {\n margin: 1.5em 0.5em 1em 1em;\n}\n\n@media screen {\n p.practicedesc {\n position: relative;\n top: -2em;\n padding: 0;\n margin: 1.5em 0.5em -1em 1em;\n }\n}\n"}),define("core/best-practices",["exports","deps/text!core/css/bp.css","core/pubsubhub","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(){let e=0;const t=document.querySelectorAll("span.practicelab"),r=document.createElement("ul");for(const n of Array.from(t)){e++;const t=window.$.fn.makeID.call([n],"bp"),i=hyperHTML`<li><a href="${`#${t}`}">Best Practice ${e}</a>: ${n.textContent}</li>`;r.appendChild(i),n.insertBefore(document.createTextNode(`Best Practice ${e}: `),n.firstChild)}const o=document.getElementById("bp-summary");t.length?(document.head.insertBefore(hyperHTML`<style>${[i.default]}</style>`,document.head.querySelector("link")),o&&(o.appendChild(hyperHTML`<h2>Best Practices Summary</h2>`),o.appendChild(r))):o&&((0,n.pub)("warn","Using best practices summary (#bp-summary) but no best practices found."),o.remove())};var r,i=(r=t)&&r.__esModule?r:{default:r};e.name="core/best-practices"}),define("core/figures",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){i=n,[...i.querySelectorAll(":not(picture)>img:not([width]):not([height]):not([srcset])")].forEach(e=>{e.height=e.naturalHeight,e.width=e.naturalWidth});var i;var o={},a=[],s=0;$("figure").each(function(){var r=$(this),i=r.find("figcaption"),l=i.text(),c=r.makeID("fig",l);i.length||(0,t.pub)("warn","A `<figure>` should contain a `<figcaption>`."),s++,i.wrapInner($("<span class='fig-title'/>")).prepend(n.createTextNode(" ")).prepend($("<span class='figno'>"+s+"</span>")).prepend(n.createTextNode(e.l10n.fig)),o[c]=i.contents();var u=i.clone();u.find("a").renameElement("span").removeAttr("href"),a.push($("<li class='tofline'><a class='tocxref' href='#"+c+"'></a></li>").find(".tocxref").append(u.contents()).end())}),$("a[href]",n).each(function(){var e=$(this),t=e.attr("href");if(t&&(t=t.substring(1),o[t]&&(e.addClass("fig-ref"),""===e.html()))){const n=o[t].slice(0,2).clone();if(!e[0].hasAttribute("title")){const n=o[t].slice(2).clone().text();e.attr("title",n.trim())}e.append(n)}});var l=$("#tof",n);if(a.length&&l.length){l.hasClass("appendix")||l.hasClass("introductory")||l.parents("section").length||(l.prevAll("section.introductory").length===l.prevAll("section").length?l.addClass("introductory"):l.prevAll("appendix").length&&l.addClass("appendix")),l.append($("<h2>"+e.l10n.table_of_fig+"</h2>")),l.append($("<ul class='tof'/>"));for(var c=l.find("ul");a.length;)c.append(a.shift())}r()};e.name="core/figures"}),(()=>{const e={float:/-?(?=[0-9]*\.|[0-9]+[eE])(([0-9]+\.[0-9]*|[0-9]*\.[0-9]+)([Ee][-+]?[0-9]+)?|[0-9]+[Ee][-+]?[0-9]+)/y,integer:/-?(0([Xx][0-9A-Fa-f]+|[0-7]*)|[1-9][0-9]*)/y,identifier:/[A-Z_a-z][0-9A-Z_a-z-]*/y,string:/"[^"]*"/y,whitespace:/[\t\n\r ]+/y,comment:/((\/(\/.*|\*([^*]|\*[^\/])*\*\/)[\t\n\r ]*)+)/y,other:/[^\t\n\r 0-9A-Z_a-z]/y};function t(t,n,r,i){const o=e[n];o.lastIndex=r;const a=o.exec(t);return a?(i.push({type:n,value:a[0]}),o.lastIndex):-1}class n{constructor(e,t,n,r){this.message=e,this.line=t,this.input=n,this.tokens=r}toString(){return`${this.message}, line ${this.line} (tokens: '${this.input}')\n${JSON.stringify(this.tokens,null,4)}`}}function r(e,t){let r=1;e=e.slice();const i=new Map;let o=null;const a="float",s="integer",l="identifier",c="string",u="other",d=Object.freeze({type:"operation",getter:!1,setter:!1,deleter:!1,static:!1,stringifier:!1}),p=Object.freeze({sequence:!1,generic:null,nullable:!1,union:!1,idlType:null,extAttrs:[]});function f(t){let i="",a=0;for(;a<5&&e.length>a;)i+=e[a].value,a++;let s;throw s=o?`Got an error during or right after parsing \`${o.partial?"partial ":""}${o.type} ${o.name}\`: ${t}`:`Got an error before parsing any named definition: ${t}`,new n(s,r,i,e.slice(0,5))}function h(e,t){return i.has(e)&&f(`The name "${e}" of type "${i.get(e)}" is already seen`),i.set(e,t),e}let m=null;function g(t,n){if(e.length&&e[0].type===t)return void 0===n||e[0].value===n?(m=e.shift(),t===l&&m.value.startsWith("_")&&(m.value=m.value.substring(1)),m):void 0}function b(){if(e.length&&("whitespace"===e[0].type||"comment"===e[0].type)){const t=e.shift();return r+=function(e,t){let n=0;for(let r=e.indexOf(t);-1!==r;r=e.indexOf(t,r+1))++n;return n}(t.value,"\n"),t}}const y={ws:/([\t\n\r ]+)/y,"line-comment":/\/\/(.*)\r?\n?/y,"multiline-comment":/\/\*((?:[^*]|\*[^/])*)\*\//y};function v(e,t){const n={type:"whitespace",value:""};for(;;){const e=b();if(!e)break;n.value+=e.value}if(n.value.length>0){if(e){let r=n.value,i=0;for(;i<r.length;){let n=!1;for(let o in y){const a=y[o];a.lastIndex=i;const s=a.exec(r);if(s){e.push({type:o+(t?"-"+t:""),value:s[1]}),n=!0,i=a.lastIndex;break}}if(!n)throw new Error("Surprising white space construct.")}}return n}}function w(){const e=function(){let e="";return v(),g(l,"unsigned")&&(e="unsigned "),v(),g(l,"short")?e+"short":g(l,"long")?(e+="long",v(),g(l,"long")?e+" long":e):void(e&&f("Failed to parse integer type"))}()||function(){let e="";return v(),g(l,"unrestricted")&&(e="unrestricted "),v(),g(l,"float")?e+"float":g(l,"double")?e+"double":void(e&&f("Failed to parse float type"))}();return e||(v(),g(l,"boolean")?"boolean":g(l,"byte")?"byte":g(l,"octet")?"octet":void 0)}function x(){if(g(l,"true"))return{type:"boolean",value:!0};if(g(l,"false"))return{type:"boolean",value:!1};if(g(l,"null"))return{type:"null"};if(g(l,"Infinity"))return{type:"Infinity",negative:!1};if(g(l,"NaN"))return{type:"NaN"};const t=g(a)||g(s);if(t)return{type:"number",value:t.value};const n=g(u,"-");if(n){if(g(l,"Infinity"))return{type:"Infinity",negative:!0};e.unshift(n)}}function k(e){for(;;){if(v(),!g(u,"?"))return;e.nullable&&f("Can't nullable more than once"),e.nullable=!0}}function C(e){const t=w(),n=Object.assign({type:e||null},p);let r,i;if(t)n.idlType=t;else{if(!(r=g(l)))return;if(i=r.value,v(),g(u,"<")){"sequence"===i&&(n.sequence=!0),n.generic=i;const t=[];do{v(),t.push($(e)||f("Error parsing generic type "+i)),v()}while(g(u,","));return"sequence"===i?1!==t.length&&f("A sequence must have exactly one subtype"):"record"===i?(2!==t.length&&f("A record must have exactly two subtypes"),/^(DOMString|USVString|ByteString)$/.test(t[0].idlType)||f("Record key must be DOMString, USVString, or ByteString"),t[0].extAttrs.length&&f("Record key cannot have extended attribute")):"Promise"===i&&t[0].extAttrs.length&&f("Promise type cannot have extended attribute"),n.idlType=1===t.length?t[0]:t,v(),g(u,">")||f("Unterminated generic type "+i),k(n),n}n.idlType=i}return k(n),n.nullable&&"any"===n.idlType&&f("Type any cannot be made nullable"),n}function E(e){if(v(),!g(u,"("))return;const t=Object.assign({type:e||null},p,{union:!0,idlType:[]}),n=$()||f("Union type with no content");for(t.idlType.push(n);v(),g(l,"or");){const e=$()||f("No type after 'or' in union type");t.idlType.push(e)}return g(u,")")||f("Unterminated union type"),k(t),t}function $(e){const t=L(),n=C(e)||E(e);return t.length&&n&&(n.extAttrs=t),n}function T(t){const n={optional:!1,variadic:!1};n.extAttrs=L(t),v(t,"pea");const r=g(l,"optional");if(r&&(n.optional=!0,v()),n.idlType=$("argument-type"),!n.idlType)return void(r&&e.unshift(r));const i=m;n.optional||(v(),e.length>=3&&"other"===e[0].type&&"."===e[0].value&&"other"===e[1].type&&"."===e[1].value&&"other"===e[2].type&&"."===e[2].value&&(e.shift(),e.shift(),e.shift(),n.variadic=!0)),v();const o=g(l);if(!o)return r&&e.unshift(r),void e.unshift(i);if(n.name=o.value,n.optional){v();const e=j();void 0!==e&&(n.default=e)}return n}function S(e){const t=[],n=T(e?t:null);if(!n)return t;for(t.push(n);;){if(v(e?t:null),!g(u,","))return t;const n=T(e?t:null)||f("Trailing comma in arguments list");t.push(n)}}function A(e){v();const t=g(l);if(!t)return;const n={name:t.value,arguments:null,type:"extended-attribute",rhs:null};v();const r=g(u,"=");return r&&(v(),n.rhs=g(l)||g(a)||g(s)||g(c)),v(),g(u,"(")&&(r&&!n.rhs?n.rhs={type:"identifier-list",value:function(){const e=[],t=g(l);t?e.push(t.value):f("Expected identifiers but not found");for(;v(),g(u,",");){v();const t=g(l)||f("Trailing comma in identifiers list");e.push(t.value)}return e}()}:n.arguments=S(e),v(),g(u,")")||f("Unexpected token in extended attribute argument list")),r&&!n.rhs&&f("No right hand side to extended attribute assignment"),n}function L(e){const t=[];if(v(e),!g(u,"["))return t;for(t[0]=A(e)||f("Extended attribute with not content"),v();g(u,",");)t.push(A(e)||f("Trailing comma in extended attribute"));return v(),g(u,"]")||f("No end of extended attribute"),t}function j(){if(v(),g(u,"=")){v();const e=x();if(e)return e;if(g(u,"["))return g(u,"]")||f("Default sequence value must be empty"),{type:"sequence",value:[]};{const e=g(c)||f("No value for default");return e.value=e.value.slice(1,-1),e}}}function D(e){if(v(e,"pea"),!g(l,"const"))return;const t={type:"const",nullable:!1};v();let n=w();n||(n=(n=g(l)||f("No type for const")).value),t.idlType=Object.assign({type:"const-type"},p,{idlType:n}),v(),g(u,"?")&&(t.nullable=!0,v());const r=g(l)||f("No name for const");t.name=r.value,v(),g(u,"=")||f("No value assignment for const"),v();const i=x();return i?t.value=i:f("No value for const"),v(),g(u,";")||f("Unterminated const"),t}function _(){if(v(),g(u,":"))return v(),(g(l)||f("No type in inheritance")).value}function N(e,t){v(),e||(e={});const n=g(l);return e.name=n?n.value:null,v(),g(u,"(")||f("Invalid operation"),e.arguments=S(t),v(),g(u,")")||f("Unterminated operation"),v(),g(u,";")||f("Unterminated operation"),e}function R(t){v(t,"pea");const n=[],r={type:"attribute",static:!1,stringifier:!1,inherit:!1,readonly:!1},i=v();if(i&&n.push(i),g(l,"inherit")){(r.static||r.stringifier)&&f("Cannot have a static or stringifier inherit"),r.inherit=!0,n.push(m);const e=v();e&&n.push(e)}if(g(l,"readonly")){r.readonly=!0,n.push(m);const e=v();e&&n.push(e)}const o=P(r);return o||(e=n.concat(e)),o}function P(e){if(!g(l,"attribute"))return;v(),e.idlType=$("attribute-type")||f("No type in attribute"),e.idlType.sequence&&f("Attributes cannot accept sequence types"),"record"===e.idlType.generic&&f("Attributes cannot accept record types"),v();const t=g(l)||f("No name in attribute");return e.name=t.value,v(),g(u,";")||f("Unterminated attribute"),e}function M(){const e=C(t="return-type")||E(t);var t;if(!e){if(g(l,"void"))return"void";f("No return type")}return e}function O(e){v(e,"pea");const t=Object.assign({},d);for(;;)if(v(),g(l,"getter"))t.getter=!0;else if(g(l,"setter"))t.setter=!0;else{if(!g(l,"deleter"))break;t.deleter=!0}return t.getter||t.setter||t.deleter?(v(),t.idlType=M(),N(t,e),t):(t.idlType=M(),v(),N(t,e),t)}function I(e){if(v(e,"pea"),g(l,"static"))return v(),G(e,"static")||V(e,"static")||f("No body in static member")}function q(e){if(v(e,"pea"),g(l,"stringifier"))return v(),g(u,";")?Object.assign({},d,{stringifier:!0}):G(e,"stringifier")||V(e,"stringifier")||f("Unterminated stringifier")}function U(){return g(l,"iterable")?"iterable":g(l,"legacyiterable")?"legacyiterable":g(l,"maplike")?"maplike":g(l,"setlike")?"setlike":void 0}function W(){return g(l,"maplike")?"maplike":g(l,"setlike")?"setlike":void 0}function H(t){v(t,"pea");const n=[],r={type:null,idlType:null,readonly:!1};if(g(l,"readonly")){r.readonly=!0,n.push(m);var i=v();i&&n.push(i)}const o=(r.readonly?W:U)();if(!o)return void(e=n.concat(e));const a="maplike"===o,s=a||"iterable"===o;return r.type=o,"maplike"!==r.type&&"setlike"!==r.type&&delete r.readonly,v(),g(u,"<")?(r.idlType=[$()]||f(`Error parsing ${o} declaration`),v(),s&&(g(u,",")?(v(),r.idlType.push($()),v()):a&&f(`Missing second type argument in ${o} declaration`)),g(u,">")||f(`Unterminated ${o} declaration`),v(),g(u,";")||f(`Missing semicolon after ${o} declaration`)):f(`Error parsing ${o} declaration`),r}function B(e,n,r="interface"){v();const i=g(l)||f("No name for interface"),a=[],s=o={type:r,name:e?i.value:h(i.value,"interface"),partial:e,members:a};for(e||(s.inheritance=_()||null),v(),g(u,"{")||f("Bodyless interface");;){if(v(n?a:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after interface"),s;const e=L(n?a:null);v();const r=D(n?a:null);if(r){r.extAttrs=e,s.members.push(r);continue}const i=t.allowNestedTypedefs&&Z(n?a:null)||I(n?a:null)||q(n?a:null)||H(n?a:null)||R(n?a:null)||O(n?a:null)||f("Unknown member");i.extAttrs=e,s.members.push(i)}}function F(e,t){if(v(e?null:t,"pea"),g(l,"interface"))return function(e,t){if(v(),!g(l,"mixin"))return;v();const n=g(l)||f("No name for interface mixin"),r=[],i=o={type:"interface mixin",name:e?n.value:h(n.value,"interface mixin"),partial:e,members:r};for(v(),g(u,"{")||f("Bodyless interface mixin");;){if(v(t?r:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after interface mixin"),i;const e=L(t?r:null);v();const n=D(t?r:null);if(n){n.extAttrs=e,i.members.push(n);continue}const o=q(t?r:null)||G(t?r:null)||V(t?r:null)||f("Unknown member");o.extAttrs=e,i.members.push(o)}}(e,t)||B(e,t)||f("Interface has no proper body")}function z(e,t){if(v(e?null:t,"pea"),!g(l,"namespace"))return;v();const n=g(l)||f("No name for namespace"),r=[],i=o={type:"namespace",name:e?n.value:h(n.value,"namespace"),partial:e,members:r};for(v(),g(u,"{")||f("Bodyless namespace");;){if(v(t?r:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after namespace"),i;const e=L(t?r:null);v();const n=G(t?r:null)||V(t?r:null)||f("Unknown member");n.extAttrs=e,i.members.push(n)}}function G(t,n){const r=v(t,"pea"),i=[],o={type:"attribute",static:!1,stringifier:!1,inherit:!1,readonly:!1};if(n&&(o[n]=!0),r&&i.push(r),g(l,"readonly")){o.readonly=!0,i.push(m);const e=v();e&&i.push(e)}const a=P(o);return a||(e=i.concat(e)),a}function V(e,t){v(e,"pea");const n=Object.assign({},d);return t&&(n[t]=!0),n.idlType=M(),N(n,e)}function X(e,t){if(v(e?null:t,"pea"),!g(l,"dictionary"))return;v();const n=g(l)||f("No name for dictionary"),r=[],i=o={type:"dictionary",name:e?n.value:h(n.value,"dictionary"),partial:e,members:r};for(e||(i.inheritance=_()||null),v(),g(u,"{")||f("Bodyless dictionary");;){if(v(t?r:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after dictionary"),i;const e=L(t?r:null);v(t?r:null,"pea");const n=g(l,"required"),o=$("dictionary-type")||f("No type for dictionary member");v();const a=g(l)||f("No name for dictionary member"),s=j();n&&s&&f("Required member must not have a default");const c={type:"field",name:a.value,required:!!n,idlType:o,extAttrs:e};void 0!==s&&(c.default=s),i.members.push(c),v(),g(u,";")||f("Unterminated dictionary member")}}function Z(e){if(v(e,"pea"),!g(l,"typedef"))return;const t={type:"typedef"};v(),t.idlType=$("typedef-type")||f("No type in typedef"),v();const n=g(l)||f("No name in typedef");return t.name=h(n.value,"typedef"),o=t,v(),g(u,";")||f("Unterminated typedef"),t}function Y(t){return function(e){let t;if(v(e,"pea"),!g(l,"callback"))return;if(v(),g(l,"interface"))return t=B(!1,e,"callback interface");const n=g(l)||f("No name for callback");return t=o={type:"callback",name:h(n.value,"callback")},v(),g(u,"=")||f("No assignment in callback"),v(),t.idlType=M(),v(),g(u,"(")||f("No arguments in callback"),t.arguments=S(e),v(),g(u,")")||f("Unterminated callback"),v(),g(u,";")||f("Unterminated callback"),t}(t)||F(!1,t)||function(e){if(v(e,"pea"),!g(l,"partial"))return;return X(!0,e)||F(!0,e)||z(!0,e)||f("Partial doesn't apply to anything")}(t)||X(!1,t)||function(e){if(v(e,"pea"),!g(l,"enum"))return;v();const t=g(l)||f("No name for enum"),n=[],r=o={type:"enum",name:h(t.value,"enum"),values:n};v(),g(u,"{")||f("No curly for enum");let i=!1;for(;;){if(v(e?n:null),g(u,"}"))return v(),g(u,";")||f("No semicolon after enum"),r;const t=g(c)||f("Unexpected value in enum");t.value=t.value.slice(1,-1),r.values.push(t),v(e?n:null),g(u,",")?(e&&n.push({type:","}),v(e?n:null),i=!0):i=!1}}(t)||Z(t)||function(t){v(t,"pea");const n=g(l);if(!n)return;const r=v();if(g(l,"implements")){const e={type:"implements",target:n.value};v();const t=g(l)||f("Incomplete implements statement");return e.implements=t.value,v(),g(u,";")||f("No terminating ; for implements statement"),e}r&&e.unshift(r),e.unshift(n)}(t)||function(t){v(t,"pea");const n=g(l);if(!n)return;const r=v();if(g(l,"includes")){const e={type:"includes",target:n.value};v();const t=g(l)||f("Incomplete includes statement");return e.includes=t.value,v(),g(u,";")||f("No terminating ; for includes statement"),e}r&&e.unshift(r),e.unshift(n)}(t)||z(!1,t)}const Q=function(t){if(!e.length)return[];const n=[];for(;;){const e=L(t?n:null),r=Y(t?n:null);if(!r){e.length&&f("Stray extended attributes");break}r.extAttrs=e,n.push(r)}return n}(t.ws);return e.length&&f("Unrecognised tokens"),Q}const i={parse:(e,n)=>(n||(n={}),r(function(e){const n=[];let r=0;for(;r<e.length;){const i=e.charAt(r);let o=-1;if(/[-0-9.]/.test(i)?(-1===(o=t(e,"float",r,n))&&(o=t(e,"integer",r,n)),-1===o&&(o=t(e,"other",r,n))):/[A-Z_a-z]/.test(i)?o=t(e,"identifier",r,n):'"'===i?-1===(o=t(e,"string",r,n))&&(o=t(e,"other",r,n)):/[\t\n\r ]/.test(i)?o=t(e,"whitespace",r,n):"/"===i?-1===(o=t(e,"comment",r,n))&&(o=t(e,"other",r,n)):o=t(e,"other",r,n),-1===o)throw new Error("Token stream not progressing");r=o}return n}(e),n))};"undefined"!=typeof module&&void 0!==module.exports?module.exports=i:"function"==typeof define&&define.amd?define("deps/webidl2",[],()=>i):(self||window).WebIDL2=i})(),define("deps/text!core/css/webidl.css",[],function(){return'/* --- WEB IDL --- */\n\npre.idl {\n padding: 1em;\n}\n\n.respec-idl-separator {\n padding: 0 0 0.4cm 0;\n}\n\n.respec-idl-separator:last-child {\n padding: 0;\n}\n\n@media print {\n pre.idl {\n white-space: pre-wrap;\n }\n}\n\npre.idl::before {\n content: "WebIDL";\n display: block;\n width: 150px;\n background: #90b8de;\n color: #fff;\n font-family: sans-serif;\n font-weight: bold;\n margin: -1em 0 1em -1em;\n height: 28px;\n line-height: 28px; \n}\n\n.idlType {\n color: #ff4500;\n font-weight: bold;\n text-decoration: none;\n}\n\n\n/*.idlModule*/\n\n\n/*.idlModuleID*/\n\n\n/*.idlInterface*/\n\n.idlInterfaceID,\n.idlDictionaryID,\n.idlCallbackID,\n.idlEnumID {\n font-weight: bold;\n color: #005a9c;\n}\n\na.idlEnumItem {\n color: #000;\n border-bottom: 1px dotted #ccc;\n text-decoration: none;\n}\n\n.idlSuperclass {\n font-style: italic;\n color: #005a9c;\n}\n\n\n/*.idlAttribute*/\n\n.idlAttrType,\n.idlFieldType,\n.idlMemberType {\n color: #005a9c;\n}\n\n.idlAttrName,\n.idlFieldName,\n.idlMemberName {\n color: #ff4500;\n}\n\n.idlAttrName a,\n.idlFieldName a,\n.idlMemberName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlMethod*/\n\n.idlMethType,\n.idlCallbackType {\n color: #005a9c;\n}\n\n.idlMethName {\n color: #ff4500;\n}\n\n.idlMethName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlCtor*/\n\n.idlCtorName {\n color: #ff4500;\n}\n\n.idlCtorName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlParam*/\n\n.idlParamType {\n color: #005a9c;\n}\n\n.idlParamName,\n.idlDefaultValue {\n font-style: italic;\n}\n\n.extAttr {\n color: #666;\n}\n\n\n/*.idlSectionComment*/\n\n.idlSectionComment {\n color: gray;\n}\n\n\n/*.idlIterable*/\n\n.idlIterableKeyType,\n.idlIterableValueType {\n color: #005a9c;\n}\n\n\n/*.idlMaplike*/\n\n.idlMaplikeKeyType,\n.idlMaplikeValueType {\n color: #005a9c;\n}\n\n\n/*.idlConst*/\n\n.idlConstType {\n color: #005a9c;\n}\n\n.idlConstName {\n color: #ff4500;\n}\n\n.idlConstName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlException*/\n\n.idlExceptionID {\n font-weight: bold;\n color: #c00;\n}\n\n.idlTypedefID,\n.idlTypedefType {\n color: #005a9c;\n}\n\n.idlRaises,\n.idlRaises a.idlType,\n.idlRaises a.idlType code,\n.excName a,\n.excName a code {\n color: #c00;\n font-weight: normal;\n}\n\n.excName a {\n font-family: monospace;\n}\n\n.idlRaises a.idlType,\n.excName a.idlType {\n border-bottom: 1px dotted #c00;\n}\n\n.excGetSetTrue,\n.excGetSetFalse,\n.prmNullTrue,\n.prmNullFalse,\n.prmOptTrue,\n.prmOptFalse {\n width: 45px;\n text-align: center;\n}\n\n.excGetSetTrue,\n.prmNullTrue,\n.prmOptTrue {\n color: #0c0;\n}\n\n.excGetSetFalse,\n.prmNullFalse,\n.prmOptFalse {\n color: #c00;\n}\n\n.idlImplements a, .idlIncludes a {\n font-weight: bold;\n}\n\ndl.attributes,\ndl.methods,\ndl.constants,\ndl.constructors,\ndl.fields,\ndl.dictionary-members {\n margin-left: 2em;\n}\n\n.attributes dt,\n.methods dt,\n.constants dt,\n.constructors dt,\n.fields dt,\n.dictionary-members dt {\n font-weight: normal;\n}\n\n.attributes dt code,\n.methods dt code,\n.constants dt code,\n.constructors dt code,\n.fields dt code,\n.dictionary-members dt code {\n font-weight: bold;\n color: #000;\n font-family: monospace;\n}\n\n.attributes dt code,\n.fields dt code,\n.dictionary-members dt code {\n background: #ffffd2;\n}\n\n.attributes dt .idlAttrType code,\n.fields dt .idlFieldType code,\n.dictionary-members dt .idlMemberType code {\n color: #005a9c;\n background: transparent;\n font-family: inherit;\n font-weight: normal;\n font-style: italic;\n}\n\n.methods dt code {\n background: #d9e6f8;\n}\n\n.constants dt code {\n background: #ddffd2;\n}\n\n.constructors dt code {\n background: #cfc;\n}\n\n.attributes dd,\n.methods dd,\n.constants dd,\n.constructors dd,\n.fields dd,\n.dictionary-members dd {\n margin-bottom: 1em;\n}\n\ntable.parameters,\ntable.exceptions {\n border-spacing: 0;\n border-collapse: collapse;\n margin: 0.5em 0;\n width: 100%;\n}\n\ntable.parameters {\n border-bottom: 1px solid #90b8de;\n}\n\ntable.exceptions {\n border-bottom: 1px solid #deb890;\n}\n\n.parameters th,\n.exceptions th {\n color: inherit;\n padding: 3px 5px;\n text-align: left;\n font-weight: normal;\n}\n\n.parameters th {\n color: #fff;\n background: #005a9c;\n}\n\n.exceptions th {\n background: #deb890;\n}\n\n.parameters td,\n.exceptions td {\n padding: 3px 10px;\n border-top: 1px solid #ddd;\n vertical-align: top;\n}\n\n.parameters tr:first-child td,\n.exceptions tr:first-child td {\n border-top: none;\n}\n\n.parameters td.prmName,\n.exceptions td.excName,\n.exceptions td.excCodeName {\n width: 100px;\n}\n\n.parameters td.prmType {\n width: 120px;\n}\n\ntable.exceptions table {\n border-spacing: 0;\n border-collapse: collapse;\n width: 100%;\n}\n\n.respec-button-copy-paste:focus {\n text-decoration: none;\n border-color: #51a7e8;\n outline: none;\n box-shadow: 0 0 5px rgba(81, 167, 232, 0.5);\n}\n\n.respec-button-copy-paste:focus:hover,\n.respec-button-copy-paste.selected:focus {\n border-color: #51a7e8;\n}\n\n.respec-button-copy-paste:hover,\n.respec-button-copy-paste:active,\n.respec-button-copy-paste.zeroclipboard-is-hover,\n.respec-button-copy-paste.zeroclipboard-is-active {\n text-decoration: none;\n background-color: #ddd;\n background-image: linear-gradient(#eee, #ddd);\n border-color: #ccc;\n}\n\n.respec-button-copy-paste:active,\n.respec-button-copy-paste.selected,\n.respec-button-copy-paste.zeroclipboard-is-active {\n background-color: #dcdcdc;\n background-image: none;\n border-color: #b5b5b5;\n box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15)\n}\n\n.respec-button-copy-paste.selected:hover {\n background-color: #cfcfcf;\n}\n\n.respec-button-copy-paste:disabled,\n.respec-button-copy-paste:disabled:hover,\n.respec-button-copy-paste.disabled,\n.respec-button-copy-paste.disabled:hover {\n color: rgba(102, 102, 102, 0.5);\n cursor: default;\n background-color: rgba(229, 229, 229, 0.5);\n background-image: none;\n border-color: rgba(197, 197, 197, 0.5);\n box-shadow: none;\n}\n'}),define("core/webidl",["exports","core/pubsubhub","deps/webidl2","handlebars.runtime","deps/text!core/css/webidl.css","templates","core/utils"],function(e,t,n,r,i,o,a){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0,e.run=function(e,n,r){var i=function(){z(),(0,t.pub)("end","core/webidl"),r()},o=$("pre.idl",n);if(!o.length)return i();l.default.registerHelper("extAttr",function(e,t){return U(e.extAttrs,t,!1)}),l.default.registerHelper("extAttrInline",function(e){return U(e.extAttrs,0,!0)}),l.default.registerHelper("extAttrClassName",function(){return"Constructor"===this.name||"NamedConstructor"===this.name?"idlCtor":"extAttr"}),l.default.registerHelper("extAttrRhs",function(e,t){return"identifier"===e.type?t.fn(e.value):`(${e.value.map(t.fn)})`}),l.default.registerHelper("param",function(e){return new l.default.SafeString(L({obj:e,optional:e.optional?"optional ":"",variadic:e.variadic?"...":""}))}),l.default.registerHelper("jsIf",function(e,t){return e?t.fn(this):t.inverse(this)}),l.default.registerHelper("idn",function(e){return new l.default.SafeString(_(e))}),l.default.registerHelper("idlType",function(e){return new l.default.SafeString(N(e.idlType))}),l.default.registerHelper("stringifyIdlConst",function(e){switch(e.type){case"null":return"null";case"Infinity":return e.negative?"-Infinity":"Infinity";case"NaN":return"NaN";case"number":return e.value;case"string":case"boolean":case"sequence":return JSON.stringify(e.value);default:return(0,t.pub)("error","Unexpected constant value type: `"+e.type+"`."),"<Unknown>"}}),l.default.registerHelper("escapeArgumentName",X),l.default.registerHelper("escapeAttributeName",Z),l.default.registerHelper("escapeIdentifier",Y),l.default.registerHelper("pads",function(e){return new l.default.SafeString(M(e))}),l.default.registerHelper("join",function(e,t,n){return e.map(n.fn).join(t)}),l.default.registerHelper("joinNonWhitespace",function(e,t,n){return e.filter(e=>"ws"!==e.type).map(n.fn).join(t)}),l.default.registerHelper("tryLink",function(e,t){const n=t.fn(this),r="toJSON"===e.name&&e.extAttrs.some(({name:e})=>"Default"===e);if(!e.dfn&&!r)return n;const i=document.createElement("a");return i.innerText=n,!e.dfn&&r?i.dataset.cite="WEBIDL#default-tojson-operation":(i.dataset.noDefault="",i.dataset.linkFor=e.linkFor?l.default.Utils.escapeExpression(e.linkFor).toLowerCase():"",i.dataset.lt=e.dfn[0].dataset.lt||""),i.outerHTML}),$(".idl",n).not("pre").length||$(n).find("head link").first().before($("<style/>").text(c.default));o.each(function(){var n;try{n=s.default.parse($(this).text(),{ws:!0})}catch(e){return void(0,t.pub)("error",`Failed to parse WebIDL: \`${e.message}\`.\n <details>\n <pre>${(0,a.normalizePadding)(this.textContent)}\n ${e}</pre>\n </details>`)}!function e(n,r,i,o){n.filter(({type:e})=>!1===["includes","implements","ws","ws-pea","ws-tpea","line-comment","multiline-comment"].includes(e)).forEach(function(n){var a;switch(n.type){case"callback interface":case"dictionary":case"interface":case"interface mixin":var s="";n.partial&&(V[n.name]||(V[n.name]=[]),V[n.name].push(n),s="-partial-"+V[n.name].length),e(n.members,r,n.name,o),a=n.name,n.idlId="idl-def-"+a.toLowerCase()+s;break;case"enum":a=n.name;for(const e of n.values)"string"===e.type&&(e.dfn=ne(a,e.value,r,n.type,o));n.idlId="idl-def-"+a.toLowerCase();break;case"callback":case"typedef":a=n.name,n.idlId="idl-def-"+a.toLowerCase();break;case"attribute":case"const":case"field":a=n.name,n.idlId="idl-def-"+i.toLowerCase()+"-"+a.toLowerCase();break;case"operation":if(n.name){a=n.name;var l=i+"."+a,c=i+"."+a+"()";G[c]||(G[c]=[]),G[l]?(n.overload=G[l].length,a=n.name+"!overload-"+n.overload):G[l]=[],G[c].push(n),G[l].push(n)}else(n.getter||n.setter||n.deleter||n.stringifier)&&(a="");const u=`idl-def-${i.toLowerCase()}-${a.toLowerCase()}`,d=n.overload||!n.arguments.length?"":"-"+n.arguments.filter(e=>!I(e.type)).map(e=>e.name.toLowerCase()).join("-").replace(/\s/g,"_");n.idlId=u+d;break;case"maplike":a="maplike",n.idlId=("idl-def-"+i+"-"+a).toLowerCase();break;case"iterable":a="iterable",n.idlId="idl-def-"+i.toLowerCase()+"-"+a.toLowerCase();break;default:return void(0,t.pub)("error",new Error("ReSpec doesn't know about IDL type: `"+n.type+"`."))}i&&(n.linkFor=i),n.dfn=ne(i,a,r,n.type,o)})}(n,e.definitionMap,"",this);var r,i,o=(r=n,(i=$("<pre></pre>").attr({class:"def idl"})).html(r.filter(function(e){return!I(e.type)}).map(function(e){return function(e,n){var r={indent:++n,obj:e};switch(e.type){case"typedef":return j(r);case"includes":return w(r);case"implements":return x(r);case"interface":return Q(r);case"interface mixin":return Q(r,{mixin:!0});case"callback interface":return Q(r,{callback:!0});case"dictionary":var i=0,o=0;e.members.filter(function(e){return!I(e.type)});for(const t of e.members){if(I(t.type))continue;const e=t.required?"required ":"";i<e.length&&(i=e.length);var a=P(t.idlType).length;o<a&&(o=a)}var s=e.members.map(function(e){switch(e.type){case"field":return r=i,(a={obj:t=e,indent:n+1}).typePad=o-P(t.idlType).length,t.required?a.qualifiers="required ":a.qualifiers=" ",a.qualifiers=a.qualifiers.slice(0,r),g(a);case"line-comment":return ee(e,n+1);case"multiline-comment":return te(e,n+1);case"ws":return K(e);case"ws-pea":break;default:throw new Error("Unexpected type in dictionary: `"+e.type+"`.")}var t,r,a}).join("");return m({obj:e,indent:n,children:s,partial:e.partial?"partial ":""});case"callback":var l=e.arguments.filter(function(e){return!I(e.type)}).map(function(e){return L({obj:e,optional:e.optional?"optional ":"",variadic:e.variadic?"...":""})}),c={obj:e,indent:n,children:l.join(", ")},u=f(c),d=$(u).text();if(d.length>80){var p=d.indexOf("(")+1;c.children=l.join(",\n"+M(p)),u=f(c)}return u;case"enum":for(var s="",h=0;h<e.values.length;h++){var v=e.values[h];switch(v.type){case"string":for(var k=!1,C=h+1;C<e.values.length;C++){var E=e.values[C];if(void 0===E.type)break;if(","===E.type){k=!0;break}}s+=b({lname:v.value?v.value.toLowerCase():"the-empty-string",name:v.value,parentID:e.name.toLowerCase(),indent:n+1,needsComma:k});break;case"line-comment":s+=ee(v,n+1);break;case"multiline-comment":s+=te(v,n+1);break;case"ws":s+=K(v);break;case",":case"ws-pea":break;default:throw new Error("Unexpected type in exception: `"+v.type+"`.")}}return y({obj:e,indent:n,children:s});default:return(0,t.pub)("error","Unexpected object type `"+e.type+"` in "+JSON.stringify(e)),""}}(e,-1)}).join("\n\n")),i);o.attr({id:this.id}),o.find(".idlAttribute,.idlCallback,.idlConst,.idlDictionary,.idlEnum,.idlException,.idlField,.idlInterface,.idlMember,.idlMethod,.idlMaplike,.idlIterable,.idlTypedef").each(function(){var t=$(this),n=t.attr("data-title").toLowerCase(),r=t.parent().closest(".idlDictionary,.idlEnum,.idlException,.idlInterface");r.length&&t.attr("data-dfn-for",r.attr("data-title").toLowerCase()),e.definitionMap[n]||(e.definitionMap[n]=[]),e.definitionMap[n].push(t)}),$(this).replaceWith(o),o[0].classList.add(...this.classList)}),n.normalize(),i()};var s=d(n),l=d(r),c=d(i),u=d(o);function d(e){return e&&e.__esModule?e:{default:e}}e.name="core/webidl";var p=u.default["attribute.html"],f=u.default["callback.html"],h=u.default["const.html"],m=u.default["dictionary.html"],g=u.default["dict-member.html"],b=u.default["enum-item.html"],y=u.default["enum.html"],v=u.default["extended-attribute.html"],w=(u.default["field.html"],u.default["includes.html"]),x=u.default["implements.html"],k=u.default["interface.html"],C=u.default["iterable.html"],E=u.default["line-comment.html"],T=u.default["maplike.html"],S=u.default["method.html"],A=u.default["multiline-comment.html"],L=u.default["param.html"],j=u.default["typedef.html"],D=new Set(["maplike","setlike","stringifier"]);function _(e){return" ".repeat(e)}function N(e){if("string"==typeof e)return`<a>${l.default.Utils.escapeExpression(e)}</a>`;if(Array.isArray(e))return e.map(N).join(", ");const t=U(e.extAttrs,0,!0),n=e.nullable?"?":"";if(e.union)return`${t}(${e.idlType.map(N).join(" or ")})${n}`;let r="";return t+(r=e.generic?`${r=W.has(e.generic)?R(e.generic):N(e.generic)}<${N(e.idlType)}>`:W.has(e.idlType)?R(e.idlType):N(e.idlType))+n}function R(e){if(!W.has(e))return e;const t=l.default.Utils.escapeExpression(e);return`<a data-cite='${W.get(t)}'>${t}</a>`}function P(e){if("string"==typeof e)return e;const t=e.nullable?"?":"";if(e.union)return`(${e.idlType.map(P).join(" or ")})${t}`;if(e.generic){const n=[].concat(e.idlType).map(P).join(", ");return`${e.generic}<${n}>${t}`}return P(e.idlType)+t}function M(e){return" ".repeat(e)}var O={ws:!0,"ws-pea":!0,"ws-tpea":!0,"line-comment":!0,"multiline-comment":!0};function I(e){return O[e]}const q=new Map([["CEReactions","HTML#cereactions"],["Clamp","WEBIDL#Clamp"],["Constructor","WEBIDL#Constructor"],["Default","WEBIDL#Default"],["EnforceRange","WEBIDL#EnforceRange"],["Exposed","WEBIDL#Exposed"],["Global","WEBIDL#Global"],["HTMLConstructor","HTML#htmlconstructor"],["LegacyUnenumerableNamedProperties","WEBIDL#LegacyUnenumerableNamedProperties"],["LenientSetter","WEBIDL#LenientSetter"],["LenientThis","WEBIDL#LenientThis"],["NamedConstructor","WEBIDL#NamedConstructor"],["NewObject","WEBIDL#NewObject"],["NoInterfaceObject","WEBIDL#NoInterfaceObject"],["OverrideBuiltins","WEBIDL#OverrideBuiltins"],["PrimaryGlobal","WEBIDL#PrimaryGlobal"],["PutForwards","WEBIDL#PutForwards"],["Replaceable","WEBIDL#Replaceable"],["SameObject","WEBIDL#SameObject"],["SecureContext","WEBIDL#SecureContext"],["TreatNonObjectAsNull","WEBIDL#TreatNonObjectAsNull"],["TreatNullAs","WEBIDL#TreatNullAs"],["Unforgeable","WEBIDL#Unforgeable"],["Unscopable","WEBIDL#Unscopable"]]);function U(e,t,n){if(0===e.length)return"";var r={extAttrs:e,indent:t,sep:n?", ":",\n "+_(t),end:n?" ":"\n"};const i=new l.default.SafeString(v(r)),o=document.createElement("div");return o.innerHTML=i,Array.from(o.querySelectorAll(".extAttrName")).filter(function(e){return q.has(e.textContent)}).forEach(function(e){const t=e.ownerDocument.createElement("a");t.dataset.cite=q.get(e.textContent),t.textContent=e.textContent,e.replaceChild(t,e.firstChild)}),new l.default.SafeString(o.innerHTML)}const W=new Map([["any","WEBIDL#idl-any"],["ArrayBuffer","WEBIDL#idl-ArrayBuffer"],["boolean","WEBIDL#idl-boolean"],["Buffer","WEBIDL#idl-Buffer"],["byte","WEBIDL#idl-byte"],["ByteString","WEBIDL#idl-ByteString"],["Callback","WEBIDL#idl-Callback"],["DataView","WEBIDL#idl-DataView"],["DOMException","WEBIDL#idl-DOMException"],["DOMString","WEBIDL#idl-DOMString"],["double","WEBIDL#idl-double"],["Error","WEBIDL#idl-Error"],["EventHandler","HTML#eventhandler"],["float","WEBIDL#idl-float"],["Float32Array","WEBIDL#idl-Float32Array"],["Float64Array","WEBIDL#idl-Float64Array"],["FrozenArray","WEBIDL#idl-frozen-array"],["Int16Array","WEBIDL#idl-Int16Array"],["Int32Array","WEBIDL#idl-Int32Array"],["Int8Array","WEBIDL#idl-Int8Array"],["long long","WEBIDL#idl-long-long"],["long","WEBIDL#idl-long"],["object","WEBIDL#idl-object"],["octet","WEBIDL#idl-octet"],["Promise","WEBIDL#idl-promise"],["record","WEBIDL#idl-record"],["sequence","WEBIDL#idl-sequence"],["short","WEBIDL#idl-short"],["Uint16Array","WEBIDL#idl-Uint16Array"],["Uint32Array","WEBIDL#idl-Uint32Array"],["Uint8Array","WEBIDL#idl-Uint8Array"],["Uint8ClampedArray","WEBIDL#dl-Uint8ClampedArray"],["unrestricted double","WEBIDL#idl-unrestricted-double"],["unrestricted float","WEBIDL#idl-unrestricted-float"],["unsigned long long","WEBIDL#idl-unsigned-long-long"],["unsigned long","WEBIDL#idl-unsigned-long"],["unsigned short","WEBIDL#idl-unsigned-short"],["USVString","WEBIDL#idl-USVString"]]),H=new Set(["any","attribute","boolean","byte","ByteString","callback","const","creator","Date","deleter","dictionary","DOMString","double","enum","false","float","getter","implements","Infinity","inherit","interface","iterable","long","maplike","NaN","null","object","octet","optional","or","partial","readonly","RegExp","required","sequence","setlike","setter","short","static","stringifier","true","typedef","unrestricted","unsigned","USVString","void"]),B=new Set(["attribute","callback","const","creator","deleter","dictionary","enum","getter","implements","inherit","interface","iterable","maplike","partial","required","setlike","setter","static","stringifier","typedef","unrestricted"]),F=new Set(["required"]);var z,G={},V={};function X(e){return H.has(e)&&!B.has(e)?"_"+e:e}function Z(e){return H.has(e)&&!F.has(e)?"_"+e:e}function Y(e){return H.has(e)?"_"+e:e}function Q(e,t={}){var n=e.obj,r=e.indent,i=0,o=0,a=0,s=0;for(const e of n.members)if(!I(e.type)&&"maplike"!==e.type&&"iterable"!==e.type){var l=P(e.idlType).length;if("attribute"===e.type){var c=J(e).length;i=Math.max(l,i),o=Math.max(c,o)}else"operation"===e.type?(e.static?l+="static ".length:e.stringifier?l+="stringifier ".length:e.getter?l+="getter ".length:e.setter&&(l+="setter ".length),a=Math.max(l,a)):"const"===e.type&&(s=Math.max(l,s))}var u=n.members.map(function(e){switch(e.type){case"attribute":return d=i,f=r+1,m=o,g=P((u=e).idlType).length,b=d-g,y=J(u),y=(y+=M(m)).slice(0,m),p({obj:u,indent:f,qualifiers:y,pad:b});case"operation":return function(e,t,n){var r=e.arguments.filter(function(e){return!I(e.type)}).map(function(e){return L({obj:e,optional:e.optional?"optional ":"",variadic:e.variadic?"...":""})}),i=r.join(", "),o=P(e.idlType).length,a=["getter","setter","deleter","stringifier","static"],s="";for(var l in a)if(e[a[l]]){o+=(s=a[l]+" ").length;break}var c={obj:e,indent:n,special:s,pad:t-o,children:i},u=S(c),d=$(u).text();if(d.length>80){var p=d.indexOf("(")+1;c.children=r.join(",\n"+M(p)),u=S(c)}return u}(e,a,r+1);case"const":return function(e,t,n){var r=t-P(e.idlType).length;e.nullable&&r--;return h({obj:e,indent:n,pad:r,nullable:e.nullable?"?":""})}(e,s,r+1);case"maplike":return c=r+1,T({obj:l=e,qualifiers:l.readonly?"readonly ":"",indent:c});case"iterable":return n=r+1,C({obj:t=e,qualifiers:t.readonly?"readonly ":"",indent:n});case"ws":return K(e);case"line-comment":return ee(e,r+1);case"multiline-comment":return te(e,r+1);default:throw new Error("Unexpected member type: `"+e.type+"`.")}var t,n,l,c,u,d,f,m,g,b,y}).join("");return k({obj:n,indent:r,partial:n.partial?"partial ":"",callback:t.callback?"callback ":"",mixin:t.mixin?"mixin ":"",children:u})}function J(e){var t="";return e.static&&(t+="static "),e.stringifier&&(t+="stringifier "),e.inherit&&(t+="inherit "),e.readonly&&(t+="readonly "),t}function K(e){return/\n.*\n/.test(e.value)?"\n":""}function ee(e,t){return E({indent:t,comment:e.value})}function te(e,t){var n=e.value.split(/\r\n|\r|\n/);if(0===n.length)return"";if(1===n.length)return E({indent:t,comment:n[0]});var r=Math.max(0,/^ */.exec(n[1])[0].length-3);function i(e){return e.slice(r)}return A({indent:t,firstLine:n[0],lastLine:i(n[n.length-1]),innerLine:n.slice(1,-1).map(i)})}function ne(e,n,r,i,o){const a=e,s=n;switch(e=e.toLowerCase(),i){case"operation":if(-1!==n.search("!overload")){n=n.toLowerCase();break}const t=n.toLowerCase()+"()",a=e+"."+n.toLowerCase()+"()";if(r[t]||r[a]){const i=r[t]?t:a,s=ne(e,i,r,null,o);if(!s)break;const l=s[0].dataset.lt?s[0].dataset.lt.split("|"):[];return l.push(i,n),s[0].dataset.lt=l.join("|"),r[n]||(r[n]=[]),r[n].push(s),s}const s=ne(e,n,r,null,o);if(!s)break;const l=s[0].dataset.lt?s[0].dataset.lt.split("|"):[];return l.push(t,n),s[0].dataset.lt=l.reverse().join("|"),r[t]=[s],s;case"enum":if(""===n){n="the-empty-string";break}default:n=n.toLowerCase()}if(D.has(n))return;var l=r[n],c=[];if(l&&0===(c=l.filter(t=>t[0].dataset.dfnFor===e)).length&&""===e&&1===l.length&&(c=l),0===c.length&&""!==e){var u=e+"."+n;void 0!==(l=r[u])&&1===l.length&&(c=l,delete r[u],c[0].attr("data-dfn-for",e),c[0].attr("data-lt",n),void 0===r[n]&&(r[n]=[]),r[n].push(c[0]))}if(c.length>1){const e=`Multiple \`<dfn>\`s for \`${s}\` ${a?`in \`${a}\``:""}`;(0,t.pub)("error",new Error(e))}if(0===c.length){if(i&&o&&n&&!1===o.classList.contains("no-link-warnings")){var d=`No \`<dfn>\` for ${i} \`${s}\`${a?" in `"+a+"`":""}`;d+=". [More info](https://github.com/w3c/respec/wiki/WebIDL-thing-is-not-defined).",(0,t.pub)("warn",d)}return}const p=c[0][0],f="dom-"+(e?e+"-":"")+n.replace(/[()]/g,"");if(p.id=f,p.dataset.idl="",p.dataset.title=p.textContent,p.dataset.dfnFor=e,!p.querySelector("code")&&!p.closest("code")&&p.children){const e=p.ownerDocument.createElement("code");for(;p.hasChildNodes();)e.appendChild(p.firstChild);p.appendChild(e)}return c[0]}e.done=new Promise(function(e){z=e})}),define("core/biblio-db",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.biblioDB=e.name=void 0;e.name="core/biblio-db";const n=new Set(["alias","reference"]),r=new Promise((e,t)=>{let n;try{n=window.indexedDB.open("respec-biblio2",12)}catch(e){return t(e)}n.onerror=(()=>{t(new DOMException(n.error.message,n.error.name))}),n.onsuccess=(()=>{e(n.result)}),n.onupgradeneeded=(async()=>{const r=n.result;Array.from(r.objectStoreNames).map(e=>r.deleteObjectStore(e));const i=[new Promise((e,t)=>{try{const n=r.createObjectStore("alias",{keyPath:"id"});n.createIndex("aliasOf","aliasOf",{unique:!1}),n.transaction.oncomplete=e,n.transaction.onerror=t}catch(e){t(e)}}),new Promise((e,t)=>{try{const n=r.createObjectStore("reference",{keyPath:"id"}).transaction;n.oncomplete=e,n.onerror=t}catch(e){t(e)}})];try{await Promise.all(i),e()}catch(e){t(e)}})});e.biblioDB={get ready(){return r},async find(e){return await this.isAlias(e)&&(e=await this.resolveAlias(e)),this.get("reference",e)},async has(e,t){if(!n.has(e))throw new TypeError("Invalid type: "+e);if(!t)throw new TypeError("id is required");const r=await this.ready;return new Promise((n,i)=>{var o=r.transaction([e],"readonly").objectStore(e),a=IDBKeyRange.only(t),s=o.openCursor(a);s.onsuccess=(()=>{n(!!s.result)}),s.onerror=(()=>{i(new DOMException(s.error.message,s.error.name))})})},async isAlias(e){if(!e)throw new TypeError("id is required");const t=await this.ready;return new Promise((n,r)=>{var i=t.transaction(["alias"],"readonly").objectStore("alias"),o=IDBKeyRange.only(e),a=i.openCursor(o);a.onsuccess=(()=>{n(!!a.result)}),a.onerror=(()=>{r(new DOMException(a.error.message,a.error.name))})})},async resolveAlias(e){if(!e)throw new TypeError("id is required");const t=await this.ready;return new Promise((n,r)=>{var i=t.transaction("alias","readonly").objectStore("alias"),o=IDBKeyRange.only(e),a=i.openCursor(o);a.onsuccess=(()=>{if(null===a.result)return n(null);n(a.result.value.aliasOf)}),a.onerror=(()=>{r(new DOMException(a.error.message,a.error.name))})})},async get(e,t){if(!n.has(e))throw new TypeError("Invalid type: "+e);if(!t)throw new TypeError("id is required");const r=await this.ready;return new Promise((n,i)=>{var o=r.transaction([e],"readonly").objectStore(e),a=IDBKeyRange.only(t),s=o.openCursor(a);s.onsuccess=(()=>{if(null===s.result)return n(null);n(s.result.value)}),s.onerror=(()=>{i(new DOMException(s.error.message,s.error.name))})})},async addAll(e){if(!e)return;const n={alias:new Set,reference:new Set};Object.keys(e).filter(n=>{if("string"==typeof e[n]){let e=`Legacy SpecRef entries are not supported: \`[[${n}]]\`. `;return e+="Please update it to the new format at [specref repo](https://github.com/tobie/specref/)",(0,t.pub)("error",e),!1}return!0}).map(t=>Object.assign({id:t},e[t])).reduce((e,t)=>(t.aliasOf?e.alias.add(t):e.reference.add(t),e),n);const r=Object.keys(n).map(e=>Array.from(n[e]).map(t=>this.add(e,t))).reduce((e,t)=>e.concat(t),[]);await Promise.all(r)},async add(e,t){if(!n.has(e))throw new TypeError("Invalid type: "+e);if("object"!=typeof t)throw new TypeError("details should be an object");if("alias"===e&&!t.hasOwnProperty("aliasOf"))throw new TypeError("Invalid alias object.");const r=await this.ready,i=await this.has(e,t.id);return new Promise((n,o)=>{const a=r.transaction([e],"readwrite").objectStore(e);var s=i?a.put(t):a.add(t);s.onsuccess=n,s.onerror=(()=>{o(new DOMException(s.error.message,s.error.name))})})},async close(){(await this.ready).close()}}}),define("core/biblio",["exports","core/biblio-db","core/utils","core/pubsubhub"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0,e.wireReference=function(e,t="_blank"){if("object"!=typeof e)throw new TypeError("Only modern object references are allowed");const n=Object.assign({},s,e),r=n.authors.join("; ")+(n.etAl?" et al":""),i=a.get(n.status)||n.status;return hyperHTML.wire(n)` + <cite> + <a + href="${n.href}" + target="${t}" + rel="noopener noreferrer"> + ${n.title.trim()}</a>. + </cite> + <span class="authors"> + ${l(r)} + </span> + <span class="publisher"> + ${l(n.publisher)} + </span> + <span class="pubDate"> + ${l(n.date)} + </span> + <span class="pubStatus"> + ${l(i)} + </span> + `},e.stringifyReference=u,e.resolveRef=async function e(t){const n=await f;if(!n.hasOwnProperty(t))return null;const r=n[t];if(r.aliasOf)return await e(r.aliasOf);return r},e.run=async function(e,n,i){e.localBiblio||(e.localBiblio={});if(e.biblio){let e="Overriding `.biblio` in config. Please use ";e+="`.localBiblio` for custom biblio entries.",(0,r.pub)("warn",e)}e.biblio={};const a=Array.from(Object.keys(e.localBiblio)).filter(t=>e.localBiblio[t].hasOwnProperty("aliasOf")).map(t=>e.localBiblio[t].aliasOf);s=e,Array.from(s.informativeReferences).filter(e=>s.normativeReferences.has(e)).forEach(e=>s.informativeReferences.delete(e));var s;const l=o(e),c=l.normativeReferences.concat(l.informativeReferences).filter(t=>!e.localBiblio.hasOwnProperty(t)).concat(a).reduce((e,t)=>(-1===e.indexOf(t)&&e.push(t),e),[]).sort(),d=[];try{await t.biblioDB.ready;const e=c.map(async e=>({id:e,data:await t.biblioDB.find(e)}));d.push(...await Promise.all(e))}catch(e){d.push(...c.map(e=>({id:e,data:null}))),console.warn(e)}const f={hasData:[],noData:[]};d.reduce((e,t)=>(t.data?e.hasData.push(t):e.noData.push(t),e),f),f.hasData.reduce((e,t)=>(e[t.id]=t.data,e),e.biblio);const m=f.noData.map(e=>e.id);if(m.length){const t=await h(m,{forceUpdate:!0});Object.assign(e.biblio,t)}Object.assign(e.biblio,e.localBiblio),function(e){var t={},n=o(e),i=n.informativeReferences,a=n.normativeReferences,s={};if(!i.length&&!a.length&&!e.refNote)return;var l=$("<section id='references' class='appendix'><h2>"+e.l10n.references+"</h2></section>").appendTo($("body"));e.refNote&&$("<p></p>").html(e.refNote).appendTo(l);for(var c=["Normative","Informative"],d=0;d<c.length;d++){var p=c[d],f="Normative"===p?a:i,h="Normative"===p?e.l10n.norm_references:e.l10n.info_references;if(f.length){var m=$("<section><h3></h3></section>").appendTo(l).find("h3").text(h).end();m.makeID(null,p+" references"),f.sort((e,t)=>e.toLowerCase().localeCompare(t.toLowerCase()));for(var g=$("<dl class='bibliography'></dl>").appendTo(m),b=0;b<f.length;b++){var y=f[b];$("<dt></dt>").attr({id:"bib-"+y}).text("["+y+"]").appendTo(g);var v=$("<dd></dd>").appendTo(g),w=e.biblio[y],x={},k=y;for(x[y]=!0;w&&w.aliasOf;)if(x[w.aliasOf]){w=null;const e=`Circular reference in biblio DB between [\`${y}\`] and [\`${k}\`].`;(0,r.pub)("error",e)}else k=w.aliasOf,w=e.biblio[k],x[k]=!0;s[k]=s[k]||[],s[k].indexOf(y)<0&&s[k].push(y),w?v.html(u(w)+"\n"):(t[y]||(t[y]=0),t[y]++,v.html("<em style='color: #f00'>Reference not found.</em>\n"))}}}for(var C in s)if(s[C].length>1){let e=`[${C}] is referenced in ${s[C].length} ways: `;e+=`(${s[C].map(e=>`'${e}'`).join(", ")}). This causes`,e+=" duplicate entries in the References section.",(0,r.pub)("warn",e)}for(var E in t){const e=`Bad reference: [\`${E}\`] (appears ${t[E]} times)`;t.hasOwnProperty(E)&&(0,r.pub)("error",e)}}(e),p(e.biblio),i(),await h(c)};e.name="core/biblio";const i=new URL("https://specref.herokuapp.com/bibrefs?refs=");function o(e){return{informativeReferences:Array.from(e.informativeReferences),normativeReferences:Array.from(e.normativeReferences)}}const a=new Map([["CR","W3C Candidate Recommendation"],["ED","W3C Editor's Draft"],["FPWD","W3C First Public Working Draft"],["LCWD","W3C Last Call Working Draft"],["NOTE","W3C Note"],["PER","W3C Proposed Edited Recommendation"],["PR","W3C Proposed Recommendation"],["REC","W3C Recommendation"],["WD","W3C Working Draft"],["WG-NOTE","W3C Working Group Note"]]),s=Object.freeze({authors:[],date:"",href:"",publisher:"",status:"",title:"",etAl:!1}),l=(c=".",e=>{const t=e.trim();return!t||t.endsWith(c)?t:t+c});var c;function u(e){if("string"==typeof e)return e;let t=`<cite>${e.title}</cite>`;(t=e.href?`<a href="${e.href}">${t}</a>. `:`${t}. `,e.authors&&e.authors.length&&(t+=e.authors.join("; "),e.etAl&&(t+=" et al"),t+="."),e.publisher)&&(t=`${t} ${e.publisher+(/\.$/.test(e.publisher)?"":".")} `);return e.date&&(t+=e.date+". "),e.status&&(t+=(a.get(e.status)||e.status)+". "),e.href&&(t+=`URL: <a href="${e.href}">${e.href}</a>`),t}var d=(0,n.createResourceHint)({hint:"dns-prefetch",href:i.origin});let p;document.head.appendChild(d);const f=e.done=new Promise(e=>{p=e});async function h(e,n={forceUpdate:!1}){if(!e.length||!1===navigator.onLine)return;let r;try{r=await fetch(i.href+e.join(","))}catch(e){return console.error(e),null}if(!n.forceUpdate&&!r.ok||200!==r.status)return null;const o=await r.json();try{await t.biblioDB.addAll(o)}catch(e){console.error(e)}return o}}),define("core/data-cite",["exports","core/pubsubhub","core/biblio"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){const t=r(e);Array.from(document.querySelectorAll(["dfn[data-cite], a[data-cite]"])).filter(e=>e.dataset.cite).map(t).forEach(({isNormative:t,key:n})=>{const r=t?e.normativeReferences:e.informativeReferences;r.add(n)})},e.linkInlineCitations=async function(e,i=respecConfig){const o=function(e){const i=r(e);return async function(r){const o=r.dataset.cite;let{key:a,frag:s,path:l}=i(r),c="";if(a===e.shortName)c=document.location.href;else{const e=await(0,n.resolveRef)(a);if(d=r,["data-cite","data-cite-frag"].filter(e=>d.hasAttribute(e)).forEach(e=>d.removeAttribute(e)),!e){var u=`Couldn't find a match for 'data-cite=${o}'.`;return console.warn(u,r),u+=" Please check developer console for offending element.",void(0,t.pub)("warn",u)}c=e.href}var d;switch(l&&(c=new URL(l,c).href),s&&(c=new URL(s,c).href),r.localName){case"a":r.href=c;break;case"dfn":{const e=r.ownerDocument.createElement("a");for(e.href=c;r.firstChild;)e.appendChild(r.firstChild);r.appendChild(e,r);break}}}}(i),a=e.querySelectorAll("dfn[data-cite], a[data-cite]"),s=Array.from(a).map(o);return await Promise.all(s)};e.name="core/data-cite";function r(e){return function t(n){const{dataset:r}=n;let{cite:i,citeFrag:o,citePath:a}=r;const s=i.startsWith("!"),l=i.search("/"),c=i.search("#");if(i.startsWith("#")&&!o){const r=n.parentElement.closest('[data-cite]:not([data-cite^="#"])'),{key:o,isNormative:a}=r?t(r):{key:e.shortName||"",isNormative:!1};return n.dataset.cite=a?`!${o}`:o,n.dataset.citeFrag=i,t(n)}return-1!==c&&(o=o||i.substr(c),i=i.substring(0,c)),-1!==l&&(a=a||i.substr(l),i=i.substring(0,l)),s&&(i=i.substr(1)),o&&!o.startsWith("#")&&(o="#"+o),a&&a.startsWith("/")&&(a=a.substr(1)),{key:i,isNormative:s,frag:o,path:a}}}}),define("core/webidl-index",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,t,n){const r=t.querySelector("section#idl-index");if(!r)return n();const i=[2,3,4,5,6].map(e=>`h${e}:first-child`).join(",");if(!r.querySelector(i)){const e=document.createElement("h2");r.title?(e.innerHTML=r.title,r.removeAttribute("title")):e.innerHTML="IDL Index",r.insertAdjacentElement("afterbegin",e)}if(!document.querySelector("pre.idl")){const e="This specification doesn't declare any Web IDL.",t=document.createTextNode(e);return r.appendChild(t),n()}const o=document.createDocumentFragment(),a=document.createElement("pre");a.classList.add("idl","def"),a.id="actual-idl-index",Array.from(document.querySelectorAll("pre.def.idl")).map(e=>{const t=document.createElement("span"),{children:n}=e.cloneNode(!0);for(const e of Array.from(n))t.appendChild(e),t.appendChild(document.createTextNode("\n"));return t.classList.add("respec-idl-separator"),t}).reduce((e,t)=>(e.appendChild(t),e),a),Array.from(a.querySelectorAll("*[id]")).forEach(e=>e.removeAttribute("id")),o.appendChild(a),r.appendChild(o),n()};e.name="core/webidl-index"}),define("core/link-to-dfn",["exports","core/data-cite","core/pubsubhub","./l10n"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,a){r.normalize();var s={};Object.keys(e.definitionMap).forEach(function(t){s[t]={};var r=[];if(e.definitionMap[t].forEach(function(e){void 0===e.attr("data-idl")&&e.removeAttr("data-dfn-for");var n=e.attr("data-dfn-for")||"";if(n in s[t]){var a=0!==s[t][n].filter("dfn").length,l=0!==e.filter("dfn").length;if(a&&l&&(e.addClass("respec-offending-element"),void 0===e.attr("title")&&e.attr("title",i[o].duplicate),void 0===e.attr("id")&&e.makeID(null,t),r.push(e[0])),a)return}s[t][n]=e,void 0===e.attr("id")&&(e.attr("data-idl")?e.makeID("dom",(n?n+"-":"")+t):e.makeID("dfn",t))}),r.length>0){const e=r.map((e,t)=>`[${t+1}](#${e.id})`).join(", ");(0,n.pub)("error",`Duplicate definitions of '${t}' at: ${e}.`)}}),$("a:not([href]):not([data-cite]):not(.logo)").each(function(){const e=$(this);if(e.hasClass("externalDFN"))return;const t=e.linkTargets(),r=t.some(function(t){if(s[t.title]&&s[t.title][t.for]){const n=s[t.title][t.for];if(n[0].dataset.cite)e[0].dataset.cite=n[0].dataset.cite;else{const t="#"+encodeURIComponent(n.prop("id"));e.attr("href",t).addClass("internalDFN")}if(e.attr("data-link-type")||e.attr("data-link-type","dfn"),n.closest("code,pre").length||1===n.contents().length&&1===n.children("code").length){const t=e[0].textContent.trim(),r=n[0].dataset.hasOwnProperty("idl"),i=r?n[0].dataset.title===t:n[0].textContent.trim()===t;if(r&&!i)return!0;e.wrapInner("<code></code>")}return!0}return!1});if(!r&&0!==t.length){if(!e.parents(".idl:not(.extAttr), dl.methods, dl.attributes, dl.constants, dl.constructors, dl.fields, dl.dictionary-members, span.idlMemberType, span.idlTypedefType, div.idlImplementsDesc").length){const r=t[0].for,i=t[0].title;return this.classList.add("respec-offending-element"),this.title="Linking error: not matching <dfn>",(0,n.pub)("warn","Found linkless <a> element "+(r?"for '"+r+"' ":"")+"with text '"+i+"' but no matching `<dfn>`."),void console.warn("Linkless element:",e[0])}e.replaceWith(e.contents())}}),(0,t.linkInlineCitations)(r,e).then(()=>{(0,n.pub)("end","core/link-to-dfn"),a()})};e.name="core/link-to-dfn";const i={en:{duplicate:"This is defined more than once in the document."}},o=r.lang in i?r.lang:"en"}),define("core/contrib",["exports","core/github","core/pubsubhub","core/utils"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){const i=document.getElementById("gh-commenters"),l=document.getElementById("gh-contributors");if(!i&&!l)return;const c={},{githubAPI:u,githubUser:d,githubToken:p}=e;if(d&&p){const e=btoa(`${d}:${p}`),t=`Basic ${e}`;Object.assign(c,{Authorization:t})}if(!u){const e="Requested list of contributors and/or commenters from GitHub, but [`githubAPI`](https://github.com/w3c/respec/wiki/githubAPI) is not set.";return void(0,n.pub)("error",e)}const f=await fetch(u,{headers:c});if(!f.ok){const e="Error fetching repository information from GitHub. "+`(HTTP Status ${f.status}).`;return void(0,n.pub)("error",e)}const h=await f.json(),{issues_url:m,issue_comment_url:g,contributors_url:b}=h,[y,v,w]=await Promise.all([(0,t.fetchIndex)(m,c),(0,t.fetchIndex)(g,c),(0,t.fetchIndex)(b,c)]),x=e.editors.map(o),k=i?function(...e){const t=e.reduce(r.flatten,[]).filter(e=>e&&e.user).map(({user:e})=>e.url);return[...new Set(t)]}(y,v):[],C=l?w.map(a):[];try{await Promise.all(s(k,x,i,c),s(C,x,l,c))}catch(e){(0,n.pub)("error","Error loading contributors and/or commenters from GitHub.")}};e.name="core/contrib";function i(e){return t=>t[e]}const o=i("name"),a=i("url");async function s(e,t,n,i){const o=(await Promise.all(e.map(e=>fetch(e,{headers:i})))).map(([e])=>e.name||e.login).filter(e=>!t.includes(e)).sort((e,t)=>e.toLowerCase().localeCompare(t.toLowerCase()));n.textContent=(0,r.joinAnd)(o),n.id=null}}),define("core/fix-headers",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,t,n){$("section:not(.introductory)",t).find("h1:first, h2:first, h3:first, h4:first, h5:first, h6:first").each(function(){var e=$(this).parents("section").length+1;e>6&&(e=6);var t="h"+e;this.localName.toLowerCase()!==t&&$(this).renameElement(t)}),n()};e.name="core/fix-headers"}),define("core/structure",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,o,a){"tocIntroductory"in e==!1&&(e.tocIntroductory=!1);"maxTocLevel"in e==!1&&(e.maxTocLevel=0);var s=$("section:not(.introductory)",o).find("h1:first, h2:first, h3:first, h4:first, h5:first, h6:first").toArray().filter(e=>null===e.closest("section.introductory"));if(!(s=$(s)).length)return a();if(s.each(function(){var e=$(this).parents("section").length+1;e>6&&(e=6);var t="h"+e;this.localName.toLowerCase()!==t&&$(this).renameElement(t)}),!e.noTOC){var l=function e(o,a,s,l,c){var u=o.children(c.tocIntroductory?"section":"section:not(.introductory)");if(0===u.length)return null;var d=$("<ol class='toc'></ol>");for(var p=0;p<u.length;p++){var f=$(u[p],a),h=f.hasClass("introductory"),m=f.hasClass("notoc");if(f.children().length&&!m){var g=f.children()[0],b=g.localName.toLowerCase();if("h2"===b||"h3"===b||"h4"===b||"h5"===b||"h6"===b){var y=g.textContent,v=$("<div></div>").append($(g).contents().clone());v.find("a").renameElement("span").attr("class","formerLink").removeAttr("href"),v.find("dfn").renameElement("span").removeAttr("id");var w=g.id?g.id:f.makeID(null,y);h||s[s.length-1]++;var x=s.slice();f.hasClass("appendix")&&1===s.length&&!n&&(r=s[0],n=!0),n&&(x[0]=i.charAt(s[0]-r));var k=x.join("."),C=1==x.length;C&&(k+=".",$(g).before(document.createComment("OddPage")));var E=$("<span class='secno'></span>").text(k+" ");h||$(g).prepend(E),t[w]=(h?"":"<span class='secno'>"+k+"</span> ")+"<span class='sec-title'>"+y+"</span>";var T=$("<a/>").attr({href:"#"+w,class:"tocxref"}).append(h?"":E.clone()).append(v.contents()),S=$("<li class='tocline'/>").append(T);(0===c.maxTocLevel||l<=c.maxTocLevel)&&d.append(S),s.push(0);var A=e(f,a,s,l+1,c);A&&S.append(A),s.pop()}}}return d}($("body",o),o,[0],1,e);if(!l)return;var c=o.createElement("nav");c.id="toc",c.innerHTML="<h2 class='introductory'>"+e.l10n.toc+"</h2>",c.appendChild(l[0]);var u=$("#toc",o),d=!1;u.length&&(d=!0),u.length||(u=$("#sotd",o)),u.length||(u=$("#abstract",o)),d?u.replaceWith(c):u.after(c);var p=$("<p role='navigation' id='back-to-top'><a href='#title'><abbr title='Back to Top'>↑</abbr></a></p>");$("body").append(p)}$("a[href^='#']:not(.tocxref)",o).each(function(){var e=$(this);if(""===e.html()){var n=e.attr("href").slice(1);t[n]&&(e.addClass("sec-ref"),e.html((e.hasClass("sectionRef")?"section ":"")+t[n]))}}),a()};var t={},n=!1,r=0,i="ABCDEFGHIJKLMNOPQRSTUVWXYZ";e.name="core/structure"}),define("w3c/informative",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(){Array.from(document.querySelectorAll("section.informative")).map(e=>e.querySelector("h2, h3, h4, h5, h6")).filter(e=>e).forEach(e=>{e.parentNode.insertBefore(hyperHTML`<p><em>This section is non-normative.</em></p>`,e.nextSibling)})};e.name="w3c/informative"}),define("w3c/permalinks",["exports","templates"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){if(!e.includePermalinks)return n();const i=r.default["permalinks.css"];var o=e.permalinkSymbol||"§",a="<style>"+i(e)+"</style>";$(t).find("head link").first().before(a),$(t).find("h2, h3, h4, h5, h6").each(function(t,n){var r=$(n);if(!r.hasClass("nolink")){var i=r.attr("id"),a=r.parent();if((a.is("section")||a.is("div"))&&(i=a.hasClass("introductory")||a.hasClass("nolink")?null:a.attr("id")),i){var s=$("<span></span>");s.attr("class","permalink");var l=r.text(),c=$("<a></a>");c.attr({href:"#"+i,"aria-label":"Permalink for "+l,title:"Permalink for "+l});var u=$("<span></span>");u.append(o),c.append(u),s.append(c),e.permalinkEdge||r.append(" "),r.append(s)}}}),n()};var n,r=(n=t)&&n.__esModule?n:{default:n};e.name="w3c/permalinks"}),define("core/id-headers",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,t,n){Array.from(document.querySelectorAll("h2:not([id]), h3:not([id]), h4:not([id]), h5:not([id]), h6:not([id])")).forEach(e=>{$(e).makeID()}),n()};e.name="core/id-headers"}),define("core/location-hash",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){(0,t.pub)("start","core/location-hash");let i="";try{i=decodeURIComponent(window.location.hash).substr(1)}catch(e){i=""}if(!i&&!document.documentElement.scrollTop)return r();const o=!!n.getElementById(i),a=/\W/.test(i);if(!o&&a){const e=i.replace(/[\W]+/gim,"-").replace(/^-+/,"").replace(/-+$/,"");document.getElementById(e)&&(i=e)}window.location.hash=`#${i}`,r()};e.name="core/location-hash"}),define("deps/text!core/css/caniuse.css",[],function(){return"/* container for stats */\n.caniuse-stats {\n display: flex;\n flex-wrap: wrap;\n justify-content: flex-start;\n align-items: baseline;\n cursor: pointer;\n}\n\nbutton.caniuse-cell {\n margin: 1px 1px 0 0;\n border: none;\n}\n\n.caniuse-browser {\n position: relative;\n}\n\n/* reset styles, hide old versions by default */\n.caniuse-browser ul {\n display: none;\n margin: 0;\n padding: 0;\n list-style: none;\n position: absolute;\n left: 0;\n z-index: 2;\n background: #fff;\n margin-top: 1px;\n}\n\n.caniuse-stats a {\n white-space: nowrap;\n align-self: center;\n margin-left: .5em;\n}\n\n/* a browser version */\n.caniuse-cell {\n display: flex;\n color: rgba(0, 0, 0, 0.8);\n font-size: 90%;\n height: 0.8cm;\n margin-right: 1px;\n margin-top: 0;\n min-width: 3cm;\n overflow: visible;\n justify-content: center;\n align-items: center;\n}\n\nli.caniuse-cell {\n margin-bottom: 1px;\n}\n\n.caniuse-cell:focus {\n outline: none;\n}\n\n.caniuse-cell:hover {\n color: rgba(0, 0, 0, 1);\n}\n\n/* supports */\n.caniuse-cell.y {\n background: #8bc34a;\n}\n\n/* no support */\n.caniuse-cell.n {\n background: #e53935;\n}\n\n/* not supported by default / partial support etc\nsee https://github.com/Fyrd/caniuse/blob/master/CONTRIBUTING.md for stats */\n.caniuse-cell.d,\n.caniuse-cell.a,\n.caniuse-cell.x,\n.caniuse-cell.p {\n background: #ffc107;\n}\n\n/* show rest of the browser versions */\n.caniuse-stats button:focus + ul,\n.caniuse-stats .caniuse-browser:hover > ul {\n display: block;\n}\n"}),define("core/caniuse",["exports","core/utils","core/pubsubhub","deps/text!core/css/caniuse.css","deps/hyperhtml"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){if(!e.caniuse)return;!function(e){const t={maxAge:864e5,browsers:["chrome","firefox","safari","edge"],versions:4};if("string"==typeof e.caniuse)return void(e.caniuse=a({feature:e.caniuse},t));Array.isArray(e.caniuse.browsers)?e.caniuse.browsers=e.caniuse.browsers.map(e=>e.toLowerCase()).filter(function(e){if(l.has(e))return!0;return(0,n.pub)("warn",`Ignoring invalid browser "\`${e}\`" in `+"[`respecConfig.caniuse.browsers`](https://github.com/w3c/respec/wiki/caniuse)"),!1}):e.caniuse.browsers=t.browsers;Object.assign(e.caniuse,t,a({},e.caniuse))}(e);const{caniuse:r}=e;if(!r.feature)return;const{feature:i}=r,u="https://caniuse.com/#feat="+i,d=(0,t.createResourceHint)({hint:"preconnect",href:"https://raw.githubusercontent.com"});document.head.appendChild(d),document.head.appendChild(hyperHTML` + <style class="removeOnSave">${o.default}</style>`);const p=document.querySelector(".head dl"),f=new Promise(async e=>{let o;try{const e=await async function(e){const{apiURL:n,feature:r,maxAge:i}=e,o=n?n.replace("{FEATURE}",r):`${s}${r}.json`,a=new Request(o),l=await(0,t.fetchAndCache)(a,i),{stats:c}=await l.json();return c}(r);o=function(e,n){return hyperHTML` + ${e.browsers.map(r=>(function(e,n,r){if(!r)return;const i=e=>{const t=r[e].split("#",1)[0].split(" ").filter(e=>e),n=t.filter(e=>c.has(e)).map(e=>c.get(e));return{support:t.join(" "),title:n.join(" ")}},[o,...a]=Object.keys(r).sort(t.semverCompare).slice(-n).reverse(),{support:s,title:u}=i(o);return hyperHTML` + <div class="caniuse-browser"> + <button class="${`caniuse-cell ${s}`}" title="${u}"> + ${l.get(e)||e} ${o} + </button> + <ul> + ${a.map(e=>{const{support:t,title:n}=i(e);return`<li class="${"caniuse-cell "+t}" title="${n}">${e}</li>`})} + </ul> + </div>`})(r,e.versions,n[r])).filter(e=>e)} + <a href="${`https://caniuse.com/#feat=${e.feature}`}" + title="Get details at caniuse.com">More info + </a>`}(r,e)}catch(e){console.error(e);const t=`Couldn't find feature "${i}" on caniuse.com? `+"Please check the feature key on [caniuse.com](https://caniuse.com)";(0,n.pub)("error",t),o=hyperHTML`<a href="${u}">caniuse.com</a>`}e(o)}),h=hyperHTML.bind(document.createDocumentFragment())` + <dt class="caniuse-title">Can I Use this API?</dt> + <dd class="caniuse-stats">${{any:f,placeholder:"Fetching data from caniuse.com..."}}</dd>`;p.appendChild(h),await f,(0,n.pub)("amend-user-config",{caniuse:i}),(0,n.sub)("beforesave",e=>{hyperHTML.bind(e.querySelector(".caniuse-stats"))` + <a href="${u}">caniuse.com</a>`})};var i,o=(i=r)&&i.__esModule?i:{default:i};var a=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="core/caniuse";const s="https://raw.githubusercontent.com/Fyrd/caniuse/master/features-json/",l=new Map([["chrome","Chrome"],["firefox","Firefox"],["ie","IE"],["edge","Edge"],["android","Android"],["safari","Safari"],["opera","Opera"],["bb","Blackberry"],["and_uc","UC (Android)"],["and_ff","Firefox (Android)"]]),c=new Map([["y","Supported."],["a","Almost supported (aka Partial support)."],["n","No support, or disabled by default."],["p","No support, but has Polyfill."],["u","Support unknown."],["x","Requires prefix to work."],["d","Disabled by default (needs to enabled)."]])}),define("core/exporter",["exports","core/utils","core/pubsubhub","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rsDocToDataURL=function(e,i=document){const o=r.get(e);if(!o){const t=[...r.values()].join(", "),n=`Invalid format: ${e}. Expected one of: ${t}.`;throw new TypeError(n)}const a=function(e,r){const i=r.cloneNode(!0);!function(e){const{head:r,body:i,documentElement:o}=e;(function({documentElement:e}){const t=document.createTreeWalker(e,NodeFilter.SHOW_COMMENT,e=>e.textContent.startsWith("_hyper"));for(const e of[...function*(e){for(;e.nextNode();)yield e.currentNode}(t)])e.remove()})(e),e.querySelectorAll(".removeOnSave, #toc-nav").forEach(e=>e.remove()),i.classList.remove("toc-sidebar"),(0,t.removeReSpec)(o);const a=e.createDocumentFragment(),s=e.querySelector("meta[name='viewport']");s&&r.firstChild!==s&&a.appendChild(s);let l=e.querySelector("meta[charset], meta[content*='charset=']");l||(l=hyperHTML`<meta charset="utf-8">`);a.appendChild(l);const c=hyperHTML` + <meta name="generator" content="${`ReSpec ${window.respecVersion||"Developer Channel"}`}"> + `;a.appendChild(c),r.insertBefore(a,r.firstChild),(0,n.pub)("beforesave",o)}(i);let o="";switch(e){case"xml":o=(new XMLSerializer).serializeToString(i);break;default:i.doctype&&(o+=(new XMLSerializer).serializeToString(i.doctype)),o+=i.documentElement.outerHTML}return o}(o,i),s=encodeURIComponent(a);return`data:${e};charset=utf-8,${s}`};const r=new Map([["text/html","html"],["application/xml","xml"]])}),define("ui/save-html",["exports","core/ui","core/l10n","core/pubsubhub","core/exporter","deps/hyperhtml"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.show=function(){if(!c)return;l.show(u)},e.exportDocument=function(e,t){const n="Exporting via ui/save-html module's `exportDocument()` is deprecated and will be removed. Use core/exporter `rsDocToDataURL()` instead.";return(0,r.pub)("warn",n),console.warn(n),(0,i.rsDocToDataURL)(t)};e.name="ui/save-html";const o=new URL("https://labs.w3.org/epub-generator/cgi-bin/epub-generator.py");o.searchParams.append("type","respec"),o.searchParams.append("url",document.location.href);const a=[{id:"respec-save-as-html",fileName:"index.html",title:"HTML",type:"text/html",get href(){return(0,i.rsDocToDataURL)(this.type)}},{id:"respec-save-as-xml",fileName:"index.xhtml",title:"XML",type:"application/xml",get href(){return(0,i.rsDocToDataURL)(this.type)}},{id:"respec-save-as-epub",fileName:"spec.epub",title:"EPUB 3",type:"application/epub+zip",href:o.href}];function s(e){const{id:n,href:r,fileName:i,title:o,type:a}=e;return hyperHTML` + <a + href="${r}" + id="${n}" + download="${i}" + type="${a}" + class="respec-save-button" + onclick=${()=>t.ui.closeModal()} + >${o}</a>`}const l={async show(e){await document.respecIsReady;const r=hyperHTML` + <div class="respec-save-buttons"> + ${a.map(s)} + </div>`;t.ui.freshModal(n.l10n[n.lang].save_snapshot,r,e)}},c="download"in HTMLAnchorElement.prototype;let u;c&&(u=t.ui.addCommand(n.l10n[n.lang].save_snapshot,"ui/save-html","Ctrl+Shift+Alt+S","💾"))}),define("ui/search-specref",["exports","core/ui","core/biblio","core/l10n"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.show=void 0;const i=t.ui.addCommand(r.l10n[r.lang].search_specref,"ui/search-specref","Ctrl+Shift+Alt+space","🔎"),o="https://specref.herokuapp.com/",a=`${o}search-refs`,s=`${o}reverse-lookup`,l=document.createElement("form"),c=window.hyperHTML.bind(l),u=hyperHTML.bind(document.createElement("div"));function d([e,t]){return hyperHTML.wire(t)` + <dt> + [${e}] + </dt> + <dd>${(0,n.wireReference)(t)}</dd> + `}l.id="specref-ui",l.addEventListener("submit",async e=>{e.preventDefault();const{searchBox:t}=l,n=t.value;if(!n)return void t.focus();f({state:"Searching Specref…"});const r=new URL(a);r.searchParams.set("q",n);const i=new URL(s);i.searchParams.set("urls",n);try{const e=performance.now(),o=await Promise.all([fetch(r).then(e=>e.json()),fetch(i).then(e=>e.json())]),{checked:a}=l.includeVersions;f({query:n,results:function({includeVersions:e}={includeVersions:!1}){return(...t)=>{const n=t.reduce((e,t)=>Object.assign(e,t),{}),r=new Map(Object.entries(n));return Array.from(r.entries()).filter(([,e])=>e.aliasOf).map(([e])=>e).reduce((e,t)=>e.delete(t)&&e,r),e||Array.from(r.values()).filter(e=>"object"==typeof e&&"versions"in e).reduce((e,t)=>e.concat(t.versions),[]).forEach(e=>{r.delete(e)}),Array.from(r.entries()).filter(([,e])=>"object"!=typeof e).reduce((e,[t])=>r.delete(t)&&r,r),r}}({includeVersions:a})(...o),state:"",timeTaken:Math.round(performance.now()-e)/1e3})}catch(e){console.error(e),f({state:"Error! Couldn't do search."})}finally{t.focus()}});const p=hyperHTML.wire()` + <header> + <p> + An Open-Source, Community-Maintained Database of + Web Standards & Related References. + </p> + </header> + <div class="searchcomponent"> + <input + name="searchBox" + type="search" + autocomplete="off" + placeholder="Keywords, titles, authors, urls…"> + <button + type="submit"> + Search + </button> + <label> + <input type="checkbox" name="includeVersions"> Include all versions. + </label> + </div> +`;function f({state:e,results:t,timeTaken:n,query:r}={state:""}){t?c` + <div>${p}</div> + <p class="state" hidden="${!e}"> + ${e} + </p> + <section hidden="${!t}">${t?function(e,t,n){if(!e.size)return u` + <p class="state"> + Your search - <strong> ${t} </strong> - + did not match any references. + </p> + `;const r=Array.from(e.entries()).slice(0,99).map(d).reduce((e,t)=>e.concat(t),[]);return u` + <p class="result-stats"> + ${e.size} results (${n} seconds). + ${e.size>99?"First 100 results.":""} + </p> + <dl class="specref-results">${r}</dl> + `}(t,r,n):[]}</section> + `:c`<div>${p}</div>`}e.show=function(){f(),t.ui.freshModal(r.l10n[r.lang].search_specref,l,i),l.querySelector("input[type=search]").focus()}}),define("ui/dfn-list",["exports","core/ui","core/l10n","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.show=void 0;const r=t.ui.addCommand(n.l10n[n.lang].definition_list,"ui/dfn-list","Ctrl+Shift+Alt+D","📔"),i=document.createElement("ul");i.classList.add("respec-dfn-list");const o=window.hyperHTML.bind(i);i.addEventListener("click",e=>{t.ui.closeModal(),e.stopPropagation()}),e.show=function(){o`${Object.entries(respecConfig.definitionMap).sort(([e],[t])=>e.localeCompare(t)).map(([e,t])=>{const[n]=t[0];return window.hyperHTML.wire(n,":li>a")` + <li> + <a href="${"#"+n.id}"> + ${n.textContent} + </a> + </li> + `})}`,t.ui.freshModal(n.l10n[n.lang].list_of_definitions,i,r)}}),define("ui/about-respec",["exports","core/ui","core/l10n","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.show=void 0,window.respecVersion=window.respecVersion||"Developer Edition";const r=document.createElement("div"),i=hyperHTML.bind(r),o=t.ui.addCommand(`About ${window.respecVersion}`,"ui/about-respec","Ctrl+Shift+Alt+A","ℹ️");function a({name:e,duration:t}){const n=hyperHTML.bind(document.createElement("tr"));return n` + <td> + <a href="${`https://github.com/w3c/respec/tree/develop/src/${e}.js`}"> + ${e} + </a> + </td> + <td> + ${t} + </td> + `}e.show=function(){t.ui.freshModal(`${n.l10n[n.lang].about_respec} - ${window.respecVersion}`,r,o);let e=[];"getEntriesByType"in performance&&performance.getEntriesByType("measure").sort((e,t)=>t.duration-e.duration).map(({name:e,duration:t})=>{const n=t.toFixed(2);return{name:e,duration:n>1e3?`${Math.round(n/1e3)} second(s)`:`${n} milliseconds`}}).map(a).reduce((e,t)=>(e.push(t),e),e),i` + <p> + ReSpec is a document production toolchain, with a notable focus on W3C specifications. + </p> + <p> + <a href='https://github.com/w3c/respec/wiki'>Documentation</a>, + <a href='https://github.com/w3c/respec/issues'>Bugs</a>. + </p> + <table border="1" width="100%" hidden="${!e.length}"> + <caption> + Loaded plugins + </caption> + <thead> + <tr> + <th> + Plugin Name + </th> + <th> + Processing time + </th> + </tr> + </thead> + <tbody>${e}</tbody> + </table> +`}}),define("core/seo",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=async function(e,t,n){n(),await t.respecIsReady;const r=t.querySelector("#abstract p:first-of-type");if(!r)return;!function(e){const t=e.ownerDocument,n=e.textContent.replace(/\s+/," ").trim(),r=t.createElement("meta");r.name="description",r.content=n,t.head.appendChild(r)}(r)};e.name="core/seo"}),define("w3c/seo",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,i,o){var a=e.shortName?"https://www.w3.org/TR/"+e.shortName+"/":null;switch(e.canonicalURI){case"edDraft":e.edDraftURI?e.canonicalURI=new URL(e.edDraftURI,i.location).href:((0,t.pub)("warn","Canonical URI set to edDraft, but no edDraftURI is set in configuration"),e.canonicalURI=null);break;case"TR":a?e.canonicalURI=a:((0,t.pub)("warn","Canonical URI set to TR, but no shortName is set in configuration"),e.canonicalURI=null);break;default:if(e.canonicalURI)try{e.canonicalURI=new URL(e.canonicalURI,i.location).href}catch(n){(0,t.pub)("warn","CanonicalURI is an invalid URL: "+n.message),e.canonicalURI=null}else a&&(e.canonicalURI=a)}if(e.canonicalURI){var s=i.createElement("link");s.setAttribute("rel","canonical"),s.setAttribute("href",e.canonicalURI),i.head.appendChild(s)}o(),e.doJsonLd&&async function(e,t){await t.respecIsReady;const i=["TechArticle"];e.rdfStatus&&i.push(e.rdfStatus);const o={"@context":["http://schema.org",{"@vocab":"http://schema.org/","@language":t.documentElement.lang||"en",w3p:"http://www.w3.org/2001/02pd/rec54#",foaf:"http://xmlns.com/foaf/0.1/",datePublished:{"@type":"http://www.w3.org/2001/XMLSchema#date"},inLanguage:{"@language":null},isBasedOn:{"@type":"@id"},license:{"@type":"@id"}}],id:e.canonicalURI||e.thisVersion,type:i,name:e.title,inLanguage:t.documentElement.lang||"en",license:e.licenseInfo.url,datePublished:e.dashDate,copyrightHolder:{name:"World Wide Web Consortium",url:"https://www.w3.org/"},discussionUrl:e.issueBase,alternativeHeadline:e.subtitle,isBasedOn:e.prevVersion};if(e.additionalCopyrightHolders){const t=Array.isArray(e.additionalCopyrightHolders)?e.additionalCopyrightHolders:[e.additionalCopyrightHolders];o.copyrightHolder=[o.copyrightHolder,...t.map(e=>({name:e}))]}const a=t.head.querySelector("meta[name=description]");a&&(o.description=a.content);e.editors&&(o.editor=e.editors.map(n));e.authors&&(o.contributor=e.authors.map(n));o.citation=[...e.normativeReferences,...e.informativeReferences].map(t=>e.biblio[t]).filter(e=>"object"==typeof e).map(r);const s=t.createElement("script");s.type="application/ld+json",s.textContent=JSON.stringify(o,null,2),t.head.appendChild(s)}(e,i)};e.name="w3c/seo";function n({name:e,url:t,mailto:n,company:r,companyURL:i}){const o={type:"Person",name:e,url:t,"foaf:mbox":n};return(r||i)&&(o.worksFor={name:r,url:i}),o}function r(e){const{href:t,title:n,href:r}=e;return{id:t,type:"TechArticle",name:n,url:r}}}),define("deps/text!core/css/github.css",[],function(){return"/*\n\ngithub.com style (c) Vasily Polovnyov <vast@whiteants.net>\n\n*/\n\n.hljs {\n display: block;\n overflow-x: auto;\n padding: 0.5em;\n color: #333;\n background: #f8f8f8;\n}\n\n.hljs-comment,\n.hljs-quote {\n color: #998;\n font-style: italic;\n}\n\n.hljs-keyword,\n.hljs-selector-tag,\n.hljs-subst {\n color: #333;\n font-weight: bold;\n}\n\n.hljs-number,\n.hljs-literal,\n.hljs-variable,\n.hljs-template-variable,\n.hljs-tag .hljs-attr {\n color: #008080;\n}\n\n.hljs-string,\n.hljs-doctag {\n color: #d14;\n}\n\n.hljs-title,\n.hljs-section,\n.hljs-selector-id {\n color: #900;\n font-weight: bold;\n}\n\n.hljs-subst {\n font-weight: normal;\n}\n\n.hljs-type,\n.hljs-class .hljs-title {\n color: #458;\n font-weight: bold;\n}\n\n.hljs-tag,\n.hljs-name,\n.hljs-attribute {\n color: #000080;\n font-weight: normal;\n}\n\n.hljs-regexp,\n.hljs-link {\n color: #009926;\n}\n\n.hljs-symbol,\n.hljs-bullet {\n color: #990073;\n}\n\n.hljs-built_in,\n.hljs-builtin-name {\n color: #0086b3;\n}\n\n.hljs-meta {\n color: #999;\n font-weight: bold;\n}\n\n.hljs-deletion {\n background: #fdd;\n}\n\n.hljs-addition {\n background: #dfd;\n}\n\n.hljs-emphasis {\n font-style: italic;\n}\n\n.hljs-strong {\n font-weight: bold;\n}\n"}),define("deps/text!core/../../worker/respec-worker.js",[],function(){return'// ReSpec Worker v0.1.1\n"use strict";\ntry {\n importScripts("https://www.w3.org/Tools/respec/respec-highlight.js");\n hljs.configure({\n tabReplace: " ", // 2 spaces\n languages: ["abnf", "css", "http", "javascript", "json", "markdown", "xml"],\n });\n} catch (err) {\n console.error("Network error loading/configuring highlighter", err);\n}\n\nself.addEventListener("message", ({ data: originalData }) => {\n const data = Object.assign({}, originalData);\n switch (data.action) {\n case "highlight":\n const { code } = data;\n const langs = data.languages.length ? data.languages : undefined;\n try {\n const { value, language } = self.hljs.highlightAuto(code, langs);\n Object.assign(data, { value, language });\n } catch (err) {\n console.error("Could not transform some code?", err);\n // Post back the original code\n Object.assign(data, { value: code, language: "" });\n }\n }\n self.postMessage(data);\n});\n'}),define("core/worker",["exports","core/utils","deps/text!../../worker/respec-worker.js"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.worker=e.name=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/worker";const o=(0,t.createResourceHint)({hint:"preload",href:"https://www.w3.org/Tools/respec/respec-highlight.js",as:"script"});document.head.appendChild(o);const a=URL.createObjectURL(new Blob([i.default],{type:"application/javascript"}));e.worker=new Worker(a)}),define("core/highlight",["exports","deps/text!core/css/github.css","core/worker"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){if(e.noHighlightCSS)return void o.remove();const t=Array.from(document.querySelectorAll("pre:not(.idl):not(.nohighlight), code.highlight"));if(0===t.length)return void o.remove();const r=t.map((e,t)=>new Promise(r=>{if(""===e.textContent.trim())return r();const o=()=>{e.setAttribute("aria-busy","false"),r()},a=setTimeout(()=>{console.error("Timed-out waiting for highlight:",e),o()},4e3),s={action:"highlight",code:e.textContent,id:`highlight:${t}`,languages:(i=e.classList,Array.from(i).filter(e=>"highlight"!==e&&"nolinks"!==e).map(e=>e.toLowerCase()))};n.worker.addEventListener("message",function t(r){const{data:{id:i,code:l,language:c,value:u}}=r;i===s.id&&(e.innerHTML=u,"pre"===e.localName&&e.classList.add("hljs"),c&&e.classList.add(c),clearTimeout(a),n.worker.removeEventListener("message",t),o())}),e.setAttribute("aria-busy","true"),n.worker.postMessage(s)}));var i;await Promise.all(r)};var r,i=(r=t)&&r.__esModule?r:{default:r};e.name="core/highlight";const o=document.createElement("style");o.textContent=i.default,document.head.appendChild(o)}),define("deps/text!core/images/clipboard.svg",[],function(){return'<svg height="16" viewBox="0 0 14 16" width="14"><path fill-rule="evenodd" d="M2 13h4v1H2v-1zm5-6H2v1h5V7zm2 3V8l-3 3 3 3v-2h5v-2H9zM4.5 9H2v1h2.5V9zM2 12h2.5v-1H2v1zm9 1h1v2c-.02.28-.11.52-.3.7-.19.18-.42.28-.7.3H1c-.55 0-1-.45-1-1V4c0-.55.45-1 1-1h3c0-1.11.89-2 2-2 1.11 0 2 .89 2 2h3c.55 0 1 .45 1 1v5h-1V6H1v9h10v-2zM2 5h8c0-.55-.45-1-1-1H8c-.55 0-1-.45-1-1s-.45-1-1-1-1 .45-1 1-.45 1-1 1H3c-.55 0-1 .45-1 1z"/></svg>'}),eXa=this,fXa=function(){return function(e){var t={};function n(r){if(t[r])return t[r].exports;var i=t[r]={i:r,l:!1,exports:{}};return e[r].call(i.exports,i,i.exports,n),i.l=!0,i.exports}return n.m=e,n.c=t,n.i=function(e){return e},n.d=function(e,t,r){n.o(e,t)||Object.defineProperty(e,t,{configurable:!1,enumerable:!0,get:r})},n.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return n.d(t,"a",t),t},n.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},n.p="",n(n.s=3)}([function(e,t,n){var r,i,o,a;a=function(e,t){var n,r=(n=t)&&n.__esModule?n:{default:n};var i="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e};var o=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),a=function(){function e(t){!function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}(this,e),this.resolveOptions(t),this.initSelection()}return o(e,[{key:"resolveOptions",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this.action=e.action,this.container=e.container,this.emitter=e.emitter,this.target=e.target,this.text=e.text,this.trigger=e.trigger,this.selectedText=""}},{key:"initSelection",value:function(){this.text?this.selectFake():this.target&&this.selectTarget()}},{key:"selectFake",value:function(){var e=this,t="rtl"==document.documentElement.getAttribute("dir");this.removeFake(),this.fakeHandlerCallback=function(){return e.removeFake()},this.fakeHandler=this.container.addEventListener("click",this.fakeHandlerCallback)||!0,this.fakeElem=document.createElement("textarea"),this.fakeElem.style.fontSize="12pt",this.fakeElem.style.border="0",this.fakeElem.style.padding="0",this.fakeElem.style.margin="0",this.fakeElem.style.position="absolute",this.fakeElem.style[t?"right":"left"]="-9999px";var n=window.pageYOffset||document.documentElement.scrollTop;this.fakeElem.style.top=n+"px",this.fakeElem.setAttribute("readonly",""),this.fakeElem.value=this.text,this.container.appendChild(this.fakeElem),this.selectedText=(0,r.default)(this.fakeElem),this.copyText()}},{key:"removeFake",value:function(){this.fakeHandler&&(this.container.removeEventListener("click",this.fakeHandlerCallback),this.fakeHandler=null,this.fakeHandlerCallback=null),this.fakeElem&&(this.container.removeChild(this.fakeElem),this.fakeElem=null)}},{key:"selectTarget",value:function(){this.selectedText=(0,r.default)(this.target),this.copyText()}},{key:"copyText",value:function(){var e=void 0;try{e=document.execCommand(this.action)}catch(t){e=!1}this.handleResult(e)}},{key:"handleResult",value:function(e){this.emitter.emit(e?"success":"error",{action:this.action,text:this.selectedText,trigger:this.trigger,clearSelection:this.clearSelection.bind(this)})}},{key:"clearSelection",value:function(){this.trigger&&this.trigger.focus(),window.getSelection().removeAllRanges()}},{key:"destroy",value:function(){this.removeFake()}},{key:"action",set:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:"copy";if(this._action=e,"copy"!==this._action&&"cut"!==this._action)throw new Error('Invalid "action" value, use either "copy" or "cut"')},get:function(){return this._action}},{key:"target",set:function(e){if(void 0!==e){if(!e||"object"!==(void 0===e?"undefined":i(e))||1!==e.nodeType)throw new Error('Invalid "target" value, use a valid Element');if("copy"===this.action&&e.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if("cut"===this.action&&(e.hasAttribute("readonly")||e.hasAttribute("disabled")))throw new Error('Invalid "target" attribute. You can\'t cut text from elements with "readonly" or "disabled" attributes');this._target=e}},get:function(){return this._target}}]),e}();e.exports=a},i=[e,n(7)],void 0===(o="function"==typeof(r=a)?r.apply(t,i):r)||(e.exports=o)},function(e,t,n){var r=n(6),i=n(5);e.exports=function(e,t,n){if(!e&&!t&&!n)throw new Error("Missing required arguments");if(!r.string(t))throw new TypeError("Second argument must be a String");if(!r.fn(n))throw new TypeError("Third argument must be a Function");if(r.node(e))return p=t,f=n,(d=e).addEventListener(p,f),{destroy:function(){d.removeEventListener(p,f)}};if(r.nodeList(e))return l=e,c=t,u=n,Array.prototype.forEach.call(l,function(e){e.addEventListener(c,u)}),{destroy:function(){Array.prototype.forEach.call(l,function(e){e.removeEventListener(c,u)})}};if(r.string(e))return o=e,a=t,s=n,i(document.body,o,a,s);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList");var o,a,s,l,c,u,d,p,f}},function(e,t){function n(){}n.prototype={on:function(e,t,n){var r=this.e||(this.e={});return(r[e]||(r[e]=[])).push({fn:t,ctx:n}),this},once:function(e,t,n){var r=this;function i(){r.off(e,i),t.apply(n,arguments)}return i._=t,this.on(e,i,n)},emit:function(e){for(var t=[].slice.call(arguments,1),n=((this.e||(this.e={}))[e]||[]).slice(),r=0,i=n.length;r<i;r++)n[r].fn.apply(n[r].ctx,t);return this},off:function(e,t){var n=this.e||(this.e={}),r=n[e],i=[];if(r&&t)for(var o=0,a=r.length;o<a;o++)r[o].fn!==t&&r[o].fn._!==t&&i.push(r[o]);return i.length?n[e]=i:delete n[e],this}},e.exports=n},function(e,t,n){var r,i,o,a;a=function(e,t,n,r){var i=s(t),o=s(n),a=s(r);function s(e){return e&&e.__esModule?e:{default:e}}var l="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e};var c=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}();var u=function(e){function t(e,n){!function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}(this,t);var r=function(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}(this,(t.__proto__||Object.getPrototypeOf(t)).call(this));return r.resolveOptions(n),r.listenClick(e),r}return function(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}(t,o.default),c(t,[{key:"resolveOptions",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this.action="function"==typeof e.action?e.action:this.defaultAction,this.target="function"==typeof e.target?e.target:this.defaultTarget,this.text="function"==typeof e.text?e.text:this.defaultText,this.container="object"===l(e.container)?e.container:document.body}},{key:"listenClick",value:function(e){var t=this;this.listener=(0,a.default)(e,"click",function(e){return t.onClick(e)})}},{key:"onClick",value:function(e){var t=e.delegateTarget||e.currentTarget;this.clipboardAction&&(this.clipboardAction=null),this.clipboardAction=new i.default({action:this.action(t),target:this.target(t),text:this.text(t),container:this.container,trigger:t,emitter:this})}},{key:"defaultAction",value:function(e){return d("action",e)}},{key:"defaultTarget",value:function(e){var t=d("target",e);if(t)return document.querySelector(t)}},{key:"defaultText",value:function(e){return d("text",e)}},{key:"destroy",value:function(){this.listener.destroy(),this.clipboardAction&&(this.clipboardAction.destroy(),this.clipboardAction=null)}}],[{key:"isSupported",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:["copy","cut"],t="string"==typeof e?[e]:e,n=!!document.queryCommandSupported;return t.forEach(function(e){n=n&&!!document.queryCommandSupported(e)}),n}}]),t}();function d(e,t){var n="data-clipboard-"+e;if(t.hasAttribute(n))return t.getAttribute(n)}e.exports=u},i=[e,n(0),n(2),n(1)],void 0===(o="function"==typeof(r=a)?r.apply(t,i):r)||(e.exports=o)},function(e,t){var n=9;if("undefined"!=typeof Element&&!Element.prototype.matches){var r=Element.prototype;r.matches=r.matchesSelector||r.mozMatchesSelector||r.msMatchesSelector||r.oMatchesSelector||r.webkitMatchesSelector}e.exports=function(e,t){for(;e&&e.nodeType!==n;){if("function"==typeof e.matches&&e.matches(t))return e;e=e.parentNode}}},function(e,t,n){var r=n(4);function i(e,t,n,i,o){var a=function(e,t,n,i){return function(n){n.delegateTarget=r(n.target,t),n.delegateTarget&&i.call(e,n)}}.apply(this,arguments);return e.addEventListener(n,a,o),{destroy:function(){e.removeEventListener(n,a,o)}}}e.exports=function(e,t,n,r,o){return"function"==typeof e.addEventListener?i.apply(null,arguments):"function"==typeof n?i.bind(null,document).apply(null,arguments):("string"==typeof e&&(e=document.querySelectorAll(e)),Array.prototype.map.call(e,function(e){return i(e,t,n,r,o)}))}},function(e,t){t.node=function(e){return void 0!==e&&e instanceof HTMLElement&&1===e.nodeType},t.nodeList=function(e){var n=Object.prototype.toString.call(e);return void 0!==e&&("[object NodeList]"===n||"[object HTMLCollection]"===n)&&"length"in e&&(0===e.length||t.node(e[0]))},t.string=function(e){return"string"==typeof e||e instanceof String},t.fn=function(e){return"[object Function]"===Object.prototype.toString.call(e)}},function(e,t){e.exports=function(e){var t;if("SELECT"===e.nodeName)e.focus(),t=e.value;else if("INPUT"===e.nodeName||"TEXTAREA"===e.nodeName){var n=e.hasAttribute("readonly");n||e.setAttribute("readonly",""),e.select(),e.setSelectionRange(0,e.value.length),n||e.removeAttribute("readonly"),t=e.value}else{e.hasAttribute("contenteditable")&&e.focus();var r=window.getSelection(),i=document.createRange();i.selectNodeContents(e),r.removeAllRanges(),r.addRange(i),t=r.toString()}return t}}])},"object"==typeof exports&&"object"==typeof module?module.exports=fXa():"function"==typeof define&&define.amd?define("deps/clipboard",[],fXa):"object"==typeof exports?exports.ClipboardJS=fXa():eXa.ClipboardJS=fXa(),define("core/webidl-clipboard",["exports","deps/text!core/images/clipboard.svg","deps/clipboard"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e,t,n){Array.from(t.querySelectorAll("pre.idl")).map(e=>{const t=a.cloneNode(!0),n=e.querySelector('span[id^="idl-def-"], span[id^="dom-"]');let r="#";return null===n&&""===e.id?"idl-index"===e.parentElement.id?r+="actual-idl-index":(e.id=`idl-${String(Math.random()).substr(2)}`,r+=e.id):r+=e.id||n.id,{button:t,elem:e,target:r}}).forEach(({elem:e,button:n,target:r})=>{const i=t.createElement("div");n.dataset.clipboardTarget=r,e.parentElement.replaceChild(i,e),i.appendChild(n),i.appendChild(e)}),new i.default(".respec-button-copy-paste",s).on("success",e=>e.clearSelection()),n()};var r=o(t),i=o(n);function o(e){return e&&e.__esModule?e:{default:e}}e.name="core/webidl-clipboard";const a=document.createElement("button");a.innerHTML=r.default,a.title="Copy IDL to clipboard",a.classList.add("respec-button-copy-paste","removeOnSave");const s={text:e=>document.querySelector(e.dataset.clipboardTarget).textContent.replace(/\ +/gm," ").replace(/^\ /gm," ").replace(/^};\n/gm,"};\n").trim()}}),define("core/data-tests",["exports","core/pubsubhub","core/l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){const n=document.querySelectorAll("[data-tests]");if(!n.length)return;if(!e.testSuiteURI)return void(0,t.pub)("error",r[i].missing_test_suite_uri);Array.from(n).filter(e=>e.dataset.tests).map(n=>{const a=document.createElement("details"),s=hyperHTML.bind(a),l=n.dataset.tests.split(/,/gm).map(e=>e.trim()).map(n=>{let o="";try{o=new URL(n,e.testSuiteURI).href}catch(e){(0,t.pub)("warn",`${r[i].bad_uri}: ${n}`)}return o});return a.classList.add("respec-tests-details","removeOnSave"),s` + <summary> + tests: ${l.length} + </summary> + <ul>${l.map(o)}</ul> + `,{elem:n,details:a}}).forEach(({elem:e,details:t})=>{delete e.dataset.tests,e.insertAdjacentElement("beforeend",t)})};const r={en:{missing_test_suite_uri:"Found tests in your spec, but missing '[`testSuiteURI`](https://github.com/w3c/respec/wiki/testSuiteURI)' in your ReSpec config.",tests:"tests",test:"test"}},i=(e.name="core/data-tests",n.lang in r?n.lang:"en");function o(e){const t=[],[n]=new URL(e).pathname.split("/").reverse(),r=n.split(".");let[i]=r;if(r.find(e=>"https"===e)){const e=document.createElement("span");e.innerHTML="🔒",e.setAttribute("aria-label","requires a secure connection"),e.setAttribute("title","Test requires HTTPS"),i=i.replace(".https",""),t.push(e)}if(i.split(".").join("-").split("-").find(e=>"manual"===e)){const e=document.createElement("span");e.innerHTML="💪",e.setAttribute("aria-label","the test must be run manually"),e.setAttribute("title","Manual test"),i=i.replace("-manual",""),t.push(e)}return hyperHTML.bind(document.createElement("li"))` + <a href="${e}"> + ${i} + </a> ${t} + `}}),define("core/list-sorter",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.sortListItems=r,e.sortDefinitionTerms=o,e.run=function(e,n,i){for(const e of document.querySelectorAll("[data-sort]")){let n;const i=e.dataset.sort||"ascending";switch(e.localName){case"dl":n=o(e,i);break;case"ol":case"ul":n=r(e,i);break;default:(0,t.pub)("warning",`ReSpec can't sort ${e.localName} elements.`)}if(n){const t=document.createRange();t.selectNodeContents(e),t.deleteContents(),e.appendChild(n)}}i()};e.name="core/list-sorter";function n(e){return({textContent:t},{textContent:n})=>"ascending"===e?t.localeCompare(n):n.localeCompare(t)}function r(e,t){return i(e,"li").sort(n(t)).reduce((e,t)=>(e.appendChild(t),e),document.createDocumentFragment())}function i(e,t){let n;try{n=e.querySelectorAll(`:scope > ${t}`)}catch(r){let i="";e.id||(i=`temp-${String(Math.random()).substr(2)}`,e.id=i);const o=`#${e.id} > ${t}`;n=e.parentElement.querySelectorAll(o),i&&(e.id="")}return[...n]}function o(e,t){return i(e,"dt").sort(n(t)).reduce((e,t)=>{const{nodeType:n,nodeName:r}=t,i=document.createDocumentFragment();let{nextSibling:o}=t;for(;o&&o.nextSibling;){i.appendChild(o.cloneNode(!0));const{nodeType:e,nodeName:t}=o.nextSibling;if(e===n&&t===r)break;o=o.nextSibling}return i.prepend(t.cloneNode(!0)),e.appendChild(i),e},document.createDocumentFragment())}}),define("deps/text!core/css/var.css",[],function(){return"var:hover {\n border-bottom: 1px dotted;\n cursor: pointer;\n}\n\nvar.respec-hl {\n color: var(--color, #000);\n background-color: var(--bg-color);\n box-shadow: 0 0 0px 2px var(--bg-color);\n}\n\n/* highlight colors\n https://github.com/w3c/tr-design/issues/152\n*/\nvar.respec-hl-c1 {\n --bg-color: #f4d200;\n}\n\nvar.respec-hl-c2 {\n --bg-color: #ff87a2;\n}\n\nvar.respec-hl-c3 {\n --bg-color: #96e885;\n}\n\nvar.respec-hl-c4 {\n --bg-color: #3eeed2;\n}\n\nvar.respec-hl-c5 {\n --bg-color: #eacfb6;\n}\n\nvar.respec-hl-c6 {\n --bg-color: #82ddff;\n}\n\nvar.respec-hl-c7 {\n --bg-color: #ffbcf2;\n}\n\n@media print {\n var.respec-hl {\n background: none;\n color: #000;\n box-shadow: unset;\n }\n}\n"}),define("core/highlight-vars",["exports","core/pubsubhub","deps/text!core/css/var.css"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){if(!e.highlightVars)return;const n=document.createElement("style");n.textContent=i.default,n.classList.add("removeOnSave"),document.head.appendChild(n),[...document.querySelectorAll("var")].forEach(e=>e.addEventListener("click",o)),(0,t.sub)("beforesave",e=>{[...e.querySelectorAll("var.respec-hl")].forEach(l)})};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/highlight-vars";function o(e){e.stopPropagation();const{target:t}=e,n=function(e){const t=e.textContent.trim(),n=e.closest("section"),r=s(e),i=[...n.querySelectorAll("var")].filter(e=>e.textContent.trim()===t),o=i[0].classList.contains("respec-hl");if(a.set(r,o),o)return i.forEach(e=>l(e,r)),[];i.forEach(e=>(c=e,u=r,void c.classList.add("respec-hl",u)));var c,u;return i}(t),r=()=>{const e=s(t);n.forEach(t=>l(t,e)),[...a.keys()].forEach(e=>a.set(e,!0))};n.length&&document.body.addEventListener("click",r,{once:!0})}const a=new Map([["respec-hl-c1",!0],["respec-hl-c2",!0],["respec-hl-c3",!0],["respec-hl-c4",!0],["respec-hl-c5",!0],["respec-hl-c6",!0],["respec-hl-c7",!0]]);function s(e){const{value:t}=e.classList,n=/respec-hl-\w+/,r=n.test(t)&&t.match(n);return r?r[0]:!0===a.get("respec-hl-c1")?"respec-hl-c1":[...a.keys()].find(e=>a.get(e))||"respec-hl-c1"}function l(e,t){e.classList.remove("respec-hl",t),e.classList.length||e.removeAttribute("class")}}),window.addEventListener("error",e=>{console.error(e.error,e.message,e)}),require.config({shim:{shortcut:{exports:"shortcut"},highlight:{exports:"hljs"}},paths:{"handlebars.runtime":"deps/handlebars","deps/highlight":"https://www.w3.org/Tools/respec/respec-highlight"},deps:["deps/hyperhtml","deps/url-search-params"]}),define("profile-oai",["deps/domReady","core/base-runner","core/ui","core/l10n","oai/defaults","core/style","w3c/style","w3c/l10n","core/github","core/data-include","core/markdown","oai/headers","w3c/abstract","w3c/conformance","core/data-transform","core/inlines","core/dfn","w3c/rfc2119","core/examples","core/issues-notes","core/requirements","core/best-practices","core/figures","core/webidl","core/data-cite","core/biblio","core/webidl-index","core/link-to-dfn","core/contrib","core/fix-headers","core/structure","w3c/informative","w3c/permalinks","core/id-headers","core/location-hash","core/caniuse","ui/save-html","ui/search-specref","ui/dfn-list","ui/about-respec","core/seo","w3c/seo","core/highlight","core/webidl-clipboard","core/data-tests","core/list-sorter","core/highlight-vars","core/linter"],(e,t,{ui:n},...r)=>{n.show(),e(async()=>{try{await t.runAll(r),await document.respecIsReady}catch(e){console.error(e)}finally{n.enable()}})}),require(["profile-oai"]); +//# sourceMappingURL=respec-oai.build.js.map \ No newline at end of file diff --git a/js/respec-worker.js b/js/respec-worker.js new file mode 100644 index 0000000000..71da79cb6c --- /dev/null +++ b/js/respec-worker.js @@ -0,0 +1,29 @@ +// ReSpec Worker v0.1.1 +"use strict"; +try { + importScripts("https://www.w3.org/Tools/respec/respec-highlight.js"); + hljs.configure({ + tabReplace: " ", // 2 spaces + languages: ["abnf", "css", "http", "javascript", "json", "markdown", "xml"], + }); +} catch (err) { + console.error("Network error loading/configuring highlighter", err); +} + +self.addEventListener("message", ({ data: originalData }) => { + const data = Object.assign({}, originalData); + switch (data.action) { + case "highlight": + const { code } = data; + const langs = data.languages.length ? data.languages : undefined; + try { + const { value, language } = self.hljs.highlightAuto(code, langs); + Object.assign(data, { value, language }); + } catch (err) { + console.error("Could not transform some code?", err); + // Post back the original code + Object.assign(data, { value: code, language: "" }); + } + } + self.postMessage(data); +}); diff --git a/oas/v3.0.1.html b/oas/v3.0.1.html new file mode 100644 index 0000000000..7c0da96986 --- /dev/null +++ b/oas/v3.0.1.html @@ -0,0 +1,4031 @@ +<html><head><meta charset="UTF-8"><title>OpenAPI Specification
      The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

      State of This Document

      The source-of-truth for the specification is the GitHub markdown file referenced above.
      +

      OpenAPI Specification

      +

      Version 3.0.1

      +

      The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!rfc2119]] [[!rfc8174]] when, and only when, they appear in all capitals, as shown here.

      +

      This document is licensed under The Apache License, Version 2.0.

      +

      Introduction

      +

      The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

      +

      An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

      + +

      Definitions

      +

      OpenAPI Document

      +

      A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

      +

      Path Templating

      +

      Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

      +

      Media Types

      +

      Media type definitions are spread across several resources. +The media type definitions SHOULD be in compliance with [[!rfc6838]].

      +

      Some examples of possible media type definitions:

      +
      
      +  text/plain; charset=utf-8
      +  application/json
      +  application/vnd.github+json
      +  application/vnd.github.v3+json
      +  application/vnd.github.v3.raw+json
      +  application/vnd.github.v3.text+json
      +  application/vnd.github.v3.html+json
      +  application/vnd.github.v3.full+json
      +  application/vnd.github.v3.diff
      +  application/vnd.github.v3.patch
      +
      +

      HTTP Status Codes

      +

      The HTTP Status Codes are used to indicate the status of the executed operation. +The available status codes are defined by [[!rfc7231]]section-6) and registered status codes are listed in the IANA Status Code Registry.

      +

      Specification

      +

      Versions

      +

      The OpenAPI Specification is versioned using Semantic Versioning 2.0.0 (semver) and follows the semver specification.

      +

      The major.minor portion of the semver (for example 3.0) SHALL designate the OAS feature set. Typically, .patch versions address errors in this document, not the feature set. Tooling which supports OAS 3.0 SHOULD be compatible with all OAS 3.0.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.0.0 and 3.0.1 for example.

      +

      Subsequent minor version releases of the OpenAPI Specification (incrementing the minor version number) SHOULD NOT interfere with tooling developed to a lower minor version and same major version. Thus a hypothetical 3.1.0 specification SHOULD be usable with tooling designed for 3.0.0.

      +

      An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the semantic version of the OAS that it uses. (OAS 2.0 documents contain a top-level version field named swagger and value "2.0".)

      +

      Format

      +

      An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

      +

      For example, if a field has an array value, the JSON array representation will be used:

      +
      
      +{
      +   "field": [ 1, 2, 3 ]
      +}
      +
      +

      All field names in the specification are case sensitive.

      +

      The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

      +

      Patterned fields MUST have unique names within the containing object.

      +

      In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

      + +

      Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

      +

      Document Structure

      +

      An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

      +

      It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

      +

      Data Types

      +

      Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. +Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. +null is not supported as a type (see nullable for an alternative solution). +Models are defined using the Schema Object, which is an extended subset of JSON Schema Specification Wright Draft 00.

      +

      Primitives have an optional modifier property: format. +OAS uses several known formats to define in fine detail the data type being used. +However, to support documentation needs, the format property is an open string-valued property, and can have any value. +Formats such as "email", "uuid", and so on, MAY be used even though undefined by this specification. +Types that are not accompanied by a format property follow the type definition in the JSON Schema. Tools that do not recognize a specific format MAY default back to the type alone, as if the format is not specified.

      +

      The formats defined by the OAS are:

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Common NametypeformatComments
      integerintegerint32signed 32 bits
      longintegerint64signed 64 bits
      floatnumberfloat
      doublenumberdouble
      stringstring
      bytestringbytebase64 encoded characters
      binarystringbinaryany sequence of octets
      booleanboolean
      datestringdateAs defined by full-date - [!rfc3339]
      dateTimestringdate-timeAs defined by date-time - [!rfc3339]
      passwordstringpasswordA hint to UIs to obscure input.
      +

      Rich Text Formatting

      +

      Throughout the specification description fields are noted as supporting CommonMark markdown formatting. +Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

      +

      Relative References in URLs

      +

      Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!rfc3986]]section-4.2). +Relative references are resolved using the URLs defined in the Server Object as a Base URI.

      +

      Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

      +

      Schema

      +

      In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

      +

      OpenAPI Object

      +

      This is the root document object of the OpenAPI document.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      openapistringREQUIRED. This string MUST be the semantic version number of the OpenAPI Specification version that the OpenAPI document uses. The openapi field SHOULD be used by tooling specifications and clients to interpret the OpenAPI document. This is not related to the API info.version string.
      infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
      servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
      pathsPaths ObjectREQUIRED. The available paths and operations for the API.
      componentsComponents ObjectAn element to hold various schemas for the specification.
      security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition.
      tags[Tag Object]A list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
      externalDocsExternal Documentation ObjectAdditional external documentation.
      +

      This object MAY be extended with Specification Extensions.

      +

      Info Object

      +

      The object provides metadata about the API. +The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      titlestringREQUIRED. The title of the application.
      descriptionstringA short description of the application. CommonMark syntax MAY be used for rich text representation.
      termsOfServicestringA URL to the Terms of Service for the API. MUST be in the format of a URL.
      contactContact ObjectThe contact information for the exposed API.
      licenseLicense ObjectThe license information for the exposed API.
      versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
      +

      This object MAY be extended with Specification Extensions.

      +

      Info Object Example:

      +
      
      +{
      +  "title": "Sample Pet Store App",
      +  "description": "This is a sample server for a pet store.",
      +  "termsOfService": "http://example.com/terms/",
      +  "contact": {
      +    "name": "API Support",
      +    "url": "http://www.example.com/support",
      +    "email": "support@example.com"
      +  },
      +  "license": {
      +    "name": "Apache 2.0",
      +    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
      +  },
      +  "version": "1.0.1"
      +}
      +
      +
      
      +title: Sample Pet Store App
      +description: This is a sample server for a pet store.
      +termsOfService: http://example.com/terms/
      +contact:
      +  name: API Support
      +  url: http://www.example.com/support
      +  email: support@example.com
      +license:
      +  name: Apache 2.0
      +  url: https://www.apache.org/licenses/LICENSE-2.0.html
      +version: 1.0.1
      +
      +

      Contact Object

      +

      Contact information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringThe identifying name of the contact person/organization.
      urlstringThe URL pointing to the contact information. MUST be in the format of a URL.
      emailstringThe email address of the contact person/organization. MUST be in the format of an email address.
      +

      This object MAY be extended with Specification Extensions.

      +

      Contact Object Example:

      +
      
      +{
      +  "name": "API Support",
      +  "url": "http://www.example.com/support",
      +  "email": "support@example.com"
      +}
      +
      +
      
      +name: API Support
      +url: http://www.example.com/support
      +email: support@example.com
      +
      +

      License Object

      +

      License information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The license name used for the API.
      urlstringA URL to the license used for the API. MUST be in the format of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      License Object Example:

      +
      
      +{
      +  "name": "Apache 2.0",
      +  "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
      +}
      +
      +
      
      +name: Apache 2.0
      +url: https://www.apache.org/licenses/LICENSE-2.0.html
      +
      +

      Server Object

      +

      An object representing a Server.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
      descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
      variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
      +

      This object MAY be extended with Specification Extensions.

      +

      Server Object Example

      +

      A single server would be described as:

      +
      
      +{
      +  "url": "https://development.gigantic-server.com/v1",
      +  "description": "Development server"
      +}
      +
      +
      
      +url: https://development.gigantic-server.com/v1
      +description: Development server
      +
      +

      The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

      +
      
      +{
      +  "servers": [
      +    {
      +      "url": "https://development.gigantic-server.com/v1",
      +      "description": "Development server"
      +    },
      +    {
      +      "url": "https://staging.gigantic-server.com/v1",
      +      "description": "Staging server"
      +    },
      +    {
      +      "url": "https://api.gigantic-server.com/v1",
      +      "description": "Production server"
      +    }
      +  ]
      +}
      +
      +
      
      +servers:
      +- url: https://development.gigantic-server.com/v1
      +  description: Development server
      +- url: https://staging.gigantic-server.com/v1
      +  description: Staging server
      +- url: https://api.gigantic-server.com/v1
      +  description: Production server
      +
      +

      The following shows how variables can be used for a server configuration:

      +
      
      +{
      +  "servers": [
      +    {
      +      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
      +      "description": "The production API server",
      +      "variables": {
      +        "username": {
      +          "default": "demo",
      +          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
      +        },
      +        "port": {
      +          "enum": [
      +            "8443",
      +            "443"
      +          ],
      +          "default": "8443"
      +        },
      +        "basePath": {
      +          "default": "v2"
      +        }
      +      }
      +    }
      +  ]
      +}
      +
      +
      
      +servers:
      +- url: https://{username}.gigantic-server.com:{port}/{basePath}
      +  description: The production API server
      +  variables:
      +    username:
      +      # note! no enum here means it is an open value
      +      default: demo
      +      description: this value is assigned by the service provider, in this example `gigantic-server.com`
      +    port:
      +      enum:
      +        - '8443'
      +        - '443'
      +      default: '8443'
      +    basePath:
      +      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
      +      default: v2
      +
      +

      Server Variable Object

      +

      An object representing a Server Variable for server URL template substitution.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      enum[string]An enumeration of string values to be used if the substitution options are from a limited set.
      defaultstringREQUIRED. The default value to use for substitution, and to send, if an alternate value is not supplied. Unlike the Schema Object’s default, this value MUST be provided by the consumer.
      descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
      +

      This object MAY be extended with Specification Extensions.

      +

      Components Object

      +

      Holds a set of reusable objects for different aspects of the OAS. +All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      schemasMap[string, Schema Object ¦ Reference Object]An object to hold reusable Schema Objects.
      responsesMap[string, Response Object ¦ Reference Object]An object to hold reusable Response Objects.
      parametersMap[string, Parameter Object ¦ Reference Object]An object to hold reusable Parameter Objects.
      examplesMap[string, Example Object ¦ Reference Object]An object to hold reusable Example Objects.
      requestBodiesMap[string, Request Body Object ¦ Reference Object]An object to hold reusable Request Body Objects.
      headersMap[string, Header Object ¦ Reference Object]An object to hold reusable Header Objects.
      securitySchemesMap[string, Security Scheme Object ¦ Reference Object]An object to hold reusable Security Scheme Objects.
      linksMap[string, Link Object ¦ Reference Object]An object to hold reusable Link Objects.
      callbacksMap[string, Callback Object ¦ Reference Object]An object to hold reusable Callback Objects.
      +

      This object MAY be extended with Specification Extensions.

      +

      All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

      +

      Field Name Examples:

      +
      
      +User
      +User_1
      +User_Name
      +user-name
      +my.org.User
      +
      +

      Components Object Example

      +
      
      +"components": {
      +  "schemas": {
      +    "Category": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      }
      +    },
      +    "Tag": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      }
      +    }
      +  },
      +  "parameters": {
      +    "skipParam": {
      +      "name": "skip",
      +      "in": "query",
      +      "description": "number of items to skip",
      +      "required": true,
      +      "schema": {
      +        "type": "integer",
      +        "format": "int32"
      +      }
      +    },
      +    "limitParam": {
      +      "name": "limit",
      +      "in": "query",
      +      "description": "max records to return",
      +      "required": true,
      +      "schema" : {
      +        "type": "integer",
      +        "format": "int32"
      +      }
      +    }
      +  },
      +  "responses": {
      +    "NotFound": {
      +      "description": "Entity not found."
      +    },
      +    "IllegalInput": {
      +      "description": "Illegal input for operation."
      +    },
      +    "GeneralError": {
      +      "description": "General Error",
      +      "content": {
      +        "application/json": {
      +          "schema": {
      +            "$ref": "#/components/schemas/GeneralError"
      +          }
      +        }
      +      }
      +    }
      +  },
      +  "securitySchemes": {
      +    "api_key": {
      +      "type": "apiKey",
      +      "name": "api_key",
      +      "in": "header"
      +    },
      +    "petstore_auth": {
      +      "type": "oauth2",
      +      "flows": {
      +        "implicit": {
      +          "authorizationUrl": "http://example.org/api/oauth/dialog",
      +          "scopes": {
      +            "write:pets": "modify pets in your account",
      +            "read:pets": "read your pets"
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    Category:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +    Tag:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +  parameters:
      +    skipParam:
      +      name: skip
      +      in: query
      +      description: number of items to skip
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +    limitParam:
      +      name: limit
      +      in: query
      +      description: max records to return
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +  responses:
      +    NotFound:
      +      description: Entity not found.
      +    IllegalInput:
      +      description: Illegal input for operation.
      +    GeneralError:
      +      description: General Error
      +      content:
      +        application/json:
      +          schema:
      +            $ref: '#/components/schemas/GeneralError'
      +  securitySchemes:
      +    api_key:
      +      type: apiKey
      +      name: api_key
      +      in: header
      +    petstore_auth:
      +      type: oauth2
      +      flows: 
      +        implicit:
      +          authorizationUrl: http://example.org/api/oauth/dialog
      +          scopes:
      +            write:pets: modify pets in your account
      +            read:pets: read your pets
      +
      +

      Paths Object

      +

      Holds the relative paths to the individual endpoints and their operations. +The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a slash. The path is appended (no relative URL resolution) to the expanded URL from the Server Object's url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
      +

      This object MAY be extended with Specification Extensions.

      +

      Path Templating Matching

      +

      Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

      +
      
      +  /pets/{petId}
      +  /pets/mine
      +
      +

      The following paths are considered identical and invalid:

      +
      
      +  /pets/{petId}
      +  /pets/{name}
      +
      +

      The following may lead to ambiguous resolution:

      +
      
      +  /{entity}/me
      +  /books/{id}
      +
      +

      Paths Object Example

      +
      
      +{
      +  "/pets": {
      +    "get": {
      +      "description": "Returns all pets from the system that the user has access to",
      +      "responses": {
      +        "200": {          
      +          "description": "A list of pets.",
      +          "content": {
      +            "application/json": {
      +              "schema": {
      +                "type": "array",
      +                "items": {
      +                  "$ref": "#/components/schemas/pet"
      +                }
      +              }
      +            }
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +/pets:
      +  get:
      +    description: Returns all pets from the system that the user has access to
      +    responses:
      +      '200':
      +        description: A list of pets.
      +        content:
      +          application/json:
      +            schema:
      +              type: array
      +              items:
      +                $ref: '#/components/schemas/pet'
      +
      +

      Path Item Object

      +

      Describes the operations available on a single path. +A Path Item MAY be empty, due to ACL constraints. +The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringAllows for an external definition of this path item. The referenced structure MUST be in the format of a Path Item Object. If there are conflicts between the referenced definition and this Path Item’s definition, the behavior is undefined.
      summarystringAn optional, string summary, intended to apply to all operations in this path.
      descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
      getOperation ObjectA definition of a GET operation on this path.
      putOperation ObjectA definition of a PUT operation on this path.
      postOperation ObjectA definition of a POST operation on this path.
      deleteOperation ObjectA definition of a DELETE operation on this path.
      optionsOperation ObjectA definition of a OPTIONS operation on this path.
      headOperation ObjectA definition of a HEAD operation on this path.
      patchOperation ObjectA definition of a PATCH operation on this path.
      traceOperation ObjectA definition of a TRACE operation on this path.
      servers[Server Object]An alternative server array to service all operations in this path.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      +

      This object MAY be extended with Specification Extensions.

      +

      Path Item Object Example

      +
      
      +{
      +  "get": {
      +    "description": "Returns pets based on ID",
      +    "summary": "Find pets by ID",
      +    "operationId": "getPetsById",
      +    "responses": {
      +      "200": {
      +        "description": "pet response",
      +        "content": {
      +          "*/*": {
      +            "schema": {
      +              "type": "array",
      +              "items": {
      +                "$ref": "#/components/schemas/Pet"
      +              }
      +            }
      +          }
      +        }
      +      },
      +      "default": {
      +        "description": "error payload",
      +        "content": {
      +          "text/html": {
      +            "schema": {
      +              "$ref": "#/components/schemas/ErrorModel"
      +            }
      +          }
      +        }
      +      }
      +    }
      +  },
      +  "parameters": [
      +    {
      +      "name": "id",
      +      "in": "path",
      +      "description": "ID of pet to use",
      +      "required": true,
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
      +        }
      +      },
      +      "style": "simple"
      +    }
      +  ]
      +}
      +
      +
      
      +get:
      +  description: Returns pets based on ID
      +  summary: Find pets by ID
      +  operationId: getPetsById
      +  responses:
      +    '200':
      +      description: pet response
      +      content:
      +        '*/*' :
      +          schema:
      +            type: array
      +            items:
      +              $ref: '#/components/schemas/Pet'
      +    default:
      +      description: error payload
      +      content:
      +        'text/html':
      +          schema:
      +            $ref: '#/components/schemas/ErrorModel'
      +parameters:
      +- name: id
      +  in: path
      +  description: ID of pet to use
      +  required: true
      +  schema:
      +    type: array
      +    style: simple
      +    items:
      +      type: string  
      +
      +

      Operation Object

      +

      Describes a single API operation on a path.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
      summarystringA short summary of what the operation does.
      descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
      operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      requestBodyRequest Body Object ¦ Reference ObjectThe request body applicable for this operation. The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [[!rfc7231]]section-4.3.1) has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers.
      responsesResponses ObjectREQUIRED. The list of possible responses as they are returned from executing this operation.
      callbacksMap[string, Callback Object ¦ Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses. The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.
      deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
      security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
      servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
      +

      This object MAY be extended with Specification Extensions.

      +

      Operation Object Example

      +
      
      +{
      +  "tags": [
      +    "pet"
      +  ],
      +  "summary": "Updates a pet in the store with form data",
      +  "operationId": "updatePetWithForm",
      +  "parameters": [
      +    {
      +      "name": "petId",
      +      "in": "path",
      +      "description": "ID of pet that needs to be updated",
      +      "required": true,
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  ],
      +  "requestBody": {
      +    "content": {
      +      "application/x-www-form-urlencoded": {
      +        "schema": {
      +          "type": "object",
      +           "properties": {
      +              "name": { 
      +                "description": "Updated name of the pet",
      +                "type": "string"
      +              },
      +              "status": {
      +                "description": "Updated status of the pet",
      +                "type": "string"
      +             }
      +           },
      +        "required": ["status"] 
      +        }
      +      }
      +    }
      +  },
      +  "responses": {
      +    "200": {
      +      "description": "Pet updated.",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
      +      }
      +    },
      +    "405": {
      +      "description": "Invalid input",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
      +      }
      +    }
      +  },
      +  "security": [
      +    {
      +      "petstore_auth": [
      +        "write:pets",
      +        "read:pets"
      +      ]
      +    }
      +  ]
      +}
      +
      +
      
      +tags:
      +- pet
      +summary: Updates a pet in the store with form data
      +operationId: updatePetWithForm
      +parameters:
      +- name: petId
      +  in: path
      +  description: ID of pet that needs to be updated
      +  required: true
      +  schema:
      +    type: string
      +requestBody:
      +  content:
      +    'application/x-www-form-urlencoded':
      +      schema:
      +       properties:
      +          name: 
      +            description: Updated name of the pet
      +            type: string
      +          status:
      +            description: Updated status of the pet
      +            type: string
      +       required:
      +         - status
      +responses:
      +  '200':
      +    description: Pet updated.
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +  '405':
      +    description: Invalid input
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +security:
      +- petstore_auth:
      +  - write:pets
      +  - read:pets
      +
      +

      External Documentation Object

      +

      Allows referencing an external resource for extended documentation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA short description of the target documentation. CommonMark syntax MAY be used for rich text representation.
      urlstringREQUIRED. The URL for the target documentation. Value MUST be in the format of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      External Documentation Object Example

      +
      
      +{
      +  "description": "Find more info here",
      +  "url": "https://example.com"
      +}
      +
      +
      
      +description: Find more info here
      +url: https://example.com
      +
      +

      Parameter Object

      +

      Describes a single operation parameter.

      +

      A unique parameter is defined by a combination of a name and location.

      +

      Parameter Locations

      +

      There are four possible parameter locations specified by the in field:

      +
        +
      • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
      • +
      • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
      • +
      • header - Custom headers that are expected as part of the request. Note that [[!rfc7230]]page-22) states header names are case insensitive.
      • +
      • cookie - Used to pass a specific cookie value to the API.
      • +
      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
      • If in is "path", the name field MUST correspond to the associated path segment from the path field in the Paths Object. See Path Templating for further information.
      • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
      • For all other cases, the name corresponds to the parameter name used by the in property.
      instringREQUIRED. The location of the parameter. Possible values are “query”, “header”, “path” or “cookie”.
      descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
      requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is “path”, this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
      deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage.
      allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored.
      +

      The rules for serialization of the parameter are specified in one of two ways. +For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
      explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
      allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!rfc3986]]section-2.2) :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
      schemaSchema Object ¦ Reference ObjectThe schema defining the type used for the parameter.
      exampleAnyExample of the media type. The example SHOULD match the specified schema and encoding properties if present. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
      examplesMap[ string, Example Object ¦ Reference Object]Examples of the media type. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
      +

      For more complex scenarios, the content property can define the media type and schema of the parameter. +A parameter MUST contain either a schema property, or a content property, but not both. +When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
      +

      Style Values

      +

      In order to support common ways of serializing simple parameters, a set of style values are defined.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      styletypeinComments
      matrixprimitive, array, objectpathPath-style parameters defined by [[!rfc6570]]section-3.2.7)
      labelprimitive, array, objectpathLabel style parameters defined by [[!rfc6570]]section-3.2.5)
      formprimitive, array, objectquery, cookieForm style parameters defined by [[!rfc6570]]section-3.2.8). This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
      simplearraypath, headerSimple style parameters defined by [[!rfc6570]]section-3.2.2). This option replaces collectionFormat with a csv value from OpenAPI 2.0.
      spaceDelimitedarrayquerySpace separated array values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
      pipeDelimitedarrayqueryPipe separated array values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
      deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
      +

      Style Examples

      +

      Assume a parameter named color has one of the following values:

      +
      
      +   string -> "blue"
      +   array -> ["blue","black","brown"]
      +   object -> { "R": 100, "G": 200, "B": 150 }
      +
      +

      The following table shows examples of rendering differences for each value.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      styleexplodeemptystringarrayobject
      matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
      matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
      labelfalse..blue.blue.black.brown.R.100.G.200.B.150
      labeltrue..blue.blue.black.brown.R=100.G=200.B=150
      formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
      formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
      simplefalsen/ablueblue,black,brownR,100,G,200,B,150
      simpletruen/ablueblue,black,brownR=100,G=200,B=150
      spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
      pipeDelimitedfalsen/an/ablue¦black¦brownR¦100¦G¦200
      deepObjecttruen/an/an/acolor\R=100&color\G=200&color\B=150
      +

      This object MAY be extended with Specification Extensions.

      +

      Parameter Object Examples

      +

      A header parameter with an array of 64 bit integer numbers:

      +
      
      +{
      +  "name": "token",
      +  "in": "header",
      +  "description": "token to be passed as a header",
      +  "required": true,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "integer",
      +      "format": "int64"
      +    }
      +  },
      +  "style": "simple"
      +}
      +
      +
      
      +name: token
      +in: header
      +description: token to be passed as a header
      +required: true
      +schema:
      +  type: array
      +  items:
      +    type: integer
      +    format: int64
      +style: simple
      +
      +

      A path parameter of a string value:

      +
      
      +{
      +  "name": "username",
      +  "in": "path",
      +  "description": "username to fetch",
      +  "required": true,
      +  "schema": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +name: username
      +in: path
      +description: username to fetch
      +required: true
      +schema:
      +  type: string
      +
      +

      An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

      +
      
      +{
      +  "name": "id",
      +  "in": "query",
      +  "description": "ID of the object to fetch",
      +  "required": false,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    }
      +  },
      +  "style": "form",
      +  "explode": true
      +}
      +
      +
      
      +name: id
      +in: query
      +description: ID of the object to fetch
      +required: false
      +schema:
      +  type: array
      +  items:
      +    type: string
      +style: form
      +explode: true
      +
      +

      A free-form query parameter, allowing undefined parameters of a specific type:

      +
      
      +{
      +  "in": "query",
      +  "name": "freeForm",
      +  "schema": {
      +    "type": "object",
      +    "additionalProperties": {
      +      "type": "integer"
      +    },
      +  },
      +  "style": "form"
      +}
      +
      +
      
      +in: query
      +name: freeForm
      +schema:
      +  type: object
      +  additionalProperties:
      +    type: integer
      +style: form
      +
      +

      A complex parameter using content to define serialization:

      +
      
      +{
      +  "in": "query",
      +  "name": "coordinates",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "object",
      +        "required": [
      +          "lat",
      +          "long"
      +        ],
      +        "properties": {
      +          "lat": {
      +            "type": "number"
      +          },
      +          "long": {
      +            "type": "number"
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +in: query
      +name: coordinates
      +content:
      +  application/json:
      +    schema:
      +      type: object
      +      required:
      +        - lat
      +        - long
      +      properties:
      +        lat:
      +          type: number
      +        long:
      +          type: number
      +
      +

      Request Body Object

      +

      Describes a single request body.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
      contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
      requiredbooleanDetermines if the request body is required in the request. Defaults to false.
      +

      This object MAY be extended with Specification Extensions.

      +

      Request Body Examples

      +

      A request body with a referenced model definition.

      +
      
      +{
      +  "description": "user to add to the system",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
      +      },
      +      "examples": {
      +          "user" : {
      +            "summary": "User Example", 
      +            "externalValue": "http://foo.bar/examples/user-example.json"
      +          } 
      +        }
      +    },
      +    "application/xml": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
      +      },
      +      "examples": {
      +          "user" : {
      +            "summary": "User example in XML",
      +            "externalValue": "http://foo.bar/examples/user-example.xml"
      +          }
      +        }
      +    },
      +    "text/plain": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in Plain text",
      +            "externalValue": "http://foo.bar/examples/user-example.txt" 
      +        }
      +      } 
      +    },
      +    "*/*": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in other format",
      +            "externalValue": "http://foo.bar/examples/user-example.whatever"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: user to add to the system
      +content: 
      +  'application/json':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User Example
      +        externalValue: 'http://foo.bar/examples/user-example.json'
      +  'application/xml':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User Example in XML
      +        externalValue: 'http://foo.bar/examples/user-example.xml'
      +  'text/plain':
      +    examples:
      +      user:
      +        summary: User example in text plain format
      +        externalValue: 'http://foo.bar/examples/user-example.txt'
      +  '*/*':
      +    examples:
      +      user: 
      +        summary: User example in other format
      +        externalValue: 'http://foo.bar/examples/user-example.whatever'
      +
      +

      A body parameter that is an array of string values:

      +
      
      +{
      +  "description": "user to add to the system",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: user to add to the system
      +required: true
      +content:
      +  text/plain:
      +    schema:
      +      type: array
      +      items:
      +        type: string
      +
      +

      Media Type Object

      +

      Each Media Type Object provides schema and examples for the media type identified by its key.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      schemaSchema Object ¦ Reference ObjectThe schema defining the type used for the request body.
      exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
      examplesMap[ string, Example Object ¦ Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
      encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
      +

      This object MAY be extended with Specification Extensions.

      +

      Media Type Examples

      +
      
      +{
      +  "application/json": {
      +    "schema": {
      +         "$ref": "#/components/schemas/Pet"
      +    },
      +    "examples": {
      +      "cat" : {
      +        "summary": "An example of a cat",
      +        "value": 
      +          {
      +            "name": "Fluffy",
      +            "petType": "Cat",
      +            "color": "White",
      +            "gender": "male",
      +            "breed": "Persian"
      +          }
      +      },
      +      "dog": {
      +        "summary": "An example of a dog with a cat's name",
      +        "value" :  { 
      +          "name": "Puma",
      +          "petType": "Dog",
      +          "color": "Black",
      +          "gender": "Female",
      +          "breed": "Mixed"
      +        },
      +      "frog": {
      +          "$ref": "#/components/examples/frog-example"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +application/json: 
      +  schema:
      +    $ref: "#/components/schemas/Pet"
      +  examples:
      +    cat:
      +      summary: An example of a cat
      +      value:
      +        name: Fluffy
      +        petType: Cat
      +        color: White
      +        gender: male
      +        breed: Persian
      +    dog:
      +      summary: An example of a dog with a cat's name
      +      value:
      +        name: Puma
      +        petType: Dog
      +        color: Black
      +        gender: Female
      +        breed: Mixed
      +    frog:
      +      $ref: "#/components/examples/frog-example"
      +
      +

      Considerations for File Uploads

      +

      In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type. Specifically:

      +
      
      +# content transferred with base64 encoding
      +schema:
      +  type: string
      +  format: base64
      +
      +
      
      +# content transferred in binary (octet-stream):
      +schema:
      +  type: string
      +  format: binary
      +
      +

      These examples apply to either input payloads of file uploads or response payloads.

      +

      A requestBody for submitting a file in a POST operation may look like the following example:

      +
      
      +requestBody:
      +  content:
      +    application/octet-stream:
      +      # any media type is accepted, functionally equivalent to `*/*`
      +      schema:
      +        # a binary file of any type
      +        type: string
      +        format: binary
      +
      +

      In addition, specific media types MAY be specified:

      +
      
      +# multiple, specific media types may be specified:
      +requestBody:
      +  content:
      +      # a binary file of type png or jpeg
      +    'image/jpeg':
      +      schema:
      +        type: string
      +        format: binary
      +    'image/png':
      +      schema:
      +        type: string
      +        format: binary        
      +
      +

      To upload multiple files, a multipart media type MUST be used:

      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        properties:
      +          # The property name 'file' will be used for all files.
      +          file:
      +            type: array
      +            items:
      +              type: string
      +              format: binary
      +
      +
      +

      Support for x-www-form-urlencoded Request Bodies

      +

      To submit content using form url encoding via [[!rfc1866]], the following +definition may be used:

      +
      
      +requestBody:
      +  content:
      +    application/x-www-form-urlencoded:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # complex types are stringified to support RFC 1866
      +            type: object
      +            properties: {}
      +
      +

      In this example, the contents in the requestBody MUST be stringified per [[!rfc1866]]) when passed to the server. In addition, the address field complex object will be stringified.

      +

      When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object's style property as form.

      +

      Special Considerations for multipart Content

      +

      It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

      +

      When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred — thus, the following default Content-Types are defined for multipart:

      +
        +
      • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
      • +
      • If the property is complex, or an array of complex values, the default Content-Type is application/json
      • +
      • If the property is a type: string with format: binary or format: base64 (aka a file object), the default Content-Type is application/octet-stream
      • +
      +

      Examples:

      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # default Content-Type for objects is `application/json`
      +            type: object
      +            properties: {}
      +          profileImage:
      +            # default Content-Type for string/binary is `application/octet-stream`
      +            type: string
      +            format: binary
      +          children:
      +            # default Content-Type for arrays is based on the `inner` type (text/plain here)
      +            type: array
      +            items:
      +              type: string
      +          addresses:
      +            # default Content-Type for arrays is based on the `inner` type (object shown, so `application/json` in this example)
      +            type: array
      +            items:
      +              type: '#/components/schemas/Address'
      +
      +

      An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

      +

      Encoding Object

      +

      A single encoding definition applied to a single schema property.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for string with format being binaryapplication/octet-stream; for other primitive types – text/plain; for object - application/json; for array – the default is defined based on the inner type. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
      headersMap[string, Header Object ¦ Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
      stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!rfc3986]]section-2.2) :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      +

      This object MAY be extended with Specification Extensions.

      +

      Encoding Object Example

      +
      
      +requestBody:
      +  content:
      +    multipart/mixed:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            # default is text/plain
      +            type: string
      +            format: uuid
      +          address:
      +            # default is application/json
      +            type: object
      +            properties: {}
      +          historyMetadata:
      +            # need to declare XML format!
      +            description: metadata in XML format
      +            type: object
      +            properties: {}
      +          profileImage:
      +            # default is application/octet-stream, need to declare an image type only!
      +            type: string
      +            format: binary
      +      encoding:
      +        historyMetadata:
      +          # require XML Content-Type in utf-8 encoding
      +          contentType: application/xml; charset=utf-8
      +        profileImage:
      +          # only accept png/jpeg
      +          contentType: image/png, image/jpeg
      +          headers:
      +            X-Rate-Limit-Limit:
      +              description: The number of allowed requests in the current period
      +              schema:
      +                type: integer
      +
      +

      Responses Object

      +

      A container for the expected responses of an operation. +The container maps a HTTP response code to the expected response.

      +

      The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. +However, documentation is expected to cover a successful operation response and any known errors.

      +

      The default MAY be used as a default response object for all HTTP codes +that are not covered individually by the specification.

      +

      The Responses Object MUST contain at least one response code, and it +SHOULD be the response for a successful operation call.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      defaultResponse Object ¦ Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses. A Reference Object can link to a response that the OpenAPI Object’s components/responses section defines.
      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      HTTP Status CodeResponse Object ¦ Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. A Reference Object can link to a response that is defined in the OpenAPI Object’s components/responses section. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. The following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response range is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
      +

      This object MAY be extended with Specification Extensions.

      +

      Responses Object Example

      +

      A 200 response for a successful operation and a default response for others (implying an error):

      +
      
      +{
      +  "200": {
      +    "description": "a pet to be returned",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/Pet"
      +        }
      +      }
      +    }
      +  },
      +  "default": {
      +    "description": "Unexpected error",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/ErrorModel"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +'200':
      +  description: a pet to be returned
      +  content: 
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/Pet'
      +default:
      +  description: Unexpected error
      +  content:
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/ErrorModel'
      +
      +

      Response Object

      +

      Describes a single response from an API Operation, including design-time, static +links to operations based on the response.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringREQUIRED. A short description of the response. CommonMark syntax MAY be used for rich text representation.
      headersMap[string, Header Object ¦ Reference Object]Maps a header name to its definition. [[!rfc7230]]page-22) states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
      contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
      linksMap[string, Link Object ¦ Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
      +

      This object MAY be extended with Specification Extensions.

      +

      Response Object Examples

      +

      Response of an array of a complex type:

      +
      
      +{
      +  "description": "A complex object array response",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "$ref": "#/components/schemas/VeryComplexType"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: A complex object array response
      +content: 
      +  application/json:
      +    schema: 
      +      type: array
      +      items:
      +        $ref: '#/components/schemas/VeryComplexType'
      +
      +

      Response with a string type:

      +
      
      +{
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  }
      +
      +}
      +
      +
      
      +description: A simple string response
      +content:
      +  text/plain:
      +    schema:
      +      type: string
      +
      +

      Plain text response with headers:

      +
      
      +{
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  },
      +  "headers": {
      +    "X-Rate-Limit-Limit": {
      +      "description": "The number of allowed requests in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    },
      +    "X-Rate-Limit-Remaining": {
      +      "description": "The number of remaining requests in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    },
      +    "X-Rate-Limit-Reset": {
      +      "description": "The number of seconds left in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: A simple string response
      +content:
      +  text/plain:
      +    schema:
      +      type: string
      +    example: 'whoa!'
      +headers:
      +  X-Rate-Limit-Limit:
      +    description: The number of allowed requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Remaining:
      +    description: The number of remaining requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Reset:
      +    description: The number of seconds left in the current period
      +    schema:
      +      type: integer
      +
      +

      Response with no return value:

      +
      
      +{
      +  "description": "object created"
      +}
      +
      +
      
      +description: object created
      +
      +

      Callback Object

      +

      A map of possible out-of band callbacks related to the parent operation. +Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. +The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {expression}Path Item ObjectA Path Item Object used to define a callback request and expected responses. A complete example is available.
      +

      This object MAY be extended with Specification Extensions.

      +

      Key Expression

      +

      The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. +A simple example might be $request.body#/url. +However, using a runtime expression the complete HTTP message can be accessed. +This includes accessing any part of a body that a JSON Pointer [[!rfc6901]] can reference.

      +

      For example, given the following HTTP request:

      +
      
      +POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
      +Host: example.org
      +Content-Type: application/json
      +Content-Length: 187
      +
      +{
      +  "failedUrl" : "http://clientdomain.com/failed",
      +  "successUrls" : [
      +    "http://clientdomain.com/fast",
      +    "http://clientdomain.com/medium",
      +    "http://clientdomain.com/slow"
      +  ] 
      +}
      +
      +201 Created
      +Location: http://example.org/subscription/1
      +
      +

      The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      ExpressionValue
      $urlhttp://example.org/subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning
      $methodPOST
      $request.path.eventTypemyevent
      $request.query.queryUrlhttp://clientdomain.com/stillrunning
      $request.header.content-Typeapplication/json
      $request.body#/failedUrlhttp://clientdomain.com/stillrunning
      $request.body#/successUrls/2http://clientdomain.com/medium
      $response.header.Locationhttp://example.org/subscription/1
      +

      Callback Object Example

      +

      The following example shows a callback to the URL specified by the id and email property in the request body.

      +
      
      +myWebhook:
      +  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
      +    post:
      +      requestBody:
      +        description: Callback payload
      +        content: 
      +          'application/json':
      +            schema:
      +              $ref: '#/components/schemas/SomePayload'
      +      responses:
      +        '200':
      +          description: webhook successfully processed and no retries will be performed
      +
      +

      Example Object

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      summarystringShort description for the example.
      descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
      valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
      externalValuestringA URL that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive.
      +

      This object MAY be extended with Specification Extensions.

      +

      In all cases, the example value is expected to be compatible with the type schema +of its associated value. Tooling implementations MAY choose to +validate compatibility automatically, and reject the example value(s) if incompatible.

      +

      Example Object Example

      +
      
      +# in a model
      +schemas:
      +  properties:
      +    name:
      +      type: string
      +      examples:
      +        name:
      +          $ref: http://example.org/petapi-examples/openapi.json#/components/examples/name-example
      +
      +# in a request body:
      +  requestBody:
      +    content:
      +      'application/json':
      +        schema:
      +          $ref: '#/components/schemas/Address'
      +        examples: 
      +          foo:
      +            summary: A foo example
      +            value: {"foo": "bar"}
      +          bar:
      +            summary: A bar example
      +            value: {"bar": "baz"}
      +      'application/xml':
      +        examples: 
      +          xmlExample:
      +            summary: This is an example in XML
      +            externalValue: 'http://example.org/examples/address-example.xml'
      +      'text/plain':
      +        examples:
      +          textExample: 
      +            summary: This is a text example
      +            externalValue: 'http://foo.bar/examples/address-example.txt' 
      +
      +
      +# in a parameter
      +  parameters:
      +    - name: 'zipCode'
      +      in: 'query'
      +      schema:
      +        type: 'string'
      +        format: 'zip-code'
      +        examples:
      +          zip-example: 
      +            $ref: '#/components/examples/zip-example'
      +
      +# in a response
      +  responses:
      +    '200':
      +      description: your car appointment has been booked
      +      content: 
      +        application/json:
      +          schema:
      +            $ref: '#/components/schemas/SuccessResponse'
      +          examples:
      +            confirmation-success:
      +              $ref: '#/components/examples/confirmation-success'
      +
      +

      Link Object

      +

      The Link object represents a possible design-time link for a response. +The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

      +

      Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

      +

      For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      operationRefstringA relative or absolute reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition.
      operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
      parametersMap[string, Any ¦ {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
      requestBodyAny ¦ {expression}A literal value or {expression} to use as a request body when calling the target operation.
      descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
      serverServer ObjectA server object to be used by the target operation.
      +

      This object MAY be extended with Specification Extensions.

      +

      A linked operation MUST be identified using either an operationRef or operationId. +In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. +Because of the potential for name clashes, the operationRef syntax is preferred +for specifications with external references.

      +

      Examples

      +

      Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

      +
      
      +paths:
      +  /users/{id}:
      +    parameters:
      +    - name: id
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +    get:
      +      responses:
      +        '200':
      +          description: the user being returned
      +          content:
      +            application/json:
      +              schema:
      +                type: object
      +                properties:
      +                  uuid: # the unique user id
      +                    type: string
      +                    format: uuid
      +          links:
      +            address:
      +              # the target link operationId
      +              operationId: getUserAddress
      +              parameters:
      +                # get the `id` field from the request path parameter named `id`
      +                userId: $request.path.id
      +  # the path item of the linked operation
      +  /users/{userid}/address:
      +    parameters:
      +    - name: userid
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +    # linked operation
      +    get:
      +      operationId: getUserAddress
      +      responses:
      +        '200':
      +          description: the user's address
      +
      +

      When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

      +

      Values from the response body can be used to drive a linked operation.

      +
      
      +links:
      +  address:
      +    operationId: getUserAddressByUUID
      +    parameters:
      +      # get the `uuid` field from the `uuid` field in the response body
      +      userUuid: $response.body#/uuid
      +
      +

      Clients follow all links at their discretion. +Neither permissions, nor the capability to make a successful call to that link, is guaranteed +solely by the existence of a relationship.

      +

      OperationRef Examples

      +

      As references to operationId MAY NOT be possible (the operationId is an optional +value), references MAY also be made through a relative operationRef:

      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
      +
      +

      or an absolute operationRef:

      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
      +
      +

      Note that in the use of operationRef, the escaped forward-slash is necessary when +using JSON references.

      +

      Runtime Expressions

      +

      Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. +This mechanism is used by Link Objects and Callback Objects.

      +

      The runtime expression is defined by the following [Augmented Backus-Naur Form] syntax

      +
      
      +      expression = ( "$url" | "$method" | "$statusCode" | "$request." source | "$response." source )
      +      source = ( header-reference | query-reference | path-reference | body-reference )  
      +      header-reference = "header." token
      +      query-reference = "query." name  
      +      path-reference = "path." name
      +      body-reference = "body" ["#" fragment]
      +      fragment = a JSON Pointer [[!rfc6901]]  
      +      name = *( char )
      +      char = as per RFC [7159]section-7)
      +      token = as per RFC [7230]section-3.2.6)
      +
      +

      The name identifier is case-sensitive, whereas token is not.

      +

      The table below provides examples of runtime expressions and examples of their use in a value:

      +

      Examples

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Source Locationexample expressionnotes
      HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
      Requested media type$request.header.accept
      Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
      Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
      Request URL$url
      Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
      Response header$response.header.ServerSingle header values only are available
      +

      Runtime expressions preserve the type of the referenced value. +Expressions can be embedded into string values by surrounding the expression with {} curly braces.

      +

      Header Object

      +

      The Header Object follows the structure of the Parameter Object with the following changes:

      +
        +
      1. name MUST NOT be specified, it is given in the corresponding headers map.
      2. +
      3. in MUST NOT be specified, it is implicitly in header.
      4. +
      5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
      6. +
      +

      Header Object Example

      +

      A simple header of type integer:

      +
      
      +{
      +  "description": "The number of allowed requests in the current period",
      +  "schema": {
      +    "type": "integer"
      +  }
      +}
      +
      +
      
      +description: The number of allowed requests in the current period
      +schema:
      +  type: integer
      +
      +

      Tag Object

      +

      Adds metadata to a single tag that is used by the Operation Object. +It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The name of the tag.
      descriptionstringA short description for the tag. CommonMark syntax MAY be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
      +

      This object MAY be extended with Specification Extensions.

      +

      Tag Object Example

      +
      
      +{
      +	"name": "pet",
      +	"description": "Pets operations"
      +}
      +
      +
      
      +name: pet
      +description: Pets operations
      +
      +

      Reference Object

      +

      A simple object to allow referencing other components in the specification, internally and externally.

      +

      The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

      +

      For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringREQUIRED. The reference string.
      +

      This object cannot be extended with additional properties and any properties added SHALL be ignored.

      +

      Reference Object Example

      +
      
      +{
      +	"$ref": "#/components/schemas/Pet"
      +}
      +
      +
      
      +$ref: '#/components/schemas/Pet'
      +
      +

      Relative Schema Document Example

      +
      
      +{
      +  "$ref": "Pet.json"
      +}
      +
      +
      
      +$ref: Pet.yaml
      +
      +

      Relative Documents With Embedded Schema Example

      +
      
      +{
      +  "$ref": "definitions.json#/Pet"
      +}
      +
      +
      
      +$ref: definitions.yaml#/Pet
      +
      +

      Schema Object

      +

      The Schema Object allows the definition of input and output data types. +These types can be objects, but also primitives and arrays. +This object is an extended subset of the JSON Schema Specification Wright Draft 00.

      +

      For more information about the properties, see JSON Schema Core and JSON Schema Validation. +Unless stated otherwise, the property definitions follow the JSON Schema.

      +

      Properties

      +

      The following properties are taken directly from the JSON Schema definition and follow the same specifications:

      +
        +
      • title
      • +
      • multipleOf
      • +
      • maximum
      • +
      • exclusiveMaximum
      • +
      • minimum
      • +
      • exclusiveMinimum
      • +
      • maxLength
      • +
      • minLength
      • +
      • pattern (This string SHOULD be a valid regular expression, according to the ECMA 262 regular expression dialect)
      • +
      • maxItems
      • +
      • minItems
      • +
      • uniqueItems
      • +
      • maxProperties
      • +
      • minProperties
      • +
      • required
      • +
      • enum
      • +
      +

      The following properties are taken from the JSON Schema definition but their definitions were adjusted to the OpenAPI Specification.

      +
        +
      • type - Value MUST be a string. Multiple types via an array are not supported.
      • +
      • allOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • oneOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • anyOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • not - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • items - Value MUST be an object and not an array. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. items MUST be present if the type is array.
      • +
      • properties - Property definitions MUST be a Schema Object and not a standard JSON Schema (inline or referenced).
      • +
      • additionalProperties - Value can be boolean or object. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • description - CommonMark syntax MAY be used for rich text representation.
      • +
      • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
      • +
      • default - The default value represents what would be assumed by the consumer of the input as the value of the schema if one is not provided. Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object defined at the same level. For example, if type is string, then default can be "foo" but cannot be 1.
      • +
      +

      Alternatively, any time a Schema Object can be used, a Reference Object can be used in its place. This allows referencing definitions instead of defining them inline.

      +

      Additional properties defined by the JSON Schema specification that are not mentioned here are strictly unsupported.

      +

      Other than the JSON Schema subset fields, the following fields MAY be used for further schema documentation:

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      nullablebooleanAllows sending a null value for the defined schema. Default value is false.
      discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
      readOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “read only”. This means that it MAY be sent as part of a response but SHOULD NOT be sent as part of the request. If the property is marked as readOnly being true and is in the required list, the required will take effect on the response only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
      writeOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “write only”. Therefore, it MAY be sent as part of a request but SHOULD NOT be sent as part of the response. If the property is marked as writeOnly being true and is in the required list, the required will take effect on the request only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
      xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
      externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
      exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.
      deprecatedbooleanSpecifies that a schema is deprecated and SHOULD be transitioned out of usage. Default value is false.
      +

      This object MAY be extended with Specification Extensions.

      +
      Composition and Inheritance (Polymorphism)
      +

      The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. +allOf takes an array of object definitions that are validated independently but together compose a single object.

      +

      While composition offers model extensibility, it does not imply a hierarchy between the models. +To support polymorphism, the OpenAPI Specification adds the discriminator field. +When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. +As such, the discriminator field MUST be a required field. +There are two ways to define the value of a discriminator for an inheriting instance.

      +
        +
      • Use the schema name.
      • +
      • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. +As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
      • +
      +
      XML Modeling
      +

      The xml property allows extra definitions when translating the JSON definition to XML. +The XML Object contains additional information about the available options.

      +

      Schema Object Examples

      +
      Primitive Sample
      +
      
      +{
      +  "type": "string",
      +  "format": "email"
      +}
      +
      +
      
      +type: string
      +format: email
      +
      +
      Simple Model
      +
      
      +{
      +  "type": "object",
      +  "required": [
      +    "name"
      +  ],
      +  "properties": {
      +    "name": {
      +      "type": "string"
      +    },
      +    "address": {
      +      "$ref": "#/components/schemas/Address"
      +    },
      +    "age": {
      +      "type": "integer",
      +      "format": "int32",
      +      "minimum": 0
      +    }
      +  }
      +}
      +
      +
      
      +type: object
      +required:
      +- name
      +properties:
      +  name:
      +    type: string
      +  address:
      +    $ref: '#/components/schemas/Address'
      +  age:
      +    type: integer
      +    format: int32
      +    minimum: 0
      +
      +
      Model with Map/Dictionary Properties
      +

      For a simple string to string mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  type: string
      +
      +

      For a string to model mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "$ref": "#/components/schemas/ComplexModel"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  $ref: '#/components/schemas/ComplexModel'
      +
      +
      Model with Example
      +
      
      +{
      +  "type": "object",
      +  "properties": {
      +    "id": {
      +      "type": "integer",
      +      "format": "int64"
      +    },
      +    "name": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "name"
      +  ],
      +  "example": {
      +    "name": "Puma",
      +    "id": 1
      +  }
      +}
      +
      +
      
      +type: object
      +properties:
      +  id:
      +    type: integer
      +    format: int64
      +  name:
      +    type: string
      +required:
      +- name
      +example:
      +  name: Puma
      +  id: 1
      +
      +
      Models with Composition
      +
      
      +{
      +  "components": {
      +    "schemas": {
      +      "ErrorModel": {
      +        "type": "object",
      +        "required": [
      +          "message",
      +          "code"
      +        ],
      +        "properties": {
      +          "message": {
      +            "type": "string"
      +          },
      +          "code": {
      +            "type": "integer",
      +            "minimum": 100,
      +            "maximum": 600
      +          }
      +        }
      +      },
      +      "ExtendedErrorModel": {
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/ErrorModel"
      +          },
      +          {
      +            "type": "object",
      +            "required": [
      +              "rootCause"
      +            ],
      +            "properties": {
      +              "rootCause": {
      +                "type": "string"
      +              }
      +            }
      +          }
      +        ]
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    ErrorModel:
      +      type: object
      +      required:
      +      - message
      +      - code
      +      properties:
      +        message:
      +          type: string
      +        code:
      +          type: integer
      +          minimum: 100
      +          maximum: 600
      +    ExtendedErrorModel:
      +      allOf:
      +      - $ref: '#/components/schemas/ErrorModel'
      +      - type: object
      +        required:
      +        - rootCause
      +        properties:
      +          rootCause:
      +            type: string
      +
      +
      Models with Polymorphism Support
      +
      
      +{
      +  "components": {
      +    "schemas": {
      +      "Pet": {
      +        "type": "object",
      +        "discriminator": {
      +          "propertyName": "petType"
      +        },
      +        "properties": {
      +          "name": {
      +            "type": "string"
      +          },
      +          "petType": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "petType"
      +        ]
      +      },
      +      "Cat": {
      +        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/Pet"
      +          },
      +          {
      +            "type": "object",
      +            "properties": {
      +              "huntingSkill": {
      +                "type": "string",
      +                "description": "The measured skill for hunting",
      +                "default": "lazy",
      +                "enum": [
      +                  "clueless",
      +                  "lazy",
      +                  "adventurous",
      +                  "aggressive"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "huntingSkill"
      +            ]
      +          }
      +        ]
      +      },
      +      "Dog": {
      +        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/Pet"
      +          },
      +          {
      +            "type": "object",
      +            "properties": {
      +              "packSize": {
      +                "type": "integer",
      +                "format": "int32",
      +                "description": "the size of the pack the dog is from",
      +                "default": 0,
      +                "minimum": 0
      +              }
      +            },
      +            "required": [
      +              "packSize"
      +            ]
      +          }
      +        ]
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    Pet:
      +      type: object
      +      discriminator:
      +        propertyName: petType
      +      properties:
      +        name:
      +          type: string
      +        petType:
      +          type: string
      +      required:
      +      - name
      +      - petType
      +    Cat:  ## "Cat" will be used as the discriminator value
      +      description: A representation of a cat
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          huntingSkill:
      +            type: string
      +            description: The measured skill for hunting
      +            enum:
      +            - clueless
      +            - lazy
      +            - adventurous
      +            - aggressive
      +        required:
      +        - huntingSkill
      +    Dog:  ## "Dog" will be used as the discriminator value
      +      description: A representation of a dog
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          packSize:
      +            type: integer
      +            format: int32
      +            description: the size of the pack the dog is from
      +            default: 0
      +            minimum: 0
      +        required:
      +        - packSize
      +
      +

      Discriminator Object

      +

      When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

      +

      When using the discriminator, inline schemas will not be considered.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
      mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
      +

      The discriminator attribute is legal only when using one of the composite keywords oneOf, anyOf, allOf.

      +

      In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +
      +

      which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +  discriminator:
      +    propertyName: pet_type
      +
      +

      The expectation now is that a property with name pet_type MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

      +
      
      +{
      +  "id": 12345,
      +  "pet_type": "Cat"
      +}
      +
      +

      Will indicate that the Cat schema be used in conjunction with this payload.

      +

      In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +  discriminator:
      +    propertyName: pet_type
      +    mapping:
      +      dog: '#/components/schemas/Dog'
      +      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +
      +

      Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

      +

      When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

      +

      In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

      +

      For example:

      +
      
      +components:
      +  schemas:
      +    Pet:
      +      type: object
      +      required:
      +      - pet_type
      +      properties:
      +        pet_type:
      +          type: string
      +      discriminator:
      +        propertyName: pet_type
      +        mapping:
      +          cachorro: Dog
      +    Cat:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Cat`
      +        properties:
      +          name:
      +            type: string
      +    Dog:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Dog`
      +        properties:
      +          bark:
      +            type: string
      +    Lizard:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Lizard`
      +        properties:
      +          lovesRocks:
      +            type: boolean
      +
      +

      a payload like this:

      +
      
      +{
      +  "pet_type": "Cat",
      +  "name": "misty"
      +}
      +
      +

      will indicate that the Cat schema be used. Likewise this schema:

      +
      
      +{
      +  "pet_type": "cachorro",
      +  "bark": "soft"
      +}
      +
      +

      will map to Dog because of the definition in the mappings element.

      +

      XML Object

      +

      A metadata object that allows for more fine-tuned XML model definitions.

      +

      When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. +See examples for expected behavior.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
      namespacestringThe URI of the namespace definition. Value MUST be in the form of an absolute URI.
      prefixstringThe prefix to be used for the name.
      attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
      wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
      +

      This object MAY be extended with Specification Extensions.

      +

      XML Object Examples

      +

      The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

      +
      No XML Element
      +

      Basic string property:

      +
      
      +{
      +    "animals": {
      +        "type": "string"
      +    }
      +}
      +
      +
      
      +animals:
      +  type: string
      +
      +
      
      +<animals>...</animals>
      +
      +

      Basic string array property (wrapped is false by default):

      +
      
      +{
      +    "animals": {
      +        "type": "array",
      +        "items": {
      +            "type": "string"
      +        }
      +    }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +
      +
      
      +<animals>...</animals>
      +<animals>...</animals>
      +<animals>...</animals>
      +
      +
      XML Name Replacement
      +
      
      +{
      +  "animals": {
      +    "type": "string",
      +    "xml": {
      +      "name": "animal"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: string
      +  xml:
      +    name: animal
      +
      +
      
      +<animal>...</animal>
      +
      +
      XML Attribute, Prefix and Namespace
      +

      In this example, a full model definition is shown.

      +
      
      +{
      +  "Person": {
      +    "type": "object",
      +    "properties": {
      +      "id": {
      +        "type": "integer",
      +        "format": "int32",
      +        "xml": {
      +          "attribute": true
      +        }
      +      },
      +      "name": {
      +        "type": "string",
      +        "xml": {
      +          "namespace": "http://example.com/schema/sample",
      +          "prefix": "sample"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +Person:
      +  type: object
      +  properties:
      +    id:
      +      type: integer
      +      format: int32
      +      xml:
      +        attribute: true
      +    name:
      +      type: string
      +      xml:
      +        namespace: http://example.com/schema/sample
      +        prefix: sample
      +
      +
      
      +<Person id="123">
      +    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
      +</Person>
      +
      +
      XML Arrays
      +

      Changing the element names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      The external name property has no effect on the XML:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animals>value</animals>
      +  <animals>value</animals>
      +</animals>
      +
      +

      To overcome the naming problem in the example above, the following definition can be used:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</animals>
      +
      +

      Affecting both internal and external names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</aliens>
      +
      +

      If we change the external element but not the internal ones:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <aliens>value</aliens>
      +  <aliens>value</aliens>
      +</aliens>
      +
      +

      Security Scheme Object

      +

      Defines a security scheme that can be used by the operations. +Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!rfc6749]], and OpenID Connect Discovery.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeApplies ToDescription
      typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "oauth2", "openIdConnect".
      descriptionstringAnyA short description for security scheme. CommonMark syntax MAY be used for rich text representation.
      namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
      instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
      schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the [Authorization header as defined in RFC7235]section-5.1).
      bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
      flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
      openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      Security Scheme Object Example

      +
      Basic Authentication Sample
      +
      
      +{
      +  "type": "http",
      +  "scheme": "basic"
      +}
      +
      +
      
      +type: http
      +scheme: basic
      +
      +
      API Key Sample
      +
      
      +{
      +  "type": "apiKey",
      +  "name": "api_key",
      +  "in": "header"
      +}
      +
      +
      
      +type: apiKey
      +name: api_key
      +in: header
      +
      +
      JWT Bearer Sample
      +
      
      +{
      +  "type": "http",
      +  "scheme": "bearer",
      +  "bearerFormat": "JWT",
      +}
      +
      +
      
      +type: http
      +scheme: bearer
      +bearerFormat: JWT
      +
      +
      Implicit OAuth2 Sample
      +
      
      +{
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
      +
      +

      OAuth Flows Object

      +

      Allows configuration of the supported OAuth Flows.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
      passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
      clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
      authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
      +

      This object MAY be extended with Specification Extensions.

      +

      OAuth Flow Object

      +

      Configuration details for a supported OAuth Flow

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeApplies ToDescription
      authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL.
      tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL.
      refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL.
      scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it.
      +

      This object MAY be extended with Specification Extensions.

      +

      OAuth Flow Object Examples

      +
      
      +{
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    },
      +    "authorizationCode": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "tokenUrl": "https://example.com/api/oauth/token",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
      +  authorizationCode:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    tokenUrl: https://example.com/api/oauth/token
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets 
      +
      +

      Security Requirement Object

      +

      Lists the required security schemes to execute this operation. +The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

      +

      Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. +This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

      +

      When a list of Security Requirement Objects is defined on the Open API object or Operation Object, only one of Security Requirement Objects in the list needs to be satisfied to authorize the request.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution. For other security scheme types, the array MUST be empty.
      +

      Security Requirement Object Examples

      +
      Non-OAuth2 Security Requirement
      +
      
      +{
      +  "api_key": []
      +}
      +
      +
      
      +api_key: []
      +
      +
      OAuth2 Security Requirement
      +
      
      +{
      +  "petstore_auth": [
      +    "write:pets",
      +    "read:pets"
      +  ]
      +}
      +
      +
      
      +petstore_auth:
      +- write:pets
      +- read:pets
      +
      +

      Specification Extensions

      +

      While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

      +

      The extensions properties are implemented as patterned fields that are always prefixed by "x-".

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. Can have any valid JSON format value.
      +

      The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

      +

      Security Filtering

      +

      Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

      +

      The reasoning is to allow an additional layer of access control over the documentation. +While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

      +

      Two examples of this:

      +
        +
      1. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
      2. +
      3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the Paths Object, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
      4. +
      +

      Appendix A: Revision History

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      VersionDateNotes
      3.0.12017-12-06Patch release of the OpenAPI Specification 3.0.1
      3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
      3.0.0-rc22017-06-16rc2 of the 3.0 specification
      3.0.0-rc12017-04-27rc1 of the 3.0 specification
      3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
      2.02015-12-31Donation of Swagger 2.0 to the Open API Initiative
      2.02014-09-08Release of Swagger 2.0
      1.22014-03-14Initial release of the formal document.
      1.12012-08-22Release of Swagger 1.1
      1.02011-08-10First release of the Swagger Specification
      + From 52affa2dde37f89e4887e19006904fea7b73f337 Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Thu, 14 Jun 2018 11:00:14 +0100 Subject: [PATCH 002/152] Add index.md, v2.0 and v3.0.0 --- index.md | 7 + oas/v2.0.html | 3101 +++++++++++++++++++++++++++++++++++ oas/v3.0.0.html | 4093 +++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 7201 insertions(+) create mode 100644 index.md create mode 100644 oas/v2.0.html create mode 100644 oas/v3.0.0.html diff --git a/index.md b/index.md new file mode 100644 index 0000000000..a0ba023253 --- /dev/null +++ b/index.md @@ -0,0 +1,7 @@ +## Current major version + +* [v3.0.0](oas/v3.0.0.html) + +## Previous major version + +* [v2.0](oas/v2.0.html) diff --git a/oas/v2.0.html b/oas/v2.0.html new file mode 100644 index 0000000000..d8c5f210ad --- /dev/null +++ b/oas/v2.0.html @@ -0,0 +1,3101 @@ +OpenAPI Specification + + +
      The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

      Status of This Document

      The source-of-truth for the specification is the GitHub markdown file referenced above.
      +

      OpenAPI Specification

      +

      (fka Swagger RESTful API Documentation Specification)

      +

      Version 2.0

      +

      The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in [!RFC2119].

      +

      The Swagger specification is licensed under The Apache License, Version 2.0.

      +

      Introductions

      +

      Swagger™ is a project used to describe and document RESTful APIs.

      +

      The Swagger specification defines a set of files required to describe such an API. These files can then be used by the Swagger-UI project to display the API and Swagger-Codegen to generate clients in various languages. Additional utilities can also take advantage of the resulting files, such as testing tools.

      +

      Revision History

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      VersionDateNotes
      2.02014-09-08Release of Swagger 2.0
      1.22014-03-14Initial release of the formal document.
      1.12012-08-22Release of Swagger 1.1
      1.02011-08-10First release of the Swagger Specification
      +

      Definitions

      +

      Path Templating

      +

      Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

      +

      Mime Types

      +

      Mime type definitions are spread across several resources. The mime type definitions should be in compliance with [[!RFC6838]].

      +

      Some examples of possible mime type definitions:

      +
      
      +  text/plain; charset=utf-8
      +  application/json
      +  application/vnd.github+json
      +  application/vnd.github.v3+json
      +  application/vnd.github.v3.raw+json
      +  application/vnd.github.v3.text+json
      +  application/vnd.github.v3.html+json
      +  application/vnd.github.v3.full+json
      +  application/vnd.github.v3.diff
      +  application/vnd.github.v3.patch
      +
      +

      HTTP Status Codes

      +

      The HTTP Status Codes are used to indicate the status of the executed operation. The available status codes are described by [[!RFC7231]] and in the IANA Status Code Registry.

      +

      Specification

      +

      Format

      +

      The files describing the RESTful API in accordance with the Swagger specification are represented as JSON objects and conform to the JSON standards. YAML, being a superset of JSON, can be used as well to +represent a Swagger specification file.

      +

      For example, if a field is said to have an array value, the JSON array representation will be used:

      +
      
      +{
      +   "field" : [...]
      +}
      +
      +

      While the API is described using JSON it does not impose a JSON input/output to the API itself.

      +

      All field names in the specification are case sensitive.

      +

      The schema exposes two types of fields. Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name. Patterned fields can have multiple occurrences as long as each has a unique name.

      +

      File Structure

      +

      The Swagger representation of the API is made of a single file. However, parts of the definitions can be split into separate files, at the discretion of the user. This is applicable for $ref fields in the specification as follows from the JSON Schema definitions.

      +

      By convention, the Swagger specification file is named swagger.json.

      +

      Data Types

      +

      Primitive data types in the Swagger Specification are based on the types supported by the JSON-Schema Draft 4. Models are described using the Schema Object which is a subset of JSON Schema Draft 4.

      +

      An additional primitive data type "file" is used by the Parameter Object and the Response Object to set the parameter type or the response as being a file.

      +

      Primitives have an optional modifier property format. Swagger uses several known formats to more finely define the data type being used. However, the format property is an open string-valued property, and can have any value to support documentation needs. Formats such as "email", "uuid", etc., can be used even though they are not defined by this specification. Types that are not accompanied by a format property follow their definition from the JSON Schema (except for file type which is defined above). The formats defined by the Swagger Specification are:

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Common NametypeformatComments
      integerintegerint32signed 32 bits
      longintegerint64signed 64 bits
      floatnumberfloat
      doublenumberdouble
      stringstring
      bytestringbytebase64 encoded characters
      binarystringbinaryany sequence of octets
      booleanboolean
      datestringdateAs defined by full-date - [!RFC3339]
      dateTimestringdate-timeAs defined by date-time - [!RFC3339]
      passwordstringpasswordUsed to hint UIs the input needs to be obscured.
      +

      Schema

      +

      Swagger Object

      +

      This is the root document object for the API specification. It combines what previously was the Resource Listing and API Declaration (version 1.2 and earlier) together into one document.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      swaggerstringRequired. Specifies the Swagger Specification version being used. It can be used by the Swagger UI and other clients to interpret the API listing. The value MUST be "2.0".
      infoInfo ObjectRequired. Provides metadata about the API. The metadata can be used by the clients if needed.
      hoststringThe host (name or ip) serving the API. This MUST be the host only and does not include the scheme nor sub-paths. It MAY include a port. If the host is not included, the host serving the documentation is to be used (including the port). The host does not support path templating.
      basePathstringThe base path on which the API is served, which is relative to the host. If it is not included, the API is served directly under the host. The value MUST start with a leading slash (/). The basePath does not support path templating.
      schemes[string]The transfer protocol of the API. Values MUST be from the list: "http", "https", "ws", "wss". If the schemes is not included, the default scheme to be used is the one used to access the Swagger definition itself.
      consumes[string]A list of MIME types the APIs can consume. This is global to all APIs but can be overridden on specific API calls. Value MUST be as described under Mime Types.
      produces[string]A list of MIME types the APIs can produce. This is global to all APIs but can be overridden on specific API calls. Value MUST be as described under Mime Types.
      pathsPaths ObjectRequired. The available paths and operations for the API.
      definitionsDefinitions ObjectAn object to hold data types produced and consumed by operations.
      parametersParameters Definitions ObjectAn object to hold parameters that can be used across operations. This property does not define global parameters for all operations.
      responsesResponses Definitions ObjectAn object to hold responses that can be used across operations. This property does not define global responses for all operations.
      securityDefinitionsSecurity Definitions ObjectSecurity scheme definitions that can be used across the specification.
      security[Security Requirement Object]A declaration of which security schemes are applied for the API as a whole. The list of values describes alternative security schemes that can be used (that is, there is a logical OR between the security requirements). Individual operations can override this definition.
      tags[Tag Object]A list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared may be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
      externalDocsExternal Documentation ObjectAdditional external documentation.
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Info Object

      +

      The object provides metadata about the API. The metadata can be used by the clients if needed, and can be presented in the Swagger-UI for convenience.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      titlestringRequired. The title of the application.
      descriptionstringA short description of the application. GFM syntax can be used for rich text representation.
      termsOfServicestringThe Terms of Service for the API.
      contactContact ObjectThe contact information for the exposed API.
      licenseLicense ObjectThe license information for the exposed API.
      versionstringRequired Provides the version of the application API (not to be confused with the specification version).
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Info Object Example:

      +
      
      +{
      +  "title": "Swagger Sample App",
      +  "description": "This is a sample server Petstore server.",
      +  "termsOfService": "http://swagger.io/terms/",
      +  "contact": {
      +    "name": "API Support",
      +    "url": "http://www.swagger.io/support",
      +    "email": "support@swagger.io"
      +  },
      +  "license": {
      +    "name": "Apache 2.0",
      +    "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
      +  },
      +  "version": "1.0.1"
      +}
      +
      +
      
      +title: Swagger Sample App
      +description: This is a sample server Petstore server.
      +termsOfService: http://swagger.io/terms/
      +contact:
      +  name: API Support
      +  url: http://www.swagger.io/support
      +  email: support@swagger.io
      +license:
      +  name: Apache 2.0
      +  url: http://www.apache.org/licenses/LICENSE-2.0.html
      +version: 1.0.1
      +
      +

      Contact Object

      +

      Contact information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringThe identifying name of the contact person/organization.
      urlstringThe URL pointing to the contact information. MUST be in the format of a URL.
      emailstringThe email address of the contact person/organization. MUST be in the format of an email address.
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Contact Object Example:

      +
      
      +{
      +  "name": "API Support",
      +  "url": "http://www.swagger.io/support",
      +  "email": "support@swagger.io"
      +}
      +
      +
      
      +name: API Support
      +url: http://www.swagger.io/support
      +email: support@swagger.io
      +
      +

      License Object

      +

      License information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringRequired. The license name used for the API.
      urlstringA URL to the license used for the API. MUST be in the format of a URL.
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      License Object Example:

      +
      
      +{
      +  "name": "Apache 2.0",
      +  "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
      +}
      +
      +
      
      +name: Apache 2.0
      +url: http://www.apache.org/licenses/LICENSE-2.0.html
      +
      +

      Paths Object

      +

      Holds the relative paths to the individual endpoints. The path is appended to the basePath in order to construct the full URL. +The Paths may be empty, due to ACL constraints.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a slash. The path is appended to the basePath in order to construct the full URL. Path templating is allowed.
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Paths Object Example

      +
      
      +{
      +  "/pets": {
      +    "get": {
      +      "description": "Returns all pets from the system that the user has access to",
      +      "produces": [
      +        "application/json"
      +      ],
      +      "responses": {
      +        "200": {
      +          "description": "A list of pets.",
      +          "schema": {
      +            "type": "array",
      +            "items": {
      +              "$ref": "#/definitions/pet"
      +            }
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +/pets:
      +  get:
      +    description: Returns all pets from the system that the user has access to
      +    produces:
      +    - application/json
      +    responses:
      +      '200':
      +        description: A list of pets.
      +        schema:
      +          type: array
      +          items:
      +            $ref: '#/definitions/pet'
      +
      +

      Path Item Object

      +

      Describes the operations available on a single path. +A Path Item may be empty, due to ACL constraints. The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringAllows for an external definition of this path item. The referenced structure MUST be in the format of a Path Item Object. If there are conflicts between the referenced definition and this Path Item’s definition, the behavior is undefined.
      getOperation ObjectA definition of a GET operation on this path.
      putOperation ObjectA definition of a PUT operation on this path.
      postOperation ObjectA definition of a POST operation on this path.
      deleteOperation ObjectA definition of a DELETE operation on this path.
      optionsOperation ObjectA definition of a OPTIONS operation on this path.
      headOperation ObjectA definition of a HEAD operation on this path.
      patchOperation ObjectA definition of a PATCH operation on this path.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the Swagger Object’s parameters. There can be one “body” parameter at most.
      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Path Item Object Example

      +
      
      +{
      +  "get": {
      +    "description": "Returns pets based on ID",
      +    "summary": "Find pets by ID",
      +    "operationId": "getPetsById",
      +    "produces": [
      +      "application/json",
      +      "text/html"
      +    ],
      +    "responses": {
      +      "200": {
      +        "description": "pet response",
      +        "schema": {
      +          "type": "array",
      +          "items": {
      +            "$ref": "#/definitions/Pet"
      +          }
      +        }
      +      },
      +      "default": {
      +        "description": "error payload",
      +        "schema": {
      +          "$ref": "#/definitions/ErrorModel"
      +        }
      +      }
      +    }
      +  },
      +  "parameters": [
      +    {
      +      "name": "id",
      +      "in": "path",
      +      "description": "ID of pet to use",
      +      "required": true,
      +      "type": "array",
      +      "items": {
      +        "type": "string"
      +      },
      +      "collectionFormat": "csv"
      +    }
      +  ]
      +}
      +
      +
      
      +get:
      +  description: Returns pets based on ID
      +  summary: Find pets by ID
      +  operationId: getPetsById
      +  produces:
      +  - application/json
      +  - text/html
      +  responses:
      +    '200':
      +      description: pet response
      +      schema:
      +        type: array
      +        items:
      +          $ref: '#/definitions/Pet'
      +    default:
      +      description: error payload
      +      schema:
      +        $ref: '#/definitions/ErrorModel'
      +parameters:
      +- name: id
      +  in: path
      +  description: ID of pet to use
      +  required: true
      +  type: array
      +  items:
      +    type: string
      +  collectionFormat: csv
      +
      +

      Operation Object

      +

      Describes a single API operation on a path.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
      summarystringA short summary of what the operation does. For maximum readability in the swagger-ui, this field SHOULD be less than 120 characters.
      descriptionstringA verbose explanation of the operation behavior. GFM syntax can be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
      operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is recommended to follow common programming naming conventions.
      consumes[string]A list of MIME types the operation can consume. This overrides the consumes definition at the Swagger Object. An empty value MAY be used to clear the global definition. Value MUST be as described under Mime Types.
      produces[string]A list of MIME types the operation can produce. This overrides the produces definition at the Swagger Object. An empty value MAY be used to clear the global definition. Value MUST be as described under Mime Types.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it, but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the Swagger Object’s parameters. There can be one “body” parameter at most.
      responsesResponses ObjectRequired. The list of possible responses as they are returned from executing this operation.
      schemes[string]The transfer protocol for the operation. Values MUST be from the list: "http", "https", "ws", "wss". The value overrides the Swagger Object schemes definition.
      deprecatedbooleanDeclares this operation to be deprecated. Usage of the declared operation should be refrained. Default value is false.
      security[Security Requirement Object]A declaration of which security schemes are applied for this operation. The list of values describes alternative security schemes that can be used (that is, there is a logical OR between the security requirements). This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Operation Object Example

      +
      
      +{
      +  "tags": [
      +    "pet"
      +  ],
      +  "summary": "Updates a pet in the store with form data",
      +  "description": "",
      +  "operationId": "updatePetWithForm",
      +  "consumes": [
      +    "application/x-www-form-urlencoded"
      +  ],
      +  "produces": [
      +    "application/json",
      +    "application/xml"
      +  ],
      +  "parameters": [
      +    {
      +      "name": "petId",
      +      "in": "path",
      +      "description": "ID of pet that needs to be updated",
      +      "required": true,
      +      "type": "string"
      +    },
      +    {
      +      "name": "name",
      +      "in": "formData",
      +      "description": "Updated name of the pet",
      +      "required": false,
      +      "type": "string"
      +    },
      +    {
      +      "name": "status",
      +      "in": "formData",
      +      "description": "Updated status of the pet",
      +      "required": false,
      +      "type": "string"
      +    }
      +  ],
      +  "responses": {
      +    "200": {
      +      "description": "Pet updated."
      +    },
      +    "405": {
      +      "description": "Invalid input"
      +    }
      +  },
      +  "security": [
      +    {
      +      "petstore_auth": [
      +        "write:pets",
      +        "read:pets"
      +      ]
      +    }
      +  ]
      +}
      +
      +
      
      +tags:
      +- pet
      +summary: Updates a pet in the store with form data
      +description: ""
      +operationId: updatePetWithForm
      +consumes:
      +- application/x-www-form-urlencoded
      +produces:
      +- application/json
      +- application/xml
      +parameters:
      +- name: petId
      +  in: path
      +  description: ID of pet that needs to be updated
      +  required: true
      +  type: string
      +- name: name
      +  in: formData
      +  description: Updated name of the pet
      +  required: false
      +  type: string
      +- name: status
      +  in: formData
      +  description: Updated status of the pet
      +  required: false
      +  type: string
      +responses:
      +  '200':
      +    description: Pet updated.
      +  '405':
      +    description: Invalid input
      +security:
      +- petstore_auth:
      +  - write:pets
      +  - read:pets
      +
      +

      External Documentation Object

      +

      Allows referencing an external resource for extended documentation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA short description of the target documentation. GFM syntax can be used for rich text representation.
      urlstringRequired. The URL for the target documentation. Value MUST be in the format of a URL.
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      External Documentation Object Example

      +
      
      +{
      +  "description": "Find more info here",
      +  "url": "https://swagger.io"
      +}
      +
      +
      
      +description: Find more info here
      +url: https://swagger.io
      +
      +

      Parameter Object

      +

      Describes a single operation parameter.

      +

      A unique parameter is defined by a combination of a name and location.

      +

      There are five possible parameter types.

      +
        +
      • Path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
      • +
      • Query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
      • +
      • Header - Custom headers that are expected as part of the request.
      • +
      • Body - The payload that’s appended to the HTTP request. Since there can only be one payload, there can only be one body parameter. The name of the body parameter has no effect on the parameter itself and is used for documentation purposes only. Since Form parameters are also in the payload, body and form parameters cannot exist together for the same operation.
      • +
      • Form - Used to describe the payload of an HTTP request when either application/x-www-form-urlencoded, multipart/form-data or both are used as the content type of the request (in Swagger’s definition, the consumes property of an operation). This is the only parameter type that can be used to send files, thus supporting the file type. Since form parameters are sent in the payload, they cannot be declared together with a body parameter for the same operation. Form parameters have a different format based on the content-type used (for further details, consult http://www.w3.org/TR/html401/interact/forms.html#h-17.13.4): +
          +
        • application/x-www-form-urlencoded - Similar to the format of Query parameters but as a payload. For example, foo=1&bar=swagger - both foo and bar are form parameters. This is normally used for simple parameters that are being transferred.
        • +
        • multipart/form-data - each parameter takes a section in the payload with an internal header. For example, for the header Content-Disposition: form-data; name="submit-name" the name of the parameter is submit-name. This type of form parameters is more commonly used for file transfers.
        • +
        +
      • +
      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringRequired. The name of the parameter. Parameter names are case sensitive.
      • If in is "path", the name field MUST correspond to the associated path segment from the path field in the Paths Object. See Path Templating for further information.
      • For all other cases, the name corresponds to the parameter name used based on the in property.
      instringRequired. The location of the parameter. Possible values are “query”, “header”, “path”, “formData” or “body”.
      descriptionstringA brief description of the parameter. This could contain examples of use. GFM syntax can be used for rich text representation.
      requiredbooleanDetermines whether this parameter is mandatory. If the parameter is in “path”, this property is required and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
      +

      If in is "body":

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      schemaSchema ObjectRequired. The schema defining the type used for the body parameter.
      +

      If in is any value other than "body":

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      typestringRequired. The type of the parameter. Since the parameter is not located at the request body, it is limited to simple types (that is, not an object). The value MUST be one of "string", "number", "integer", "boolean", "array" or "file". If type is "file", the consumes MUST be either "multipart/form-data", " application/x-www-form-urlencoded" or both and the parameter MUST be in "formData".
      formatstringThe extending format for the previously mentioned type. See Data Type Formats for further details.
      allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for either query or formData parameters and allows you to send a parameter with a name only or an empty value. Default value is false.
      itemsItems ObjectRequired if type is “array”. Describes the type of items in the array.
      collectionFormatstringDetermines the format of the array if type array is used. Possible values are:
      • csv - comma separated values foo,bar.
      • ssv - space separated values foo bar.
      • tsv - tab separated values foo\tbar.
      • pipes - pipe separated values foo|bar.
      • multi - corresponds to multiple parameter instances instead of multiple values for a single instance foo=bar&foo=baz. This is valid only for parameters in “query” or “formData”.
      Default value is csv.
      default*Declares the value of the parameter that the server will use if none is provided, for example a “count” to control the number of results per page might default to 100 if not supplied by the client in the request. (Note: “default” has no meaning for required parameters.) See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-6.2. Unlike JSON Schema this value MUST conform to the defined type for this parameter.
      maximumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
      exclusiveMaximumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
      minimumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
      exclusiveMinimumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
      maxLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.1.
      minLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.2.
      patternstringSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.3.
      maxItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.2.
      minItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.3.
      uniqueItemsbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.4.
      enum[*]See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.5.1.
      multipleOfnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.1.
      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Parameter Object Examples

      +
      Body Parameters
      +

      A body parameter with a referenced schema definition (normally for a model definition):

      +
      
      +{
      +  "name": "user",
      +  "in": "body",
      +  "description": "user to add to the system",
      +  "required": true,
      +  "schema": {
      +    "$ref": "#/definitions/User"
      +  }
      +}
      +
      +
      
      +name: user
      +in: body
      +description: user to add to the system
      +required: true
      +schema:
      +  $ref: '#/definitions/User'
      +
      +

      A body parameter that is an array of string values:

      +
      
      +{
      +  "name": "user",
      +  "in": "body",
      +  "description": "user to add to the system",
      +  "required": true,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    }
      +  }
      +}
      +
      +
      
      +name: user
      +in: body
      +description: user to add to the system
      +required: true
      +schema:
      +  type: array
      +  items:
      +    type: string
      +
      +
      Other Parameters
      +

      A header parameter with an array of 64 bit integer numbers:

      +
      
      +{
      +  "name": "token",
      +  "in": "header",
      +  "description": "token to be passed as a header",
      +  "required": true,
      +  "type": "array",
      +  "items": {
      +    "type": "integer",
      +    "format": "int64"
      +  },
      +  "collectionFormat": "csv"
      +}
      +
      +
      
      +name: token
      +in: header
      +description: token to be passed as a header
      +required: true
      +type: array
      +items:
      +  type: integer
      +  format: int64
      +collectionFormat: csv
      +
      +

      A path parameter of a string value:

      +
      
      +{
      +  "name": "username",
      +  "in": "path",
      +  "description": "username to fetch",
      +  "required": true,
      +  "type": "string"
      +}
      +
      +
      
      +name: username
      +in: path
      +description: username to fetch
      +required: true
      +type: string
      +
      +

      An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

      +
      
      +{
      +  "name": "id",
      +  "in": "query",
      +  "description": "ID of the object to fetch",
      +  "required": false,
      +  "type": "array",
      +  "items": {
      +    "type": "string"
      +  },
      +  "collectionFormat": "multi"
      +}
      +
      +
      
      +name: id
      +in: query
      +description: ID of the object to fetch
      +required: false
      +type: array
      +items:
      +  type: string
      +collectionFormat: multi
      +
      +

      A form data with file type for a file upload:

      +
      
      +{
      +  "name": "avatar",
      +  "in": "formData",
      +  "description": "The avatar of the user",
      +  "required": true,
      +  "type": "file"
      +}
      +
      +
      
      +name: avatar
      +in: formData
      +description: The avatar of the user
      +required: true
      +type: file
      +
      +

      Items Object

      +

      A limited subset of JSON-Schema’s items object. It is used by parameter definitions that are not located in "body".

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      typestringRequired. The internal type of the array. The value MUST be one of "string", "number", "integer", "boolean", or "array". Files and models are not allowed.
      formatstringThe extending format for the previously mentioned type. See Data Type Formats for further details.
      itemsItems ObjectRequired if type is “array”. Describes the type of items in the array.
      collectionFormatstringDetermines the format of the array if type array is used. Possible values are:
      • csv - comma separated values foo,bar.
      • ssv - space separated values foo bar.
      • tsv - tab separated values foo\tbar.
      • pipes - pipe separated values foo|bar.
      Default value is csv.
      default*Declares the value of the item that the server will use if none is provided. (Note: “default” has no meaning for required items.) See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-6.2. Unlike JSON Schema this value MUST conform to the defined type for the data type.
      maximumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
      exclusiveMaximumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
      minimumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
      exclusiveMinimumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
      maxLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.1.
      minLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.2.
      patternstringSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.3.
      maxItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.2.
      minItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.3.
      uniqueItemsbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.4.
      enum[*]See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.5.1.
      multipleOfnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.1.
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Items Object Examples

      +

      Items must be of type string and have the minimum length of 2 characters:

      +
      
      +{
      +    "type": "string",
      +    "minLength": 2
      +}
      +
      +
      
      +type: string
      +minLength: 2
      +
      +

      An array of arrays, the internal array being of type integer, numbers must be between 0 and 63 (inclusive):

      +
      
      +{
      +    "type": "array",
      +    "items": {
      +        "type": "integer",
      +        "minimum": 0,
      +        "maximum": 63
      +    }
      +}
      +
      +
      
      +type: array
      +items:
      +  type: integer
      +  minimum: 0
      +  maximum: 63
      +
      +

      Responses Object

      +

      A container for the expected responses of an operation. The container maps a HTTP response code to the expected response. It is not expected from the documentation to necessarily cover all possible HTTP response codes, since they may not be known in advance. However, it is expected from the documentation to cover a successful operation response and any known errors.

      +

      The default can be used as the default response object for all HTTP codes that are not covered individually by the specification.

      +

      The Responses Object MUST contain at least one response code, and it SHOULD be the response for a successful operation call.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      defaultResponse Object ¦ Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. It can be used to cover undeclared responses. Reference Object can be used to link to a response that is defined at the Swagger Object’s responses section.
      +

      Patterned Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {HTTP Status Code}Response Object ¦ Reference ObjectAny HTTP status code can be used as the property name (one property per HTTP status code). Describes the expected response for that HTTP status code. Reference Object can be used to link to a response that is defined at the Swagger Object’s responses section.
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Responses Object Example

      +

      A 200 response for successful operation and a default response for others (implying an error):

      +
      
      +{
      +  "200": {
      +    "description": "a pet to be returned",
      +    "schema": {
      +      "$ref": "#/definitions/Pet"
      +    }
      +  },
      +  "default": {
      +    "description": "Unexpected error",
      +    "schema": {
      +      "$ref": "#/definitions/ErrorModel"
      +    }
      +  }
      +}
      +
      +
      
      +'200':
      +  description: a pet to be returned
      +  schema:
      +    $ref: '#/definitions/Pet'
      +default:
      +  description: Unexpected error
      +  schema:
      +    $ref: '#/definitions/ErrorModel'
      +
      +

      Response Object

      +

      Describes a single response from an API Operation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringRequired. A short description of the response. GFM syntax can be used for rich text representation.
      schemaSchema ObjectA definition of the response structure. It can be a primitive, an array or an object. If this field does not exist, it means no content is returned as part of the response. As an extension to the Schema Object, its root type value may also be "file". This SHOULD be accompanied by a relevant produces mime-type.
      headersHeaders ObjectA list of headers that are sent with the response.
      examplesExample ObjectAn example of the response message.
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Response Object Examples

      +

      Response of an array of a complex type:

      +
      
      +{
      +  "description": "A complex object array response",
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "$ref": "#/definitions/VeryComplexType"
      +    }
      +  }
      +}
      +
      +
      
      +description: A complex object array response
      +schema:
      +  type: array
      +  items:
      +    $ref: '#/definitions/VeryComplexType'
      +
      +

      Response with a string type:

      +
      
      +{
      +  "description": "A simple string response",
      +  "schema": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +description: A simple string response
      +schema:
      +  type: string
      +
      +

      Response with headers:

      +
      
      +{
      +  "description": "A simple string response",
      +  "schema": {
      +    "type": "string"
      +  },
      +  "headers": {
      +    "X-Rate-Limit-Limit": {
      +      "description": "The number of allowed requests in the current period",
      +      "type": "integer"
      +    },
      +    "X-Rate-Limit-Remaining": {
      +      "description": "The number of remaining requests in the current period",
      +      "type": "integer"
      +    },
      +    "X-Rate-Limit-Reset": {
      +      "description": "The number of seconds left in the current period",
      +      "type": "integer"
      +    }
      +  }
      +}
      +
      +
      
      +description: A simple string response
      +schema:
      +  type: string
      +headers:
      +  X-Rate-Limit-Limit:
      +    description: The number of allowed requests in the current period
      +    type: integer
      +  X-Rate-Limit-Remaining:
      +    description: The number of remaining requests in the current period
      +    type: integer
      +  X-Rate-Limit-Reset:
      +    description: The number of seconds left in the current period
      +    type: integer
      +
      +

      Response with no return value:

      +
      
      +{
      +  "description": "object created"
      +}
      +
      +
      
      +description: object created
      +
      +

      Headers Object

      +

      Lists the headers that can be sent as part of a response.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}Header ObjectThe name of the property corresponds to the name of the header. The value describes the type of the header.
      +

      Headers Object Example

      +

      Rate-limit headers:

      +
      
      +{
      +    "X-Rate-Limit-Limit": {
      +        "description": "The number of allowed requests in the current period",
      +        "type": "integer"
      +    },
      +    "X-Rate-Limit-Remaining": {
      +        "description": "The number of remaining requests in the current period",
      +        "type": "integer"
      +    },
      +    "X-Rate-Limit-Reset": {
      +        "description": "The number of seconds left in the current period",
      +        "type": "integer"
      +    }
      +}
      +
      +
      
      +X-Rate-Limit-Limit:
      +  description: The number of allowed requests in the current period
      +  type: integer
      +X-Rate-Limit-Remaining:
      +  description: The number of remaining requests in the current period
      +  type: integer
      +X-Rate-Limit-Reset:
      +  description: The number of seconds left in the current period
      +  type: integer
      +
      +

      Example Object

      +

      Allows sharing examples for operation responses.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {mime type}AnyThe name of the property MUST be one of the Operation produces values (either implicit or inherited). The value SHOULD be an example of what such a response would look like.
      +

      Example Object Example

      +

      Example response for application/json mimetype of a Pet data type:

      +
      
      +{
      +  "application/json": {
      +    "name": "Puma",
      +    "type": "Dog",
      +    "color": "Black",
      +    "gender": "Female",
      +    "breed": "Mixed"
      +  }
      +}
      +
      +
      
      +application/json:
      +  name: Puma
      +  type: Dog
      +  color: Black
      +  gender: Female
      +  breed: Mixed
      +
      +

      Header Object

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA short description of the header.
      typestringRequired. The type of the object. The value MUST be one of "string", "number", "integer", "boolean", or "array".
      formatstringThe extending format for the previously mentioned type. See Data Type Formats for further details.
      itemsItems ObjectRequired if type is “array”. Describes the type of items in the array.
      collectionFormatstringDetermines the format of the array if type array is used. Possible values are:
      • csv - comma separated values foo,bar.
      • ssv - space separated values foo bar.
      • tsv - tab separated values foo\tbar.
      • pipes - pipe separated values foo|bar.
      Default value is csv.
      default*Declares the value of the header that the server will use if none is provided. (Note: “default” has no meaning for required headers.) See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-6.2. Unlike JSON Schema this value MUST conform to the defined type for the header.
      maximumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
      exclusiveMaximumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
      minimumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
      exclusiveMinimumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
      maxLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.1.
      minLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.2.
      patternstringSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.3.
      maxItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.2.
      minItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.3.
      uniqueItemsbooleanhttps://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.4.
      enum[*]See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.5.1.
      multipleOfnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.1.
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Header Object Example

      +

      A simple header with of an integer type:

      +
      
      +{
      +  "description": "The number of allowed requests in the current period",
      +  "type": "integer"
      +}
      +
      +
      
      +description: The number of allowed requests in the current period
      +type: integer
      +
      +

      Tag Object

      +

      Allows adding meta data to a single tag that is used by the Operation Object. It is not mandatory to have a Tag Object per tag used there.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringRequired. The name of the tag.
      descriptionstringA short description for the tag. GFM syntax can be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Tag Object Example

      +
      
      +{
      +	"name": "pet",
      +	"description": "Pets operations"
      +}
      +
      +
      
      +name: pet
      +description: Pets operations
      +
      +

      Reference Object

      +

      A simple object to allow referencing other definitions in the specification. It can be used to reference parameters and responses that are defined at the top level for reuse.

      +

      The Reference Object is a JSON Reference that uses a JSON Pointer as its value. For this specification, only canonical dereferencing is supported.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringRequired. The reference string.
      +

      Reference Object Example

      +
      
      +{
      +	"$ref": "#/definitions/Pet"
      +}
      +
      +
      
      +$ref: '#/definitions/Pet'
      +
      +

      Relative Schema File Example

      +
      
      +{
      +  "$ref": "Pet.json"
      +}
      +
      +
      
      +$ref: 'Pet.yaml'
      +
      +

      Relative Files With Embedded Schema Example

      +
      
      +{
      +  "$ref": "definitions.json#/Pet"
      +}
      +
      +
      
      +$ref: 'definitions.yaml#/Pet'
      +
      +

      Schema Object

      +

      The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is based on the JSON Schema Specification Draft 4 and uses a predefined subset of it. On top of this subset, there are extensions provided by this specification to allow for more complete documentation.

      +

      Further information about the properties can be found in JSON Schema Core and JSON Schema Validation. Unless stated otherwise, the property definitions follow the JSON Schema specification as referenced here.

      +

      The following properties are taken directly from the JSON Schema definition and follow the same specifications:

      +
        +
      • $ref - As a JSON Reference
      • +
      • format (See Data Type Formats for further details)
      • +
      • title
      • +
      • description (GFM syntax can be used for rich text representation)
      • +
      • default (Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object)
      • +
      • multipleOf
      • +
      • maximum
      • +
      • exclusiveMaximum
      • +
      • minimum
      • +
      • exclusiveMinimum
      • +
      • maxLength
      • +
      • minLength
      • +
      • pattern
      • +
      • maxItems
      • +
      • minItems
      • +
      • uniqueItems
      • +
      • maxProperties
      • +
      • minProperties
      • +
      • required
      • +
      • enum
      • +
      • type
      • +
      +

      The following properties are taken from the JSON Schema definition but their definitions were adjusted to the Swagger Specification. Their definition is the same as the one from JSON Schema, only where the original definition references the JSON Schema definition, the Schema Object definition is used instead.

      +
        +
      • items
      • +
      • allOf
      • +
      • properties
      • +
      • additionalProperties
      • +
      +

      Other than the JSON Schema subset fields, the following fields may be used for further schema documentation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      discriminatorstringAdds support for polymorphism. The discriminator is the schema property name that is used to differentiate between other schema that inherit this schema. The property name used MUST be defined at this schema and it MUST be in the required property list. When used, the value MUST be the name of this schema or any schema that inherits it.
      readOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “read only”. This means that it MAY be sent as part of a response but MUST NOT be sent as part of the request. Properties marked as readOnly being true SHOULD NOT be in the required list of the defined schema. Default value is false.
      xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds Additional metadata to describe the XML representation format of this property.
      externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
      exampleAnyA free-form property to include an example of an instance for this schema.
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +
      Composition and Inheritance (Polymorphism)
      +

      Swagger allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. allOf takes in an array of object definitions that are validated independently but together compose a single object.

      +

      While composition offers model extensibility, it does not imply a hierarchy between the models. To support polymorphism, Swagger adds the support of the discriminator field. When used, the discriminator will be the name of the property used to decide which schema definition is used to validate the structure of the model. As such, the discriminator field MUST be a required field. The value of the chosen property has to be the friendly name given to the model under the definitions property. As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.

      +
      XML Modeling
      +

      The xml property allows extra definitions when translating the JSON definition to XML. The XML Object contains additional information about the available options.

      +

      Schema Object Examples

      +
      Primitive Sample
      +

      Unlike previous versions of Swagger, Schema definitions can be used to describe primitive and arrays as well.

      +
      
      +{
      +    "type": "string",
      +    "format": "email"
      +}
      +
      +
      
      +type: string
      +format: email
      +
      +
      Simple Model
      +
      
      +{
      +  "type": "object",
      +  "required": [
      +    "name"
      +  ],
      +  "properties": {
      +    "name": {
      +      "type": "string"
      +    },
      +    "address": {
      +      "$ref": "#/definitions/Address"
      +    },
      +    "age": {
      +      "type": "integer",
      +      "format": "int32",
      +      "minimum": 0
      +    }
      +  }
      +}
      +
      +
      
      +type: object
      +required:
      +- name
      +properties:
      +  name:
      +    type: string
      +  address:
      +    $ref: '#/definitions/Address'
      +  age:
      +    type: integer
      +    format: int32
      +    minimum: 0
      +
      +
      Model with Map/Dictionary Properties
      +

      For a simple string to string mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  type: string
      +
      +

      For a string to model mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "$ref": "#/definitions/ComplexModel"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  $ref: '#/definitions/ComplexModel'
      +
      +
      Model with Example
      +
      
      +{
      +  "type": "object",
      +  "properties": {
      +    "id": {
      +      "type": "integer",
      +      "format": "int64"
      +    },
      +    "name": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "name"
      +  ],
      +  "example": {
      +    "name": "Puma",
      +    "id": 1
      +  }
      +}
      +
      +
      
      +type: object
      +properties:
      +  id:
      +    type: integer
      +    format: int64
      +  name:
      +    type: string
      +required:
      +- name
      +example:
      +  name: Puma
      +  id: 1
      +
      +
      Models with Composition
      +
      
      +{
      +  "definitions": {
      +    "ErrorModel": {
      +      "type": "object",
      +      "required": [
      +        "message",
      +        "code"
      +      ],
      +      "properties": {
      +        "message": {
      +          "type": "string"
      +        },
      +        "code": {
      +          "type": "integer",
      +          "minimum": 100,
      +          "maximum": 600
      +        }
      +      }
      +    },
      +    "ExtendedErrorModel": {
      +      "allOf": [
      +        {
      +          "$ref": "#/definitions/ErrorModel"
      +        },
      +        {
      +          "type": "object",
      +          "required": [
      +            "rootCause"
      +          ],
      +          "properties": {
      +            "rootCause": {
      +              "type": "string"
      +            }
      +          }
      +        }
      +      ]
      +    }
      +  }
      +}
      +
      +
      
      +definitions:
      +  ErrorModel:
      +    type: object
      +    required:
      +    - message
      +    - code
      +    properties:
      +      message:
      +        type: string
      +      code:
      +        type: integer
      +        minimum: 100
      +        maximum: 600
      +  ExtendedErrorModel:
      +    allOf:
      +    - $ref: '#/definitions/ErrorModel'
      +    - type: object
      +      required:
      +      - rootCause
      +      properties:
      +        rootCause:
      +          type: string
      +
      +
      Models with Polymorphism Support
      +
      
      +{
      +  "definitions": {
      +    "Pet": {
      +      "type": "object",
      +      "discriminator": "petType",
      +      "properties": {
      +        "name": {
      +          "type": "string"
      +        },
      +        "petType": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "name",
      +        "petType"
      +      ]
      +    },
      +    "Cat": {
      +      "description": "A representation of a cat",
      +      "allOf": [
      +        {
      +          "$ref": "#/definitions/Pet"
      +        },
      +        {
      +          "type": "object",
      +          "properties": {
      +            "huntingSkill": {
      +              "type": "string",
      +              "description": "The measured skill for hunting",
      +              "default": "lazy",
      +              "enum": [
      +                "clueless",
      +                "lazy",
      +                "adventurous",
      +                "aggressive"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "huntingSkill"
      +          ]
      +        }
      +      ]
      +    },
      +    "Dog": {
      +      "description": "A representation of a dog",
      +      "allOf": [
      +        {
      +          "$ref": "#/definitions/Pet"
      +        },
      +        {
      +          "type": "object",
      +          "properties": {
      +            "packSize": {
      +              "type": "integer",
      +              "format": "int32",
      +              "description": "the size of the pack the dog is from",
      +              "default": 0,
      +              "minimum": 0
      +            }
      +          },
      +          "required": [
      +            "packSize"
      +          ]
      +        }
      +      ]
      +    }
      +  }
      +}
      +
      +
      
      +definitions:
      +  Pet:
      +    type: object
      +    discriminator: petType
      +    properties:
      +      name:
      +        type: string
      +      petType:
      +        type: string
      +    required:
      +    - name
      +    - petType
      +  Cat:
      +    description: A representation of a cat
      +    allOf:
      +    - $ref: '#/definitions/Pet'
      +    - type: object
      +      properties:
      +        huntingSkill:
      +          type: string
      +          description: The measured skill for hunting
      +          default: lazy
      +          enum:
      +          - clueless
      +          - lazy
      +          - adventurous
      +          - aggressive
      +      required:
      +      - huntingSkill
      +  Dog:
      +    description: A representation of a dog
      +    allOf:
      +    - $ref: '#/definitions/Pet'
      +    - type: object
      +      properties:
      +        packSize:
      +          type: integer
      +          format: int32
      +          description: the size of the pack the dog is from
      +          default: 0
      +          minimum: 0
      +      required:
      +      - packSize
      +
      +

      XML Object

      +

      A metadata object that allows for more fine-tuned XML model definitions.

      +

      When using arrays, XML element names are not inferred (for singular/plural forms) and the name property should be used to add that information. See examples for expected behavior.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringReplaces the name of the element/attribute used for the described schema property. When defined within the Items Object (items), it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
      namespacestringThe URL of the namespace definition. Value SHOULD be in the form of a URL.
      prefixstringThe prefix to be used for the name.
      attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
      wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      XML Object Examples

      +

      The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

      +
      No XML Element
      +

      Basic string property:

      +
      
      +{
      +    "animals": {
      +        "type": "string"
      +    }
      +}
      +
      +
      
      +animals:
      +  type: string
      +
      +
      
      +<animals>...</animals>
      +
      +

      Basic string array property (wrapped is false by default):

      +
      
      +{
      +    "animals": {
      +        "type": "array",
      +        "items": {
      +            "type": "string"
      +        }
      +    }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +
      +
      
      +<animals>...</animals>
      +<animals>...</animals>
      +<animals>...</animals>
      +
      +
      XML Name Replacement
      +
      
      +{
      +  "animals": {
      +    "type": "string",
      +    "xml": {
      +      "name": "animal"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: string
      +  xml:
      +    name: animal
      +
      +
      
      +<animal>...</animal>
      +
      +
      XML Attribute, Prefix and Namespace
      +

      In this example, a full model definition is shown.

      +
      
      +{
      +  "Person": {
      +    "type": "object",
      +    "properties": {
      +      "id": {
      +        "type": "integer",
      +        "format": "int32",
      +        "xml": {
      +          "attribute": true
      +        }
      +      },
      +      "name": {
      +        "type": "string",
      +        "xml": {
      +          "namespace": "http://swagger.io/schema/sample",
      +          "prefix": "sample"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +Person:
      +  type: object
      +  properties:
      +    id:
      +      type: integer
      +      format: int32
      +      xml:
      +        attribute: true
      +    name:
      +      type: string
      +      xml:
      +        namespace: http://swagger.io/schema/sample
      +        prefix: sample
      +
      +
      
      +<Person id="123">
      +    <sample:name xmlns:sample="http://swagger.io/schema/sample">example</sample:name>
      +</Person>
      +
      +
      XML Arrays
      +

      Changing the element names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      The external name property has no effect on the XML:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      Even when the array is wrapped, if no name is explicitly defined, the same name will be used both internally and externally:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animals>value</animals>
      +  <animals>value</animals>
      +</animals>
      +
      +

      To overcome the above example, the following definition can be used:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</animals>
      +
      +

      Affecting both internal and external names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</aliens>
      +
      +

      If we change the external element but not the internal ones:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <aliens>value</aliens>
      +  <aliens>value</aliens>
      +</aliens>
      +
      +

      Definitions Object

      +

      An object to hold data types that can be consumed and produced by operations. These data types can be primitives, arrays or models.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}Schema ObjectA single definition, mapping a “name” to the schema it defines.
      +

      Definitions Object Example

      +
      
      +{
      +  "Category": {
      +    "type": "object",
      +    "properties": {
      +      "id": {
      +        "type": "integer",
      +        "format": "int64"
      +      },
      +      "name": {
      +        "type": "string"
      +      }
      +    }
      +  },
      +  "Tag": {
      +    "type": "object",
      +    "properties": {
      +      "id": {
      +        "type": "integer",
      +        "format": "int64"
      +      },
      +      "name": {
      +        "type": "string"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +Category:
      +  type: object
      +  properties:
      +    id:
      +      type: integer
      +      format: int64
      +    name:
      +      type: string
      +Tag:
      +  type: object
      +  properties:
      +    id:
      +      type: integer
      +      format: int64
      +    name:
      +      type: string
      +
      +

      Parameters Definitions Object

      +

      An object to hold parameters to be reused across operations. Parameter definitions can be referenced to the ones defined here.

      +

      This does not define global operation parameters.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}Parameter ObjectA single parameter definition, mapping a “name” to the parameter it defines.
      +

      Parameters Definition Object Example

      +
      
      +{
      +  "skipParam": {
      +    "name": "skip",
      +    "in": "query",
      +    "description": "number of items to skip",
      +    "required": true,
      +    "type": "integer",
      +    "format": "int32"
      +  },
      +  "limitParam": {
      +    "name": "limit",
      +    "in": "query",
      +    "description": "max records to return",
      +    "required": true,
      +    "type": "integer",
      +    "format": "int32"
      +  }
      +}
      +
      +
      
      +skipParam:
      +  name: skip
      +  in: query
      +  description: number of items to skip
      +  required: true
      +  type: integer
      +  format: int32
      +limitParam:
      +  name: limit
      +  in: query
      +  description: max records to return
      +  required: true
      +  type: integer
      +  format: int32
      +
      +

      Responses Definitions Object

      +

      An object to hold responses to be reused across operations. Response definitions can be referenced to the ones defined here.

      +

      This does not define global operation responses.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}Response ObjectA single response definition, mapping a “name” to the response it defines.
      +

      Responses Definitions Object Example

      +
      
      +{
      +  "NotFound": {
      +    "description": "Entity not found."
      +  },
      +  "IllegalInput": {
      +  	"description": "Illegal input for operation."
      +  },
      +  "GeneralError": {
      +  	"description": "General Error",
      +  	"schema": {
      +  		"$ref": "#/definitions/GeneralError"
      +  	}
      +  }
      +}
      +
      +
      
      +NotFound:
      +  description: Entity not found.
      +IllegalInput:
      +  description: Illegal input for operation.
      +GeneralError:
      +  description: General Error
      +  schema:
      +    $ref: '#/definitions/GeneralError'
      +
      +

      Security Definitions Object

      +

      A declaration of the security schemes available to be used in the specification. This does not enforce the security schemes on the operations and only serves to provide the relevant details for each scheme.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}Security Scheme ObjectA single security scheme definition, mapping a “name” to the scheme it defines.
      +

      Security Definitions Object Example

      +
      
      +{
      +  "api_key": {
      +    "type": "apiKey",
      +    "name": "api_key",
      +    "in": "header"
      +  },
      +  "petstore_auth": {
      +    "type": "oauth2",
      +    "authorizationUrl": "http://swagger.io/api/oauth/dialog",
      +    "flow": "implicit",
      +    "scopes": {
      +      "write:pets": "modify pets in your account",
      +      "read:pets": "read your pets"
      +    }
      +  }
      +}
      +
      +
      
      +api_key:
      +  type: apiKey
      +  name: api_key
      +  in: header
      +petstore_auth:
      +  type: oauth2
      +  authorizationUrl: http://swagger.io/api/oauth/dialog
      +  flow: implicit
      +  scopes:
      +    write:pets: modify pets in your account
      +    read:pets: read your pets
      +
      +

      Security Scheme Object

      +

      Allows the definition of a security scheme that can be used by the operations. Supported schemes are basic authentication, an API key (either as a header or as a query parameter) and OAuth2’s common flows (implicit, password, application and access code).

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeValidityDescription
      typestringAnyRequired. The type of the security scheme. Valid values are "basic", "apiKey" or "oauth2".
      descriptionstringAnyA short description for security scheme.
      namestringapiKeyRequired. The name of the header or query parameter to be used.
      instringapiKeyRequired The location of the API key. Valid values are "query" or "header".
      flowstringoauth2Required. The flow used by the OAuth2 security scheme. Valid values are "implicit", "password", "application" or "accessCode".
      authorizationUrlstringoauth2 ("implicit", "accessCode")Required. The authorization URL to be used for this flow. This SHOULD be in the form of a URL.
      tokenUrlstringoauth2 ("password", "application", "accessCode")Required. The token URL to be used for this flow. This SHOULD be in the form of a URL.
      scopesScopes Objectoauth2Required. The available scopes for the OAuth2 security scheme.
      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Security Scheme Object Example

      +
      Basic Authentication Sample
      +
      
      +{
      +  "type": "basic"
      +}
      +
      +
      
      +type: basic
      +
      +
      API Key Sample
      +
      
      +{
      +  "type": "apiKey",
      +  "name": "api_key",
      +  "in": "header"
      +}
      +
      +
      
      +type: apiKey
      +name: api_key
      +in: header
      +
      +
      Implicit OAuth2 Sample
      +
      
      +{
      +  "type": "oauth2",
      +  "authorizationUrl": "http://swagger.io/api/oauth/dialog",
      +  "flow": "implicit",
      +  "scopes": {
      +    "write:pets": "modify pets in your account",
      +    "read:pets": "read your pets"
      +  }
      +}
      +
      +
      
      +type: oauth2
      +authorizationUrl: http://swagger.io/api/oauth/dialog
      +flow: implicit
      +scopes:
      +  write:pets: modify pets in your account
      +  read:pets: read your pets
      +
      +

      Scopes Object

      +

      Lists the available scopes for an OAuth2 security scheme.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}stringMaps between a name of a scope to a short description of it (as the value of the property).
      +

      Patterned Objects

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
      +

      Scopes Object Example

      +
      
      +{
      +  "write:pets": "modify pets in your account",
      +  "read:pets": "read your pets"
      +}
      +
      +
      
      +write:pets: modify pets in your account
      +read:pets: read your pets
      +
      +

      Security Requirement Object

      +

      Lists the required security schemes to execute this operation. The object can have multiple security schemes declared in it which are all required (that is, there is a logical AND between the schemes).

      +

      The name used for each property MUST correspond to a security scheme declared in the Security Definitions.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}[string]Each name must correspond to a security scheme which is declared in the Security Definitions. If the security scheme is of type "oauth2", then the value is a list of scope names required for the execution. For other security scheme types, the array MUST be empty.
      +

      Security Requirement Object Examples

      +
      Non-OAuth2 Security Requirement
      +
      
      +{
      +  "api_key": []
      +}
      +
      +
      
      +api_key: []
      +
      +
      OAuth2 Security Requirement
      +
      
      +{
      +  "petstore_auth": [
      +    "write:pets",
      +    "read:pets"
      +  ]
      +}
      +
      +
      
      +petstore_auth:
      +- write:pets
      +- read:pets
      +
      +

      Specification Extensions

      +

      While the Swagger Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

      +

      The extensions properties are always prefixed by "x-" and can have any valid JSON format value.

      +

      The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

      +

      Security Filtering

      +

      Some objects in the Swagger specification may be declared and remain empty, or completely be removed, even though they are inherently the core of the API documentation.

      +

      The reasoning behind it is to allow an additional layer of access control over the documentation itself. While not part of the specification itself, certain libraries may choose to allow access to parts of the documentation based on some form of authentication/authorization.

      +

      Two examples for this:

      +
        +
      1. The Paths Object may be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
      2. +
      3. The Path Item Object may be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the Paths Object so the user will not be aware of its existence. This allows the documentation provider a finer control over what the viewer can see.
      4. +
      + diff --git a/oas/v3.0.0.html b/oas/v3.0.0.html new file mode 100644 index 0000000000..918104376a --- /dev/null +++ b/oas/v3.0.0.html @@ -0,0 +1,4093 @@ +OpenAPI Specification + + +
      The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

      Status of This Document

      The source-of-truth for the specification is the GitHub markdown file referenced above.
      +

      OpenAPI Specification

      +

      Version 3.0.0

      +

      The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

      +

      This document is licensed under The Apache License, Version 2.0.

      +

      Introduction

      +

      The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

      +

      An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

      + +

      Definitions

      +

      OpenAPI Document

      +

      A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

      +

      Path Templating

      +

      Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

      +

      Media Types

      +

      Media type definitions are spread across several resources. +The media type definitions SHOULD be in compliance with [[!RFC6838]].

      +

      Some examples of possible media type definitions:

      +
      
      +  text/plain; charset=utf-8
      +  application/json
      +  application/vnd.github+json
      +  application/vnd.github.v3+json
      +  application/vnd.github.v3.raw+json
      +  application/vnd.github.v3.text+json
      +  application/vnd.github.v3.html+json
      +  application/vnd.github.v3.full+json
      +  application/vnd.github.v3.diff
      +  application/vnd.github.v3.patch
      +
      +

      HTTP Status Codes

      +

      The HTTP Status Codes are used to indicate the status of the executed operation. +The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

      +

      Specification

      +

      Versions

      +

      The OpenAPI Specification is versioned using Semantic Versioning 2.0.0 (semver) and follows the semver specification.

      +

      The major.minor portion of the semver (for example 3.0) SHALL designate the OAS feature set. Typically, .patch versions address errors in this document, not the feature set. Tooling which supports OAS 3.0 SHOULD be compatible with all OAS 3.0.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.0.0 and 3.0.1 for example.

      +

      Subsequent minor version releases of the OpenAPI Specification (incrementing the minor version number) SHOULD NOT interfere with tooling developed to a lower minor version and same major version. Thus a hypothetical 3.1.0 specification SHOULD be usable with tooling designed for 3.0.0.

      +

      An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the semantic version of the OAS that it uses. (OAS 2.0 documents contain a top-level version field named swagger and value "2.0".)

      +

      Format

      +

      An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

      +

      For example, if a field has an array value, the JSON array representation will be used:

      +
      
      +{
      +   "field": [ 1, 2, 3 ]
      +}
      +
      +

      All field names in the specification are case sensitive.

      +

      The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

      +

      Patterned fields MUST have unique names within the containing object.

      +

      In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

      + +

      Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

      +

      Document Structure

      +

      An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

      +

      It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

      +

      Data Types

      +

      Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. +Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. +null is not supported as a type (see nullable for an alternative solution). +Models are defined using the Schema Object, which is an extended subset of JSON Schema Specification Wright Draft 00.

      +

      Primitives have an optional modifier property: format. +OAS uses several known formats to define in fine detail the data type being used. +However, to support documentation needs, the format property is an open string-valued property, and can have any value. +Formats such as "email", "uuid", and so on, MAY be used even though undefined by this specification. +Types that are not accompanied by a format property follow the type definition in the JSON Schema. Tools that do not recognize a specific format MAY default back to the type alone, as if the format is not specified.

      +

      The formats defined by the OAS are:

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Common NametypeformatComments
      integerintegerint32signed 32 bits
      longintegerint64signed 64 bits
      floatnumberfloat
      doublenumberdouble
      stringstring
      bytestringbytebase64 encoded characters
      binarystringbinaryany sequence of octets
      booleanboolean
      datestringdateAs defined by full-date - [!RFC3339]
      dateTimestringdate-timeAs defined by date-time - [!RFC3339]
      passwordstringpasswordA hint to UIs to obscure input.
      +

      Rich Text Formatting

      +

      Throughout the specification description fields are noted as supporting CommonMark markdown formatting. +Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

      +

      Relative References in URLs

      +

      Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. +Relative references are resolved using the URLs defined in the Server Object as a Base URI.

      +

      Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

      +

      Schema

      +

      In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

      +

      OpenAPI Object

      +

      This is the root document object of the OpenAPI document.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      openapistringREQUIRED. This string MUST be the semantic version number of the OpenAPI Specification version that the OpenAPI document uses. The openapi field SHOULD be used by tooling specifications and clients to interpret the OpenAPI document. This is not related to the API info.version string.
      infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
      servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
      pathsPaths ObjectREQUIRED. The available paths and operations for the API.
      componentsComponents ObjectAn element to hold various schemas for the specification.
      security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition.
      tags[Tag Object]A list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
      externalDocsExternal Documentation ObjectAdditional external documentation.
      +

      This object MAY be extended with Specification Extensions.

      +

      Info Object

      +

      The object provides metadata about the API. +The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      titlestringREQUIRED. The title of the application.
      descriptionstringA short description of the application. CommonMark syntax MAY be used for rich text representation.
      termsOfServicestringA URL to the Terms of Service for the API. MUST be in the format of a URL.
      contactContact ObjectThe contact information for the exposed API.
      licenseLicense ObjectThe license information for the exposed API.
      versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
      +

      This object MAY be extended with Specification Extensions.

      +

      Info Object Example:

      +
      
      +{
      +  "title": "Sample Pet Store App",
      +  "description": "This is a sample server for a pet store.",
      +  "termsOfService": "http://example.com/terms/",
      +  "contact": {
      +    "name": "API Support",
      +    "url": "http://www.example.com/support",
      +    "email": "support@example.com"
      +  },
      +  "license": {
      +    "name": "Apache 2.0",
      +    "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
      +  },
      +  "version": "1.0.1"
      +}
      +
      +
      
      +title: Sample Pet Store App
      +description: This is a sample server for a pet store.
      +termsOfService: http://example.com/terms/
      +contact:
      +  name: API Support
      +  url: http://www.example.com/support
      +  email: support@example.com
      +license:
      +  name: Apache 2.0
      +  url: http://www.apache.org/licenses/LICENSE-2.0.html
      +version: 1.0.1
      +
      +

      Contact Object

      +

      Contact information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringThe identifying name of the contact person/organization.
      urlstringThe URL pointing to the contact information. MUST be in the format of a URL.
      emailstringThe email address of the contact person/organization. MUST be in the format of an email address.
      +

      This object MAY be extended with Specification Extensions.

      +

      Contact Object Example:

      +
      
      +{
      +  "name": "API Support",
      +  "url": "http://www.example.com/support",
      +  "email": "support@example.com"
      +}
      +
      +
      
      +name: API Support
      +url: http://www.example.com/support
      +email: support@example.com
      +
      +

      License Object

      +

      License information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The license name used for the API.
      urlstringA URL to the license used for the API. MUST be in the format of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      License Object Example:

      +
      
      +{
      +  "name": "Apache 2.0",
      +  "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
      +}
      +
      +
      
      +name: Apache 2.0
      +url: http://www.apache.org/licenses/LICENSE-2.0.html
      +
      +

      Server Object

      +

      An object representing a Server.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
      descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
      variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
      +

      This object MAY be extended with Specification Extensions.

      +

      Server Object Example

      +

      A single server would be described as:

      +
      
      +{
      +  "url": "https://development.gigantic-server.com/v1",
      +  "description": "Development server"
      +}
      +
      +
      
      +url: https://development.gigantic-server.com/v1
      +description: Development server
      +
      +

      The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

      +
      
      +{
      +  "servers": [
      +    {
      +      "url": "https://development.gigantic-server.com/v1",
      +      "description": "Development server"
      +    },
      +    {
      +      "url": "https://staging.gigantic-server.com/v1",
      +      "description": "Staging server"
      +    },
      +    {
      +      "url": "https://api.gigantic-server.com/v1",
      +      "description": "Production server"
      +    }
      +  ]
      +}
      +
      +
      
      +servers:
      +- url: https://development.gigantic-server.com/v1
      +  description: Development server
      +- url: https://staging.gigantic-server.com/v1
      +  description: Staging server
      +- url: https://api.gigantic-server.com/v1
      +  description: Production server
      +
      +

      The following shows how variables can be used for a server configuration:

      +
      
      +{
      +  "servers": [
      +    {
      +      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
      +      "description": "The production API server",
      +      "variables": {
      +        "username": {
      +          "default": "demo",
      +          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
      +        },
      +        "port": {
      +          "enum": [
      +            "8443",
      +            "443"
      +          ],
      +          "default": "8443"
      +        },
      +        "basePath": {
      +          "default": "v2"
      +        }
      +      }
      +    }
      +  ]
      +}
      +
      +
      
      +servers:
      +- url: https://{username}.gigantic-server.com:{port}/{basePath}
      +  description: The production API server
      +  variables:
      +    username:
      +      # note! no enum here means it is an open value
      +      default: demo
      +      description: this value is assigned by the service provider, in this example `gigantic-server.com`
      +    port:
      +      enum:
      +        - '8443'
      +        - '443'
      +      default: '8443'
      +    basePath:
      +      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
      +      default: v2
      +
      +

      Server Variable Object

      +

      An object representing a Server Variable for server URL template substitution.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      enum[string]An enumeration of string values to be used if the substitution options are from a limited set.
      defaultstringREQUIRED. The default value to use for substitution, and to send, if an alternate value is not supplied. Unlike the Schema Object’s default, this value MUST be provided by the consumer.
      descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
      +

      This object MAY be extended with Specification Extensions.

      +

      Components Object

      +

      Holds a set of reusable objects for different aspects of the OAS. +All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      schemasMap[string, Schema Object ¦ Reference Object]An object to hold reusable Schema Objects.
      responsesMap[string, Response Object ¦ Reference Object]An object to hold reusable Response Objects.
      parametersMap[string, Parameter Object ¦ Reference Object]An object to hold reusable Parameter Objects.
      examplesMap[string, Example Object ¦ Reference Object]An object to hold reusable Example Objects.
      requestBodiesMap[string, Request Body Object ¦ Reference Object]An object to hold reusable Request Body Objects.
      headersMap[string, Header Object ¦ Reference Object]An object to hold reusable Header Objects.
      securitySchemesMap[string, Security Scheme Object ¦ Reference Object]An object to hold reusable Security Scheme Objects.
      linksMap[string, Link Object ¦ Reference Object]An object to hold reusable Link Objects.
      callbacksMap[string, Callback Object ¦ Reference Object]An object to hold reusable Callback Objects.
      +

      This object MAY be extended with Specification Extensions.

      +

      All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

      +

      Field Name Examples:

      +
      
      +User
      +User_1
      +User_Name
      +user-name
      +my.org.User
      +
      +

      Components Object Example

      +
      
      +"components": {
      +  "schemas": {
      +    "Category": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      }
      +    },
      +    "Tag": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      }
      +    }
      +  },
      +  "parameters": {
      +    "skipParam": {
      +      "name": "skip",
      +      "in": "query",
      +      "description": "number of items to skip",
      +      "required": true,
      +      "schema": {
      +        "type": "integer",
      +        "format": "int32"
      +      }
      +    },
      +    "limitParam": {
      +      "name": "limit",
      +      "in": "query",
      +      "description": "max records to return",
      +      "required": true,
      +      "schema" : {
      +        "type": "integer",
      +        "format": "int32"
      +      }
      +    }
      +  },
      +  "responses": {
      +    "NotFound": {
      +      "description": "Entity not found."
      +    },
      +    "IllegalInput": {
      +      "description": "Illegal input for operation."
      +    },
      +    "GeneralError": {
      +      "description": "General Error",
      +      "content": {
      +        "application/json": {
      +          "schema": {
      +            "$ref": "#/components/schemas/GeneralError"
      +          }
      +        }
      +      }
      +    }
      +  },
      +  "securitySchemes": {
      +    "api_key": {
      +      "type": "apiKey",
      +      "name": "api_key",
      +      "in": "header"
      +    },
      +    "petstore_auth": {
      +      "type": "oauth2",
      +      "flows": {
      +        "implicit": {
      +          "authorizationUrl": "http://example.org/api/oauth/dialog",
      +          "scopes": {
      +            "write:pets": "modify pets in your account",
      +            "read:pets": "read your pets"
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    Category:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +    Tag:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +  parameters:
      +    skipParam:
      +      name: skip
      +      in: query
      +      description: number of items to skip
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +    limitParam:
      +      name: limit
      +      in: query
      +      description: max records to return
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +  responses:
      +    NotFound:
      +      description: Entity not found.
      +    IllegalInput:
      +      description: Illegal input for operation.
      +    GeneralError:
      +      description: General Error
      +      content:
      +        application/json:
      +          schema:
      +            $ref: '#/components/schemas/GeneralError'
      +  securitySchemes:
      +    api_key:
      +      type: apiKey
      +      name: api_key
      +      in: header
      +    petstore_auth:
      +      type: oauth2
      +      flows: 
      +        implicit:
      +          authorizationUrl: http://example.org/api/oauth/dialog
      +          scopes:
      +            write:pets: modify pets in your account
      +            read:pets: read your pets
      +
      +

      Paths Object

      +

      Holds the relative paths to the individual endpoints and their operations. +The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a slash. The path is appended (no relative URL resolution) to the expanded URL from the Server Object's url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
      +

      This object MAY be extended with Specification Extensions.

      +

      Path Templating Matching

      +

      Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

      +
      
      +  /pets/{petId}
      +  /pets/mine
      +
      +

      The following paths are considered identical and invalid:

      +
      
      +  /pets/{petId}
      +  /pets/{name}
      +
      +

      The following may lead to ambiguous resolution:

      +
      
      +  /{entity}/me
      +  /books/{id}
      +
      +

      Paths Object Example

      +
      
      +{
      +  "/pets": {
      +    "get": {
      +      "description": "Returns all pets from the system that the user has access to",
      +      "responses": {
      +        "200": {          
      +          "description": "A list of pets.",
      +          "content": {
      +            "application/json": {
      +              "schema": {
      +                "type": "array",
      +                "items": {
      +                  "$ref": "#/components/schemas/pet"
      +                }
      +              }
      +            }
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +/pets:
      +  get:
      +    description: Returns all pets from the system that the user has access to
      +    responses:
      +      '200':
      +        description: A list of pets.
      +        content:
      +          application/json:
      +            schema:
      +              type: array
      +              items:
      +                $ref: '#/components/schemas/pet'
      +
      +

      Path Item Object

      +

      Describes the operations available on a single path. +A Path Item MAY be empty, due to ACL constraints. +The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringAllows for an external definition of this path item. The referenced structure MUST be in the format of a Path Item Object. If there are conflicts between the referenced definition and this Path Item’s definition, the behavior is undefined.
      summarystringAn optional, string summary, intended to apply to all operations in this path.
      descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
      getOperation ObjectA definition of a GET operation on this path.
      putOperation ObjectA definition of a PUT operation on this path.
      postOperation ObjectA definition of a POST operation on this path.
      deleteOperation ObjectA definition of a DELETE operation on this path.
      optionsOperation ObjectA definition of a OPTIONS operation on this path.
      headOperation ObjectA definition of a HEAD operation on this path.
      patchOperation ObjectA definition of a PATCH operation on this path.
      traceOperation ObjectA definition of a TRACE operation on this path.
      servers[Server Object]An alternative server array to service all operations in this path.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      +

      This object MAY be extended with Specification Extensions.

      +

      Path Item Object Example

      +
      
      +{
      +  "get": {
      +    "description": "Returns pets based on ID",
      +    "summary": "Find pets by ID",
      +    "operationId": "getPetsById",
      +    "responses": {
      +      "200": {
      +        "description": "pet response",
      +        "content": {
      +          "*/*": {
      +            "schema": {
      +              "type": "array",
      +              "items": {
      +                "$ref": "#/components/schemas/Pet"
      +              }
      +            }
      +          }
      +        }
      +      },
      +      "default": {
      +        "description": "error payload",
      +        "content": {
      +          "text/html": {
      +            "schema": {
      +              "$ref": "#/components/schemas/ErrorModel"
      +            }
      +          }
      +        }
      +      }
      +    }
      +  },
      +  "parameters": [
      +    {
      +      "name": "id",
      +      "in": "path",
      +      "description": "ID of pet to use",
      +      "required": true,
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
      +        }
      +      },
      +      "style": "simple"
      +    }
      +  ]
      +}
      +
      +
      
      +get:
      +  description: Returns pets based on ID
      +  summary: Find pets by ID
      +  operationId: getPetsById
      +  responses:
      +    '200':
      +      description: pet response
      +      content:
      +        '*/*' :
      +          schema:
      +            type: array
      +            items:
      +              $ref: '#/components/schemas/Pet'
      +    default:
      +      description: error payload
      +      content:
      +        'text/html':
      +          schema:
      +            $ref: '#/components/schemas/ErrorModel'
      +parameters:
      +- name: id
      +  in: path
      +  description: ID of pet to use
      +  required: true
      +  schema:
      +    type: array
      +    style: simple
      +    items:
      +      type: string  
      +
      +

      Operation Object

      +

      Describes a single API operation on a path.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
      summarystringA short summary of what the operation does.
      descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
      operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      requestBodyRequest Body Object ¦ Reference ObjectThe request body applicable for this operation. The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers.
      responsesResponses ObjectREQUIRED. The list of possible responses as they are returned from executing this operation.
      callbacksMap[string, Callback Object ¦ Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses. The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.
      deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
      security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
      servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
      +

      This object MAY be extended with Specification Extensions.

      +

      Operation Object Example

      +
      
      +{
      +  "tags": [
      +    "pet"
      +  ],
      +  "summary": "Updates a pet in the store with form data",
      +  "operationId": "updatePetWithForm",
      +  "parameters": [
      +    {
      +      "name": "petId",
      +      "in": "path",
      +      "description": "ID of pet that needs to be updated",
      +      "required": true,
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  ],
      +  "requestBody": {
      +    "content": {
      +      "application/x-www-form-urlencoded": {
      +        "schema": {
      +          "type": "object",
      +           "properties": {
      +              "name": { 
      +                "description": "Updated name of the pet",
      +                "type": "string"
      +              },
      +              "status": {
      +                "description": "Updated status of the pet",
      +                "type": "string"
      +             }
      +           },
      +        "required": ["status"] 
      +        }
      +      }
      +    }
      +  },
      +  "responses": {
      +    "200": {
      +      "description": "Pet updated.",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
      +      }
      +    },
      +    "405": {
      +      "description": "Invalid input",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
      +      }
      +    }
      +  },
      +  "security": [
      +    {
      +      "petstore_auth": [
      +        "write:pets",
      +        "read:pets"
      +      ]
      +    }
      +  ]
      +}
      +
      +
      
      +tags:
      +- pet
      +summary: Updates a pet in the store with form data
      +operationId: updatePetWithForm
      +parameters:
      +- name: petId
      +  in: path
      +  description: ID of pet that needs to be updated
      +  required: true
      +  schema:
      +    type: string
      +requestBody:
      +  content:
      +    'application/x-www-form-urlencoded':
      +      schema:
      +       properties:
      +          name: 
      +            description: Updated name of the pet
      +            type: string
      +          status:
      +            description: Updated status of the pet
      +            type: string
      +       required:
      +         - status
      +responses:
      +  '200':
      +    description: Pet updated.
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +  '405':
      +    description: Invalid input
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +security:
      +- petstore_auth:
      +  - write:pets
      +  - read:pets
      +
      +

      External Documentation Object

      +

      Allows referencing an external resource for extended documentation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA short description of the target documentation. CommonMark syntax MAY be used for rich text representation.
      urlstringREQUIRED. The URL for the target documentation. Value MUST be in the format of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      External Documentation Object Example

      +
      
      +{
      +  "description": "Find more info here",
      +  "url": "https://example.com"
      +}
      +
      +
      
      +description: Find more info here
      +url: https://example.com
      +
      +

      Parameter Object

      +

      Describes a single operation parameter.

      +

      A unique parameter is defined by a combination of a name and location.

      +

      Parameter Locations

      +

      There are four possible parameter locations specified by the in field:

      +
        +
      • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
      • +
      • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
      • +
      • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
      • +
      • cookie - Used to pass a specific cookie value to the API.
      • +
      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
      • If in is "path", the name field MUST correspond to the associated path segment from the path field in the Paths Object. See Path Templating for further information.
      • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
      • For all other cases, the name corresponds to the parameter name used by the in property.
      instringREQUIRED. The location of the parameter. Possible values are “query”, “header”, “path” or “cookie”.
      descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
      requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is “path”, this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
      deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage.
      allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored.
      +

      The rules for serialization of the parameter are specified in one of two ways. +For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
      explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
      allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
      schemaSchema Object ¦ Reference ObjectThe schema defining the type used for the parameter.
      exampleAnyExample of the media type. The example SHOULD match the specified schema and encoding properties if present. The example object is mutually exclusive of the examples object. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
      examplesMap[ string, Example Object ¦ Reference Object]Examples of the media type. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples object is mutually exclusive of the example object. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
      +

      For more complex scenarios, the content property can define the media type and schema of the parameter. +A parameter MUST contain either a schema property, or a content property, but not both. +When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
      +

      Style Values

      +

      In order to support common ways of serializing simple parameters, a set of style values are defined.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      styletypeinComments
      matrixprimitive, array, objectpathPath-style parameters defined by [[!RFC6570]]
      labelprimitive, array, objectpathLabel style parameters defined by [[!RFC6570]]
      formprimitive, array, objectquery, cookieForm style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
      simplearraypath, headerSimple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0.
      spaceDelimitedarrayquerySpace separated array values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
      pipeDelimitedarrayqueryPipe separated array values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
      deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
      +

      Style Examples

      +

      Assume a parameter named color has one of the following values:

      +
      
      +   string -> "blue"
      +   array -> ["blue","black","brown"]
      +   object -> { "R": 100, "G": 200, "B": 150 }
      +
      +

      The following table shows examples of rendering differences for each value.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      styleexplodeemptystringarrayobject
      matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
      matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
      labelfalse..blue.blue.black.brown.R.100.G.200.B.150
      labeltrue..blue.blue.black.brown.R=100.G=200.B=150
      formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
      formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
      simplefalsen/ablueblue,black,brownR,100,G,200,B,150
      simpletruen/ablueblue,black,brownR=100,G=200,B=150
      spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
      pipeDelimitedfalsen/an/ablue¦black¦brownR¦100¦G¦200
      deepObjecttruen/an/an/acolor\R=100&color\G=200&color\B=150
      +

      This object MAY be extended with Specification Extensions.

      +

      Parameter Object Examples

      +

      A header parameter with an array of 64 bit integer numbers:

      +
      
      +{
      +  "name": "token",
      +  "in": "header",
      +  "description": "token to be passed as a header",
      +  "required": true,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "integer",
      +      "format": "int64"
      +    }
      +  },
      +  "style": "simple"
      +}
      +
      +
      
      +name: token
      +in: header
      +description: token to be passed as a header
      +required: true
      +schema:
      +  type: array
      +  items:
      +    type: integer
      +    format: int64
      +style: simple
      +
      +

      A path parameter of a string value:

      +
      
      +{
      +  "name": "username",
      +  "in": "path",
      +  "description": "username to fetch",
      +  "required": true,
      +  "schema": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +name: username
      +in: path
      +description: username to fetch
      +required: true
      +schema:
      +  type: string
      +
      +

      An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

      +
      
      +{
      +  "name": "id",
      +  "in": "query",
      +  "description": "ID of the object to fetch",
      +  "required": false,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    }
      +  },
      +  "style": "form",
      +  "explode": true
      +}
      +
      +
      
      +name: id
      +in: query
      +description: ID of the object to fetch
      +required: false
      +schema:
      +  type: array
      +  items:
      +    type: string
      +style: form
      +explode: true
      +
      +

      A free-form query parameter, allowing undefined parameters of a specific type:

      +
      
      +{
      +  "in": "query",
      +  "name": "freeForm",
      +  "schema": {
      +    "type": "object",
      +    "additionalProperties": {
      +      "type": "integer"
      +    },
      +  },
      +  "style": "form"
      +}
      +
      +
      
      +in: query
      +name: freeForm
      +schema:
      +  type: object
      +  additionalProperties:
      +    type: integer
      +style: form
      +
      +

      A complex parameter using content to define serialization:

      +
      
      +{
      +  "in": "query",
      +  "name": "coordinates",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "object",
      +        "required": [
      +          "lat",
      +          "long"
      +        ],
      +        "properties": {
      +          "lat": {
      +            "type": "number"
      +          },
      +          "long": {
      +            "type": "number"
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +in: query
      +name: coordinates
      +content:
      +  application/json:
      +    schema:
      +      type: object
      +      required:
      +        - lat
      +        - long
      +      properties:
      +        lat:
      +          type: number
      +        long:
      +          type: number
      +
      +

      Request Body Object

      +

      Describes a single request body.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
      contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
      requiredbooleanDetermines if the request body is required in the request. Defaults to false.
      +

      This object MAY be extended with Specification Extensions.

      +

      Request Body Examples

      +

      A request body with a referenced model definition.

      +
      
      +{
      +  "description": "user to add to the system",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
      +      },
      +      "examples": {
      +          "user" : {
      +            "summary": "User Example", 
      +            "externalValue": "http://foo.bar/examples/user-example.json"
      +          } 
      +        }
      +    },
      +    "application/xml": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
      +      },
      +      "examples": {
      +          "user" : {
      +            "summary": "User example in XML",
      +            "externalValue": "http://foo.bar/examples/user-example.xml"
      +          }
      +        }
      +    },
      +    "text/plain": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in Plain text",
      +            "externalValue": "http://foo.bar/examples/user-example.txt" 
      +        }
      +      } 
      +    },
      +    "*/*": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in other format",
      +            "externalValue": "http://foo.bar/examples/user-example.whatever"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: user to add to the system
      +content: 
      +  'application/json':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User Example
      +        externalValue: 'http://foo.bar/examples/user-example.json'
      +  'application/xml':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User Example in XML
      +        externalValue: 'http://foo.bar/examples/user-example.xml'
      +  'text/plain':
      +    examples:
      +      user:
      +        summary: User example in text plain format
      +        externalValue: 'http://foo.bar/examples/user-example.txt'
      +  '*/*':
      +    examples:
      +      user: 
      +        summary: User example in other format
      +        externalValue: 'http://foo.bar/examples/user-example.whatever'
      +
      +

      A body parameter that is an array of string values:

      +
      
      +{
      +  "description": "user to add to the system",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: user to add to the system
      +required: true
      +content:
      +  text/plain:
      +    schema:
      +      type: array
      +      items:
      +        type: string
      +
      +

      Media Type Object

      +

      Each Media Type Object provides schema and examples for the media type identified by its key.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      schemaSchema Object ¦ Reference ObjectThe schema defining the type used for the request body.
      exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example object is mutually exclusive of the examples object. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
      examplesMap[ string, Example Object ¦ Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples object is mutually exclusive of the example object. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
      encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
      +

      This object MAY be extended with Specification Extensions.

      +

      Media Type Examples

      +
      
      +{
      +  "application/json": {
      +    "schema": {
      +         "$ref": "#/components/schemas/Pet"
      +    },
      +    "examples": {
      +      "cat" : {
      +        "summary": "An example of a cat",
      +        "value": 
      +          {
      +            "name": "Fluffy",
      +            "petType": "Cat",
      +            "color": "White",
      +            "gender": "male",
      +            "breed": "Persian"
      +          }
      +      },
      +      "dog": {
      +        "summary": "An example of a dog with a cat's name",
      +        "value" :  { 
      +          "name": "Puma",
      +          "petType": "Dog",
      +          "color": "Black",
      +          "gender": "Female",
      +          "breed": "Mixed"
      +        },
      +      "frog": {
      +          "$ref": "#/components/examples/frog-example"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +application/json: 
      +  schema:
      +    $ref: "#/components/schemas/Pet"
      +  examples:
      +    cat:
      +      summary: An example of a cat
      +      value:
      +        name: Fluffy
      +        petType: Cat
      +        color: White
      +        gender: male
      +        breed: Persian
      +    dog:
      +      summary: An example of a dog with a cat's name
      +      value:
      +        name: Puma
      +        petType: Dog
      +        color: Black
      +        gender: Female
      +        breed: Mixed
      +    frog:
      +      $ref: "#/components/examples/frog-example"
      +
      +

      Considerations for File Uploads

      +

      In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type. Specifically:

      +
      
      +# content transferred with base64 encoding
      +schema:
      +  type: string
      +  format: base64
      +
      +
      
      +# content transferred in binary (octet-stream):
      +schema:
      +  type: string
      +  format: binary
      +
      +

      These examples apply to either input payloads of file uploads or response payloads.

      +

      A requestBody for submitting a file in a POST operation may look like the following example:

      +
      
      +requestBody:
      +  content:
      +    application/octet-stream:
      +      # any media type is accepted, functionally equivalent to `*/*`
      +      schema:
      +        # a binary file of any type
      +        type: string
      +        format: binary
      +
      +

      In addition, specific media types MAY be specified:

      +
      
      +# multiple, specific media types may be specified:
      +requestBody:
      +  content:
      +      # a binary file of type png or jpeg
      +    'image/jpeg':
      +      schema:
      +        type: string
      +        format: binary
      +    'image/png':
      +      schema:
      +        type: string
      +        format: binary        
      +
      +

      To upload multiple files, a multipart media type MUST be used:

      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        properties:
      +          # The property name 'file' will be used for all files.
      +          file:
      +            type: array
      +            items:
      +              type: string
      +              format: binary
      +
      +
      +

      Support for x-www-form-urlencoded Request Bodies

      +

      To submit content using form url encoding via [[!RFC1866]], the following +definition may be used:

      +
      
      +requestBody:
      +  content:
      +    application/x-www-form-urlencoded:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # complex types are stringified to support RFC 1866
      +            type: object
      +            properties: {}
      +
      +

      In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

      +

      When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object's style property as form.

      +

      Special Considerations for multipart Content

      +

      It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

      +

      When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred — thus, the following default Content-Types are defined for multipart:

      +
        +
      • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
      • +
      • If the property is complex, or an array of complex values, the default Content-Type is application/json
      • +
      • If the property is a type: string with format: binary or format: base64 (aka a file object), the default Content-Type is application/octet-stream
      • +
      +

      Examples:

      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # default Content-Type for objects is `application/json`
      +            type: object
      +            properties: {}
      +          profileImage:
      +            # default Content-Type for string/binary is `application/octet-stream`
      +            type: string
      +            format: binary
      +          children:
      +            # default Content-Type for arrays is based on the `inner` type (text/plain here)
      +            type: array
      +            items:
      +              type: string
      +          addresses:
      +            # default Content-Type for arrays is based on the `inner` type (object shown, so `application/json` in this example)
      +            type: array
      +            items:
      +              type: '#/components/schemas/Address'
      +
      +

      An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

      +

      Encoding Object

      +

      A single encoding definition applied to a single schema property.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for string with format being binaryapplication/octet-stream; for other primitive types – text/plain; for object - application/json; for array – the default is defined based on the inner type. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
      headersMap[string, Header Object ¦ Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
      stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      +

      This object MAY be extended with Specification Extensions.

      +

      Encoding Object Example

      +
      
      +requestBody:
      +  content:
      +    multipart/mixed:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            # default is text/plain
      +            type: string
      +            format: uuid
      +          address:
      +            # default is application/json
      +            type: object
      +            properties: {}
      +          historyMetadata:
      +            # need to declare XML format!
      +            description: metadata in XML format
      +            type: object
      +            properties: {}
      +          profileImage:
      +            # default is application/octet-stream, need to declare an image type only!
      +            type: string
      +            format: binary
      +      encoding:
      +        historyMetadata:
      +          # require XML Content-Type in utf-8 encoding
      +          contentType: application/xml; charset=utf-8
      +        profileImage:
      +          # only accept png/jpeg
      +          contentType: image/png, image/jpeg
      +          headers:
      +            X-Rate-Limit-Limit:
      +              description: The number of allowed requests in the current period
      +              schema:
      +                type: integer
      +
      +

      Responses Object

      +

      A container for the expected responses of an operation. +The container maps a HTTP response code to the expected response.

      +

      The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. +However, documentation is expected to cover a successful operation response and any known errors.

      +

      The default MAY be used as a default response object for all HTTP codes +that are not covered individually by the specification.

      +

      The Responses Object MUST contain at least one response code, and it +SHOULD be the response for a successful operation call.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      defaultResponse Object ¦ Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses. A Reference Object can link to a response that the OpenAPI Object’s components/responses section defines.
      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      HTTP Status CodeResponse Object ¦ Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. A Reference Object can link to a response that is defined in the OpenAPI Object’s components/responses section. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. The following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response range is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
      +

      This object MAY be extended with Specification Extensions.

      +

      Responses Object Example

      +

      A 200 response for a successful operation and a default response for others (implying an error):

      +
      
      +{
      +  "200": {
      +    "description": "a pet to be returned",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/Pet"
      +        }
      +      }
      +    }
      +  },
      +  "default": {
      +    "description": "Unexpected error",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/ErrorModel"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +'200':
      +  description: a pet to be returned
      +  content: 
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/Pet'
      +default:
      +  description: Unexpected error
      +  content:
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/ErrorModel'
      +
      +

      Response Object

      +

      Describes a single response from an API Operation, including design-time, static +links to operations based on the response.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringREQUIRED. A short description of the response. CommonMark syntax MAY be used for rich text representation.
      headersMap[string, Header Object ¦ Reference Object]Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
      contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
      linksMap[string, Link Object ¦ Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
      +

      This object MAY be extended with Specification Extensions.

      +

      Response Object Examples

      +

      Response of an array of a complex type:

      +
      
      +{
      +  "description": "A complex object array response",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "$ref": "#/components/schemas/VeryComplexType"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: A complex object array response
      +content: 
      +  application/json:
      +    schema: 
      +      type: array
      +      items:
      +        $ref: '#/components/schemas/VeryComplexType'
      +
      +

      Response with a string type:

      +
      
      +{
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  }
      +
      +}
      +
      +
      
      +description: A simple string response
      +representations:
      +  text/plain:
      +    schema:
      +      type: string
      +
      +

      Plain text response with headers:

      +
      
      +{
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  },
      +  "headers": {
      +    "X-Rate-Limit-Limit": {
      +      "description": "The number of allowed requests in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    },
      +    "X-Rate-Limit-Remaining": {
      +      "description": "The number of remaining requests in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    },
      +    "X-Rate-Limit-Reset": {
      +      "description": "The number of seconds left in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: A simple string response
      +content:
      +  text/plain:
      +    schema:
      +      type: string
      +    example: 'whoa!'
      +headers:
      +  X-Rate-Limit-Limit:
      +    description: The number of allowed requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Remaining:
      +    description: The number of remaining requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Reset:
      +    description: The number of seconds left in the current period
      +    schema:
      +      type: integer
      +
      +

      Response with no return value:

      +
      
      +{
      +  "description": "object created"
      +}
      +
      +
      
      +description: object created
      +
      +

      Callback Object

      +

      A map of possible out-of band callbacks related to the parent operation. +Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. +The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {expression}Path Item ObjectA Path Item Object used to define a callback request and expected responses. A complete example is available.
      +

      This object MAY be extended with Specification Extensions.

      +

      Key Expression

      +

      The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. +A simple example might be $request.body#/url. +However, using a runtime expression the complete HTTP message can be accessed. +This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

      +

      For example, given the following HTTP request:

      +
      
      +POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
      +Host: example.org
      +Content-Type: application/json
      +Content-Length: 187
      +
      +{
      +  "failedUrl" : "http://clientdomain.com/failed",
      +  "successUrls" : [
      +    "http://clientdomain.com/fast",
      +    "http://clientdomain.com/medium",
      +    "http://clientdomain.com/slow"
      +  ] 
      +}
      +
      +201 Created
      +Location: http://example.org/subscription/1
      +
      +

      The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      ExpressionValue
      $urlhttp://example.org/subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning
      $methodPOST
      $request.path.eventTypemyevent
      $request.query.queryUrlhttp://clientdomain.com/stillrunning
      $request.header.content-Typeapplication/json
      $request.body#/failedUrlhttp://clientdomain.com/stillrunning
      $request.body#/successUrls/2http://clientdomain.com/medium
      $response.header.Locationhttp://example.org/subscription/1
      +

      Callback Object Example

      +

      The following example shows a callback to the URL specified by the id and email property in the request body.

      +
      
      +myWebhook:
      +  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
      +    post:
      +      requestBody:
      +        description: Callback payload
      +        content: 
      +          'application/json':
      +            schema:
      +              $ref: '#/components/schemas/SomePayload'
      +      responses:
      +        '200':
      +          description: webhook successfully processed and no retries will be performed
      +
      +

      Example Object

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      summarystringShort description for the example.
      descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
      valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
      externalValuestringA URL that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive.
      +

      This object MAY be extended with Specification Extensions.

      +

      In all cases, the example value is expected to be compatible with the type schema +of its associated value. Tooling implementations MAY choose to +validate compatibility automatically, and reject the example value(s) if incompatible.

      +

      Example Object Example

      +
      
      +# in a model
      +schemas:
      +  properties:
      +    name:
      +      type: string
      +      examples:
      +        name:
      +          $ref: http://example.org/petapi-examples/openapi.json#/components/examples/name-example
      +
      +# in a request body:
      +  requestBody:
      +    content:
      +      'application/json':
      +        schema:
      +          $ref: '#/components/schemas/Address'
      +        examples: 
      +          foo:
      +            summary: A foo example
      +            value: {"foo": "bar"}
      +          bar:
      +            summary: A bar example
      +            value: {"bar": "baz"}
      +      'application/xml':
      +        examples: 
      +          xmlExample:
      +            summary: This is an example in XML
      +            externalValue: 'http://example.org/examples/address-example.xml'
      +      'text/plain':
      +        examples:
      +          textExample: 
      +            summary: This is a text example
      +            externalValue: 'http://foo.bar/examples/address-example.txt' 
      +
      +
      +# in a parameter
      +  parameters:
      +    - name: 'zipCode'
      +      in: 'query'
      +      schema:
      +        type: 'string'
      +        format: 'zip-code'
      +        examples:
      +          zip-example: 
      +            $ref: '#/components/examples/zip-example'
      +
      +# in a response
      +  responses:
      +    '200':
      +      description: your car appointment has been booked
      +      content: 
      +        application/json:
      +          schema:
      +            $ref: '#/components/schemas/SuccessResponse'
      +          examples:
      +            confirmation-success:
      +              $ref: '#/components/examples/confirmation-success'
      +
      +

      Link Object

      +

      The Link object represents a possible design-time link for a response. +The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

      +

      Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

      +

      For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      operationRefstringA relative or absolute reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition.
      operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
      parametersMap[string, Any ¦ {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
      requestBodyAny ¦ {expression}A literal value or {expression} to use as a request body when calling the target operation.
      descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
      serverServer ObjectA server object to be used by the target operation.
      +

      This object MAY be extended with Specification Extensions.

      +

      A linked operation MUST be identified using either an operationRef or operationId. +In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. +Because of the potential for name clashes, the operationRef syntax is preferred +for specifications with external references.

      +

      Examples

      +

      Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

      +
      
      +paths:
      +  /users/{id}:
      +    parameters:
      +    - name: id
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +    get:
      +      responses:
      +        '200':
      +          description: the user being returned
      +          content:
      +            application/json:
      +              schema:
      +                type: object
      +                properties:
      +                  uuid: # the unique user id
      +                    type: string
      +                    format: uuid
      +        links:
      +          address:
      +            # the target link operationId
      +            operationId: getUserAddress
      +            parameters:
      +              # get the `id` field from the request path parameter named `id`
      +              userId: $request.path.id
      +  # the path item of the linked operation
      +  /users/{userid}/address:
      +    parameters:
      +    - name: userid
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +      # linked operation
      +      get:
      +        operationId: getUserAddress
      +        responses:
      +          '200':
      +            description: the user's address
      +
      +

      When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

      +

      Values from the response body can be used to drive a linked operation.

      +
      
      +links:
      +  address:
      +    operationId: getUserAddressByUUID
      +    parameters:
      +      # get the `id` field from the request path parameter named `id`
      +      userUuid: $response.body#/uuid
      +
      +

      Clients follow all links at their discretion. +Neither permissions, nor the capability to make a successful call to that link, is guaranteed +solely by the existence of a relationship.

      +

      OperationRef Examples

      +

      As references to operationId MAY NOT be possible (the operationId is an optional +value), references MAY also be made through a relative operationRef:

      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
      +
      +

      or an absolute operationRef:

      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
      +
      +

      Note that in the use of operationRef, the escaped forward-slash is necessary when +using JSON references.

      +

      Runtime Expressions

      +

      Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. +This mechanism is used by Link Objects and Callback Objects.

      +

      The runtime expression is defined by the following [Augmented Backus-Naur Form] syntax

      +
      
      +      expression = ( "$url" | "$method" | "$statusCode" | "$request." source | "$response." source )
      +      source = ( header-reference | query-reference | path-reference | body-reference )  
      +      header-reference = "header." token
      +      query-reference = "query." name  
      +      path-reference = "path." name
      +      body-reference = "body" ["#" fragment]
      +      fragment = a JSON Pointer [RFC 6901](https://tools.ietf.org/html/rfc6901)  
      +      name = *( char )
      +      char = as per RFC [7159](https://tools.ietf.org/html/rfc7159#section-7)
      +      token = as per RFC [7230](https://tools.ietf.org/html/rfc7230#section-3.2.6)
      +
      +

      The name identifier is case-sensitive, whereas token is not.

      +

      The table below provides examples of runtime expressions and examples of their use in a value:

      +

      Examples

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Source Locationexample expressionnotes
      HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
      Requested media type$request.header.accept
      Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
      Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
      Request URL$url
      Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
      Response header$response.header.ServerSingle header values only are available
      +

      Runtime expressions preserve the type of the referenced value. +Expressions can be embedded into string values by surrounding the expression with {} curly braces.

      +

      Header Object

      +

      The Header Object follows the structure of the Parameter Object with the following changes:

      +
        +
      1. name MUST NOT be specified, it is given in the corresponding headers map.
      2. +
      3. in MUST NOT be specified, it is implicitly in header.
      4. +
      5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
      6. +
      +

      Header Object Example

      +

      A simple header of type integer:

      +
      
      +{
      +  "description": "The number of allowed requests in the current period",
      +  "schema": {
      +    "type": "integer"
      +  }
      +}
      +
      +
      
      +description: The number of allowed requests in the current period
      +schema:
      +  type: integer
      +
      +

      Tag Object

      +

      Adds metadata to a single tag that is used by the Operation Object. +It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The name of the tag.
      descriptionstringA short description for the tag. CommonMark syntax MAY be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
      +

      This object MAY be extended with Specification Extensions.

      +

      Tag Object Example

      +
      
      +{
      +	"name": "pet",
      +	"description": "Pets operations"
      +}
      +
      +
      
      +name: pet
      +description: Pets operations
      +
      +

      Examples Object

      +

      In an example, a JSON Reference MAY be used, with the +explicit restriction that examples having a JSON format with object named +$ref are not allowed. Therefore, that example, structurally, can be +either a string primitive or an object, similar to additionalProperties.

      +

      In all cases, the payload is expected to be compatible with the type schema +for the associated value. Tooling implementations MAY choose to +validate compatibility automatically, and reject the example value(s) if they +are incompatible.

      +
      
      +# in a model
      +schemas:
      +  properties:
      +    name:
      +      type: string
      +      example:
      +        $ref: http://foo.bar#/examples/name-example
      +
      +# in a request body, note the plural `examples`
      +  requestBody:
      +    content:
      +      'application/json':
      +        schema:
      +          $ref: '#/components/schemas/Address'
      +        examples:
      +          foo:
      +            value: {"foo": "bar"}
      +          bar:
      +            value: {"bar": "baz"}
      +      'application/xml':
      +        examples:
      +          xml:
      +            externalValue: 'http://foo.bar/examples/address-example.xml'
      +      'text/plain':
      +        examples:
      +          text:
      +            externalValue: 'http://foo.bar/examples/address-example.txt'
      +        
      +# in a parameter
      +  parameters:
      +    - name: 'zipCode'
      +      in: 'query'
      +      schema:
      +        type: 'string'
      +        format: 'zip-code'
      +        example: 
      +          $ref: 'http://foo.bar#/examples/zip-example'
      +
      +# in a response, note the singular `example`:
      +  responses:
      +    '200':
      +      description: your car appointment has been booked
      +      content: 
      +        application/json:
      +          schema:
      +            $ref: '#/components/schemas/SuccessResponse'
      +          example:
      +            $ref: http://foo.bar#/examples/address-example.json
      +
      +

      Reference Object

      +

      A simple object to allow referencing other components in the specification, internally and externally.

      +

      The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

      +

      For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringREQUIRED. The reference string.
      +

      This object cannot be extended with additional properties and any properties added SHALL be ignored.

      +

      Reference Object Example

      +
      
      +{
      +	"$ref": "#/components/schemas/Pet"
      +}
      +
      +
      
      +$ref: '#/components/schemas/Pet'
      +
      +

      Relative Schema Document Example

      +
      
      +{
      +  "$ref": "Pet.json"
      +}
      +
      +
      
      +$ref: Pet.yaml
      +
      +

      Relative Documents With Embedded Schema Example

      +
      
      +{
      +  "$ref": "definitions.json#/Pet"
      +}
      +
      +
      
      +$ref: definitions.yaml#/Pet
      +
      +

      Schema Object

      +

      The Schema Object allows the definition of input and output data types. +These types can be objects, but also primitives and arrays. +This object is an extended subset of the JSON Schema Specification Wright Draft 00.

      +

      For more information about the properties, see JSON Schema Core and JSON Schema Validation. +Unless stated otherwise, the property definitions follow the JSON Schema.

      +

      Properties

      +

      The following properties are taken directly from the JSON Schema definition and follow the same specifications:

      +
        +
      • title
      • +
      • multipleOf
      • +
      • maximum
      • +
      • exclusiveMaximum
      • +
      • minimum
      • +
      • exclusiveMinimum
      • +
      • maxLength
      • +
      • minLength
      • +
      • pattern (This string SHOULD be a valid regular expression, according to the ECMA 262 regular expression dialect)
      • +
      • maxItems
      • +
      • minItems
      • +
      • uniqueItems
      • +
      • maxProperties
      • +
      • minProperties
      • +
      • required
      • +
      • enum
      • +
      +

      The following properties are taken from the JSON Schema definition but their definitions were adjusted to the OpenAPI Specification.

      +
        +
      • type - Value MUST be a string. Multiple types via an array are not supported.
      • +
      • allOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • oneOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • anyOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • not - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • items - Value MUST be an object and not an array. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. items MUST be present if the type is array.
      • +
      • properties - Property definitions MUST be a Schema Object and not a standard JSON Schema (inline or referenced).
      • +
      • additionalProperties - Value can be boolean or object. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • description - CommonMark syntax MAY be used for rich text representation.
      • +
      • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
      • +
      • default - The default value represents what would be assumed by the consumer of the input as the value of the schema if one is not provided. Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object defined at the same level. For example, if type is string, then default can be "foo" but cannot be 1.
      • +
      +

      Alternatively, any time a Schema Object can be used, a Reference Object can be used in its place. This allows referencing definitions instead of defining them inline.

      +

      Additional properties defined by the JSON Schema specification that are not mentioned here are strictly unsupported.

      +

      Other than the JSON Schema subset fields, the following fields MAY be used for further schema documentation:

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      nullablebooleanAllows sending a null value for the defined schema. Default value is false.
      discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
      readOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “read only”. This means that it MAY be sent as part of a response but SHOULD NOT be sent as part of the request. If the property is marked as readOnly being true and is in the required list, the required will take effect on the response only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
      writeOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “write only”. Therefore, it MAY be sent as part of a request but SHOULD NOT be sent as part of the response. If the property is marked as writeOnly being true and is in the required list, the required will take effect on the request only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
      xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
      externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
      exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.
      deprecatedbooleanSpecifies that a schema is deprecated and SHOULD be transitioned out of usage. Default value is false.
      +

      This object MAY be extended with Specification Extensions.

      +
      Composition and Inheritance (Polymorphism)
      +

      The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. +allOf takes an array of object definitions that are validated independently but together compose a single object.

      +

      While composition offers model extensibility, it does not imply a hierarchy between the models. +To support polymorphism, the OpenAPI Specification adds the discriminator field. +When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. +As such, the discriminator field MUST be a required field. +There are are two ways to define the value of a discriminator for an inheriting instance.

      +
        +
      • Use the schema name.
      • +
      • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. +As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
      • +
      +
      XML Modeling
      +

      The xml property allows extra definitions when translating the JSON definition to XML. +The XML Object contains additional information about the available options.

      +

      Schema Object Examples

      +
      Primitive Sample
      +
      
      +{
      +  "type": "string",
      +  "format": "email"
      +}
      +
      +
      
      +type: string
      +format: email
      +
      +
      Simple Model
      +
      
      +{
      +  "type": "object",
      +  "required": [
      +    "name"
      +  ],
      +  "properties": {
      +    "name": {
      +      "type": "string"
      +    },
      +    "address": {
      +      "$ref": "#/components/schemas/Address"
      +    },
      +    "age": {
      +      "type": "integer",
      +      "format": "int32",
      +      "minimum": 0
      +    }
      +  }
      +}
      +
      +
      
      +type: object
      +required:
      +- name
      +properties:
      +  name:
      +    type: string
      +  address:
      +    $ref: '#/components/schemas/Address'
      +  age:
      +    type: integer
      +    format: int32
      +    minimum: 0
      +
      +
      Model with Map/Dictionary Properties
      +

      For a simple string to string mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  type: string
      +
      +

      For a string to model mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "$ref": "#/components/schemas/ComplexModel"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  $ref: '#/components/schemas/ComplexModel'
      +
      +
      Model with Example
      +
      
      +{
      +  "type": "object",
      +  "properties": {
      +    "id": {
      +      "type": "integer",
      +      "format": "int64"
      +    },
      +    "name": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "name"
      +  ],
      +  "example": {
      +    "name": "Puma",
      +    "id": 1
      +  }
      +}
      +
      +
      
      +type: object
      +properties:
      +  id:
      +    type: integer
      +    format: int64
      +  name:
      +    type: string
      +required:
      +- name
      +example:
      +  name: Puma
      +  id: 1
      +
      +
      Models with Composition
      +
      
      +{
      +  "components": {
      +    "schemas": {
      +      "ErrorModel": {
      +        "type": "object",
      +        "required": [
      +          "message",
      +          "code"
      +        ],
      +        "properties": {
      +          "message": {
      +            "type": "string"
      +          },
      +          "code": {
      +            "type": "integer",
      +            "minimum": 100,
      +            "maximum": 600
      +          }
      +        }
      +      },
      +      "ExtendedErrorModel": {
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/ErrorModel"
      +          },
      +          {
      +            "type": "object",
      +            "required": [
      +              "rootCause"
      +            ],
      +            "properties": {
      +              "rootCause": {
      +                "type": "string"
      +              }
      +            }
      +          }
      +        ]
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    ErrorModel:
      +      type: object
      +      required:
      +      - message
      +      - code
      +      properties:
      +        message:
      +          type: string
      +        code:
      +          type: integer
      +          minimum: 100
      +          maximum: 600
      +    ExtendedErrorModel:
      +      allOf:
      +      - $ref: '#/components/schemas/ErrorModel'
      +      - type: object
      +        required:
      +        - rootCause
      +        properties:
      +          rootCause:
      +            type: string
      +
      +
      Models with Polymorphism Support
      +
      
      +{
      +  "components": {
      +    "schemas": {
      +      "Pet": {
      +        "type": "object",
      +        "discriminator": {
      +          "propertyName": "petType"
      +        },
      +        "properties": {
      +          "name": {
      +            "type": "string"
      +          },
      +          "petType": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "petType"
      +        ]
      +      },
      +      "Cat": {
      +        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/Pet"
      +          },
      +          {
      +            "type": "object",
      +            "properties": {
      +              "huntingSkill": {
      +                "type": "string",
      +                "description": "The measured skill for hunting",
      +                "default": "lazy",
      +                "enum": [
      +                  "clueless",
      +                  "lazy",
      +                  "adventurous",
      +                  "aggressive"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "huntingSkill"
      +            ]
      +          }
      +        ]
      +      },
      +      "Dog": {
      +        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/Pet"
      +          },
      +          {
      +            "type": "object",
      +            "properties": {
      +              "packSize": {
      +                "type": "integer",
      +                "format": "int32",
      +                "description": "the size of the pack the dog is from",
      +                "default": 0,
      +                "minimum": 0
      +              }
      +            },
      +            "required": [
      +              "packSize"
      +            ]
      +          }
      +        ]
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    Pet:
      +      type: object
      +      discriminator:
      +        propertyName: petType
      +      properties:
      +        name:
      +          type: string
      +        petType:
      +          type: string
      +      required:
      +      - name
      +      - petType
      +    Cat:  ## "Cat" will be used as the discriminator value
      +      description: A representation of a cat
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          huntingSkill:
      +            type: string
      +            description: The measured skill for hunting
      +            enum:
      +            - clueless
      +            - lazy
      +            - adventurous
      +            - aggressive
      +        required:
      +        - huntingSkill
      +    Dog:  ## "Dog" will be used as the discriminator value
      +      description: A representation of a dog
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          packSize:
      +            type: integer
      +            format: int32
      +            description: the size of the pack the dog is from
      +            default: 0
      +            minimum: 0
      +        required:
      +        - packSize
      +
      +

      Discriminator Object

      +

      When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

      +

      When using the discriminator, inline schemas will not be considered.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
      mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
      +

      The discriminator attribute is legal only when using one of the composite keywords oneOf, anyOf, allOf.

      +

      In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +
      +

      which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +  discriminator:
      +    propertyName: pet_type
      +
      +

      The expectation now is that a property with name pet_type MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

      +
      
      +{
      +  "id": 12345,
      +  "pet_type": "Cat"
      +}
      +
      +

      Will indicate that the Cat schema be used in conjunction with this payload.

      +

      In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +  discriminator:
      +    propertyName: pet_type
      +    mapping:
      +      dog: '#/components/schemas/Dog'
      +      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +
      +

      Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

      +

      When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

      +

      In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

      +

      For example:

      +
      
      +components:
      +  schemas:
      +    Pet:
      +      type: object
      +      required:
      +      - pet_type
      +      properties:
      +        pet_type:
      +          type: string
      +      discriminator:
      +        propertyName: pet_type
      +        mapping:
      +          cachorro: Dog
      +    Cat:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Cat`
      +        properties:
      +          name:
      +            type: string
      +    Dog:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Dog`
      +        properties:
      +          bark:
      +            type: string
      +    Lizard:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Lizard`
      +        properties:
      +          lovesRocks:
      +            type: boolean
      +
      +

      a payload like this:

      +
      
      +{
      +  "pet_type": "Cat",
      +  "name": "misty"
      +}
      +
      +

      will indicate that the Cat schema be used. Likewise this schema:

      +
      
      +{
      +  "pet_type": "cachorro",
      +  "bark": "soft"
      +}
      +
      +

      will map to Dog because of the definition in the mappings element.

      +

      XML Object

      +

      A metadata object that allows for more fine-tuned XML model definitions.

      +

      When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. +See examples for expected behavior.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
      namespacestringThe URI of the namespace definition. Value MUST be in the form of an absolute URI.
      prefixstringThe prefix to be used for the name.
      attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
      wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
      +

      This object MAY be extended with Specification Extensions.

      +

      XML Object Examples

      +

      The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

      +
      No XML Element
      +

      Basic string property:

      +
      
      +{
      +    "animals": {
      +        "type": "string"
      +    }
      +}
      +
      +
      
      +animals:
      +  type: string
      +
      +
      
      +<animals>...</animals>
      +
      +

      Basic string array property (wrapped is false by default):

      +
      
      +{
      +    "animals": {
      +        "type": "array",
      +        "items": {
      +            "type": "string"
      +        }
      +    }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +
      +
      
      +<animals>...</animals>
      +<animals>...</animals>
      +<animals>...</animals>
      +
      +
      XML Name Replacement
      +
      
      +{
      +  "animals": {
      +    "type": "string",
      +    "xml": {
      +      "name": "animal"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: string
      +  xml:
      +    name: animal
      +
      +
      
      +<animal>...</animal>
      +
      +
      XML Attribute, Prefix and Namespace
      +

      In this example, a full model definition is shown.

      +
      
      +{
      +  "Person": {
      +    "type": "object",
      +    "properties": {
      +      "id": {
      +        "type": "integer",
      +        "format": "int32",
      +        "xml": {
      +          "attribute": true
      +        }
      +      },
      +      "name": {
      +        "type": "string",
      +        "xml": {
      +          "namespace": "http://example.com/schema/sample",
      +          "prefix": "sample"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +Person:
      +  type: object
      +  properties:
      +    id:
      +      type: integer
      +      format: int32
      +      xml:
      +        attribute: true
      +    name:
      +      type: string
      +      xml:
      +        namespace: http://example.com/schema/sample
      +        prefix: sample
      +
      +
      
      +<Person id="123">
      +    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
      +</Person>
      +
      +
      XML Arrays
      +

      Changing the element names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      The external name property has no effect on the XML:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animals>value</animals>
      +  <animals>value</animals>
      +</animals>
      +
      +

      To overcome the naming problem in the example above, the following definition can be used:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</animals>
      +
      +

      Affecting both internal and external names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</aliens>
      +
      +

      If we change the external element but not the internal ones:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <aliens>value</aliens>
      +  <aliens>value</aliens>
      +</aliens>
      +
      +

      Security Scheme Object

      +

      Defines a security scheme that can be used by the operations. +Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeApplies ToDescription
      typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "oauth2", "openIdConnect".
      descriptionstringAnyA short description for security scheme. CommonMark syntax MAY be used for rich text representation.
      namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
      instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
      schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]].
      bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
      flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
      openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      Security Scheme Object Example

      +
      Basic Authentication Sample
      +
      
      +{
      +  "type": "http",
      +  "scheme": "basic"
      +}
      +
      +
      
      +type: http
      +scheme: basic
      +
      +
      API Key Sample
      +
      
      +{
      +  "type": "apiKey",
      +  "name": "api_key",
      +  "in": "header"
      +}
      +
      +
      
      +type: apiKey
      +name: api_key
      +in: header
      +
      +
      JWT Bearer Sample
      +
      
      +{
      +  "type": "http",
      +  "scheme": "bearer",
      +  "bearerFormat": "JWT",
      +}
      +
      +
      
      +type: http
      +scheme: bearer
      +bearerFormat: JWT
      +
      +
      Implicit OAuth2 Sample
      +
      
      +{
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
      +
      +

      OAuth Flows Object

      +

      Allows configuration of the supported OAuth Flows.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
      passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
      clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
      authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
      +

      This object MAY be extended with Specification Extensions.

      +

      OAuth Flow Object

      +

      Configuration details for a supported OAuth Flow

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeApplies ToDescription
      authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL.
      tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL.
      refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL.
      scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it.
      +

      This object MAY be extended with Specification Extensions.

      +

      OAuth Flow Object Examples

      +
      
      +{
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    },
      +    "authorizationCode": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "tokenUrl": "https://example.com/api/oauth/token",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
      +  authorizationCode:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    tokenUrl: https://example.com/api/oauth/token
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets 
      +
      +

      Security Requirement Object

      +

      Lists the required security schemes to execute this operation. +The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

      +

      Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. +This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

      +

      When a list of Security Requirement Objects is defined on the Open API object or Operation Object, only one of Security Requirement Objects in the list needs to be satisfied to authorize the request.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution. For other security scheme types, the array MUST be empty.
      +

      Security Requirement Object Examples

      +
      Non-OAuth2 Security Requirement
      +
      
      +{
      +  "api_key": []
      +}
      +
      +
      
      +api_key: []
      +
      +
      OAuth2 Security Requirement
      +
      
      +{
      +  "petstore_auth": [
      +    "write:pets",
      +    "read:pets"
      +  ]
      +}
      +
      +
      
      +petstore_auth:
      +- write:pets
      +- read:pets
      +
      +

      Specification Extensions

      +

      While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

      +

      The extensions properties are implemented as patterned fields that are always prefixed by "x-".

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. Can have any valid JSON format value.
      +

      The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

      +

      Security Filtering

      +

      Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

      +

      The reasoning is to allow an additional layer of access control over the documentation. +While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

      +

      Two examples of this:

      +
        +
      1. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
      2. +
      3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the Paths Object, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
      4. +
      +

      Appendix A: Revision History

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      VersionDateNotes
      3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
      3.0.0-rc22017-06-16rc2 of the 3.0 specification
      3.0.0-rc12017-04-27rc1 of the 3.0 specification
      3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
      2.02015-12-31Donation of Swagger 2.0 to the Open API Initiative
      2.02014-09-08Release of Swagger 2.0
      1.22014-03-14Initial release of the formal document.
      1.12012-08-22Release of Swagger 1.1
      1.02011-08-10First release of the Swagger Specification
      + From 68215a32ccee001c8b9e74d5f0de85879ab9019b Mon Sep 17 00:00:00 2001 From: Ron Date: Wed, 11 Jul 2018 16:30:37 -0600 Subject: [PATCH 003/152] Create CNAME --- CNAME | 1 + 1 file changed, 1 insertion(+) create mode 100644 CNAME diff --git a/CNAME b/CNAME new file mode 100644 index 0000000000..03b6ea005a --- /dev/null +++ b/CNAME @@ -0,0 +1 @@ +spec.openapis.org \ No newline at end of file From 74ee685a6120fe044fda630944e238b9ec1e4c01 Mon Sep 17 00:00:00 2001 From: "Deployment Bot (from Travis CI)" Date: Thu, 20 Sep 2018 07:19:37 +0000 Subject: [PATCH 004/152] Deploy MikeRalphson/OpenAPI-Specification to github.com/MikeRalphson/OpenAPI-Specification.git:gh-pages --- index.md | 4 +- js/respec-oai.build.js.map | 210 +++ oas/v3.0.1.html | 3056 ++++++++++++++++++------------------ 3 files changed, 1744 insertions(+), 1526 deletions(-) create mode 100644 js/respec-oai.build.js.map diff --git a/index.md b/index.md index a0ba023253..265e83207d 100644 --- a/index.md +++ b/index.md @@ -1,7 +1,7 @@ -## Current major version +## Current version * [v3.0.0](oas/v3.0.0.html) -## Previous major version +## Previous version * [v2.0](oas/v2.0.html) diff --git a/js/respec-oai.build.js.map b/js/respec-oai.build.js.map new file mode 100644 index 0000000000..899b0a5f60 --- /dev/null +++ b/js/respec-oai.build.js.map @@ -0,0 +1,210 @@ +{ + "version": 3, + "sources": [ + "deps/require.js", + "deps/hyperhtml.js", + "deps/url-search-params.js", + "deps/domReady.js", + "core/pubsubhub.js", + "deps/marked.js", + "core/utils.js", + "core/post-process.js", + "core/pre-process.js", + "core/include-config.js", + "core/override-configuration.js", + "core/respec-ready.js", + "core/base-runner.js", + "shortcut.js", + "deps/text.js", + "ui/ui.css!deps/text", + "deps/jquery.js", + "core/jquery-enhanced.js", + "core/ui.js", + "core/l10n.js", + "core/linter.js", + "core/LinterRule.js", + "core/linter-rules/no-headingless-sections.js", + "core/linter-rules/no-http-props.js", + "w3c/l10n.js", + "w3c/linter-rules/privsec-section.js", + "core/linter-rules/check-punctuation.js", + "core/linter-rules/local-refs-exist.js", + "oai/defaults.js", + "core/css/respec2.css!deps/text", + "core/style.js", + "w3c/style.js", + "core/github.js", + "core/data-include.js", + "core/markdown.js", + "deps/handlebars.js", + "templates.js", + "w3c/templates/cgbg-sotd.js", + "w3c/templates/sotd.js", + "w3c/templates/show-logo.js", + "w3c/templates/show-people.js", + "w3c/templates/show-link.js", + "w3c/templates/cgbg-headers.js", + "oai/templates/show-logo.js", + "oai/templates/show-people.js", + "oai/templates/show-link.js", + "oai/templates/headers.js", + "oai/headers.js", + "w3c/abstract.js", + "w3c/templates/conformance.js", + "w3c/conformance.js", + "core/data-transform.js", + "core/inlines.js", + "deps/pluralize.js", + "core/dfn.js", + "w3c/rfc2119.js", + "core/css/examples.css!deps/text", + "core/examples.js", + "deps/text!core/css/issues-notes.css", + "core/issues-notes.js", + "core/requirements.js", + "core/css/bp.css!deps/text", + "core/best-practices.js", + "core/figures.js", + "deps/webidl2.js", + "core/css/webidl.css!deps/text", + "core/webidl.js", + "core/biblio-db.js", + "core/biblio.js", + "core/data-cite.js", + "core/webidl-index.js", + "core/link-to-dfn.js", + "core/contrib.js", + "core/fix-headers.js", + "core/structure.js", + "w3c/informative.js", + "w3c/permalinks.js", + "core/id-headers.js", + "core/location-hash.js", + "core/css/caniuse.css!deps/text", + "core/caniuse.js", + "core/exporter.js", + "ui/save-html.js", + "ui/search-specref.js", + "ui/dfn-list.js", + "ui/about-respec.js", + "core/seo.js", + "w3c/seo.js", + "core/css/github.css!deps/text", + "deps/text!core/../../worker/respec-worker.js", + "core/worker.js", + "core/highlight.js", + "core/images/clipboard.svg!deps/text", + "deps/clipboard.js", + "core/webidl-clipboard.js", + "core/data-tests.js", + "core/list-sorter.js", + "core/css/var.css!deps/text", + "core/highlight-vars.js", + "profile-oai.js" + ], + "names": [], + "mappings": "AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACpmEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC10CA;AACA;AACA;AACA;AACA;AACA,ACLA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3+CA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACndA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC1EA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC9OA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzZA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChlQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3LA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChNA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC/FA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACxEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC7DA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzGA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3CA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC5JA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC57CA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC1aA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACpDA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjLA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC/BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC/BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACtKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3bA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC7BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC/BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC9BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC7FA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3eA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC/FA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnCA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AClFA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChDA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC9CA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACpFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzkCA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC12BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACxQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChSA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACpIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AClIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACtJA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACxFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC1CA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3GA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACvFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AClJA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACxCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3EA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACpCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChJA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACvCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACxFA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC36BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACtGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC7GA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3GA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA", + "file": "profile-oai.build.js", + "sourcesContent": [ + "/** vim: et:ts=4:sw=4:sts=4\n * @license RequireJS 2.3.5 Copyright jQuery Foundation and other contributors.\n * Released under MIT license, https://github.com/requirejs/requirejs/blob/master/LICENSE\n */\n//Not using strict: uneven strict support in browsers, #392, and causes\n//problems with requirejs.exec()/transpiler plugins that may not be strict.\n/*jslint regexp: true, nomen: true, sloppy: true */\n/*global window, navigator, document, importScripts, setTimeout, opera */\n\nvar requirejs, require, define;\n(function (global, setTimeout) {\n var req, s, head, baseElement, dataMain, src,\n interactiveScript, currentlyAddingScript, mainScript, subPath,\n version = '2.3.5',\n commentRegExp = /\\/\\*[\\s\\S]*?\\*\\/|([^:\"'=]|^)\\/\\/.*$/mg,\n cjsRequireRegExp = /[^.]\\s*require\\s*\\(\\s*[\"']([^'\"\\s]+)[\"']\\s*\\)/g,\n jsSuffixRegExp = /\\.js$/,\n currDirRegExp = /^\\.\\//,\n op = Object.prototype,\n ostring = op.toString,\n hasOwn = op.hasOwnProperty,\n isBrowser = !!(typeof window !== 'undefined' && typeof navigator !== 'undefined' && window.document),\n isWebWorker = !isBrowser && typeof importScripts !== 'undefined',\n //PS3 indicates loaded and complete, but need to wait for complete\n //specifically. Sequence is 'loading', 'loaded', execution,\n // then 'complete'. The UA check is unfortunate, but not sure how\n //to feature test w/o causing perf issues.\n readyRegExp = isBrowser && navigator.platform === 'PLAYSTATION 3' ?\n /^complete$/ : /^(complete|loaded)$/,\n defContextName = '_',\n //Oh the tragedy, detecting opera. See the usage of isOpera for reason.\n isOpera = typeof opera !== 'undefined' && opera.toString() === '[object Opera]',\n contexts = {},\n cfg = {},\n globalDefQueue = [],\n useInteractive = false;\n\n //Could match something like ')//comment', do not lose the prefix to comment.\n function commentReplace(match, singlePrefix) {\n return singlePrefix || '';\n }\n\n function isFunction(it) {\n return ostring.call(it) === '[object Function]';\n }\n\n function isArray(it) {\n return ostring.call(it) === '[object Array]';\n }\n\n /**\n * Helper function for iterating over an array. If the func returns\n * a true value, it will break out of the loop.\n */\n function each(ary, func) {\n if (ary) {\n var i;\n for (i = 0; i < ary.length; i += 1) {\n if (ary[i] && func(ary[i], i, ary)) {\n break;\n }\n }\n }\n }\n\n /**\n * Helper function for iterating over an array backwards. If the func\n * returns a true value, it will break out of the loop.\n */\n function eachReverse(ary, func) {\n if (ary) {\n var i;\n for (i = ary.length - 1; i > -1; i -= 1) {\n if (ary[i] && func(ary[i], i, ary)) {\n break;\n }\n }\n }\n }\n\n function hasProp(obj, prop) {\n return hasOwn.call(obj, prop);\n }\n\n function getOwn(obj, prop) {\n return hasProp(obj, prop) && obj[prop];\n }\n\n /**\n * Cycles over properties in an object and calls a function for each\n * property value. If the function returns a truthy value, then the\n * iteration is stopped.\n */\n function eachProp(obj, func) {\n var prop;\n for (prop in obj) {\n if (hasProp(obj, prop)) {\n if (func(obj[prop], prop)) {\n break;\n }\n }\n }\n }\n\n /**\n * Simple function to mix in properties from source into target,\n * but only if target does not already have a property of the same name.\n */\n function mixin(target, source, force, deepStringMixin) {\n if (source) {\n eachProp(source, function (value, prop) {\n if (force || !hasProp(target, prop)) {\n if (deepStringMixin && typeof value === 'object' && value &&\n !isArray(value) && !isFunction(value) &&\n !(value instanceof RegExp)) {\n\n if (!target[prop]) {\n target[prop] = {};\n }\n mixin(target[prop], value, force, deepStringMixin);\n } else {\n target[prop] = value;\n }\n }\n });\n }\n return target;\n }\n\n //Similar to Function.prototype.bind, but the 'this' object is specified\n //first, since it is easier to read/figure out what 'this' will be.\n function bind(obj, fn) {\n return function () {\n return fn.apply(obj, arguments);\n };\n }\n\n function scripts() {\n return document.getElementsByTagName('script');\n }\n\n function defaultOnError(err) {\n throw err;\n }\n\n //Allow getting a global that is expressed in\n //dot notation, like 'a.b.c'.\n function getGlobal(value) {\n if (!value) {\n return value;\n }\n var g = global;\n each(value.split('.'), function (part) {\n g = g[part];\n });\n return g;\n }\n\n /**\n * Constructs an error with a pointer to an URL with more information.\n * @param {String} id the error ID that maps to an ID on a web page.\n * @param {String} message human readable error.\n * @param {Error} [err] the original error, if there is one.\n *\n * @returns {Error}\n */\n function makeError(id, msg, err, requireModules) {\n var e = new Error(msg + '\\nhttp://requirejs.org/docs/errors.html#' + id);\n e.requireType = id;\n e.requireModules = requireModules;\n if (err) {\n e.originalError = err;\n }\n return e;\n }\n\n if (typeof define !== 'undefined') {\n //If a define is already in play via another AMD loader,\n //do not overwrite.\n return;\n }\n\n if (typeof requirejs !== 'undefined') {\n if (isFunction(requirejs)) {\n //Do not overwrite an existing requirejs instance.\n return;\n }\n cfg = requirejs;\n requirejs = undefined;\n }\n\n //Allow for a require config object\n if (typeof require !== 'undefined' && !isFunction(require)) {\n //assume it is a config object.\n cfg = require;\n require = undefined;\n }\n\n function newContext(contextName) {\n var inCheckLoaded, Module, context, handlers,\n checkLoadedTimeoutId,\n config = {\n //Defaults. Do not set a default for map\n //config to speed up normalize(), which\n //will run faster if there is no default.\n waitSeconds: 7,\n baseUrl: './',\n paths: {},\n bundles: {},\n pkgs: {},\n shim: {},\n config: {}\n },\n registry = {},\n //registry of just enabled modules, to speed\n //cycle breaking code when lots of modules\n //are registered, but not activated.\n enabledRegistry = {},\n undefEvents = {},\n defQueue = [],\n defined = {},\n urlFetched = {},\n bundlesMap = {},\n requireCounter = 1,\n unnormalizedCounter = 1;\n\n /**\n * Trims the . and .. from an array of path segments.\n * It will keep a leading path segment if a .. will become\n * the first path segment, to help with module name lookups,\n * which act like paths, but can be remapped. But the end result,\n * all paths that use this function should look normalized.\n * NOTE: this method MODIFIES the input array.\n * @param {Array} ary the array of path segments.\n */\n function trimDots(ary) {\n var i, part;\n for (i = 0; i < ary.length; i++) {\n part = ary[i];\n if (part === '.') {\n ary.splice(i, 1);\n i -= 1;\n } else if (part === '..') {\n // If at the start, or previous value is still ..,\n // keep them so that when converted to a path it may\n // still work when converted to a path, even though\n // as an ID it is less than ideal. In larger point\n // releases, may be better to just kick out an error.\n if (i === 0 || (i === 1 && ary[2] === '..') || ary[i - 1] === '..') {\n continue;\n } else if (i > 0) {\n ary.splice(i - 1, 2);\n i -= 2;\n }\n }\n }\n }\n\n /**\n * Given a relative module name, like ./something, normalize it to\n * a real name that can be mapped to a path.\n * @param {String} name the relative name\n * @param {String} baseName a real name that the name arg is relative\n * to.\n * @param {Boolean} applyMap apply the map config to the value. Should\n * only be done if this normalization is for a dependency ID.\n * @returns {String} normalized name\n */\n function normalize(name, baseName, applyMap) {\n var pkgMain, mapValue, nameParts, i, j, nameSegment, lastIndex,\n foundMap, foundI, foundStarMap, starI, normalizedBaseParts,\n baseParts = (baseName && baseName.split('/')),\n map = config.map,\n starMap = map && map['*'];\n\n //Adjust any relative paths.\n if (name) {\n name = name.split('/');\n lastIndex = name.length - 1;\n\n // If wanting node ID compatibility, strip .js from end\n // of IDs. Have to do this here, and not in nameToUrl\n // because node allows either .js or non .js to map\n // to same file.\n if (config.nodeIdCompat && jsSuffixRegExp.test(name[lastIndex])) {\n name[lastIndex] = name[lastIndex].replace(jsSuffixRegExp, '');\n }\n\n // Starts with a '.' so need the baseName\n if (name[0].charAt(0) === '.' && baseParts) {\n //Convert baseName to array, and lop off the last part,\n //so that . matches that 'directory' and not name of the baseName's\n //module. For instance, baseName of 'one/two/three', maps to\n //'one/two/three.js', but we want the directory, 'one/two' for\n //this normalization.\n normalizedBaseParts = baseParts.slice(0, baseParts.length - 1);\n name = normalizedBaseParts.concat(name);\n }\n\n trimDots(name);\n name = name.join('/');\n }\n\n //Apply map config if available.\n if (applyMap && map && (baseParts || starMap)) {\n nameParts = name.split('/');\n\n outerLoop: for (i = nameParts.length; i > 0; i -= 1) {\n nameSegment = nameParts.slice(0, i).join('/');\n\n if (baseParts) {\n //Find the longest baseName segment match in the config.\n //So, do joins on the biggest to smallest lengths of baseParts.\n for (j = baseParts.length; j > 0; j -= 1) {\n mapValue = getOwn(map, baseParts.slice(0, j).join('/'));\n\n //baseName segment has config, find if it has one for\n //this name.\n if (mapValue) {\n mapValue = getOwn(mapValue, nameSegment);\n if (mapValue) {\n //Match, update name to the new value.\n foundMap = mapValue;\n foundI = i;\n break outerLoop;\n }\n }\n }\n }\n\n //Check for a star map match, but just hold on to it,\n //if there is a shorter segment match later in a matching\n //config, then favor over this star map.\n if (!foundStarMap && starMap && getOwn(starMap, nameSegment)) {\n foundStarMap = getOwn(starMap, nameSegment);\n starI = i;\n }\n }\n\n if (!foundMap && foundStarMap) {\n foundMap = foundStarMap;\n foundI = starI;\n }\n\n if (foundMap) {\n nameParts.splice(0, foundI, foundMap);\n name = nameParts.join('/');\n }\n }\n\n // If the name points to a package's name, use\n // the package main instead.\n pkgMain = getOwn(config.pkgs, name);\n\n return pkgMain ? pkgMain : name;\n }\n\n function removeScript(name) {\n if (isBrowser) {\n each(scripts(), function (scriptNode) {\n if (scriptNode.getAttribute('data-requiremodule') === name &&\n scriptNode.getAttribute('data-requirecontext') === context.contextName) {\n scriptNode.parentNode.removeChild(scriptNode);\n return true;\n }\n });\n }\n }\n\n function hasPathFallback(id) {\n var pathConfig = getOwn(config.paths, id);\n if (pathConfig && isArray(pathConfig) && pathConfig.length > 1) {\n //Pop off the first array value, since it failed, and\n //retry\n pathConfig.shift();\n context.require.undef(id);\n\n //Custom require that does not do map translation, since\n //ID is \"absolute\", already mapped/resolved.\n context.makeRequire(null, {\n skipMap: true\n })([id]);\n\n return true;\n }\n }\n\n //Turns a plugin!resource to [plugin, resource]\n //with the plugin being undefined if the name\n //did not have a plugin prefix.\n function splitPrefix(name) {\n var prefix,\n index = name ? name.indexOf('!') : -1;\n if (index > -1) {\n prefix = name.substring(0, index);\n name = name.substring(index + 1, name.length);\n }\n return [prefix, name];\n }\n\n /**\n * Creates a module mapping that includes plugin prefix, module\n * name, and path. If parentModuleMap is provided it will\n * also normalize the name via require.normalize()\n *\n * @param {String} name the module name\n * @param {String} [parentModuleMap] parent module map\n * for the module name, used to resolve relative names.\n * @param {Boolean} isNormalized: is the ID already normalized.\n * This is true if this call is done for a define() module ID.\n * @param {Boolean} applyMap: apply the map config to the ID.\n * Should only be true if this map is for a dependency.\n *\n * @returns {Object}\n */\n function makeModuleMap(name, parentModuleMap, isNormalized, applyMap) {\n var url, pluginModule, suffix, nameParts,\n prefix = null,\n parentName = parentModuleMap ? parentModuleMap.name : null,\n originalName = name,\n isDefine = true,\n normalizedName = '';\n\n //If no name, then it means it is a require call, generate an\n //internal name.\n if (!name) {\n isDefine = false;\n name = '_@r' + (requireCounter += 1);\n }\n\n nameParts = splitPrefix(name);\n prefix = nameParts[0];\n name = nameParts[1];\n\n if (prefix) {\n prefix = normalize(prefix, parentName, applyMap);\n pluginModule = getOwn(defined, prefix);\n }\n\n //Account for relative paths if there is a base name.\n if (name) {\n if (prefix) {\n if (isNormalized) {\n normalizedName = name;\n } else if (pluginModule && pluginModule.normalize) {\n //Plugin is loaded, use its normalize method.\n normalizedName = pluginModule.normalize(name, function (name) {\n return normalize(name, parentName, applyMap);\n });\n } else {\n // If nested plugin references, then do not try to\n // normalize, as it will not normalize correctly. This\n // places a restriction on resourceIds, and the longer\n // term solution is not to normalize until plugins are\n // loaded and all normalizations to allow for async\n // loading of a loader plugin. But for now, fixes the\n // common uses. Details in #1131\n normalizedName = name.indexOf('!') === -1 ?\n normalize(name, parentName, applyMap) :\n name;\n }\n } else {\n //A regular module.\n normalizedName = normalize(name, parentName, applyMap);\n\n //Normalized name may be a plugin ID due to map config\n //application in normalize. The map config values must\n //already be normalized, so do not need to redo that part.\n nameParts = splitPrefix(normalizedName);\n prefix = nameParts[0];\n normalizedName = nameParts[1];\n isNormalized = true;\n\n url = context.nameToUrl(normalizedName);\n }\n }\n\n //If the id is a plugin id that cannot be determined if it needs\n //normalization, stamp it with a unique ID so two matching relative\n //ids that may conflict can be separate.\n suffix = prefix && !pluginModule && !isNormalized ?\n '_unnormalized' + (unnormalizedCounter += 1) :\n '';\n\n return {\n prefix: prefix,\n name: normalizedName,\n parentMap: parentModuleMap,\n unnormalized: !!suffix,\n url: url,\n originalName: originalName,\n isDefine: isDefine,\n id: (prefix ?\n prefix + '!' + normalizedName :\n normalizedName) + suffix\n };\n }\n\n function getModule(depMap) {\n var id = depMap.id,\n mod = getOwn(registry, id);\n\n if (!mod) {\n mod = registry[id] = new context.Module(depMap);\n }\n\n return mod;\n }\n\n function on(depMap, name, fn) {\n var id = depMap.id,\n mod = getOwn(registry, id);\n\n if (hasProp(defined, id) &&\n (!mod || mod.defineEmitComplete)) {\n if (name === 'defined') {\n fn(defined[id]);\n }\n } else {\n mod = getModule(depMap);\n if (mod.error && name === 'error') {\n fn(mod.error);\n } else {\n mod.on(name, fn);\n }\n }\n }\n\n function onError(err, errback) {\n var ids = err.requireModules,\n notified = false;\n\n if (errback) {\n errback(err);\n } else {\n each(ids, function (id) {\n var mod = getOwn(registry, id);\n if (mod) {\n //Set error on module, so it skips timeout checks.\n mod.error = err;\n if (mod.events.error) {\n notified = true;\n mod.emit('error', err);\n }\n }\n });\n\n if (!notified) {\n req.onError(err);\n }\n }\n }\n\n /**\n * Internal method to transfer globalQueue items to this context's\n * defQueue.\n */\n function takeGlobalQueue() {\n //Push all the globalDefQueue items into the context's defQueue\n if (globalDefQueue.length) {\n each(globalDefQueue, function(queueItem) {\n var id = queueItem[0];\n if (typeof id === 'string') {\n context.defQueueMap[id] = true;\n }\n defQueue.push(queueItem);\n });\n globalDefQueue = [];\n }\n }\n\n handlers = {\n 'require': function (mod) {\n if (mod.require) {\n return mod.require;\n } else {\n return (mod.require = context.makeRequire(mod.map));\n }\n },\n 'exports': function (mod) {\n mod.usingExports = true;\n if (mod.map.isDefine) {\n if (mod.exports) {\n return (defined[mod.map.id] = mod.exports);\n } else {\n return (mod.exports = defined[mod.map.id] = {});\n }\n }\n },\n 'module': function (mod) {\n if (mod.module) {\n return mod.module;\n } else {\n return (mod.module = {\n id: mod.map.id,\n uri: mod.map.url,\n config: function () {\n return getOwn(config.config, mod.map.id) || {};\n },\n exports: mod.exports || (mod.exports = {})\n });\n }\n }\n };\n\n function cleanRegistry(id) {\n //Clean up machinery used for waiting modules.\n delete registry[id];\n delete enabledRegistry[id];\n }\n\n function breakCycle(mod, traced, processed) {\n var id = mod.map.id;\n\n if (mod.error) {\n mod.emit('error', mod.error);\n } else {\n traced[id] = true;\n each(mod.depMaps, function (depMap, i) {\n var depId = depMap.id,\n dep = getOwn(registry, depId);\n\n //Only force things that have not completed\n //being defined, so still in the registry,\n //and only if it has not been matched up\n //in the module already.\n if (dep && !mod.depMatched[i] && !processed[depId]) {\n if (getOwn(traced, depId)) {\n mod.defineDep(i, defined[depId]);\n mod.check(); //pass false?\n } else {\n breakCycle(dep, traced, processed);\n }\n }\n });\n processed[id] = true;\n }\n }\n\n function checkLoaded() {\n var err, usingPathFallback,\n waitInterval = config.waitSeconds * 1000,\n //It is possible to disable the wait interval by using waitSeconds of 0.\n expired = waitInterval && (context.startTime + waitInterval) < new Date().getTime(),\n noLoads = [],\n reqCalls = [],\n stillLoading = false,\n needCycleCheck = true;\n\n //Do not bother if this call was a result of a cycle break.\n if (inCheckLoaded) {\n return;\n }\n\n inCheckLoaded = true;\n\n //Figure out the state of all the modules.\n eachProp(enabledRegistry, function (mod) {\n var map = mod.map,\n modId = map.id;\n\n //Skip things that are not enabled or in error state.\n if (!mod.enabled) {\n return;\n }\n\n if (!map.isDefine) {\n reqCalls.push(mod);\n }\n\n if (!mod.error) {\n //If the module should be executed, and it has not\n //been inited and time is up, remember it.\n if (!mod.inited && expired) {\n if (hasPathFallback(modId)) {\n usingPathFallback = true;\n stillLoading = true;\n } else {\n noLoads.push(modId);\n removeScript(modId);\n }\n } else if (!mod.inited && mod.fetched && map.isDefine) {\n stillLoading = true;\n if (!map.prefix) {\n //No reason to keep looking for unfinished\n //loading. If the only stillLoading is a\n //plugin resource though, keep going,\n //because it may be that a plugin resource\n //is waiting on a non-plugin cycle.\n return (needCycleCheck = false);\n }\n }\n }\n });\n\n if (expired && noLoads.length) {\n //If wait time expired, throw error of unloaded modules.\n err = makeError('timeout', 'Load timeout for modules: ' + noLoads, null, noLoads);\n err.contextName = context.contextName;\n return onError(err);\n }\n\n //Not expired, check for a cycle.\n if (needCycleCheck) {\n each(reqCalls, function (mod) {\n breakCycle(mod, {}, {});\n });\n }\n\n //If still waiting on loads, and the waiting load is something\n //other than a plugin resource, or there are still outstanding\n //scripts, then just try back later.\n if ((!expired || usingPathFallback) && stillLoading) {\n //Something is still waiting to load. Wait for it, but only\n //if a timeout is not already in effect.\n if ((isBrowser || isWebWorker) && !checkLoadedTimeoutId) {\n checkLoadedTimeoutId = setTimeout(function () {\n checkLoadedTimeoutId = 0;\n checkLoaded();\n }, 50);\n }\n }\n\n inCheckLoaded = false;\n }\n\n Module = function (map) {\n this.events = getOwn(undefEvents, map.id) || {};\n this.map = map;\n this.shim = getOwn(config.shim, map.id);\n this.depExports = [];\n this.depMaps = [];\n this.depMatched = [];\n this.pluginMaps = {};\n this.depCount = 0;\n\n /* this.exports this.factory\n this.depMaps = [],\n this.enabled, this.fetched\n */\n };\n\n Module.prototype = {\n init: function (depMaps, factory, errback, options) {\n options = options || {};\n\n //Do not do more inits if already done. Can happen if there\n //are multiple define calls for the same module. That is not\n //a normal, common case, but it is also not unexpected.\n if (this.inited) {\n return;\n }\n\n this.factory = factory;\n\n if (errback) {\n //Register for errors on this module.\n this.on('error', errback);\n } else if (this.events.error) {\n //If no errback already, but there are error listeners\n //on this module, set up an errback to pass to the deps.\n errback = bind(this, function (err) {\n this.emit('error', err);\n });\n }\n\n //Do a copy of the dependency array, so that\n //source inputs are not modified. For example\n //\"shim\" deps are passed in here directly, and\n //doing a direct modification of the depMaps array\n //would affect that config.\n this.depMaps = depMaps && depMaps.slice(0);\n\n this.errback = errback;\n\n //Indicate this module has be initialized\n this.inited = true;\n\n this.ignore = options.ignore;\n\n //Could have option to init this module in enabled mode,\n //or could have been previously marked as enabled. However,\n //the dependencies are not known until init is called. So\n //if enabled previously, now trigger dependencies as enabled.\n if (options.enabled || this.enabled) {\n //Enable this module and dependencies.\n //Will call this.check()\n this.enable();\n } else {\n this.check();\n }\n },\n\n defineDep: function (i, depExports) {\n //Because of cycles, defined callback for a given\n //export can be called more than once.\n if (!this.depMatched[i]) {\n this.depMatched[i] = true;\n this.depCount -= 1;\n this.depExports[i] = depExports;\n }\n },\n\n fetch: function () {\n if (this.fetched) {\n return;\n }\n this.fetched = true;\n\n context.startTime = (new Date()).getTime();\n\n var map = this.map;\n\n //If the manager is for a plugin managed resource,\n //ask the plugin to load it now.\n if (this.shim) {\n context.makeRequire(this.map, {\n enableBuildCallback: true\n })(this.shim.deps || [], bind(this, function () {\n return map.prefix ? this.callPlugin() : this.load();\n }));\n } else {\n //Regular dependency.\n return map.prefix ? this.callPlugin() : this.load();\n }\n },\n\n load: function () {\n var url = this.map.url;\n\n //Regular dependency.\n if (!urlFetched[url]) {\n urlFetched[url] = true;\n context.load(this.map.id, url);\n }\n },\n\n /**\n * Checks if the module is ready to define itself, and if so,\n * define it.\n */\n check: function () {\n if (!this.enabled || this.enabling) {\n return;\n }\n\n var err, cjsModule,\n id = this.map.id,\n depExports = this.depExports,\n exports = this.exports,\n factory = this.factory;\n\n if (!this.inited) {\n // Only fetch if not already in the defQueue.\n if (!hasProp(context.defQueueMap, id)) {\n this.fetch();\n }\n } else if (this.error) {\n this.emit('error', this.error);\n } else if (!this.defining) {\n //The factory could trigger another require call\n //that would result in checking this module to\n //define itself again. If already in the process\n //of doing that, skip this work.\n this.defining = true;\n\n if (this.depCount < 1 && !this.defined) {\n if (isFunction(factory)) {\n //If there is an error listener, favor passing\n //to that instead of throwing an error. However,\n //only do it for define()'d modules. require\n //errbacks should not be called for failures in\n //their callbacks (#699). However if a global\n //onError is set, use that.\n if ((this.events.error && this.map.isDefine) ||\n req.onError !== defaultOnError) {\n try {\n exports = context.execCb(id, factory, depExports, exports);\n } catch (e) {\n err = e;\n }\n } else {\n exports = context.execCb(id, factory, depExports, exports);\n }\n\n // Favor return value over exports. If node/cjs in play,\n // then will not have a return value anyway. Favor\n // module.exports assignment over exports object.\n if (this.map.isDefine && exports === undefined) {\n cjsModule = this.module;\n if (cjsModule) {\n exports = cjsModule.exports;\n } else if (this.usingExports) {\n //exports already set the defined value.\n exports = this.exports;\n }\n }\n\n if (err) {\n err.requireMap = this.map;\n err.requireModules = this.map.isDefine ? [this.map.id] : null;\n err.requireType = this.map.isDefine ? 'define' : 'require';\n return onError((this.error = err));\n }\n\n } else {\n //Just a literal value\n exports = factory;\n }\n\n this.exports = exports;\n\n if (this.map.isDefine && !this.ignore) {\n defined[id] = exports;\n\n if (req.onResourceLoad) {\n var resLoadMaps = [];\n each(this.depMaps, function (depMap) {\n resLoadMaps.push(depMap.normalizedMap || depMap);\n });\n req.onResourceLoad(context, this.map, resLoadMaps);\n }\n }\n\n //Clean up\n cleanRegistry(id);\n\n this.defined = true;\n }\n\n //Finished the define stage. Allow calling check again\n //to allow define notifications below in the case of a\n //cycle.\n this.defining = false;\n\n if (this.defined && !this.defineEmitted) {\n this.defineEmitted = true;\n this.emit('defined', this.exports);\n this.defineEmitComplete = true;\n }\n\n }\n },\n\n callPlugin: function () {\n var map = this.map,\n id = map.id,\n //Map already normalized the prefix.\n pluginMap = makeModuleMap(map.prefix);\n\n //Mark this as a dependency for this plugin, so it\n //can be traced for cycles.\n this.depMaps.push(pluginMap);\n\n on(pluginMap, 'defined', bind(this, function (plugin) {\n var load, normalizedMap, normalizedMod,\n bundleId = getOwn(bundlesMap, this.map.id),\n name = this.map.name,\n parentName = this.map.parentMap ? this.map.parentMap.name : null,\n localRequire = context.makeRequire(map.parentMap, {\n enableBuildCallback: true\n });\n\n //If current map is not normalized, wait for that\n //normalized name to load instead of continuing.\n if (this.map.unnormalized) {\n //Normalize the ID if the plugin allows it.\n if (plugin.normalize) {\n name = plugin.normalize(name, function (name) {\n return normalize(name, parentName, true);\n }) || '';\n }\n\n //prefix and name should already be normalized, no need\n //for applying map config again either.\n normalizedMap = makeModuleMap(map.prefix + '!' + name,\n this.map.parentMap,\n true);\n on(normalizedMap,\n 'defined', bind(this, function (value) {\n this.map.normalizedMap = normalizedMap;\n this.init([], function () { return value; }, null, {\n enabled: true,\n ignore: true\n });\n }));\n\n normalizedMod = getOwn(registry, normalizedMap.id);\n if (normalizedMod) {\n //Mark this as a dependency for this plugin, so it\n //can be traced for cycles.\n this.depMaps.push(normalizedMap);\n\n if (this.events.error) {\n normalizedMod.on('error', bind(this, function (err) {\n this.emit('error', err);\n }));\n }\n normalizedMod.enable();\n }\n\n return;\n }\n\n //If a paths config, then just load that file instead to\n //resolve the plugin, as it is built into that paths layer.\n if (bundleId) {\n this.map.url = context.nameToUrl(bundleId);\n this.load();\n return;\n }\n\n load = bind(this, function (value) {\n this.init([], function () { return value; }, null, {\n enabled: true\n });\n });\n\n load.error = bind(this, function (err) {\n this.inited = true;\n this.error = err;\n err.requireModules = [id];\n\n //Remove temp unnormalized modules for this module,\n //since they will never be resolved otherwise now.\n eachProp(registry, function (mod) {\n if (mod.map.id.indexOf(id + '_unnormalized') === 0) {\n cleanRegistry(mod.map.id);\n }\n });\n\n onError(err);\n });\n\n //Allow plugins to load other code without having to know the\n //context or how to 'complete' the load.\n load.fromText = bind(this, function (text, textAlt) {\n /*jslint evil: true */\n var moduleName = map.name,\n moduleMap = makeModuleMap(moduleName),\n hasInteractive = useInteractive;\n\n //As of 2.1.0, support just passing the text, to reinforce\n //fromText only being called once per resource. Still\n //support old style of passing moduleName but discard\n //that moduleName in favor of the internal ref.\n if (textAlt) {\n text = textAlt;\n }\n\n //Turn off interactive script matching for IE for any define\n //calls in the text, then turn it back on at the end.\n if (hasInteractive) {\n useInteractive = false;\n }\n\n //Prime the system by creating a module instance for\n //it.\n getModule(moduleMap);\n\n //Transfer any config to this other module.\n if (hasProp(config.config, id)) {\n config.config[moduleName] = config.config[id];\n }\n\n try {\n req.exec(text);\n } catch (e) {\n return onError(makeError('fromtexteval',\n 'fromText eval for ' + id +\n ' failed: ' + e,\n e,\n [id]));\n }\n\n if (hasInteractive) {\n useInteractive = true;\n }\n\n //Mark this as a dependency for the plugin\n //resource\n this.depMaps.push(moduleMap);\n\n //Support anonymous modules.\n context.completeLoad(moduleName);\n\n //Bind the value of that module to the value for this\n //resource ID.\n localRequire([moduleName], load);\n });\n\n //Use parentName here since the plugin's name is not reliable,\n //could be some weird string with no path that actually wants to\n //reference the parentName's path.\n plugin.load(map.name, localRequire, load, config);\n }));\n\n context.enable(pluginMap, this);\n this.pluginMaps[pluginMap.id] = pluginMap;\n },\n\n enable: function () {\n enabledRegistry[this.map.id] = this;\n this.enabled = true;\n\n //Set flag mentioning that the module is enabling,\n //so that immediate calls to the defined callbacks\n //for dependencies do not trigger inadvertent load\n //with the depCount still being zero.\n this.enabling = true;\n\n //Enable each dependency\n each(this.depMaps, bind(this, function (depMap, i) {\n var id, mod, handler;\n\n if (typeof depMap === 'string') {\n //Dependency needs to be converted to a depMap\n //and wired up to this module.\n depMap = makeModuleMap(depMap,\n (this.map.isDefine ? this.map : this.map.parentMap),\n false,\n !this.skipMap);\n this.depMaps[i] = depMap;\n\n handler = getOwn(handlers, depMap.id);\n\n if (handler) {\n this.depExports[i] = handler(this);\n return;\n }\n\n this.depCount += 1;\n\n on(depMap, 'defined', bind(this, function (depExports) {\n if (this.undefed) {\n return;\n }\n this.defineDep(i, depExports);\n this.check();\n }));\n\n if (this.errback) {\n on(depMap, 'error', bind(this, this.errback));\n } else if (this.events.error) {\n // No direct errback on this module, but something\n // else is listening for errors, so be sure to\n // propagate the error correctly.\n on(depMap, 'error', bind(this, function(err) {\n this.emit('error', err);\n }));\n }\n }\n\n id = depMap.id;\n mod = registry[id];\n\n //Skip special modules like 'require', 'exports', 'module'\n //Also, don't call enable if it is already enabled,\n //important in circular dependency cases.\n if (!hasProp(handlers, id) && mod && !mod.enabled) {\n context.enable(depMap, this);\n }\n }));\n\n //Enable each plugin that is used in\n //a dependency\n eachProp(this.pluginMaps, bind(this, function (pluginMap) {\n var mod = getOwn(registry, pluginMap.id);\n if (mod && !mod.enabled) {\n context.enable(pluginMap, this);\n }\n }));\n\n this.enabling = false;\n\n this.check();\n },\n\n on: function (name, cb) {\n var cbs = this.events[name];\n if (!cbs) {\n cbs = this.events[name] = [];\n }\n cbs.push(cb);\n },\n\n emit: function (name, evt) {\n each(this.events[name], function (cb) {\n cb(evt);\n });\n if (name === 'error') {\n //Now that the error handler was triggered, remove\n //the listeners, since this broken Module instance\n //can stay around for a while in the registry.\n delete this.events[name];\n }\n }\n };\n\n function callGetModule(args) {\n //Skip modules already defined.\n if (!hasProp(defined, args[0])) {\n getModule(makeModuleMap(args[0], null, true)).init(args[1], args[2]);\n }\n }\n\n function removeListener(node, func, name, ieName) {\n //Favor detachEvent because of IE9\n //issue, see attachEvent/addEventListener comment elsewhere\n //in this file.\n if (node.detachEvent && !isOpera) {\n //Probably IE. If not it will throw an error, which will be\n //useful to know.\n if (ieName) {\n node.detachEvent(ieName, func);\n }\n } else {\n node.removeEventListener(name, func, false);\n }\n }\n\n /**\n * Given an event from a script node, get the requirejs info from it,\n * and then removes the event listeners on the node.\n * @param {Event} evt\n * @returns {Object}\n */\n function getScriptData(evt) {\n //Using currentTarget instead of target for Firefox 2.0's sake. Not\n //all old browsers will be supported, but this one was easy enough\n //to support and still makes sense.\n var node = evt.currentTarget || evt.srcElement;\n\n //Remove the listeners once here.\n removeListener(node, context.onScriptLoad, 'load', 'onreadystatechange');\n removeListener(node, context.onScriptError, 'error');\n\n return {\n node: node,\n id: node && node.getAttribute('data-requiremodule')\n };\n }\n\n function intakeDefines() {\n var args;\n\n //Any defined modules in the global queue, intake them now.\n takeGlobalQueue();\n\n //Make sure any remaining defQueue items get properly processed.\n while (defQueue.length) {\n args = defQueue.shift();\n if (args[0] === null) {\n return onError(makeError('mismatch', 'Mismatched anonymous define() module: ' +\n args[args.length - 1]));\n } else {\n //args are id, deps, factory. Should be normalized by the\n //define() function.\n callGetModule(args);\n }\n }\n context.defQueueMap = {};\n }\n\n context = {\n config: config,\n contextName: contextName,\n registry: registry,\n defined: defined,\n urlFetched: urlFetched,\n defQueue: defQueue,\n defQueueMap: {},\n Module: Module,\n makeModuleMap: makeModuleMap,\n nextTick: req.nextTick,\n onError: onError,\n\n /**\n * Set a configuration for the context.\n * @param {Object} cfg config object to integrate.\n */\n configure: function (cfg) {\n //Make sure the baseUrl ends in a slash.\n if (cfg.baseUrl) {\n if (cfg.baseUrl.charAt(cfg.baseUrl.length - 1) !== '/') {\n cfg.baseUrl += '/';\n }\n }\n\n // Convert old style urlArgs string to a function.\n if (typeof cfg.urlArgs === 'string') {\n var urlArgs = cfg.urlArgs;\n cfg.urlArgs = function(id, url) {\n return (url.indexOf('?') === -1 ? '?' : '&') + urlArgs;\n };\n }\n\n //Save off the paths since they require special processing,\n //they are additive.\n var shim = config.shim,\n objs = {\n paths: true,\n bundles: true,\n config: true,\n map: true\n };\n\n eachProp(cfg, function (value, prop) {\n if (objs[prop]) {\n if (!config[prop]) {\n config[prop] = {};\n }\n mixin(config[prop], value, true, true);\n } else {\n config[prop] = value;\n }\n });\n\n //Reverse map the bundles\n if (cfg.bundles) {\n eachProp(cfg.bundles, function (value, prop) {\n each(value, function (v) {\n if (v !== prop) {\n bundlesMap[v] = prop;\n }\n });\n });\n }\n\n //Merge shim\n if (cfg.shim) {\n eachProp(cfg.shim, function (value, id) {\n //Normalize the structure\n if (isArray(value)) {\n value = {\n deps: value\n };\n }\n if ((value.exports || value.init) && !value.exportsFn) {\n value.exportsFn = context.makeShimExports(value);\n }\n shim[id] = value;\n });\n config.shim = shim;\n }\n\n //Adjust packages if necessary.\n if (cfg.packages) {\n each(cfg.packages, function (pkgObj) {\n var location, name;\n\n pkgObj = typeof pkgObj === 'string' ? {name: pkgObj} : pkgObj;\n\n name = pkgObj.name;\n location = pkgObj.location;\n if (location) {\n config.paths[name] = pkgObj.location;\n }\n\n //Save pointer to main module ID for pkg name.\n //Remove leading dot in main, so main paths are normalized,\n //and remove any trailing .js, since different package\n //envs have different conventions: some use a module name,\n //some use a file name.\n config.pkgs[name] = pkgObj.name + '/' + (pkgObj.main || 'main')\n .replace(currDirRegExp, '')\n .replace(jsSuffixRegExp, '');\n });\n }\n\n //If there are any \"waiting to execute\" modules in the registry,\n //update the maps for them, since their info, like URLs to load,\n //may have changed.\n eachProp(registry, function (mod, id) {\n //If module already has init called, since it is too\n //late to modify them, and ignore unnormalized ones\n //since they are transient.\n if (!mod.inited && !mod.map.unnormalized) {\n mod.map = makeModuleMap(id, null, true);\n }\n });\n\n //If a deps array or a config callback is specified, then call\n //require with those args. This is useful when require is defined as a\n //config object before require.js is loaded.\n if (cfg.deps || cfg.callback) {\n context.require(cfg.deps || [], cfg.callback);\n }\n },\n\n makeShimExports: function (value) {\n function fn() {\n var ret;\n if (value.init) {\n ret = value.init.apply(global, arguments);\n }\n return ret || (value.exports && getGlobal(value.exports));\n }\n return fn;\n },\n\n makeRequire: function (relMap, options) {\n options = options || {};\n\n function localRequire(deps, callback, errback) {\n var id, map, requireMod;\n\n if (options.enableBuildCallback && callback && isFunction(callback)) {\n callback.__requireJsBuild = true;\n }\n\n if (typeof deps === 'string') {\n if (isFunction(callback)) {\n //Invalid call\n return onError(makeError('requireargs', 'Invalid require call'), errback);\n }\n\n //If require|exports|module are requested, get the\n //value for them from the special handlers. Caveat:\n //this only works while module is being defined.\n if (relMap && hasProp(handlers, deps)) {\n return handlers[deps](registry[relMap.id]);\n }\n\n //Synchronous access to one module. If require.get is\n //available (as in the Node adapter), prefer that.\n if (req.get) {\n return req.get(context, deps, relMap, localRequire);\n }\n\n //Normalize module name, if it contains . or ..\n map = makeModuleMap(deps, relMap, false, true);\n id = map.id;\n\n if (!hasProp(defined, id)) {\n return onError(makeError('notloaded', 'Module name \"' +\n id +\n '\" has not been loaded yet for context: ' +\n contextName +\n (relMap ? '' : '. Use require([])')));\n }\n return defined[id];\n }\n\n //Grab defines waiting in the global queue.\n intakeDefines();\n\n //Mark all the dependencies as needing to be loaded.\n context.nextTick(function () {\n //Some defines could have been added since the\n //require call, collect them.\n intakeDefines();\n\n requireMod = getModule(makeModuleMap(null, relMap));\n\n //Store if map config should be applied to this require\n //call for dependencies.\n requireMod.skipMap = options.skipMap;\n\n requireMod.init(deps, callback, errback, {\n enabled: true\n });\n\n checkLoaded();\n });\n\n return localRequire;\n }\n\n mixin(localRequire, {\n isBrowser: isBrowser,\n\n /**\n * Converts a module name + .extension into an URL path.\n * *Requires* the use of a module name. It does not support using\n * plain URLs like nameToUrl.\n */\n toUrl: function (moduleNamePlusExt) {\n var ext,\n index = moduleNamePlusExt.lastIndexOf('.'),\n segment = moduleNamePlusExt.split('/')[0],\n isRelative = segment === '.' || segment === '..';\n\n //Have a file extension alias, and it is not the\n //dots from a relative path.\n if (index !== -1 && (!isRelative || index > 1)) {\n ext = moduleNamePlusExt.substring(index, moduleNamePlusExt.length);\n moduleNamePlusExt = moduleNamePlusExt.substring(0, index);\n }\n\n return context.nameToUrl(normalize(moduleNamePlusExt,\n relMap && relMap.id, true), ext, true);\n },\n\n defined: function (id) {\n return hasProp(defined, makeModuleMap(id, relMap, false, true).id);\n },\n\n specified: function (id) {\n id = makeModuleMap(id, relMap, false, true).id;\n return hasProp(defined, id) || hasProp(registry, id);\n }\n });\n\n //Only allow undef on top level require calls\n if (!relMap) {\n localRequire.undef = function (id) {\n //Bind any waiting define() calls to this context,\n //fix for #408\n takeGlobalQueue();\n\n var map = makeModuleMap(id, relMap, true),\n mod = getOwn(registry, id);\n\n mod.undefed = true;\n removeScript(id);\n\n delete defined[id];\n delete urlFetched[map.url];\n delete undefEvents[id];\n\n //Clean queued defines too. Go backwards\n //in array so that the splices do not\n //mess up the iteration.\n eachReverse(defQueue, function(args, i) {\n if (args[0] === id) {\n defQueue.splice(i, 1);\n }\n });\n delete context.defQueueMap[id];\n\n if (mod) {\n //Hold on to listeners in case the\n //module will be attempted to be reloaded\n //using a different config.\n if (mod.events.defined) {\n undefEvents[id] = mod.events;\n }\n\n cleanRegistry(id);\n }\n };\n }\n\n return localRequire;\n },\n\n /**\n * Called to enable a module if it is still in the registry\n * awaiting enablement. A second arg, parent, the parent module,\n * is passed in for context, when this method is overridden by\n * the optimizer. Not shown here to keep code compact.\n */\n enable: function (depMap) {\n var mod = getOwn(registry, depMap.id);\n if (mod) {\n getModule(depMap).enable();\n }\n },\n\n /**\n * Internal method used by environment adapters to complete a load event.\n * A load event could be a script load or just a load pass from a synchronous\n * load call.\n * @param {String} moduleName the name of the module to potentially complete.\n */\n completeLoad: function (moduleName) {\n var found, args, mod,\n shim = getOwn(config.shim, moduleName) || {},\n shExports = shim.exports;\n\n takeGlobalQueue();\n\n while (defQueue.length) {\n args = defQueue.shift();\n if (args[0] === null) {\n args[0] = moduleName;\n //If already found an anonymous module and bound it\n //to this name, then this is some other anon module\n //waiting for its completeLoad to fire.\n if (found) {\n break;\n }\n found = true;\n } else if (args[0] === moduleName) {\n //Found matching define call for this script!\n found = true;\n }\n\n callGetModule(args);\n }\n context.defQueueMap = {};\n\n //Do this after the cycle of callGetModule in case the result\n //of those calls/init calls changes the registry.\n mod = getOwn(registry, moduleName);\n\n if (!found && !hasProp(defined, moduleName) && mod && !mod.inited) {\n if (config.enforceDefine && (!shExports || !getGlobal(shExports))) {\n if (hasPathFallback(moduleName)) {\n return;\n } else {\n return onError(makeError('nodefine',\n 'No define call for ' + moduleName,\n null,\n [moduleName]));\n }\n } else {\n //A script that does not call define(), so just simulate\n //the call for it.\n callGetModule([moduleName, (shim.deps || []), shim.exportsFn]);\n }\n }\n\n checkLoaded();\n },\n\n /**\n * Converts a module name to a file path. Supports cases where\n * moduleName may actually be just an URL.\n * Note that it **does not** call normalize on the moduleName,\n * it is assumed to have already been normalized. This is an\n * internal API, not a public one. Use toUrl for the public API.\n */\n nameToUrl: function (moduleName, ext, skipExt) {\n var paths, syms, i, parentModule, url,\n parentPath, bundleId,\n pkgMain = getOwn(config.pkgs, moduleName);\n\n if (pkgMain) {\n moduleName = pkgMain;\n }\n\n bundleId = getOwn(bundlesMap, moduleName);\n\n if (bundleId) {\n return context.nameToUrl(bundleId, ext, skipExt);\n }\n\n //If a colon is in the URL, it indicates a protocol is used and it is just\n //an URL to a file, or if it starts with a slash, contains a query arg (i.e. ?)\n //or ends with .js, then assume the user meant to use an url and not a module id.\n //The slash is important for protocol-less URLs as well as full paths.\n if (req.jsExtRegExp.test(moduleName)) {\n //Just a plain path, not module name lookup, so just return it.\n //Add extension if it is included. This is a bit wonky, only non-.js things pass\n //an extension, this method probably needs to be reworked.\n url = moduleName + (ext || '');\n } else {\n //A module that needs to be converted to a path.\n paths = config.paths;\n\n syms = moduleName.split('/');\n //For each module name segment, see if there is a path\n //registered for it. Start with most specific name\n //and work up from it.\n for (i = syms.length; i > 0; i -= 1) {\n parentModule = syms.slice(0, i).join('/');\n\n parentPath = getOwn(paths, parentModule);\n if (parentPath) {\n //If an array, it means there are a few choices,\n //Choose the one that is desired\n if (isArray(parentPath)) {\n parentPath = parentPath[0];\n }\n syms.splice(0, i, parentPath);\n break;\n }\n }\n\n //Join the path parts together, then figure out if baseUrl is needed.\n url = syms.join('/');\n url += (ext || (/^data\\:|^blob\\:|\\?/.test(url) || skipExt ? '' : '.js'));\n url = (url.charAt(0) === '/' || url.match(/^[\\w\\+\\.\\-]+:/) ? '' : config.baseUrl) + url;\n }\n\n return config.urlArgs && !/^blob\\:/.test(url) ?\n url + config.urlArgs(moduleName, url) : url;\n },\n\n //Delegates to req.load. Broken out as a separate function to\n //allow overriding in the optimizer.\n load: function (id, url) {\n req.load(context, id, url);\n },\n\n /**\n * Executes a module callback function. Broken out as a separate function\n * solely to allow the build system to sequence the files in the built\n * layer in the right sequence.\n *\n * @private\n */\n execCb: function (name, callback, args, exports) {\n return callback.apply(exports, args);\n },\n\n /**\n * callback for script loads, used to check status of loading.\n *\n * @param {Event} evt the event from the browser for the script\n * that was loaded.\n */\n onScriptLoad: function (evt) {\n //Using currentTarget instead of target for Firefox 2.0's sake. Not\n //all old browsers will be supported, but this one was easy enough\n //to support and still makes sense.\n if (evt.type === 'load' ||\n (readyRegExp.test((evt.currentTarget || evt.srcElement).readyState))) {\n //Reset interactive script so a script node is not held onto for\n //to long.\n interactiveScript = null;\n\n //Pull out the name of the module and the context.\n var data = getScriptData(evt);\n context.completeLoad(data.id);\n }\n },\n\n /**\n * Callback for script errors.\n */\n onScriptError: function (evt) {\n var data = getScriptData(evt);\n if (!hasPathFallback(data.id)) {\n var parents = [];\n eachProp(registry, function(value, key) {\n if (key.indexOf('_@r') !== 0) {\n each(value.depMaps, function(depMap) {\n if (depMap.id === data.id) {\n parents.push(key);\n return true;\n }\n });\n }\n });\n return onError(makeError('scripterror', 'Script error for \"' + data.id +\n (parents.length ?\n '\", needed by: ' + parents.join(', ') :\n '\"'), evt, [data.id]));\n }\n }\n };\n\n context.require = context.makeRequire();\n return context;\n }\n\n /**\n * Main entry point.\n *\n * If the only argument to require is a string, then the module that\n * is represented by that string is fetched for the appropriate context.\n *\n * If the first argument is an array, then it will be treated as an array\n * of dependency string names to fetch. An optional function callback can\n * be specified to execute when all of those dependencies are available.\n *\n * Make a local req variable to help Caja compliance (it assumes things\n * on a require that are not standardized), and to give a short\n * name for minification/local scope use.\n */\n req = requirejs = function (deps, callback, errback, optional) {\n\n //Find the right context, use default\n var context, config,\n contextName = defContextName;\n\n // Determine if have config object in the call.\n if (!isArray(deps) && typeof deps !== 'string') {\n // deps is a config object\n config = deps;\n if (isArray(callback)) {\n // Adjust args if there are dependencies\n deps = callback;\n callback = errback;\n errback = optional;\n } else {\n deps = [];\n }\n }\n\n if (config && config.context) {\n contextName = config.context;\n }\n\n context = getOwn(contexts, contextName);\n if (!context) {\n context = contexts[contextName] = req.s.newContext(contextName);\n }\n\n if (config) {\n context.configure(config);\n }\n\n return context.require(deps, callback, errback);\n };\n\n /**\n * Support require.config() to make it easier to cooperate with other\n * AMD loaders on globally agreed names.\n */\n req.config = function (config) {\n return req(config);\n };\n\n /**\n * Execute something after the current tick\n * of the event loop. Override for other envs\n * that have a better solution than setTimeout.\n * @param {Function} fn function to execute later.\n */\n req.nextTick = typeof setTimeout !== 'undefined' ? function (fn) {\n setTimeout(fn, 4);\n } : function (fn) { fn(); };\n\n /**\n * Export require as a global, but only if it does not already exist.\n */\n if (!require) {\n require = req;\n }\n\n req.version = version;\n\n //Used to filter out dependencies that are already paths.\n req.jsExtRegExp = /^\\/|:|\\?|\\.js$/;\n req.isBrowser = isBrowser;\n s = req.s = {\n contexts: contexts,\n newContext: newContext\n };\n\n //Create default context.\n req({});\n\n //Exports some context-sensitive methods on global require.\n each([\n 'toUrl',\n 'undef',\n 'defined',\n 'specified'\n ], function (prop) {\n //Reference from contexts instead of early binding to default context,\n //so that during builds, the latest instance of the default context\n //with its config gets used.\n req[prop] = function () {\n var ctx = contexts[defContextName];\n return ctx.require[prop].apply(ctx, arguments);\n };\n });\n\n if (isBrowser) {\n head = s.head = document.getElementsByTagName('head')[0];\n //If BASE tag is in play, using appendChild is a problem for IE6.\n //When that browser dies, this can be removed. Details in this jQuery bug:\n //http://dev.jquery.com/ticket/2709\n baseElement = document.getElementsByTagName('base')[0];\n if (baseElement) {\n head = s.head = baseElement.parentNode;\n }\n }\n\n /**\n * Any errors that require explicitly generates will be passed to this\n * function. Intercept/override it if you want custom error handling.\n * @param {Error} err the error object.\n */\n req.onError = defaultOnError;\n\n /**\n * Creates the node for the load command. Only used in browser envs.\n */\n req.createNode = function (config, moduleName, url) {\n var node = config.xhtml ?\n document.createElementNS('http://www.w3.org/1999/xhtml', 'html:script') :\n document.createElement('script');\n node.type = config.scriptType || 'text/javascript';\n node.charset = 'utf-8';\n node.async = true;\n return node;\n };\n\n /**\n * Does the request to load a module for the browser case.\n * Make this a separate function to allow other environments\n * to override it.\n *\n * @param {Object} context the require context to find state.\n * @param {String} moduleName the name of the module.\n * @param {Object} url the URL to the module.\n */\n req.load = function (context, moduleName, url) {\n var config = (context && context.config) || {},\n node;\n if (isBrowser) {\n //In the browser so use a script tag\n node = req.createNode(config, moduleName, url);\n\n node.setAttribute('data-requirecontext', context.contextName);\n node.setAttribute('data-requiremodule', moduleName);\n\n //Set up load listener. Test attachEvent first because IE9 has\n //a subtle issue in its addEventListener and script onload firings\n //that do not match the behavior of all other browsers with\n //addEventListener support, which fire the onload event for a\n //script right after the script execution. See:\n //https://connect.microsoft.com/IE/feedback/details/648057/script-onload-event-is-not-fired-immediately-after-script-execution\n //UNFORTUNATELY Opera implements attachEvent but does not follow the script\n //script execution mode.\n if (node.attachEvent &&\n //Check if node.attachEvent is artificially added by custom script or\n //natively supported by browser\n //read https://github.com/requirejs/requirejs/issues/187\n //if we can NOT find [native code] then it must NOT natively supported.\n //in IE8, node.attachEvent does not have toString()\n //Note the test for \"[native code\" with no closing brace, see:\n //https://github.com/requirejs/requirejs/issues/273\n !(node.attachEvent.toString && node.attachEvent.toString().indexOf('[native code') < 0) &&\n !isOpera) {\n //Probably IE. IE (at least 6-8) do not fire\n //script onload right after executing the script, so\n //we cannot tie the anonymous define call to a name.\n //However, IE reports the script as being in 'interactive'\n //readyState at the time of the define call.\n useInteractive = true;\n\n node.attachEvent('onreadystatechange', context.onScriptLoad);\n //It would be great to add an error handler here to catch\n //404s in IE9+. However, onreadystatechange will fire before\n //the error handler, so that does not help. If addEventListener\n //is used, then IE will fire error before load, but we cannot\n //use that pathway given the connect.microsoft.com issue\n //mentioned above about not doing the 'script execute,\n //then fire the script load event listener before execute\n //next script' that other browsers do.\n //Best hope: IE10 fixes the issues,\n //and then destroys all installs of IE 6-9.\n //node.attachEvent('onerror', context.onScriptError);\n } else {\n node.addEventListener('load', context.onScriptLoad, false);\n node.addEventListener('error', context.onScriptError, false);\n }\n node.src = url;\n\n //Calling onNodeCreated after all properties on the node have been\n //set, but before it is placed in the DOM.\n if (config.onNodeCreated) {\n config.onNodeCreated(node, config, moduleName, url);\n }\n\n //For some cache cases in IE 6-8, the script executes before the end\n //of the appendChild execution, so to tie an anonymous define\n //call to the module name (which is stored on the node), hold on\n //to a reference to this node, but clear after the DOM insertion.\n currentlyAddingScript = node;\n if (baseElement) {\n head.insertBefore(node, baseElement);\n } else {\n head.appendChild(node);\n }\n currentlyAddingScript = null;\n\n return node;\n } else if (isWebWorker) {\n try {\n //In a web worker, use importScripts. This is not a very\n //efficient use of importScripts, importScripts will block until\n //its script is downloaded and evaluated. However, if web workers\n //are in play, the expectation is that a build has been done so\n //that only one script needs to be loaded anyway. This may need\n //to be reevaluated if other use cases become common.\n\n // Post a task to the event loop to work around a bug in WebKit\n // where the worker gets garbage-collected after calling\n // importScripts(): https://webkit.org/b/153317\n setTimeout(function() {}, 0);\n importScripts(url);\n\n //Account for anonymous modules\n context.completeLoad(moduleName);\n } catch (e) {\n context.onError(makeError('importscripts',\n 'importScripts failed for ' +\n moduleName + ' at ' + url,\n e,\n [moduleName]));\n }\n }\n };\n\n function getInteractiveScript() {\n if (interactiveScript && interactiveScript.readyState === 'interactive') {\n return interactiveScript;\n }\n\n eachReverse(scripts(), function (script) {\n if (script.readyState === 'interactive') {\n return (interactiveScript = script);\n }\n });\n return interactiveScript;\n }\n\n //Look for a data-main script attribute, which could also adjust the baseUrl.\n if (isBrowser && !cfg.skipDataMain) {\n //Figure out baseUrl. Get it from the script tag with require.js in it.\n eachReverse(scripts(), function (script) {\n //Set the 'head' where we can append children by\n //using the script's parent.\n if (!head) {\n head = script.parentNode;\n }\n\n //Look for a data-main attribute to set main script for the page\n //to load. If it is there, the path to data main becomes the\n //baseUrl, if it is not already set.\n dataMain = script.getAttribute('data-main');\n if (dataMain) {\n //Preserve dataMain in case it is a path (i.e. contains '?')\n mainScript = dataMain;\n\n //Set final baseUrl if there is not already an explicit one,\n //but only do so if the data-main value is not a loader plugin\n //module ID.\n if (!cfg.baseUrl && mainScript.indexOf('!') === -1) {\n //Pull off the directory of data-main for use as the\n //baseUrl.\n src = mainScript.split('/');\n mainScript = src.pop();\n subPath = src.length ? src.join('/') + '/' : './';\n\n cfg.baseUrl = subPath;\n }\n\n //Strip off any trailing .js since mainScript is now\n //like a module name.\n mainScript = mainScript.replace(jsSuffixRegExp, '');\n\n //If mainScript is still a path, fall back to dataMain\n if (req.jsExtRegExp.test(mainScript)) {\n mainScript = dataMain;\n }\n\n //Put the data-main script in the files to load.\n cfg.deps = cfg.deps ? cfg.deps.concat(mainScript) : [mainScript];\n\n return true;\n }\n });\n }\n\n /**\n * The function that handles definitions of modules. Differs from\n * require() in that a string for the module should be the first argument,\n * and the function to execute after dependencies are loaded should\n * return a value to define the module corresponding to the first argument's\n * name.\n */\n define = function (name, deps, callback) {\n var node, context;\n\n //Allow for anonymous modules\n if (typeof name !== 'string') {\n //Adjust args appropriately\n callback = deps;\n deps = name;\n name = null;\n }\n\n //This module may not have dependencies\n if (!isArray(deps)) {\n callback = deps;\n deps = null;\n }\n\n //If no name, and callback is a function, then figure out if it a\n //CommonJS thing with dependencies.\n if (!deps && isFunction(callback)) {\n deps = [];\n //Remove comments from the callback string,\n //look for require calls, and pull them into the dependencies,\n //but only if there are function args.\n if (callback.length) {\n callback\n .toString()\n .replace(commentRegExp, commentReplace)\n .replace(cjsRequireRegExp, function (match, dep) {\n deps.push(dep);\n });\n\n //May be a CommonJS thing even without require calls, but still\n //could use exports, and module. Avoid doing exports and module\n //work though if it just needs require.\n //REQUIRES the function to expect the CommonJS variables in the\n //order listed below.\n deps = (callback.length === 1 ? ['require'] : ['require', 'exports', 'module']).concat(deps);\n }\n }\n\n //If in IE 6-8 and hit an anonymous define() call, do the interactive\n //work.\n if (useInteractive) {\n node = currentlyAddingScript || getInteractiveScript();\n if (node) {\n if (!name) {\n name = node.getAttribute('data-requiremodule');\n }\n context = contexts[node.getAttribute('data-requirecontext')];\n }\n }\n\n //Always save off evaluating the def call until the script onload handler.\n //This allows multiple modules to be in a file without prematurely\n //tracing dependencies, and allows for anonymous module support,\n //where the module name is not known until the script onload event\n //occurs. If no context, use the global queue, and get it processed\n //in the onscript load callback.\n if (context) {\n context.defQueue.push([name, deps, callback]);\n context.defQueueMap[name] = true;\n } else {\n globalDefQueue.push([name, deps, callback]);\n }\n };\n\n define.amd = {\n jQuery: true\n };\n\n /**\n * Executes the text. Normally just uses eval, but can be modified\n * to use a better, environment-specific call. Only used for transpiling\n * loader plugins, not for plain JS modules.\n * @param {String} text the text to execute/evaluate.\n */\n req.exec = function (text) {\n /*jslint evil: true */\n return eval(text);\n };\n\n //Set up with config info.\n req(cfg);\n}(this, (typeof setTimeout === 'undefined' ? undefined : setTimeout)));\n\ndefine(\"deps/require\", function(){});\n\n", + "var hyperHTML = (function (global) {\n 'use strict';\n\n var G = document.defaultView;\n\n // Node.CONSTANTS\n // 'cause some engine has no global Node defined\n // (i.e. Node, NativeScript, basicHTML ... )\n var ELEMENT_NODE = 1;\n var TEXT_NODE = 3;\n var COMMENT_NODE = 8;\n var DOCUMENT_FRAGMENT_NODE = 11;\n\n // HTML related constants\n var VOID_ELEMENTS = /^area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|source|track|wbr$/i;\n\n // SVG related constants\n var OWNER_SVG_ELEMENT = 'ownerSVGElement';\n var SVG_NAMESPACE = 'http://www.w3.org/2000/svg';\n\n // Custom Elements / MutationObserver constants\n var CONNECTED = 'connected';\n var DISCONNECTED = 'dis' + CONNECTED;\n\n // hyperHTML related constants\n var EXPANDO = '_hyper: ';\n var SHOULD_USE_TEXT_CONTENT = /^style|textarea$/i;\n var UID = EXPANDO + (Math.random() * new Date() | 0) + ';';\n var UIDC = '';\n\n // you know that kind of basics you need to cover\n // your use case only but you don't want to bloat the library?\n // There's even a package in here:\n // https://www.npmjs.com/package/poorlyfills\n\n // used to dispatch simple events\n var Event = G.Event;\n try {\n new Event('Event');\n } catch (o_O) {\n Event = function Event(type) {\n var e = document.createEvent('Event');\n e.initEvent(type, false, false);\n return e;\n };\n }\n\n // used to store template literals\n /* istanbul ignore next */\n var Map = G.Map || function Map() {\n var keys = [],\n values = [];\n return {\n get: function get(obj) {\n return values[keys.indexOf(obj)];\n },\n set: function set(obj, value) {\n values[keys.push(obj) - 1] = value;\n }\n };\n };\n\n // used to store wired content\n var ID = 0;\n var WeakMap = G.WeakMap || function WeakMap() {\n var key = UID + ID++;\n return {\n get: function get(obj) {\n return obj[key];\n },\n set: function set(obj, value) {\n Object.defineProperty(obj, key, {\n configurable: true,\n value: value\n });\n }\n };\n };\n\n // used to store hyper.Components\n var WeakSet = G.WeakSet || function WeakSet() {\n var wm = new WeakMap();\n return {\n add: function add(obj) {\n wm.set(obj, true);\n },\n has: function has(obj) {\n return wm.get(obj) === true;\n }\n };\n };\n\n // used to be sure IE9 or older Androids work as expected\n var isArray = Array.isArray || function (toString) {\n return function (arr) {\n return toString.call(arr) === '[object Array]';\n };\n }({}.toString);\n\n var trim = UID.trim || function () {\n return this.replace(/^\\s+|\\s+$/g, '');\n };\n\n // hyperHTML.Component is a very basic class\n // able to create Custom Elements like components\n // including the ability to listen to connect/disconnect\n // events via onconnect/ondisconnect attributes\n // Components can be created imperatively or declaratively.\n // The main difference is that declared components\n // will not automatically render on setState(...)\n // to simplify state handling on render.\n function Component() {\n return this; // this is needed in Edge !!!\n }\n\n // Component is lazily setup because it needs\n // wire mechanism as lazy content\n function setup(content) {\n // there are various weakly referenced variables in here\n // and mostly are to use Component.for(...) static method.\n var children = new WeakMap();\n var create = Object.create;\n var createEntry = function createEntry(wm, id, component) {\n wm.set(id, component);\n return component;\n };\n var get = function get(Class, info, context, id) {\n var relation = info.get(Class) || relate(Class, info);\n switch (typeof id) {\n case 'object':\n case 'function':\n var wm = relation.w || (relation.w = new WeakMap());\n return wm.get(id) || createEntry(wm, id, new Class(context));\n default:\n var sm = relation.p || (relation.p = create(null));\n return sm[id] || (sm[id] = new Class(context));\n }\n };\n var relate = function relate(Class, info) {\n var relation = { w: null, p: null };\n info.set(Class, relation);\n return relation;\n };\n var set = function set(context) {\n var info = new Map();\n children.set(context, info);\n return info;\n };\n // The Component Class\n Object.defineProperties(Component, {\n // Component.for(context[, id]) is a convenient way\n // to automatically relate data/context to children components\n // If not created yet, the new Component(context) is weakly stored\n // and after that same instance would always be returned.\n for: {\n configurable: true,\n value: function value(context, id) {\n return get(this, children.get(context) || set(context), context, id == null ? 'default' : id);\n }\n }\n });\n Object.defineProperties(Component.prototype, {\n // all events are handled with the component as context\n handleEvent: {\n value: function value(e) {\n var ct = e.currentTarget;\n this['getAttribute' in ct && ct.getAttribute('data-call') || 'on' + e.type](e);\n }\n },\n // components will lazily define html or svg properties\n // as soon as these are invoked within the .render() method\n // Such render() method is not provided by the base class\n // but it must be available through the Component extend.\n // Declared components could implement a\n // render(props) method too and use props as needed.\n html: lazyGetter('html', content),\n svg: lazyGetter('svg', content),\n // the state is a very basic/simple mechanism inspired by Preact\n state: lazyGetter('state', function () {\n return this.defaultState;\n }),\n // it is possible to define a default state that'd be always an object otherwise\n defaultState: {\n get: function get() {\n return {};\n }\n },\n // setting some property state through a new object\n // or a callback, triggers also automatically a render\n // unless explicitly specified to not do so (render === false)\n setState: {\n value: function value(state, render) {\n var target = this.state;\n var source = typeof state === 'function' ? state.call(this, target) : state;\n for (var key in source) {\n target[key] = source[key];\n }if (render !== false) this.render();\n return this;\n }\n }\n });\n }\n\n // instead of a secret key I could've used a WeakMap\n // However, attaching a property directly will result\n // into better performance with thousands of components\n // hanging around, and less memory pressure caused by the WeakMap\n var lazyGetter = function lazyGetter(type, fn) {\n var secret = '_' + type + '$';\n return {\n get: function get() {\n return this[secret] || (this[type] = fn.call(this, type));\n },\n set: function set(value) {\n Object.defineProperty(this, secret, { configurable: true, value: value });\n }\n };\n };\n\n var intents = {};\n var keys = [];\n var hasOwnProperty = intents.hasOwnProperty;\n\n var length = 0;\n\n var Intent = {\n\n // hyperHTML.define('intent', (object, update) => {...})\n // can be used to define a third parts update mechanism\n // when every other known mechanism failed.\n // hyper.define('user', info => info.name);\n // hyper(node)`

      ${{user}}

      `;\n define: function define(intent, callback) {\n if (!(intent in intents)) {\n length = keys.push(intent);\n }\n intents[intent] = callback;\n },\n\n // this method is used internally as last resort\n // to retrieve a value out of an object\n invoke: function invoke(object, callback) {\n for (var i = 0; i < length; i++) {\n var key = keys[i];\n if (hasOwnProperty.call(object, key)) {\n return intents[key](object[key], callback);\n }\n }\n }\n };\n\n // these are tiny helpers to simplify most common operations needed here\n var create = function create(node, type) {\n return doc(node).createElement(type);\n };\n var doc = function doc(node) {\n return node.ownerDocument || node;\n };\n var fragment = function fragment(node) {\n return doc(node).createDocumentFragment();\n };\n var text = function text(node, _text) {\n return doc(node).createTextNode(_text);\n };\n\n // TODO: I'd love to code-cover RegExp too here\n // these are fundamental for this library\n\n var spaces = ' \\\\f\\\\n\\\\r\\\\t';\n var almostEverything = '[^ ' + spaces + '\\\\/>\"\\'=]+';\n var attrName = '[ ' + spaces + ']+' + almostEverything;\n var tagName = '<([A-Za-z]+[A-Za-z0-9:_-]*)((?:';\n var attrPartials = '(?:=(?:\\'[^\\']*?\\'|\"[^\"]*?\"|<[^>]*?>|' + almostEverything + '))?)';\n\n var attrSeeker = new RegExp(tagName + attrName + attrPartials + '+)([ ' + spaces + ']*/?>)', 'g');\n\n var selfClosing = new RegExp(tagName + attrName + attrPartials + '*)([ ' + spaces + ']*/>)', 'g');\n\n var testFragment = fragment(document);\n\n // DOM4 node.append(...many)\n var hasAppend = 'append' in testFragment;\n\n // detect old browsers without HTMLTemplateElement content support\n var hasContent = 'content' in create(document, 'template');\n\n // IE 11 has problems with cloning templates: it \"forgets\" empty childNodes\n testFragment.appendChild(text(testFragment, 'g'));\n testFragment.appendChild(text(testFragment, ''));\n var hasDoomedCloneNode = testFragment.cloneNode(true).childNodes.length === 1;\n\n // old browsers need to fallback to cloneNode\n // Custom Elements V0 and V1 will work polyfilled\n // but native implementations need importNode instead\n // (specially Chromium and its old V0 implementation)\n var hasImportNode = 'importNode' in document;\n\n // appends an array of nodes\n // to a generic node/fragment\n // When available, uses append passing all arguments at once\n // hoping that's somehow faster, even if append has more checks on type\n var append = hasAppend ? function (node, childNodes) {\n node.append.apply(node, childNodes);\n } : function (node, childNodes) {\n var length = childNodes.length;\n for (var i = 0; i < length; i++) {\n node.appendChild(childNodes[i]);\n }\n };\n\n var findAttributes = new RegExp('(' + attrName + '=)([\\'\"]?)' + UIDC + '\\\\2', 'gi');\n var comments = function comments($0, $1, $2, $3) {\n return '<' + $1 + $2.replace(findAttributes, replaceAttributes) + $3;\n };\n var replaceAttributes = function replaceAttributes($0, $1, $2) {\n return $1 + ($2 || '\"') + UID + ($2 || '\"');\n };\n\n // given a node and a generic HTML content,\n // create either an SVG or an HTML fragment\n // where such content will be injected\n var createFragment = function createFragment(node, html) {\n return (OWNER_SVG_ELEMENT in node ? SVGFragment : HTMLFragment)(node, html.replace(attrSeeker, comments));\n };\n\n // IE/Edge shenanigans proof cloneNode\n // it goes through all nodes manually\n // instead of relying the engine to suddenly\n // merge nodes together\n var cloneNode = hasDoomedCloneNode ? function (node) {\n var clone = node.cloneNode();\n var childNodes = node.childNodes ||\n // this is an excess of caution\n // but some node, in IE, might not\n // have childNodes property.\n // The following fallback ensure working code\n // in older IE without compromising performance\n // or any other browser/engine involved.\n /* istanbul ignore next */\n [];\n var length = childNodes.length;\n for (var i = 0; i < length; i++) {\n clone.appendChild(cloneNode(childNodes[i]));\n }\n return clone;\n } :\n // the following ignore is due code-coverage\n // combination of not having document.importNode\n // but having a working node.cloneNode.\n // This shenario is common on older Android/WebKit browsers\n // but basicHTML here tests just two major cases:\n // with document.importNode or with broken cloneNode.\n /* istanbul ignore next */\n function (node) {\n return node.cloneNode(true);\n };\n\n // used to import html into fragments\n var importNode = hasImportNode ? function (doc$$1, node) {\n return doc$$1.importNode(node, true);\n } : function (doc$$1, node) {\n return cloneNode(node);\n };\n\n // just recycling a one-off array to use slice\n // in every needed place\n var slice = [].slice;\n\n // lazy evaluated, returns the unique identity\n // of a template literal, as tempalte literal itself.\n // By default, ES2015 template literals are unique\n // tag`a${1}z` === tag`a${2}z`\n // even if interpolated values are different\n // the template chunks are in a frozen Array\n // that is identical each time you use the same\n // literal to represent same static content\n // around its own interpolations.\n var unique = function unique(template) {\n return _TL(template);\n };\n\n // TL returns a unique version of the template\n // it needs lazy feature detection\n // (cannot trust literals with transpiled code)\n var _TL = function TL(template) {\n if (\n // TypeScript template literals are not standard\n template.propertyIsEnumerable('raw') ||\n // Firefox < 55 has not standard implementation neither\n /Firefox\\/(\\d+)/.test((G.navigator || {}).userAgent) && parseFloat(RegExp.$1) < 55) {\n // in these cases, address templates once\n var templateObjects = {};\n // but always return the same template\n _TL = function TL(template) {\n var key = '_' + template.join(UID);\n return templateObjects[key] || (templateObjects[key] = template);\n };\n } else {\n // make TL an identity like function\n _TL = function TL(template) {\n return template;\n };\n }\n return _TL(template);\n };\n\n // create document fragments via native template\n // with a fallback for browsers that won't be able\n // to deal with some injected element such or others\n var HTMLFragment = hasContent ? function (node, html) {\n var container = create(node, 'template');\n container.innerHTML = html;\n return container.content;\n } : function (node, html) {\n var container = create(node, 'template');\n var content = fragment(node);\n if (/^[^\\S]*?<(col(?:group)?|t(?:head|body|foot|r|d|h))/i.test(html)) {\n var selector = RegExp.$1;\n container.innerHTML = '' + html + '
      ';\n append(content, slice.call(container.querySelectorAll(selector)));\n } else {\n container.innerHTML = html;\n append(content, slice.call(container.childNodes));\n }\n return content;\n };\n\n // creates SVG fragment with a fallback for IE that needs SVG\n // within the HTML content\n var SVGFragment = hasContent ? function (node, html) {\n var content = fragment(node);\n var container = doc(node).createElementNS(SVG_NAMESPACE, 'svg');\n container.innerHTML = html;\n append(content, slice.call(container.childNodes));\n return content;\n } : function (node, html) {\n var content = fragment(node);\n var container = create(node, 'div');\n container.innerHTML = '' + html + '';\n append(content, slice.call(container.firstChild.childNodes));\n return content;\n };\n\n function Wire(childNodes) {\n this.childNodes = childNodes;\n this.length = childNodes.length;\n this.first = childNodes[0];\n this.last = childNodes[this.length - 1];\n }\n\n // when a wire is inserted, all its nodes will follow\n Wire.prototype.insert = function insert() {\n var df = fragment(this.first);\n append(df, this.childNodes);\n return df;\n };\n\n // when a wire is removed, all its nodes must be removed as well\n Wire.prototype.remove = function remove() {\n var first = this.first;\n var last = this.last;\n if (this.length === 2) {\n last.parentNode.removeChild(last);\n } else {\n var range = doc(first).createRange();\n range.setStartBefore(this.childNodes[1]);\n range.setEndAfter(last);\n range.deleteContents();\n }\n return first;\n };\n\n // every template literal interpolation indicates\n // a precise target in the DOM the template is representing.\n // `

      some ${'content'}

      `\n // hyperHTML finds only once per template literal,\n // hence once per entire application life-cycle,\n // all nodes that are related to interpolations.\n // These nodes are stored as indexes used to retrieve,\n // once per upgrade, nodes that will change on each future update.\n // A path example is [2, 0, 1] representing the operation:\n // node.childNodes[2].childNodes[0].childNodes[1]\n // Attributes are addressed via their owner node and their name.\n var createPath = function createPath(node) {\n var path = [];\n var parentNode = void 0;\n switch (node.nodeType) {\n case ELEMENT_NODE:\n case DOCUMENT_FRAGMENT_NODE:\n parentNode = node;\n break;\n case COMMENT_NODE:\n parentNode = node.parentNode;\n prepend(path, parentNode, node);\n break;\n default:\n parentNode = node.ownerElement;\n break;\n }\n for (node = parentNode; parentNode = parentNode.parentNode; node = parentNode) {\n prepend(path, parentNode, node);\n }\n return path;\n };\n\n var prepend = function prepend(path, parent, node) {\n path.unshift(path.indexOf.call(parent.childNodes, node));\n };\n\n var Path = {\n create: function create(type, node, name) {\n return { type: type, name: name, node: node, path: createPath(node) };\n },\n find: function find(node, path) {\n var length = path.length;\n for (var i = 0; i < length; i++) {\n node = node.childNodes[path[i]];\n }\n return node;\n }\n };\n\n // from https://github.com/developit/preact/blob/33fc697ac11762a1cb6e71e9847670d047af7ce5/src/constants.js\n var IS_NON_DIMENSIONAL = /acit|ex(?:s|g|n|p|$)|rph|ows|mnc|ntw|ine[ch]|zoo|^ord/i;\n\n // style is handled as both string and object\n // even if the target is an SVG element (consistency)\n var Style = (function (node, original, isSVG) {\n if (isSVG) {\n var style = original.cloneNode(true);\n style.value = '';\n node.setAttributeNode(style);\n return update(style, isSVG);\n }\n return update(node.style, isSVG);\n });\n\n // the update takes care or changing/replacing\n // only properties that are different or\n // in case of string, the whole node\n var update = function update(style, isSVG) {\n var oldType = void 0,\n oldValue = void 0;\n return function (newValue) {\n switch (typeof newValue) {\n case 'object':\n if (newValue) {\n if (oldType === 'object') {\n if (!isSVG) {\n if (oldValue !== newValue) {\n for (var key in oldValue) {\n if (!(key in newValue)) {\n style[key] = '';\n }\n }\n }\n }\n } else {\n if (isSVG) style.value = '';else style.cssText = '';\n }\n var info = isSVG ? {} : style;\n for (var _key in newValue) {\n var value = newValue[_key];\n info[_key] = typeof value === 'number' && !IS_NON_DIMENSIONAL.test(_key) ? value + 'px' : value;\n }\n oldType = 'object';\n if (isSVG) style.value = toStyle(oldValue = info);else oldValue = newValue;\n break;\n }\n default:\n if (oldValue != newValue) {\n oldType = 'string';\n oldValue = newValue;\n if (isSVG) style.value = newValue || '';else style.cssText = newValue || '';\n }\n break;\n }\n };\n };\n\n var hyphen = /([^A-Z])([A-Z]+)/g;\n var ized = function ized($0, $1, $2) {\n return $1 + '-' + $2.toLowerCase();\n };\n var toStyle = function toStyle(object) {\n var css = [];\n for (var key in object) {\n css.push(key.replace(hyphen, ized), ':', object[key], ';');\n }\n return css.join('');\n };\n\n /* AUTOMATICALLY IMPORTED, DO NOT MODIFY */\n /*! (c) 2017 Andrea Giammarchi (ISC) */\n\n /**\n * This code is a revisited port of the snabbdom vDOM diffing logic,\n * the same that fuels as fork Vue.js or other libraries.\n * @credits https://github.com/snabbdom/snabbdom\n */\n\n var identity = function identity(O) {\n return O;\n };\n\n var remove = function remove(parentNode, before, after) {\n var range = parentNode.ownerDocument.createRange();\n range.setStartBefore(before);\n range.setEndAfter(after);\n range.deleteContents();\n };\n\n var domdiff = function domdiff(parentNode, // where changes happen\n currentNodes, // Array of current items/nodes\n futureNodes, // Array of future items/nodes\n getNode, // optional way to retrieve a node from an item\n beforeNode // optional item/node to use as insertBefore delimiter\n ) {\n var get = getNode || identity;\n var before = beforeNode == null ? null : get(beforeNode, 0);\n var currentStart = 0,\n futureStart = 0;\n var currentEnd = currentNodes.length - 1;\n var currentStartNode = currentNodes[0];\n var currentEndNode = currentNodes[currentEnd];\n var futureEnd = futureNodes.length - 1;\n var futureStartNode = futureNodes[0];\n var futureEndNode = futureNodes[futureEnd];\n while (currentStart <= currentEnd && futureStart <= futureEnd) {\n if (currentStartNode == null) {\n currentStartNode = currentNodes[++currentStart];\n } else if (currentEndNode == null) {\n currentEndNode = currentNodes[--currentEnd];\n } else if (futureStartNode == null) {\n futureStartNode = futureNodes[++futureStart];\n } else if (futureEndNode == null) {\n futureEndNode = futureNodes[--futureEnd];\n } else if (currentStartNode == futureStartNode) {\n currentStartNode = currentNodes[++currentStart];\n futureStartNode = futureNodes[++futureStart];\n } else if (currentEndNode == futureEndNode) {\n currentEndNode = currentNodes[--currentEnd];\n futureEndNode = futureNodes[--futureEnd];\n } else if (currentStartNode == futureEndNode) {\n parentNode.insertBefore(get(currentStartNode, 1), get(currentEndNode, -0).nextSibling);\n currentStartNode = currentNodes[++currentStart];\n futureEndNode = futureNodes[--futureEnd];\n } else if (currentEndNode == futureStartNode) {\n parentNode.insertBefore(get(currentEndNode, 1), get(currentStartNode, 0));\n currentEndNode = currentNodes[--currentEnd];\n futureStartNode = futureNodes[++futureStart];\n } else {\n var index = currentNodes.indexOf(futureStartNode);\n if (index < 0) {\n parentNode.insertBefore(get(futureStartNode, 1), get(currentStartNode, 0));\n futureStartNode = futureNodes[++futureStart];\n } else {\n var i = index;\n var f = futureStart;\n while (i <= currentEnd && f <= futureEnd && currentNodes[i] === futureNodes[f]) {\n i++;\n f++;\n }\n if (1 < i - index) {\n if (--index === currentStart) {\n parentNode.removeChild(get(currentStartNode, -1));\n } else {\n remove(parentNode, get(currentStartNode, -1), get(currentNodes[index], -1));\n }\n currentStart = i;\n futureStart = f;\n currentStartNode = currentNodes[i];\n futureStartNode = futureNodes[f];\n } else {\n var el = currentNodes[index];\n currentNodes[index] = null;\n parentNode.insertBefore(get(el, 1), get(currentStartNode, 0));\n futureStartNode = futureNodes[++futureStart];\n }\n }\n }\n }\n if (currentStart <= currentEnd || futureStart <= futureEnd) {\n if (currentStart > currentEnd) {\n var pin = futureNodes[futureEnd + 1];\n var place = pin == null ? before : get(pin, 0);\n if (futureStart === futureEnd) {\n parentNode.insertBefore(get(futureNodes[futureStart], 1), place);\n } else {\n var fragment = parentNode.ownerDocument.createDocumentFragment();\n while (futureStart <= futureEnd) {\n fragment.appendChild(get(futureNodes[futureStart++], 1));\n }\n parentNode.insertBefore(fragment, place);\n }\n } else {\n if (currentNodes[currentStart] == null) currentStart++;\n if (currentStart === currentEnd) {\n parentNode.removeChild(get(currentNodes[currentStart], -1));\n } else {\n remove(parentNode, get(currentNodes[currentStart], -1), get(currentNodes[currentEnd], -1));\n }\n }\n }\n return futureNodes;\n };\n\n // hyper.Component have a connected/disconnected\n // mechanism provided by MutationObserver\n // This weak set is used to recognize components\n // as DOM node that needs to trigger connected/disconnected events\n var components = new WeakSet();\n\n // a basic dictionary used to filter already cached attributes\n // while looking for special hyperHTML values.\n function Cache() {}\n Cache.prototype = Object.create(null);\n\n // returns an intent to explicitly inject content as html\n var asHTML = function asHTML(html) {\n return { html: html };\n };\n\n // returns nodes from wires and components\n var asNode = function asNode(item, i) {\n return 'ELEMENT_NODE' in item ? item : item.constructor === Wire ?\n // in the Wire case, the content can be\n // removed, post-pended, inserted, or pre-pended and\n // all these cases are handled by domdiff already\n /* istanbul ignore next */\n 1 / i < 0 ? i ? item.remove() : item.last : i ? item.insert() : item.first : asNode(item.render(), i);\n };\n\n // returns true if domdiff can handle the value\n var canDiff = function canDiff(value) {\n return 'ELEMENT_NODE' in value || value instanceof Wire || value instanceof Component;\n };\n\n // updates are created once per context upgrade\n // within the main render function (../hyper/render.js)\n // These are an Array of callbacks to invoke passing\n // each interpolation value.\n // Updates can be related to any kind of content,\n // attributes, or special text-only cases such `, headElem.querySelector(\"link\"));\n handleIssues(issuesAndNotes, ghIssues, conf);\n }\n});\n//# sourceMappingURL=issues-notes.js.map;\n", + "define('core/requirements',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"core/requirements\"; // Module core/requirements\n // This module does two things:\n //\n // 1. It finds and marks all requirements. These are elements with class \"req\".\n // When a requirement is found, it is reported using the \"req\" event. This\n // can be used by a containing shell to extract them.\n // Requirements are automatically numbered.\n //\n // 2. It allows referencing requirements by their ID simply using an empty \n // element with its href pointing to the requirement it should be referencing\n // and a class of \"reqRef\".\n function run(conf, doc, cb) {\n $(\".req\").each(function (i) {\n i++;\n var $req = $(this);\n var title = \"Req. \" + i;\n $req.prepend(\"\" + title + \": \");\n });\n\n $(\"a.reqRef\").each(function () {\n var $ref = $(this),\n href = $ref.attr(\"href\"),\n id,\n $req,\n txt;\n if (!href) return;\n id = href.substring(1);\n $req = $(\"#\" + id);\n if ($req.length) {\n txt = $req.find(\"> a\").text();\n } else {\n txt = \"Req. not found '\" + id + \"'\";\n (0, _pubsubhub.pub)(\"error\", \"Requirement not found in element `a.reqRef`: \" + id);\n }\n $ref.text(txt);\n });\n cb();\n }\n});\n//# sourceMappingURL=requirements.js.map;\n", + "\ndefine('deps/text!core/css/bp.css',[],function () { return '/* --- Best Practices --- */\\ndiv.practice {\\n border: solid #bebebe 1px;\\n margin: 2em 1em 1em 2em;\\n}\\n\\nspan.practicelab {\\n margin: 1.5em 0.5em 1em 1em;\\n font-weight: bold;\\n font-style: italic;\\n background: #dfffff;\\n position: relative;\\n padding: 0 0.5em;\\n top: -1.5em;\\n}\\n\\np.practicedesc {\\n margin: 1.5em 0.5em 1em 1em;\\n}\\n\\n@media screen {\\n p.practicedesc {\\n position: relative;\\n top: -2em;\\n padding: 0;\\n margin: 1.5em 0.5em -1em 1em;\\n }\\n}\\n';});\n\n", + "define('core/best-practices',[\"exports\", \"deps/text!core/css/bp.css\", \"core/pubsubhub\", \"deps/hyperhtml\"], function (exports, _bp, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _bp2 = _interopRequireDefault(_bp);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n const name = exports.name = \"core/best-practices\"; // Module core/best-practices\n // Handles the marking up of best practices, and can generate a summary of all of them.\n // The summary is generated if there is a section in the document with ID bp-summary.\n // Best practices are marked up with span.practicelab.\n function run() {\n let num = 0;\n const bps = document.querySelectorAll(\"span.practicelab\");\n const ul = document.createElement(\"ul\");\n for (const bp of Array.from(bps)) {\n num++;\n const id = window.$.fn.makeID.call([bp], \"bp\");\n const li = hyperHTML`
    2. Best Practice ${num}: ${bp.textContent}
    3. `;\n ul.appendChild(li);\n bp.insertBefore(document.createTextNode(`Best Practice ${num}: `), bp.firstChild);\n }\n const bpSummary = document.getElementById(\"bp-summary\");\n if (bps.length) {\n document.head.insertBefore(hyperHTML``, document.head.querySelector(\"link\"));\n if (bpSummary) {\n bpSummary.appendChild(hyperHTML`

      Best Practices Summary

      `);\n bpSummary.appendChild(ul);\n }\n } else if (bpSummary) {\n (0, _pubsubhub.pub)(\"warn\", \"Using best practices summary (#bp-summary) but no best practices found.\");\n bpSummary.remove();\n }\n }\n});\n//# sourceMappingURL=best-practices.js.map;\n", + "define('core/figures',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"core/figures\"; // Module core/figure\n // Handles figures in the document.\n // Adds width and height to images, if they are missing.\n // Generates a Table of Figures wherever there is a #tof element.\n\n function run(conf, doc, cb) {\n normalizeImages(doc);\n // process all figures\n var figMap = {},\n tof = [],\n num = 0;\n $(\"figure\").each(function () {\n var $fig = $(this),\n $cap = $fig.find(\"figcaption\"),\n tit = $cap.text(),\n id = $fig.makeID(\"fig\", tit);\n if (!$cap.length) (0, _pubsubhub.pub)(\"warn\", \"A `
      ` should contain a `
      `.\");\n\n // set proper caption title\n num++;\n $cap.wrapInner($(\"\")).prepend(doc.createTextNode(\" \")).prepend($(\"\" + num + \"\")).prepend(doc.createTextNode(conf.l10n.fig));\n figMap[id] = $cap.contents();\n var $tofCap = $cap.clone();\n $tofCap.find(\"a\").renameElement(\"span\").removeAttr(\"href\");\n tof.push($(\"
    4. \").find(\".tocxref\").append($tofCap.contents()).end());\n });\n\n // Update all anchors with empty content that reference a figure ID\n $(\"a[href]\", doc).each(function () {\n var $a = $(this),\n id = $a.attr(\"href\");\n if (!id) return;\n id = id.substring(1);\n if (figMap[id]) {\n $a.addClass(\"fig-ref\");\n if ($a.html() === \"\") {\n const $shortFigDescriptor = figMap[id].slice(0, 2).clone();\n if (!$a[0].hasAttribute(\"title\")) {\n const longFigDescriptor = figMap[id].slice(2).clone().text();\n $a.attr(\"title\", longFigDescriptor.trim());\n }\n $a.append($shortFigDescriptor);\n }\n }\n });\n\n // Create a Table of Figures if a section with id 'tof' exists.\n var $tof = $(\"#tof\", doc);\n if (tof.length && $tof.length) {\n // if it has a parent section, don't touch it\n // if it has a class of appendix or introductory, don't touch it\n // if all the preceding section siblings are introductory, make it introductory\n // if there is a preceding section sibling which is an appendix, make it appendix\n if (!$tof.hasClass(\"appendix\") && !$tof.hasClass(\"introductory\") && !$tof.parents(\"section\").length) {\n if ($tof.prevAll(\"section.introductory\").length === $tof.prevAll(\"section\").length) {\n $tof.addClass(\"introductory\");\n } else if ($tof.prevAll(\"appendix\").length) {\n $tof.addClass(\"appendix\");\n }\n }\n $tof.append($(\"

      \" + conf.l10n.table_of_fig + \"

      \"));\n $tof.append($(\"
        \"));\n var $ul = $tof.find(\"ul\");\n while (tof.length) $ul.append(tof.shift());\n }\n cb();\n }\n\n function normalizeImages(doc) {\n [...doc.querySelectorAll(\":not(picture)>img:not([width]):not([height]):not([srcset])\")].forEach(img => {\n img.height = img.naturalHeight;\n img.width = img.naturalWidth;\n });\n }\n});\n//# sourceMappingURL=figures.js.map;\n", + "\"use strict\";\r\n\r\n(() => {\r\n // These regular expressions use the sticky flag so they will only match at\r\n // the current location (ie. the offset of lastIndex).\r\n const tokenRe = {\r\n // This expression uses a lookahead assertion to catch false matches\r\n // against integers early.\r\n \"float\": /-?(?=[0-9]*\\.|[0-9]+[eE])(([0-9]+\\.[0-9]*|[0-9]*\\.[0-9]+)([Ee][-+]?[0-9]+)?|[0-9]+[Ee][-+]?[0-9]+)/y,\r\n \"integer\": /-?(0([Xx][0-9A-Fa-f]+|[0-7]*)|[1-9][0-9]*)/y,\r\n \"identifier\": /[A-Z_a-z][0-9A-Z_a-z-]*/y,\r\n \"string\": /\"[^\"]*\"/y,\r\n \"whitespace\": /[\\t\\n\\r ]+/y,\r\n \"comment\": /((\\/(\\/.*|\\*([^*]|\\*[^\\/])*\\*\\/)[\\t\\n\\r ]*)+)/y,\r\n \"other\": /[^\\t\\n\\r 0-9A-Z_a-z]/y\r\n };\r\n\r\n function attemptTokenMatch(str, type, lastIndex, tokens) {\r\n const re = tokenRe[type];\r\n re.lastIndex = lastIndex;\r\n const result = re.exec(str);\r\n if (result) {\r\n tokens.push({ type, value: result[0] });\r\n return re.lastIndex;\r\n }\r\n return -1;\r\n }\r\n\r\n function tokenise(str) {\r\n const tokens = [];\r\n let lastIndex = 0;\r\n while (lastIndex < str.length) {\r\n const nextChar = str.charAt(lastIndex);\r\n let result = -1;\r\n if (/[-0-9.]/.test(nextChar)) {\r\n result = attemptTokenMatch(str, \"float\", lastIndex, tokens);\r\n if (result === -1) {\r\n result = attemptTokenMatch(str, \"integer\", lastIndex, tokens);\r\n }\r\n if (result === -1) {\r\n // '-' and '.' can also match \"other\".\r\n result = attemptTokenMatch(str, \"other\", lastIndex, tokens);\r\n }\r\n } else if (/[A-Z_a-z]/.test(nextChar)) {\r\n result = attemptTokenMatch(str, \"identifier\", lastIndex, tokens);\r\n } else if (nextChar === '\"') {\r\n result = attemptTokenMatch(str, \"string\", lastIndex, tokens);\r\n if (result === -1) {\r\n // '\"' can also match \"other\".\r\n result = attemptTokenMatch(str, \"other\", lastIndex, tokens);\r\n }\r\n } else if (/[\\t\\n\\r ]/.test(nextChar)) {\r\n result = attemptTokenMatch(str, \"whitespace\", lastIndex, tokens);\r\n } else if (nextChar === '/') {\r\n result = attemptTokenMatch(str, \"comment\", lastIndex, tokens);\r\n if (result === -1) {\r\n // '/' can also match \"other\".\r\n result = attemptTokenMatch(str, \"other\", lastIndex, tokens);\r\n }\r\n } else {\r\n result = attemptTokenMatch(str, \"other\", lastIndex, tokens);\r\n }\r\n if (result === -1) {\r\n throw new Error(\"Token stream not progressing\");\r\n }\r\n lastIndex = result;\r\n }\r\n return tokens;\r\n }\r\n\r\n class WebIDLParseError {\r\n constructor(str, line, input, tokens) {\r\n this.message = str;\r\n this.line = line;\r\n this.input = input;\r\n this.tokens = tokens;\r\n }\r\n\r\n toString() {\r\n return `${this.message}, line ${this.line} (tokens: '${this.input}')\\n${JSON.stringify(this.tokens, null, 4)}`;\r\n }\r\n }\r\n\r\n function parse(tokens, opt) {\r\n let line = 1;\r\n tokens = tokens.slice();\r\n const names = new Map();\r\n let current = null;\r\n\r\n const FLOAT = \"float\";\r\n const INT = \"integer\";\r\n const ID = \"identifier\";\r\n const STR = \"string\";\r\n const OTHER = \"other\";\r\n\r\n const EMPTY_OPERATION = Object.freeze({\r\n type: \"operation\",\r\n getter: false,\r\n setter: false,\r\n deleter: false,\r\n static: false,\r\n stringifier: false\r\n });\r\n\r\n const EMPTY_IDLTYPE = Object.freeze({\r\n sequence: false,\r\n generic: null,\r\n nullable: false,\r\n union: false,\r\n idlType: null,\r\n extAttrs: []\r\n });\r\n\r\n function error(str) {\r\n let tok = \"\";\r\n let numTokens = 0;\r\n const maxTokens = 5;\r\n while (numTokens < maxTokens && tokens.length > numTokens) {\r\n tok += tokens[numTokens].value;\r\n numTokens++;\r\n }\r\n\r\n let message;\r\n if (current) {\r\n message = `Got an error during or right after parsing \\`${current.partial ? \"partial \" : \"\"}${current.type} ${current.name}\\`: ${str}`\r\n }\r\n else {\r\n // throwing before any valid definition\r\n message = `Got an error before parsing any named definition: ${str}`;\r\n }\r\n\r\n throw new WebIDLParseError(message, line, tok, tokens.slice(0, maxTokens));\r\n }\r\n\r\n function sanitize_name(name, type) {\r\n if (names.has(name)) {\r\n error(`The name \"${name}\" of type \"${names.get(name)}\" is already seen`);\r\n }\r\n names.set(name, type);\r\n return name;\r\n }\r\n\r\n let last_token = null;\r\n\r\n function consume(type, value) {\r\n if (!tokens.length || tokens[0].type !== type) return;\r\n if (typeof value === \"undefined\" || tokens[0].value === value) {\r\n last_token = tokens.shift();\r\n if (type === ID && last_token.value.startsWith('_'))\r\n last_token.value = last_token.value.substring(1);\r\n return last_token;\r\n }\r\n }\r\n\r\n function count(str, char) {\r\n let total = 0;\r\n for (let i = str.indexOf(char); i !== -1; i = str.indexOf(char, i + 1)) {\r\n ++total;\r\n }\r\n return total;\r\n }\r\n\r\n function ws() {\r\n if (!tokens.length) return;\r\n if (tokens[0].type === \"whitespace\" || tokens[0].type === \"comment\") {\r\n const t = tokens.shift();\r\n line += count(t.value, '\\n');\r\n return t;\r\n }\r\n }\r\n\r\n const all_ws_re = {\r\n \"ws\": /([\\t\\n\\r ]+)/y,\r\n \"line-comment\": /\\/\\/(.*)\\r?\\n?/y,\r\n \"multiline-comment\": /\\/\\*((?:[^*]|\\*[^/])*)\\*\\//y\r\n };\r\n function all_ws(store, pea) { // pea == post extended attribute, tpea = same for types\r\n const t = { type: \"whitespace\", value: \"\" };\r\n while (true) {\r\n const w = ws();\r\n if (!w) break;\r\n t.value += w.value;\r\n }\r\n if (t.value.length > 0) {\r\n if (store) {\r\n let w = t.value;\r\n let lastIndex = 0;\r\n while (lastIndex < w.length) {\r\n let matched = false;\r\n // Servo doesn't support using \"const\" in this construction yet.\r\n // See https://github.com/servo/servo/issues/20231.\r\n // |type| can be made const once Servo supports it.\r\n for (let type in all_ws_re) {\r\n const re = all_ws_re[type];\r\n re.lastIndex = lastIndex;\r\n const result = re.exec(w);\r\n if (result) {\r\n store.push({ type: type + (pea ? (\"-\" + pea) : \"\"), value: result[1] });\r\n matched = true;\r\n lastIndex = re.lastIndex;\r\n break;\r\n }\r\n }\r\n if (!matched)\r\n throw new Error(\"Surprising white space construct.\"); // this shouldn't happen\r\n }\r\n }\r\n return t;\r\n }\r\n }\r\n\r\n function integer_type() {\r\n let ret = \"\";\r\n all_ws();\r\n if (consume(ID, \"unsigned\")) ret = \"unsigned \";\r\n all_ws();\r\n if (consume(ID, \"short\")) return ret + \"short\";\r\n if (consume(ID, \"long\")) {\r\n ret += \"long\";\r\n all_ws();\r\n if (consume(ID, \"long\")) return ret + \" long\";\r\n return ret;\r\n }\r\n if (ret) error(\"Failed to parse integer type\");\r\n }\r\n\r\n function float_type() {\r\n let ret = \"\";\r\n all_ws();\r\n if (consume(ID, \"unrestricted\")) ret = \"unrestricted \";\r\n all_ws();\r\n if (consume(ID, \"float\")) return ret + \"float\";\r\n if (consume(ID, \"double\")) return ret + \"double\";\r\n if (ret) error(\"Failed to parse float type\");\r\n }\r\n\r\n function primitive_type() {\r\n const num_type = integer_type() || float_type();\r\n if (num_type) return num_type;\r\n all_ws();\r\n if (consume(ID, \"boolean\")) return \"boolean\";\r\n if (consume(ID, \"byte\")) return \"byte\";\r\n if (consume(ID, \"octet\")) return \"octet\";\r\n }\r\n\r\n function const_value() {\r\n if (consume(ID, \"true\")) return { type: \"boolean\", value: true };\r\n if (consume(ID, \"false\")) return { type: \"boolean\", value: false };\r\n if (consume(ID, \"null\")) return { type: \"null\" };\r\n if (consume(ID, \"Infinity\")) return { type: \"Infinity\", negative: false };\r\n if (consume(ID, \"NaN\")) return { type: \"NaN\" };\r\n const ret = consume(FLOAT) || consume(INT);\r\n if (ret) return { type: \"number\", value: ret.value };\r\n const tok = consume(OTHER, \"-\");\r\n if (tok) {\r\n if (consume(ID, \"Infinity\")) return { type: \"Infinity\", negative: true };\r\n else tokens.unshift(tok);\r\n }\r\n }\r\n\r\n function type_suffix(obj) {\r\n while (true) {\r\n all_ws();\r\n if (consume(OTHER, \"?\")) {\r\n if (obj.nullable) error(\"Can't nullable more than once\");\r\n obj.nullable = true;\r\n } else return;\r\n }\r\n }\r\n\r\n function single_type(typeName) {\r\n const prim = primitive_type();\r\n const ret = Object.assign({ type: typeName || null }, EMPTY_IDLTYPE);\r\n let name;\r\n let value;\r\n if (prim) {\r\n ret.idlType = prim;\r\n } else if (name = consume(ID)) {\r\n value = name.value;\r\n all_ws();\r\n // Generic types\r\n if (consume(OTHER, \"<\")) {\r\n // backwards compat\r\n if (value === \"sequence\") {\r\n ret.sequence = true;\r\n }\r\n ret.generic = value;\r\n const types = [];\r\n do {\r\n all_ws();\r\n types.push(type_with_extended_attributes(typeName) || error(\"Error parsing generic type \" + value));\r\n all_ws();\r\n }\r\n while (consume(OTHER, \",\"));\r\n if (value === \"sequence\") {\r\n if (types.length !== 1) error(\"A sequence must have exactly one subtype\");\r\n } else if (value === \"record\") {\r\n if (types.length !== 2) error(\"A record must have exactly two subtypes\");\r\n if (!/^(DOMString|USVString|ByteString)$/.test(types[0].idlType)) {\r\n error(\"Record key must be DOMString, USVString, or ByteString\");\r\n }\r\n if (types[0].extAttrs.length) error(\"Record key cannot have extended attribute\");\r\n } else if (value === \"Promise\") {\r\n if (types[0].extAttrs.length) error(\"Promise type cannot have extended attribute\");\r\n }\r\n ret.idlType = types.length === 1 ? types[0] : types;\r\n all_ws();\r\n if (!consume(OTHER, \">\")) error(\"Unterminated generic type \" + value);\r\n type_suffix(ret);\r\n return ret;\r\n } else {\r\n ret.idlType = value;\r\n }\r\n } else {\r\n return;\r\n }\r\n type_suffix(ret);\r\n if (ret.nullable && ret.idlType === \"any\") error(\"Type any cannot be made nullable\");\r\n return ret;\r\n }\r\n\r\n function union_type(typeName) {\r\n all_ws();\r\n if (!consume(OTHER, \"(\")) return;\r\n const ret = Object.assign({ type: typeName || null }, EMPTY_IDLTYPE, { union: true, idlType: [] });\r\n const fst = type_with_extended_attributes() || error(\"Union type with no content\");\r\n ret.idlType.push(fst);\r\n while (true) {\r\n all_ws();\r\n if (!consume(ID, \"or\")) break;\r\n const typ = type_with_extended_attributes() || error(\"No type after 'or' in union type\");\r\n ret.idlType.push(typ);\r\n }\r\n if (!consume(OTHER, \")\")) error(\"Unterminated union type\");\r\n type_suffix(ret);\r\n return ret;\r\n }\r\n\r\n function type(typeName) {\r\n return single_type(typeName) || union_type(typeName);\r\n }\r\n\r\n function type_with_extended_attributes(typeName) {\r\n const extAttrs = extended_attrs();\r\n const ret = single_type(typeName) || union_type(typeName);\r\n if (extAttrs.length && ret) ret.extAttrs = extAttrs;\r\n return ret;\r\n }\r\n\r\n function argument(store) {\r\n const ret = { optional: false, variadic: false };\r\n ret.extAttrs = extended_attrs(store);\r\n all_ws(store, \"pea\");\r\n const opt_token = consume(ID, \"optional\");\r\n if (opt_token) {\r\n ret.optional = true;\r\n all_ws();\r\n }\r\n ret.idlType = type_with_extended_attributes(\"argument-type\");\r\n if (!ret.idlType) {\r\n if (opt_token) tokens.unshift(opt_token);\r\n return;\r\n }\r\n const type_token = last_token;\r\n if (!ret.optional) {\r\n all_ws();\r\n if (tokens.length >= 3 &&\r\n tokens[0].type === \"other\" && tokens[0].value === \".\" &&\r\n tokens[1].type === \"other\" && tokens[1].value === \".\" &&\r\n tokens[2].type === \"other\" && tokens[2].value === \".\"\r\n ) {\r\n tokens.shift();\r\n tokens.shift();\r\n tokens.shift();\r\n ret.variadic = true;\r\n }\r\n }\r\n all_ws();\r\n const name = consume(ID);\r\n if (!name) {\r\n if (opt_token) tokens.unshift(opt_token);\r\n tokens.unshift(type_token);\r\n return;\r\n }\r\n ret.name = name.value;\r\n if (ret.optional) {\r\n all_ws();\r\n const dflt = default_();\r\n if (typeof dflt !== \"undefined\") {\r\n ret[\"default\"] = dflt;\r\n }\r\n }\r\n return ret;\r\n }\r\n\r\n function argument_list(store) {\r\n const ret = [];\r\n const arg = argument(store ? ret : null);\r\n if (!arg) return ret;\r\n ret.push(arg);\r\n while (true) {\r\n all_ws(store ? ret : null);\r\n if (!consume(OTHER, \",\")) return ret;\r\n const nxt = argument(store ? ret : null) || error(\"Trailing comma in arguments list\");\r\n ret.push(nxt);\r\n }\r\n }\r\n\r\n function simple_extended_attr(store) {\r\n all_ws();\r\n const name = consume(ID);\r\n if (!name) return;\r\n const ret = {\r\n name: name.value,\r\n arguments: null,\r\n type: \"extended-attribute\",\r\n rhs: null\r\n };\r\n all_ws();\r\n const eq = consume(OTHER, \"=\");\r\n if (eq) {\r\n all_ws();\r\n ret.rhs = consume(ID) ||\r\n consume(FLOAT) ||\r\n consume(INT) ||\r\n consume(STR);\r\n }\r\n all_ws();\r\n if (consume(OTHER, \"(\")) {\r\n if (eq && !ret.rhs) {\r\n // [Exposed=(Window,Worker)]\r\n ret.rhs = {\r\n type: \"identifier-list\",\r\n value: identifiers()\r\n };\r\n }\r\n else {\r\n // [NamedConstructor=Audio(DOMString src)] or [Constructor(DOMString str)]\r\n ret.arguments = argument_list(store);\r\n }\r\n all_ws();\r\n consume(OTHER, \")\") || error(\"Unexpected token in extended attribute argument list\");\r\n }\r\n if (eq && !ret.rhs) error(\"No right hand side to extended attribute assignment\");\r\n return ret;\r\n }\r\n\r\n // Note: we parse something simpler than the official syntax. It's all that ever\r\n // seems to be used\r\n function extended_attrs(store) {\r\n const eas = [];\r\n all_ws(store);\r\n if (!consume(OTHER, \"[\")) return eas;\r\n eas[0] = simple_extended_attr(store) || error(\"Extended attribute with not content\");\r\n all_ws();\r\n while (consume(OTHER, \",\")) {\r\n eas.push(simple_extended_attr(store) || error(\"Trailing comma in extended attribute\"));\r\n }\r\n all_ws();\r\n consume(OTHER, \"]\") || error(\"No end of extended attribute\");\r\n return eas;\r\n }\r\n\r\n function default_() {\r\n all_ws();\r\n if (consume(OTHER, \"=\")) {\r\n all_ws();\r\n const def = const_value();\r\n if (def) {\r\n return def;\r\n } else if (consume(OTHER, \"[\")) {\r\n if (!consume(OTHER, \"]\")) error(\"Default sequence value must be empty\");\r\n return { type: \"sequence\", value: [] };\r\n } else {\r\n const str = consume(STR) || error(\"No value for default\");\r\n str.value = str.value.slice(1, -1);\r\n return str;\r\n }\r\n }\r\n }\r\n\r\n function const_(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"const\")) return;\r\n const ret = { type: \"const\", nullable: false };\r\n all_ws();\r\n let typ = primitive_type();\r\n if (!typ) {\r\n typ = consume(ID) || error(\"No type for const\");\r\n typ = typ.value;\r\n }\r\n ret.idlType = Object.assign({ type: \"const-type\" }, EMPTY_IDLTYPE, { idlType: typ });\r\n all_ws();\r\n if (consume(OTHER, \"?\")) {\r\n ret.nullable = true;\r\n all_ws();\r\n }\r\n const name = consume(ID) || error(\"No name for const\");\r\n ret.name = name.value;\r\n all_ws();\r\n consume(OTHER, \"=\") || error(\"No value assignment for const\");\r\n all_ws();\r\n const cnt = const_value();\r\n if (cnt) ret.value = cnt;\r\n else error(\"No value for const\");\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated const\");\r\n return ret;\r\n }\r\n\r\n function inheritance() {\r\n all_ws();\r\n if (consume(OTHER, \":\")) {\r\n all_ws();\r\n const inh = consume(ID) || error(\"No type in inheritance\");\r\n return inh.value;\r\n }\r\n }\r\n\r\n function operation_rest(ret, store) {\r\n all_ws();\r\n if (!ret) ret = {};\r\n const name = consume(ID);\r\n ret.name = name ? name.value : null;\r\n all_ws();\r\n consume(OTHER, \"(\") || error(\"Invalid operation\");\r\n ret.arguments = argument_list(store);\r\n all_ws();\r\n consume(OTHER, \")\") || error(\"Unterminated operation\");\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated operation\");\r\n return ret;\r\n }\r\n\r\n function callback(store) {\r\n all_ws(store, \"pea\");\r\n let ret;\r\n if (!consume(ID, \"callback\")) return;\r\n all_ws();\r\n const tok = consume(ID, \"interface\");\r\n if (tok) {\r\n ret = interface_rest(false, store, \"callback interface\");\r\n return ret;\r\n }\r\n const name = consume(ID) || error(\"No name for callback\");\r\n ret = current = { type: \"callback\", name: sanitize_name(name.value, \"callback\") };\r\n all_ws();\r\n consume(OTHER, \"=\") || error(\"No assignment in callback\");\r\n all_ws();\r\n ret.idlType = return_type();\r\n all_ws();\r\n consume(OTHER, \"(\") || error(\"No arguments in callback\");\r\n ret.arguments = argument_list(store);\r\n all_ws();\r\n consume(OTHER, \")\") || error(\"Unterminated callback\");\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated callback\");\r\n return ret;\r\n }\r\n\r\n function attribute(store) {\r\n all_ws(store, \"pea\");\r\n const grabbed = [];\r\n const ret = {\r\n type: \"attribute\",\r\n static: false,\r\n stringifier: false,\r\n inherit: false,\r\n readonly: false\r\n };\r\n const w = all_ws();\r\n if (w) grabbed.push(w);\r\n if (consume(ID, \"inherit\")) {\r\n if (ret.static || ret.stringifier) error(\"Cannot have a static or stringifier inherit\");\r\n ret.inherit = true;\r\n grabbed.push(last_token);\r\n const w = all_ws();\r\n if (w) grabbed.push(w);\r\n }\r\n if (consume(ID, \"readonly\")) {\r\n ret.readonly = true;\r\n grabbed.push(last_token);\r\n const w = all_ws();\r\n if (w) grabbed.push(w);\r\n }\r\n const rest = attribute_rest(ret);\r\n if (!rest) {\r\n tokens = grabbed.concat(tokens);\r\n }\r\n return rest;\r\n }\r\n\r\n function attribute_rest(ret) {\r\n if (!consume(ID, \"attribute\")) {\r\n return;\r\n }\r\n all_ws();\r\n ret.idlType = type_with_extended_attributes(\"attribute-type\") || error(\"No type in attribute\");\r\n if (ret.idlType.sequence) error(\"Attributes cannot accept sequence types\");\r\n if (ret.idlType.generic === \"record\") error(\"Attributes cannot accept record types\");\r\n all_ws();\r\n const name = consume(ID) || error(\"No name in attribute\");\r\n ret.name = name.value;\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated attribute\");\r\n return ret;\r\n }\r\n\r\n function return_type() {\r\n const typ = type(\"return-type\");\r\n if (!typ) {\r\n if (consume(ID, \"void\")) {\r\n return \"void\";\r\n } else error(\"No return type\");\r\n }\r\n return typ;\r\n }\r\n\r\n function operation(store) {\r\n all_ws(store, \"pea\");\r\n const ret = Object.assign({}, EMPTY_OPERATION);\r\n while (true) {\r\n all_ws();\r\n if (consume(ID, \"getter\")) ret.getter = true;\r\n else if (consume(ID, \"setter\")) ret.setter = true;\r\n else if (consume(ID, \"deleter\")) ret.deleter = true;\r\n else break;\r\n }\r\n if (ret.getter || ret.setter || ret.deleter) {\r\n all_ws();\r\n ret.idlType = return_type();\r\n operation_rest(ret, store);\r\n return ret;\r\n }\r\n ret.idlType = return_type();\r\n all_ws();\r\n operation_rest(ret, store);\r\n return ret;\r\n }\r\n\r\n function static_member(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"static\")) return;\r\n all_ws();\r\n return noninherited_attribute(store, \"static\") ||\r\n regular_operation(store, \"static\") ||\r\n error(\"No body in static member\");\r\n }\r\n\r\n function stringifier(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"stringifier\")) return;\r\n all_ws();\r\n if (consume(OTHER, \";\")) {\r\n return Object.assign({}, EMPTY_OPERATION, { stringifier: true });\r\n }\r\n return noninherited_attribute(store, \"stringifier\") ||\r\n regular_operation(store, \"stringifier\") ||\r\n error(\"Unterminated stringifier\");\r\n }\r\n\r\n function identifiers() {\r\n const arr = [];\r\n const id = consume(ID);\r\n if (id) {\r\n arr.push(id.value);\r\n }\r\n else error(\"Expected identifiers but not found\");\r\n while (true) {\r\n all_ws();\r\n if (consume(OTHER, \",\")) {\r\n all_ws();\r\n const name = consume(ID) || error(\"Trailing comma in identifiers list\");\r\n arr.push(name.value);\r\n } else break;\r\n }\r\n return arr;\r\n }\r\n\r\n function iterable_type() {\r\n if (consume(ID, \"iterable\")) return \"iterable\";\r\n else if (consume(ID, \"legacyiterable\")) return \"legacyiterable\";\r\n else if (consume(ID, \"maplike\")) return \"maplike\";\r\n else if (consume(ID, \"setlike\")) return \"setlike\";\r\n else return;\r\n }\r\n\r\n function readonly_iterable_type() {\r\n if (consume(ID, \"maplike\")) return \"maplike\";\r\n else if (consume(ID, \"setlike\")) return \"setlike\";\r\n else return;\r\n }\r\n\r\n function iterable(store) {\r\n all_ws(store, \"pea\");\r\n const grabbed = [];\r\n const ret = { type: null, idlType: null, readonly: false };\r\n if (consume(ID, \"readonly\")) {\r\n ret.readonly = true;\r\n grabbed.push(last_token);\r\n var w = all_ws();\r\n if (w) grabbed.push(w);\r\n }\r\n const consumeItType = ret.readonly ? readonly_iterable_type : iterable_type;\r\n\r\n const ittype = consumeItType();\r\n if (!ittype) {\r\n tokens = grabbed.concat(tokens);\r\n return;\r\n }\r\n\r\n const secondTypeRequired = ittype === \"maplike\";\r\n const secondTypeAllowed = secondTypeRequired || ittype === \"iterable\";\r\n ret.type = ittype;\r\n if (ret.type !== 'maplike' && ret.type !== 'setlike')\r\n delete ret.readonly;\r\n all_ws();\r\n if (consume(OTHER, \"<\")) {\r\n ret.idlType = [type_with_extended_attributes()] || error(`Error parsing ${ittype} declaration`);\r\n all_ws();\r\n if (secondTypeAllowed) {\r\n if (consume(OTHER, \",\")) {\r\n all_ws();\r\n ret.idlType.push(type_with_extended_attributes());\r\n all_ws();\r\n }\r\n else if (secondTypeRequired)\r\n error(`Missing second type argument in ${ittype} declaration`);\r\n }\r\n if (!consume(OTHER, \">\")) error(`Unterminated ${ittype} declaration`);\r\n all_ws();\r\n if (!consume(OTHER, \";\")) error(`Missing semicolon after ${ittype} declaration`);\r\n } else\r\n error(`Error parsing ${ittype} declaration`);\r\n\r\n return ret;\r\n }\r\n\r\n function interface_rest(isPartial, store, typeName = \"interface\") {\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for interface\");\r\n const mems = [];\r\n const ret = current = {\r\n type: typeName,\r\n name: isPartial ? name.value : sanitize_name(name.value, \"interface\"),\r\n partial: isPartial,\r\n members: mems\r\n };\r\n if (!isPartial) ret.inheritance = inheritance() || null;\r\n all_ws();\r\n consume(OTHER, \"{\") || error(\"Bodyless interface\");\r\n while (true) {\r\n all_ws(store ? mems : null);\r\n if (consume(OTHER, \"}\")) {\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Missing semicolon after interface\");\r\n return ret;\r\n }\r\n const ea = extended_attrs(store ? mems : null);\r\n all_ws();\r\n const cnt = const_(store ? mems : null);\r\n if (cnt) {\r\n cnt.extAttrs = ea;\r\n ret.members.push(cnt);\r\n continue;\r\n }\r\n const mem = (opt.allowNestedTypedefs && typedef(store ? mems : null)) ||\r\n static_member(store ? mems : null) ||\r\n stringifier(store ? mems : null) ||\r\n iterable(store ? mems : null) ||\r\n attribute(store ? mems : null) ||\r\n operation(store ? mems : null) ||\r\n error(\"Unknown member\");\r\n mem.extAttrs = ea;\r\n ret.members.push(mem);\r\n }\r\n }\r\n\r\n function mixin_rest(isPartial, store) {\r\n all_ws();\r\n if (!consume(ID, \"mixin\")) return;\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for interface mixin\");\r\n const mems = [];\r\n const ret = current = {\r\n type: \"interface mixin\",\r\n name: isPartial ? name.value : sanitize_name(name.value, \"interface mixin\"),\r\n partial: isPartial,\r\n members: mems\r\n };\r\n all_ws();\r\n consume(OTHER, \"{\") || error(\"Bodyless interface mixin\");\r\n while (true) {\r\n all_ws(store ? mems : null);\r\n if (consume(OTHER, \"}\")) {\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Missing semicolon after interface mixin\");\r\n return ret;\r\n }\r\n const ea = extended_attrs(store ? mems : null);\r\n all_ws();\r\n const cnt = const_(store ? mems : null);\r\n if (cnt) {\r\n cnt.extAttrs = ea;\r\n ret.members.push(cnt);\r\n continue;\r\n }\r\n const mem = stringifier(store ? mems : null) ||\r\n noninherited_attribute(store ? mems : null) ||\r\n regular_operation(store ? mems : null) ||\r\n error(\"Unknown member\");\r\n mem.extAttrs = ea;\r\n ret.members.push(mem);\r\n }\r\n }\r\n\r\n function interface_(isPartial, store) {\r\n all_ws(isPartial ? null : store, \"pea\");\r\n if (!consume(ID, \"interface\")) return;\r\n return mixin_rest(isPartial, store) ||\r\n interface_rest(isPartial, store) ||\r\n error(\"Interface has no proper body\");\r\n }\r\n\r\n function namespace(isPartial, store) {\r\n all_ws(isPartial ? null : store, \"pea\");\r\n if (!consume(ID, \"namespace\")) return;\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for namespace\");\r\n const mems = [];\r\n const ret = current = {\r\n type: \"namespace\",\r\n name: isPartial ? name.value : sanitize_name(name.value, \"namespace\"),\r\n partial: isPartial,\r\n members: mems\r\n };\r\n all_ws();\r\n consume(OTHER, \"{\") || error(\"Bodyless namespace\");\r\n while (true) {\r\n all_ws(store ? mems : null);\r\n if (consume(OTHER, \"}\")) {\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Missing semicolon after namespace\");\r\n return ret;\r\n }\r\n const ea = extended_attrs(store ? mems : null);\r\n all_ws();\r\n const mem = noninherited_attribute(store ? mems : null) ||\r\n regular_operation(store ? mems : null) ||\r\n error(\"Unknown member\");\r\n mem.extAttrs = ea;\r\n ret.members.push(mem);\r\n }\r\n }\r\n\r\n function noninherited_attribute(store, prefix) {\r\n const w = all_ws(store, \"pea\");\r\n const grabbed = [];\r\n const ret = {\r\n type: \"attribute\",\r\n static: false,\r\n stringifier: false,\r\n inherit: false,\r\n readonly: false\r\n };\r\n if (prefix) {\r\n ret[prefix] = true;\r\n }\r\n if (w) grabbed.push(w);\r\n if (consume(ID, \"readonly\")) {\r\n ret.readonly = true;\r\n grabbed.push(last_token);\r\n const w = all_ws();\r\n if (w) grabbed.push(w);\r\n }\r\n const rest = attribute_rest(ret);\r\n if (!rest) {\r\n tokens = grabbed.concat(tokens);\r\n }\r\n return rest;\r\n }\r\n\r\n function regular_operation(store, prefix) {\r\n all_ws(store, \"pea\");\r\n const ret = Object.assign({}, EMPTY_OPERATION);\r\n if (prefix) {\r\n ret[prefix] = true;\r\n }\r\n ret.idlType = return_type();\r\n return operation_rest(ret, store);\r\n }\r\n\r\n function partial(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"partial\")) return;\r\n const thing = dictionary(true, store) ||\r\n interface_(true, store) ||\r\n namespace(true, store) ||\r\n error(\"Partial doesn't apply to anything\");\r\n return thing;\r\n }\r\n\r\n function dictionary(isPartial, store) {\r\n all_ws(isPartial ? null : store, \"pea\");\r\n if (!consume(ID, \"dictionary\")) return;\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for dictionary\");\r\n const mems = [];\r\n const ret = current = {\r\n type: \"dictionary\",\r\n name: isPartial ? name.value : sanitize_name(name.value, \"dictionary\"),\r\n partial: isPartial,\r\n members: mems\r\n };\r\n if (!isPartial) ret.inheritance = inheritance() || null;\r\n all_ws();\r\n consume(OTHER, \"{\") || error(\"Bodyless dictionary\");\r\n while (true) {\r\n all_ws(store ? mems : null);\r\n if (consume(OTHER, \"}\")) {\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Missing semicolon after dictionary\");\r\n return ret;\r\n }\r\n const ea = extended_attrs(store ? mems : null);\r\n all_ws(store ? mems : null, \"pea\");\r\n const required = consume(ID, \"required\");\r\n const typ = type_with_extended_attributes(\"dictionary-type\") || error(\"No type for dictionary member\");\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for dictionary member\");\r\n const dflt = default_();\r\n if (required && dflt) error(\"Required member must not have a default\");\r\n const member = {\r\n type: \"field\",\r\n name: name.value,\r\n required: !!required,\r\n idlType: typ,\r\n extAttrs: ea\r\n };\r\n if (typeof dflt !== \"undefined\") {\r\n member[\"default\"] = dflt;\r\n }\r\n ret.members.push(member);\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated dictionary member\");\r\n }\r\n }\r\n\r\n function enum_(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"enum\")) return;\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for enum\");\r\n const vals = [];\r\n const ret = current = {\r\n type: \"enum\",\r\n name: sanitize_name(name.value, \"enum\"),\r\n values: vals\r\n };\r\n all_ws();\r\n consume(OTHER, \"{\") || error(\"No curly for enum\");\r\n let saw_comma = false;\r\n while (true) {\r\n all_ws(store ? vals : null);\r\n if (consume(OTHER, \"}\")) {\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"No semicolon after enum\");\r\n return ret;\r\n }\r\n const val = consume(STR) || error(\"Unexpected value in enum\");\r\n val.value = val.value.slice(1, -1);\r\n ret.values.push(val);\r\n all_ws(store ? vals : null);\r\n if (consume(OTHER, \",\")) {\r\n if (store) vals.push({ type: \",\" });\r\n all_ws(store ? vals : null);\r\n saw_comma = true;\r\n } else {\r\n saw_comma = false;\r\n }\r\n }\r\n }\r\n\r\n function typedef(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"typedef\")) return;\r\n const ret = {\r\n type: \"typedef\"\r\n };\r\n all_ws();\r\n ret.idlType = type_with_extended_attributes(\"typedef-type\") || error(\"No type in typedef\");\r\n all_ws();\r\n const name = consume(ID) || error(\"No name in typedef\");\r\n ret.name = sanitize_name(name.value, \"typedef\");\r\n current = ret;\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated typedef\");\r\n return ret;\r\n }\r\n\r\n function implements_(store) {\r\n all_ws(store, \"pea\");\r\n const target = consume(ID);\r\n if (!target) return;\r\n const w = all_ws();\r\n if (consume(ID, \"implements\")) {\r\n const ret = {\r\n type: \"implements\",\r\n target: target.value\r\n };\r\n all_ws();\r\n const imp = consume(ID) || error(\"Incomplete implements statement\");\r\n ret[\"implements\"] = imp.value;\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"No terminating ; for implements statement\");\r\n return ret;\r\n } else {\r\n // rollback\r\n if (w)\r\n tokens.unshift(w);\r\n tokens.unshift(target);\r\n }\r\n }\r\n\r\n function includes(store) {\r\n all_ws(store, \"pea\");\r\n const target = consume(ID);\r\n if (!target) return;\r\n const w = all_ws();\r\n if (consume(ID, \"includes\")) {\r\n const ret = {\r\n type: \"includes\",\r\n target: target.value\r\n };\r\n all_ws();\r\n const imp = consume(ID) || error(\"Incomplete includes statement\");\r\n ret[\"includes\"] = imp.value;\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"No terminating ; for includes statement\");\r\n return ret;\r\n } else {\r\n // rollback\r\n if (w)\r\n tokens.unshift(w);\r\n tokens.unshift(target);\r\n }\r\n }\r\n\r\n function definition(store) {\r\n return callback(store) ||\r\n interface_(false, store) ||\r\n partial(store) ||\r\n dictionary(false, store) ||\r\n enum_(store) ||\r\n typedef(store) ||\r\n implements_(store) ||\r\n includes(store) ||\r\n namespace(false, store);\r\n }\r\n\r\n function definitions(store) {\r\n if (!tokens.length) return [];\r\n const defs = [];\r\n while (true) {\r\n const ea = extended_attrs(store ? defs : null);\r\n const def = definition(store ? defs : null);\r\n if (!def) {\r\n if (ea.length) error(\"Stray extended attributes\");\r\n break;\r\n }\r\n def.extAttrs = ea;\r\n defs.push(def);\r\n }\r\n return defs;\r\n }\r\n const res = definitions(opt.ws);\r\n if (tokens.length) error(\"Unrecognised tokens\");\r\n return res;\r\n }\r\n\r\n const obj = {\r\n parse(str, opt) {\r\n if (!opt) opt = {};\r\n const tokens = tokenise(str);\r\n return parse(tokens, opt);\r\n }\r\n };\r\n\r\n if (typeof module !== 'undefined' && typeof module.exports !== 'undefined') {\r\n module.exports = obj;\r\n } else if (typeof define === 'function' && define.amd) {\r\n define('deps/webidl2',[], () => obj);\r\n } else {\r\n (self || window).WebIDL2 = obj;\r\n }\r\n})();\r\n\n", + "\ndefine('deps/text!core/css/webidl.css',[],function () { return '/* --- WEB IDL --- */\\n\\npre.idl {\\n padding: 1em;\\n}\\n\\n.respec-idl-separator {\\n padding: 0 0 0.4cm 0;\\n}\\n\\n.respec-idl-separator:last-child {\\n padding: 0;\\n}\\n\\n@media print {\\n pre.idl {\\n white-space: pre-wrap;\\n }\\n}\\n\\npre.idl::before {\\n content: \"WebIDL\";\\n display: block;\\n width: 150px;\\n background: #90b8de;\\n color: #fff;\\n font-family: sans-serif;\\n font-weight: bold;\\n margin: -1em 0 1em -1em;\\n height: 28px;\\n line-height: 28px; \\n}\\n\\n.idlType {\\n color: #ff4500;\\n font-weight: bold;\\n text-decoration: none;\\n}\\n\\n\\n/*.idlModule*/\\n\\n\\n/*.idlModuleID*/\\n\\n\\n/*.idlInterface*/\\n\\n.idlInterfaceID,\\n.idlDictionaryID,\\n.idlCallbackID,\\n.idlEnumID {\\n font-weight: bold;\\n color: #005a9c;\\n}\\n\\na.idlEnumItem {\\n color: #000;\\n border-bottom: 1px dotted #ccc;\\n text-decoration: none;\\n}\\n\\n.idlSuperclass {\\n font-style: italic;\\n color: #005a9c;\\n}\\n\\n\\n/*.idlAttribute*/\\n\\n.idlAttrType,\\n.idlFieldType,\\n.idlMemberType {\\n color: #005a9c;\\n}\\n\\n.idlAttrName,\\n.idlFieldName,\\n.idlMemberName {\\n color: #ff4500;\\n}\\n\\n.idlAttrName a,\\n.idlFieldName a,\\n.idlMemberName a {\\n color: #ff4500;\\n border-bottom: 1px dotted #ff4500;\\n text-decoration: none;\\n}\\n\\n\\n/*.idlMethod*/\\n\\n.idlMethType,\\n.idlCallbackType {\\n color: #005a9c;\\n}\\n\\n.idlMethName {\\n color: #ff4500;\\n}\\n\\n.idlMethName a {\\n color: #ff4500;\\n border-bottom: 1px dotted #ff4500;\\n text-decoration: none;\\n}\\n\\n\\n/*.idlCtor*/\\n\\n.idlCtorName {\\n color: #ff4500;\\n}\\n\\n.idlCtorName a {\\n color: #ff4500;\\n border-bottom: 1px dotted #ff4500;\\n text-decoration: none;\\n}\\n\\n\\n/*.idlParam*/\\n\\n.idlParamType {\\n color: #005a9c;\\n}\\n\\n.idlParamName,\\n.idlDefaultValue {\\n font-style: italic;\\n}\\n\\n.extAttr {\\n color: #666;\\n}\\n\\n\\n/*.idlSectionComment*/\\n\\n.idlSectionComment {\\n color: gray;\\n}\\n\\n\\n/*.idlIterable*/\\n\\n.idlIterableKeyType,\\n.idlIterableValueType {\\n color: #005a9c;\\n}\\n\\n\\n/*.idlMaplike*/\\n\\n.idlMaplikeKeyType,\\n.idlMaplikeValueType {\\n color: #005a9c;\\n}\\n\\n\\n/*.idlConst*/\\n\\n.idlConstType {\\n color: #005a9c;\\n}\\n\\n.idlConstName {\\n color: #ff4500;\\n}\\n\\n.idlConstName a {\\n color: #ff4500;\\n border-bottom: 1px dotted #ff4500;\\n text-decoration: none;\\n}\\n\\n\\n/*.idlException*/\\n\\n.idlExceptionID {\\n font-weight: bold;\\n color: #c00;\\n}\\n\\n.idlTypedefID,\\n.idlTypedefType {\\n color: #005a9c;\\n}\\n\\n.idlRaises,\\n.idlRaises a.idlType,\\n.idlRaises a.idlType code,\\n.excName a,\\n.excName a code {\\n color: #c00;\\n font-weight: normal;\\n}\\n\\n.excName a {\\n font-family: monospace;\\n}\\n\\n.idlRaises a.idlType,\\n.excName a.idlType {\\n border-bottom: 1px dotted #c00;\\n}\\n\\n.excGetSetTrue,\\n.excGetSetFalse,\\n.prmNullTrue,\\n.prmNullFalse,\\n.prmOptTrue,\\n.prmOptFalse {\\n width: 45px;\\n text-align: center;\\n}\\n\\n.excGetSetTrue,\\n.prmNullTrue,\\n.prmOptTrue {\\n color: #0c0;\\n}\\n\\n.excGetSetFalse,\\n.prmNullFalse,\\n.prmOptFalse {\\n color: #c00;\\n}\\n\\n.idlImplements a, .idlIncludes a {\\n font-weight: bold;\\n}\\n\\ndl.attributes,\\ndl.methods,\\ndl.constants,\\ndl.constructors,\\ndl.fields,\\ndl.dictionary-members {\\n margin-left: 2em;\\n}\\n\\n.attributes dt,\\n.methods dt,\\n.constants dt,\\n.constructors dt,\\n.fields dt,\\n.dictionary-members dt {\\n font-weight: normal;\\n}\\n\\n.attributes dt code,\\n.methods dt code,\\n.constants dt code,\\n.constructors dt code,\\n.fields dt code,\\n.dictionary-members dt code {\\n font-weight: bold;\\n color: #000;\\n font-family: monospace;\\n}\\n\\n.attributes dt code,\\n.fields dt code,\\n.dictionary-members dt code {\\n background: #ffffd2;\\n}\\n\\n.attributes dt .idlAttrType code,\\n.fields dt .idlFieldType code,\\n.dictionary-members dt .idlMemberType code {\\n color: #005a9c;\\n background: transparent;\\n font-family: inherit;\\n font-weight: normal;\\n font-style: italic;\\n}\\n\\n.methods dt code {\\n background: #d9e6f8;\\n}\\n\\n.constants dt code {\\n background: #ddffd2;\\n}\\n\\n.constructors dt code {\\n background: #cfc;\\n}\\n\\n.attributes dd,\\n.methods dd,\\n.constants dd,\\n.constructors dd,\\n.fields dd,\\n.dictionary-members dd {\\n margin-bottom: 1em;\\n}\\n\\ntable.parameters,\\ntable.exceptions {\\n border-spacing: 0;\\n border-collapse: collapse;\\n margin: 0.5em 0;\\n width: 100%;\\n}\\n\\ntable.parameters {\\n border-bottom: 1px solid #90b8de;\\n}\\n\\ntable.exceptions {\\n border-bottom: 1px solid #deb890;\\n}\\n\\n.parameters th,\\n.exceptions th {\\n color: inherit;\\n padding: 3px 5px;\\n text-align: left;\\n font-weight: normal;\\n}\\n\\n.parameters th {\\n color: #fff;\\n background: #005a9c;\\n}\\n\\n.exceptions th {\\n background: #deb890;\\n}\\n\\n.parameters td,\\n.exceptions td {\\n padding: 3px 10px;\\n border-top: 1px solid #ddd;\\n vertical-align: top;\\n}\\n\\n.parameters tr:first-child td,\\n.exceptions tr:first-child td {\\n border-top: none;\\n}\\n\\n.parameters td.prmName,\\n.exceptions td.excName,\\n.exceptions td.excCodeName {\\n width: 100px;\\n}\\n\\n.parameters td.prmType {\\n width: 120px;\\n}\\n\\ntable.exceptions table {\\n border-spacing: 0;\\n border-collapse: collapse;\\n width: 100%;\\n}\\n\\n.respec-button-copy-paste:focus {\\n text-decoration: none;\\n border-color: #51a7e8;\\n outline: none;\\n box-shadow: 0 0 5px rgba(81, 167, 232, 0.5);\\n}\\n\\n.respec-button-copy-paste:focus:hover,\\n.respec-button-copy-paste.selected:focus {\\n border-color: #51a7e8;\\n}\\n\\n.respec-button-copy-paste:hover,\\n.respec-button-copy-paste:active,\\n.respec-button-copy-paste.zeroclipboard-is-hover,\\n.respec-button-copy-paste.zeroclipboard-is-active {\\n text-decoration: none;\\n background-color: #ddd;\\n background-image: linear-gradient(#eee, #ddd);\\n border-color: #ccc;\\n}\\n\\n.respec-button-copy-paste:active,\\n.respec-button-copy-paste.selected,\\n.respec-button-copy-paste.zeroclipboard-is-active {\\n background-color: #dcdcdc;\\n background-image: none;\\n border-color: #b5b5b5;\\n box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15)\\n}\\n\\n.respec-button-copy-paste.selected:hover {\\n background-color: #cfcfcf;\\n}\\n\\n.respec-button-copy-paste:disabled,\\n.respec-button-copy-paste:disabled:hover,\\n.respec-button-copy-paste.disabled,\\n.respec-button-copy-paste.disabled:hover {\\n color: rgba(102, 102, 102, 0.5);\\n cursor: default;\\n background-color: rgba(229, 229, 229, 0.5);\\n background-image: none;\\n border-color: rgba(197, 197, 197, 0.5);\\n box-shadow: none;\\n}\\n';});\n\n", + "define('core/webidl',[\"exports\", \"core/pubsubhub\", \"deps/webidl2\", \"handlebars.runtime\", \"deps/text!core/css/webidl.css\", \"templates\", \"core/utils\"], function (exports, _pubsubhub, _webidl, _handlebars, _webidl3, _templates, _utils) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.done = exports.name = undefined;\n exports.run = run;\n\n var _webidl2 = _interopRequireDefault(_webidl);\n\n var _handlebars2 = _interopRequireDefault(_handlebars);\n\n var _webidl4 = _interopRequireDefault(_webidl3);\n\n var _templates2 = _interopRequireDefault(_templates);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n // Module core/webidl\n // Highlights and links WebIDL marked up inside
        .\n\n  // TODO:\n  //  - It could be useful to report parsed IDL items as events\n  //  - don't use generated content in the CSS!\n  const name = exports.name = \"core/webidl\";\n\n  var idlAttributeTmpl = _templates2.default[\"attribute.html\"];\n  var idlCallbackTmpl = _templates2.default[\"callback.html\"];\n  var idlConstTmpl = _templates2.default[\"const.html\"];\n  var idlDictionaryTmpl = _templates2.default[\"dictionary.html\"];\n  var idlDictMemberTmpl = _templates2.default[\"dict-member.html\"];\n  var idlEnumItemTmpl = _templates2.default[\"enum-item.html\"];\n  var idlEnumTmpl = _templates2.default[\"enum.html\"];\n  var idlExtAttributeTmpl = _templates2.default[\"extended-attribute.html\"];\n  var idlFieldTmpl = _templates2.default[\"field.html\"];\n  var idlIncludesTmpl = _templates2.default[\"includes.html\"];\n  var idlImplementsTmpl = _templates2.default[\"implements.html\"];\n  var idlInterfaceTmpl = _templates2.default[\"interface.html\"];\n  var idlIterableTmpl = _templates2.default[\"iterable.html\"];\n  var idlLineCommentTmpl = _templates2.default[\"line-comment.html\"];\n  var idlMaplikeTmpl = _templates2.default[\"maplike.html\"];\n  var idlMethodTmpl = _templates2.default[\"method.html\"];\n  var idlMultiLineCommentTmpl = _templates2.default[\"multiline-comment.html\"];\n  var idlParamTmpl = _templates2.default[\"param.html\"];\n  var idlTypedefTmpl = _templates2.default[\"typedef.html\"];\n  // TODO: make these linkable somehow.\n  // https://github.com/w3c/respec/issues/999\n  // https://github.com/w3c/respec/issues/982\n  var unlinkable = new Set([\"maplike\", \"setlike\", \"stringifier\"]);\n\n  function registerHelpers() {\n    _handlebars2.default.registerHelper(\"extAttr\", function (obj, indent) {\n      return extAttr(obj.extAttrs, indent, /*singleLine=*/false);\n    });\n    _handlebars2.default.registerHelper(\"extAttrInline\", function (obj) {\n      return extAttr(obj.extAttrs, 0, /*singleLine=*/true);\n    });\n    _handlebars2.default.registerHelper(\"extAttrClassName\", function () {\n      var extAttr = this;\n      if (extAttr.name === \"Constructor\" || extAttr.name === \"NamedConstructor\") {\n        return \"idlCtor\";\n      }\n      return \"extAttr\";\n    });\n    _handlebars2.default.registerHelper(\"extAttrRhs\", function (rhs, options) {\n      if (rhs.type === \"identifier\") {\n        return options.fn(rhs.value);\n      }\n      return `(${rhs.value.map(options.fn)})`;\n    });\n    _handlebars2.default.registerHelper(\"param\", function (obj) {\n      return new _handlebars2.default.SafeString(idlParamTmpl({\n        obj: obj,\n        optional: obj.optional ? \"optional \" : \"\",\n        variadic: obj.variadic ? \"...\" : \"\"\n      }));\n    });\n    _handlebars2.default.registerHelper(\"jsIf\", function (condition, options) {\n      if (condition) {\n        return options.fn(this);\n      } else {\n        return options.inverse(this);\n      }\n    });\n    _handlebars2.default.registerHelper(\"idn\", function (indent) {\n      return new _handlebars2.default.SafeString(idn(indent));\n    });\n    _handlebars2.default.registerHelper(\"idlType\", function (obj) {\n      return new _handlebars2.default.SafeString(idlType2Html(obj.idlType));\n    });\n    _handlebars2.default.registerHelper(\"stringifyIdlConst\", function (value) {\n      switch (value.type) {\n        case \"null\":\n          return \"null\";\n        case \"Infinity\":\n          return value.negative ? \"-Infinity\" : \"Infinity\";\n        case \"NaN\":\n          return \"NaN\";\n        case \"number\":\n          return value.value;\n        case \"string\":\n        case \"boolean\":\n        case \"sequence\":\n          return JSON.stringify(value.value);\n        default:\n          (0, _pubsubhub.pub)(\"error\", \"Unexpected constant value type: `\" + value.type + \"`.\");\n          return \"\";\n      }\n    });\n    _handlebars2.default.registerHelper(\"escapeArgumentName\", escapeArgumentName);\n    _handlebars2.default.registerHelper(\"escapeAttributeName\", escapeAttributeName);\n    _handlebars2.default.registerHelper(\"escapeIdentifier\", escapeIdentifier);\n    _handlebars2.default.registerHelper(\"pads\", function (num) {\n      return new _handlebars2.default.SafeString(pads(num));\n    });\n    _handlebars2.default.registerHelper(\"join\", function (arr, between, options) {\n      return arr.map(options.fn).join(between);\n    });\n    _handlebars2.default.registerHelper(\"joinNonWhitespace\", function (arr, between, options) {\n      return arr.filter(elem => elem.type !== \"ws\").map(options.fn).join(between);\n    });\n    // A block helper that emits an  around its contents\n    // if obj.dfn exists. If it exists, that implies that\n    // there's another  for the object.\n    _handlebars2.default.registerHelper(\"tryLink\", function (obj, options) {\n      const content = options.fn(this);\n      const isDefaultJSON = obj.name === \"toJSON\" && obj.extAttrs.some(({ name }) => name === \"Default\");\n      // nothing defines this.\n      if (!obj.dfn && !isDefaultJSON) {\n        return content;\n      }\n      // We are going to return a hyperlink\n      const a = document.createElement(\"a\");\n      a.innerText = content;\n      // Let's deal with WebIDL's Default toJSON(); first.\n      if (!obj.dfn && isDefaultJSON) {\n        // If toJSON is not overridden, link directly to WebIDL spec.\n        a.dataset.cite = \"WEBIDL#default-tojson-operation\";\n      } else {\n        // This is an internal IDL reference.\n        a.dataset.noDefault = \"\";\n        a.dataset.linkFor = obj.linkFor ? _handlebars2.default.Utils.escapeExpression(obj.linkFor).toLowerCase() : \"\";\n        a.dataset.lt = obj.dfn[0].dataset.lt || \"\";\n      }\n      return a.outerHTML;\n    });\n  }\n\n  function idn(lvl) {\n    return \"    \".repeat(lvl);\n  }\n\n  function idlType2Html(idlType) {\n    if (typeof idlType === \"string\") {\n      return `${_handlebars2.default.Utils.escapeExpression(idlType)}`;\n    }\n    if (Array.isArray(idlType)) {\n      return idlType.map(idlType2Html).join(\", \");\n    }\n    const extAttrs = extAttr(idlType.extAttrs, 0, /*singleLine=*/true);\n    const nullable = idlType.nullable ? \"?\" : \"\";\n    if (idlType.union) {\n      return `${extAttrs}(${idlType.idlType.map(idlType2Html).join(\" or \")})${nullable}`;\n    }\n    let type = \"\";\n    if (idlType.generic) {\n      type = standardTypes.has(idlType.generic) ? linkStandardType(idlType.generic) : idlType2Html(idlType.generic);\n      type = `${type}<${idlType2Html(idlType.idlType)}>`;\n    } else {\n      type = standardTypes.has(idlType.idlType) ? linkStandardType(idlType.idlType) : idlType2Html(idlType.idlType);\n    }\n    return extAttrs + type + nullable;\n  }\n\n  function linkStandardType(type) {\n    if (!standardTypes.has(type)) {\n      return type;\n    }\n    const safeType = _handlebars2.default.Utils.escapeExpression(type);\n    return `${safeType}`;\n  }\n\n  function idlType2Text(idlType) {\n    if (typeof idlType === \"string\") {\n      return idlType;\n    }\n    const nullable = idlType.nullable ? \"?\" : \"\";\n    if (idlType.union) {\n      return `(${idlType.idlType.map(idlType2Text).join(\" or \")})${nullable}`;\n    }\n    if (idlType.generic) {\n      const types = [].concat(idlType.idlType).map(idlType2Text).join(\", \");\n      return `${idlType.generic}<${types}>${nullable}`;\n    }\n    return idlType2Text(idlType.idlType) + nullable;\n  }\n\n  function pads(num) {\n    return \" \".repeat(num);\n  }\n  var whitespaceTypes = {\n    ws: true,\n    \"ws-pea\": true,\n    \"ws-tpea\": true,\n    \"line-comment\": true,\n    \"multiline-comment\": true\n  };\n\n  function typeIsWhitespace(webIdlType) {\n    return whitespaceTypes[webIdlType];\n  }\n\n  const extenedAttributesLinks = new Map([[\"CEReactions\", \"HTML#cereactions\"], [\"Clamp\", \"WEBIDL#Clamp\"], [\"Constructor\", \"WEBIDL#Constructor\"], [\"Default\", \"WEBIDL#Default\"], [\"EnforceRange\", \"WEBIDL#EnforceRange\"], [\"Exposed\", \"WEBIDL#Exposed\"], [\"Global\", \"WEBIDL#Global\"], [\"HTMLConstructor\", \"HTML#htmlconstructor\"], [\"LegacyUnenumerableNamedProperties\", \"WEBIDL#LegacyUnenumerableNamedProperties\"], [\"LenientSetter\", \"WEBIDL#LenientSetter\"], [\"LenientThis\", \"WEBIDL#LenientThis\"], [\"NamedConstructor\", \"WEBIDL#NamedConstructor\"], [\"NewObject\", \"WEBIDL#NewObject\"], [\"NoInterfaceObject\", \"WEBIDL#NoInterfaceObject\"], [\"OverrideBuiltins\", \"WEBIDL#OverrideBuiltins\"], [\"PrimaryGlobal\", \"WEBIDL#PrimaryGlobal\"], [\"PutForwards\", \"WEBIDL#PutForwards\"], [\"Replaceable\", \"WEBIDL#Replaceable\"], [\"SameObject\", \"WEBIDL#SameObject\"], [\"SecureContext\", \"WEBIDL#SecureContext\"], [\"TreatNonObjectAsNull\", \"WEBIDL#TreatNonObjectAsNull\"], [\"TreatNullAs\", \"WEBIDL#TreatNullAs\"], [\"Unforgeable\", \"WEBIDL#Unforgeable\"], [\"Unscopable\", \"WEBIDL#Unscopable\"]]);\n\n  function extAttr(extAttrs, indent, singleLine) {\n    if (extAttrs.length === 0) {\n      // If there are no extended attributes, omit the [] entirely.\n      return \"\";\n    }\n    var opt = {\n      extAttrs: extAttrs,\n      indent: indent,\n      sep: singleLine ? \", \" : \",\\n \" + idn(indent),\n      end: singleLine ? \" \" : \"\\n\"\n    };\n    const safeString = new _handlebars2.default.SafeString(idlExtAttributeTmpl(opt));\n    const tmpParser = document.createElement(\"div\");\n    tmpParser.innerHTML = safeString;\n    Array.from(tmpParser.querySelectorAll(\".extAttrName\")).filter(function (elem) {\n      return extenedAttributesLinks.has(elem.textContent);\n    }).forEach(function (elem) {\n      const a = elem.ownerDocument.createElement(\"a\");\n      a.dataset.cite = extenedAttributesLinks.get(elem.textContent);\n      a.textContent = elem.textContent;\n      elem.replaceChild(a, elem.firstChild);\n    });\n    return new _handlebars2.default.SafeString(tmpParser.innerHTML);\n  }\n\n  const standardTypes = new Map([[\"any\", \"WEBIDL#idl-any\"], [\"ArrayBuffer\", \"WEBIDL#idl-ArrayBuffer\"], [\"boolean\", \"WEBIDL#idl-boolean\"], [\"Buffer\", \"WEBIDL#idl-Buffer\"], [\"byte\", \"WEBIDL#idl-byte\"], [\"ByteString\", \"WEBIDL#idl-ByteString\"], [\"Callback\", \"WEBIDL#idl-Callback\"], [\"DataView\", \"WEBIDL#idl-DataView\"], [\"DOMException\", \"WEBIDL#idl-DOMException\"], [\"DOMString\", \"WEBIDL#idl-DOMString\"], [\"double\", \"WEBIDL#idl-double\"], [\"Error\", \"WEBIDL#idl-Error\"], [\"EventHandler\", \"HTML#eventhandler\"], [\"float\", \"WEBIDL#idl-float\"], [\"Float32Array\", \"WEBIDL#idl-Float32Array\"], [\"Float64Array\", \"WEBIDL#idl-Float64Array\"], [\"FrozenArray\", \"WEBIDL#idl-frozen-array\"], [\"Int16Array\", \"WEBIDL#idl-Int16Array\"], [\"Int32Array\", \"WEBIDL#idl-Int32Array\"], [\"Int8Array\", \"WEBIDL#idl-Int8Array\"], [\"long long\", \"WEBIDL#idl-long-long\"], [\"long\", \"WEBIDL#idl-long\"], [\"object\", \"WEBIDL#idl-object\"], [\"octet\", \"WEBIDL#idl-octet\"], [\"Promise\", \"WEBIDL#idl-promise\"], [\"record\", \"WEBIDL#idl-record\"], [\"sequence\", \"WEBIDL#idl-sequence\"], [\"short\", \"WEBIDL#idl-short\"], [\"Uint16Array\", \"WEBIDL#idl-Uint16Array\"], [\"Uint32Array\", \"WEBIDL#idl-Uint32Array\"], [\"Uint8Array\", \"WEBIDL#idl-Uint8Array\"], [\"Uint8ClampedArray\", \"WEBIDL#dl-Uint8ClampedArray\"], [\"unrestricted double\", \"WEBIDL#idl-unrestricted-double\"], [\"unrestricted float\", \"WEBIDL#idl-unrestricted-float\"], [\"unsigned long long\", \"WEBIDL#idl-unsigned-long-long\"], [\"unsigned long\", \"WEBIDL#idl-unsigned-long\"], [\"unsigned short\", \"WEBIDL#idl-unsigned-short\"], [\"USVString\", \"WEBIDL#idl-USVString\"]]);\n\n  const idlKeywords = new Set([\"any\", \"attribute\", \"boolean\", \"byte\", \"ByteString\", \"callback\", \"const\", \"creator\", \"Date\", \"deleter\", \"dictionary\", \"DOMString\", \"double\", \"enum\", \"false\", \"float\", \"getter\", \"implements\", \"Infinity\", \"inherit\", \"interface\", \"iterable\", \"long\", \"maplike\", \"NaN\", \"null\", \"object\", \"octet\", \"optional\", \"or\", \"partial\", \"readonly\", \"RegExp\", \"required\", \"sequence\", \"setlike\", \"setter\", \"short\", \"static\", \"stringifier\", \"true\", \"typedef\", \"unrestricted\", \"unsigned\", \"USVString\", \"void\"]);\n  const argumentNameKeyword = new Set([\"attribute\", \"callback\", \"const\", \"creator\", \"deleter\", \"dictionary\", \"enum\", \"getter\", \"implements\", \"inherit\", \"interface\", \"iterable\", \"maplike\", \"partial\", \"required\", \"setlike\", \"setter\", \"static\", \"stringifier\", \"typedef\", \"unrestricted\"]);\n  const attributeNameKeyword = new Set([\"required\"]);\n  var operationNames = {};\n  var idlPartials = {};\n\n  function escapeArgumentName(argumentName) {\n    if (idlKeywords.has(argumentName) && !argumentNameKeyword.has(argumentName)) return \"_\" + argumentName;\n    return argumentName;\n  }\n\n  function escapeAttributeName(attributeName) {\n    if (idlKeywords.has(attributeName) && !attributeNameKeyword.has(attributeName)) return \"_\" + attributeName;\n    return attributeName;\n  }\n\n  function escapeIdentifier(identifier) {\n    if (idlKeywords.has(identifier)) return \"_\" + identifier;\n    return identifier;\n  }\n\n  // Takes the result of WebIDL2.parse(), an array of definitions.\n  function makeMarkup(conf, parse) {\n    var attr = { class: \"def idl\" };\n    var $pre = $(\"
        \").attr(attr);\n    $pre.html(parse.filter(function (defn) {\n      return !typeIsWhitespace(defn.type);\n    }).map(function (defn) {\n      return writeDefinition(defn, -1);\n    }).join(\"\\n\\n\"));\n    return $pre;\n  }\n\n  function writeDefinition(obj, indent) {\n    indent++;\n    var opt = { indent: indent, obj: obj };\n    switch (obj.type) {\n      case \"typedef\":\n        return idlTypedefTmpl(opt);\n      case \"includes\":\n        return idlIncludesTmpl(opt);\n      case \"implements\":\n        return idlImplementsTmpl(opt);\n      case \"interface\":\n        return writeInterfaceDefinition(opt);\n      case \"interface mixin\":\n        return writeInterfaceDefinition(opt, { mixin: true });\n      case \"callback interface\":\n        return writeInterfaceDefinition(opt, { callback: true });\n      case \"dictionary\":\n        var maxQualifiers = 0,\n            maxType = 0;\n        var members = obj.members.filter(function (member) {\n          return !typeIsWhitespace(member.type);\n        });\n        for (const it of obj.members) {\n          if (typeIsWhitespace(it.type)) {\n            continue;\n          }\n          const qualifiers = it.required ? \"required \" : \"\";\n          if (maxQualifiers < qualifiers.length) maxQualifiers = qualifiers.length;\n\n          var typeLen = idlType2Text(it.idlType).length;\n          if (maxType < typeLen) maxType = typeLen;\n        }\n        var children = obj.members.map(function (it) {\n          switch (it.type) {\n            case \"field\":\n              return writeMember(it, maxQualifiers, maxType, indent + 1);\n            case \"line-comment\":\n              return writeLineComment(it, indent + 1);\n            case \"multiline-comment\":\n              return writeMultiLineComment(it, indent + 1);\n            case \"ws\":\n              return writeBlankLines(it);\n            case \"ws-pea\":\n              break;\n            default:\n              throw new Error(\"Unexpected type in dictionary: `\" + it.type + \"`.\");\n          }\n        }).join(\"\");\n        return idlDictionaryTmpl({\n          obj: obj,\n          indent: indent,\n          children: children,\n          partial: obj.partial ? \"partial \" : \"\"\n        });\n      case \"callback\":\n        var paramObjs = obj.arguments.filter(function (it) {\n          return !typeIsWhitespace(it.type);\n        }).map(function (it) {\n          return idlParamTmpl({\n            obj: it,\n            optional: it.optional ? \"optional \" : \"\",\n            variadic: it.variadic ? \"...\" : \"\"\n          });\n        });\n        var callbackObj = {\n          obj: obj,\n          indent: indent,\n          children: paramObjs.join(\", \")\n        };\n        var ret = idlCallbackTmpl(callbackObj);\n        var line = $(ret).text();\n        if (line.length > 80) {\n          var paramPad = line.indexOf(\"(\") + 1;\n          callbackObj.children = paramObjs.join(\",\\n\" + pads(paramPad));\n\n          ret = idlCallbackTmpl(callbackObj);\n        }\n        return ret;\n      case \"enum\":\n        var children = \"\";\n        for (var i = 0; i < obj.values.length; i++) {\n          var item = obj.values[i];\n          switch (item.type) {\n            case \"string\":\n              var needsComma = false;\n              for (var j = i + 1; j < obj.values.length; j++) {\n                var lookahead = obj.values[j];\n                if (lookahead.type === undefined) break;\n                if (lookahead.type === \",\") {\n                  needsComma = true;\n                  break;\n                }\n              }\n              children += idlEnumItemTmpl({\n                lname: item.value ? item.value.toLowerCase() : \"the-empty-string\",\n                name: item.value,\n                parentID: obj.name.toLowerCase(),\n                indent: indent + 1,\n                needsComma: needsComma\n              });\n              break;\n            case \"line-comment\":\n              children += writeLineComment(item, indent + 1);\n              break;\n            case \"multiline-comment\":\n              children += writeMultiLineComment(item, indent + 1);\n              break;\n            case \"ws\":\n              children += writeBlankLines(item);\n              break;\n            case \",\":\n            case \"ws-pea\":\n              break;\n            default:\n              throw new Error(\"Unexpected type in exception: `\" + item.type + \"`.\");\n          }\n        }\n        return idlEnumTmpl({ obj: obj, indent: indent, children: children });\n      default:\n        (0, _pubsubhub.pub)(\"error\", \"Unexpected object type `\" + obj.type + \"` in \" + JSON.stringify(obj));\n        return \"\";\n    }\n  }\n\n  function writeInterfaceDefinition(opt, fixes = {}) {\n    var obj = opt.obj,\n        indent = opt.indent;\n    var maxAttr = 0,\n        maxAttrQualifiers = 0,\n        maxMeth = 0,\n        maxConst = 0;\n    for (const it of obj.members) {\n      if (typeIsWhitespace(it.type) || it.type === \"maplike\" || it.type === \"iterable\") {\n        continue;\n      }\n      var len = idlType2Text(it.idlType).length;\n      if (it.type === \"attribute\") {\n        var qualifiersLen = writeAttributeQualifiers(it).length;\n        maxAttr = Math.max(len, maxAttr);\n        maxAttrQualifiers = Math.max(qualifiersLen, maxAttrQualifiers);\n      } else if (it.type === \"operation\") {\n        if (it.static) {\n          len += \"static \".length;\n        } else if (it.stringifier) {\n          len += \"stringifier \".length;\n        } else if (it.getter) {\n          len += \"getter \".length;\n        } else if (it.setter) {\n          len += \"setter \".length;\n        }\n        maxMeth = Math.max(len, maxMeth);\n      } else if (it.type === \"const\") {\n        maxConst = Math.max(len, maxConst);\n      }\n    }\n    var children = obj.members.map(function (ch) {\n      switch (ch.type) {\n        case \"attribute\":\n          return writeAttribute(ch, maxAttr, indent + 1, maxAttrQualifiers);\n        case \"operation\":\n          return writeMethod(ch, maxMeth, indent + 1);\n        case \"const\":\n          return writeConst(ch, maxConst, indent + 1);\n        case \"maplike\":\n          return writeMaplike(ch, indent + 1);\n        case \"iterable\":\n          return writeIterable(ch, indent + 1);\n        case \"ws\":\n          return writeBlankLines(ch);\n        case \"line-comment\":\n          return writeLineComment(ch, indent + 1);\n        case \"multiline-comment\":\n          return writeMultiLineComment(ch, indent + 1);\n        default:\n          throw new Error(\"Unexpected member type: `\" + ch.type + \"`.\");\n      }\n    }).join(\"\");\n    return idlInterfaceTmpl({\n      obj,\n      indent,\n      partial: obj.partial ? \"partial \" : \"\",\n      callback: fixes.callback ? \"callback \" : \"\",\n      mixin: fixes.mixin ? \"mixin \" : \"\",\n      children\n    });\n  }\n\n  function writeField(attr, max, indent) {\n    var pad = max - idlType2Text(attr.idlType).length;\n    return idlFieldTmpl({\n      obj: attr,\n      indent: indent,\n      pad: pad\n    });\n  }\n\n  function writeAttributeQualifiers(attr) {\n    var qualifiers = \"\";\n    if (attr.static) qualifiers += \"static \";\n    if (attr.stringifier) qualifiers += \"stringifier \";\n    if (attr.inherit) qualifiers += \"inherit \";\n    if (attr.readonly) qualifiers += \"readonly \";\n    return qualifiers;\n  }\n\n  function writeAttribute(attr, max, indent, maxQualifiers) {\n    var len = idlType2Text(attr.idlType).length;\n    var pad = max - len;\n    var qualifiers = writeAttributeQualifiers(attr);\n    qualifiers += pads(maxQualifiers);\n    qualifiers = qualifiers.slice(0, maxQualifiers);\n    return idlAttributeTmpl({\n      obj: attr,\n      indent: indent,\n      qualifiers: qualifiers,\n      pad: pad\n    });\n  }\n\n  function writeMethod(meth, max, indent) {\n    var paramObjs = meth.arguments.filter(function (it) {\n      return !typeIsWhitespace(it.type);\n    }).map(function (it) {\n      return idlParamTmpl({\n        obj: it,\n        optional: it.optional ? \"optional \" : \"\",\n        variadic: it.variadic ? \"...\" : \"\"\n      });\n    });\n    var params = paramObjs.join(\", \");\n    var len = idlType2Text(meth.idlType).length;\n    var specialProps = [\"getter\", \"setter\", \"deleter\", \"stringifier\", \"static\"];\n    var special = \"\";\n    for (var i in specialProps) {\n      if (meth[specialProps[i]]) {\n        special = specialProps[i] + \" \";\n        len += special.length;\n        break;\n      }\n    }\n    var pad = max - len;\n    var methObj = {\n      obj: meth,\n      indent: indent,\n      special: special,\n      pad: pad,\n      children: params\n    };\n    var ret = idlMethodTmpl(methObj);\n    var line = $(ret).text();\n    if (line.length > 80) {\n      var paramPad = line.indexOf(\"(\") + 1;\n      methObj.children = paramObjs.join(\",\\n\" + pads(paramPad));\n      ret = idlMethodTmpl(methObj);\n    }\n    return ret;\n  }\n\n  function writeConst(cons, max, indent) {\n    var pad = max - idlType2Text(cons.idlType).length;\n    if (cons.nullable) pad--;\n    return idlConstTmpl({\n      obj: cons,\n      indent: indent,\n      pad: pad,\n      nullable: cons.nullable ? \"?\" : \"\"\n    });\n  }\n\n  // Writes a single blank line if whitespace includes at least one blank line.\n  function writeBlankLines(whitespace) {\n    if (/\\n.*\\n/.test(whitespace.value)) {\n      // Members end with a newline, so we only need 1 extra one to get a blank line.\n      return \"\\n\";\n    }\n    return \"\";\n  }\n\n  function writeLineComment(comment, indent) {\n    return idlLineCommentTmpl({ indent: indent, comment: comment.value });\n  }\n\n  function writeMultiLineComment(comment, indent) {\n    // Split the multi-line comment into lines so we can indent it properly.\n    var lines = comment.value.split(/\\r\\n|\\r|\\n/);\n    if (lines.length === 0) {\n      return \"\";\n    } else if (lines.length === 1) {\n      return idlLineCommentTmpl({ indent: indent, comment: lines[0] });\n    }\n    var initialSpaces = Math.max(0, /^ */.exec(lines[1])[0].length - 3);\n\n    function trimInitialSpace(line) {\n      return line.slice(initialSpaces);\n    }\n    return idlMultiLineCommentTmpl({\n      indent: indent,\n      firstLine: lines[0],\n      lastLine: trimInitialSpace(lines[lines.length - 1]),\n      innerLine: lines.slice(1, -1).map(trimInitialSpace)\n    });\n  }\n\n  function writeMaplike(maplike, indent) {\n    return idlMaplikeTmpl({\n      obj: maplike,\n      qualifiers: maplike.readonly ? \"readonly \" : \"\",\n      indent: indent\n    });\n  }\n\n  function writeIterable(iterable, indent) {\n    return idlIterableTmpl({\n      obj: iterable,\n      qualifiers: iterable.readonly ? \"readonly \" : \"\",\n      indent: indent\n    });\n  }\n\n  function writeMember(memb, maxQualifiers, maxType, indent) {\n    var opt = { obj: memb, indent: indent };\n    opt.typePad = maxType - idlType2Text(memb.idlType).length;\n    if (memb.required) opt.qualifiers = \"required \";else opt.qualifiers = \"         \";\n    opt.qualifiers = opt.qualifiers.slice(0, maxQualifiers);\n    return idlDictMemberTmpl(opt);\n  }\n\n  // Each entity defined in IDL is either a top- or second-level entity:\n  // Interface or Interface.member. This function finds the \n  // element defining each entity and attaches it to the entity's\n  // 'refTitle' property, and records that it describes an IDL entity by\n  // adding a [data-idl] attribute.\n\n  function linkDefinitions(parse, definitionMap, parent, idlElem) {\n    parse\n    // Don't bother with any of these\n    .filter(({ type }) => [\"includes\", \"implements\", \"ws\", \"ws-pea\", \"ws-tpea\", \"line-comment\", \"multiline-comment\"].includes(type) === false).forEach(function (defn) {\n      var name;\n      switch (defn.type) {\n        // Top-level entities with linkable members.\n        case \"callback interface\":\n        case \"dictionary\":\n        case \"interface\":\n        case \"interface mixin\":\n          var partialIdx = \"\";\n          if (defn.partial) {\n            if (!idlPartials[defn.name]) {\n              idlPartials[defn.name] = [];\n            }\n            idlPartials[defn.name].push(defn);\n            partialIdx = \"-partial-\" + idlPartials[defn.name].length;\n          }\n          linkDefinitions(defn.members, definitionMap, defn.name, idlElem);\n          name = defn.name;\n          defn.idlId = \"idl-def-\" + name.toLowerCase() + partialIdx;\n          break;\n        case \"enum\":\n          name = defn.name;\n          for (const v of defn.values) {\n            if (v.type === \"string\") {\n              v.dfn = findDfn(name, v.value, definitionMap, defn.type, idlElem);\n            }\n          }\n          defn.idlId = \"idl-def-\" + name.toLowerCase();\n          break;\n        // Top-level entities without linkable members.\n        case \"callback\":\n        case \"typedef\":\n          name = defn.name;\n          defn.idlId = \"idl-def-\" + name.toLowerCase();\n          break;\n        // Members of top-level entities.\n        case \"attribute\":\n        case \"const\":\n        case \"field\":\n          name = defn.name;\n          defn.idlId = \"idl-def-\" + parent.toLowerCase() + \"-\" + name.toLowerCase();\n          break;\n        case \"operation\":\n          if (defn.name) {\n            name = defn.name;\n            var qualifiedName = parent + \".\" + name;\n            var fullyQualifiedName = parent + \".\" + name + \"()\";\n            if (!operationNames[fullyQualifiedName]) {\n              operationNames[fullyQualifiedName] = [];\n            }\n            if (!operationNames[qualifiedName]) {\n              operationNames[qualifiedName] = [];\n            } else {\n              defn.overload = operationNames[qualifiedName].length;\n              name = defn.name + \"!overload-\" + defn.overload;\n            }\n            operationNames[fullyQualifiedName].push(defn);\n            operationNames[qualifiedName].push(defn);\n          } else if (defn.getter || defn.setter || defn.deleter || defn.stringifier) {\n            name = \"\";\n          }\n          const idHead = `idl-def-${parent.toLowerCase()}-${name.toLowerCase()}`;\n          const idTail = defn.overload || !defn.arguments.length ? \"\" : \"-\" + defn.arguments.filter(arg => !typeIsWhitespace(arg.type)).map(arg => arg.name.toLowerCase()).join(\"-\").replace(/\\s/g, \"_\");\n          defn.idlId = idHead + idTail;\n          break;\n        case \"maplike\":\n          name = \"maplike\";\n          defn.idlId = (\"idl-def-\" + parent + \"-\" + name).toLowerCase();\n          break;\n        case \"iterable\":\n          name = \"iterable\";\n          defn.idlId = \"idl-def-\" + parent.toLowerCase() + \"-\" + name.toLowerCase();\n          break;\n        default:\n          (0, _pubsubhub.pub)(\"error\", new Error(\"ReSpec doesn't know about IDL type: `\" + defn.type + \"`.\"));\n          return;\n      }\n      if (parent) {\n        defn.linkFor = parent;\n      }\n      defn.dfn = findDfn(parent, name, definitionMap, defn.type, idlElem);\n    });\n  }\n\n  // This function looks for a  element whose title is 'name' and\n  // that is \"for\" 'parent', which is the empty string when 'name'\n  // refers to a top-level entity. For top-level entities, \n  // elements that inherit a non-empty [dfn-for] attribute are also\n  // counted as matching.\n  //\n  // When a matching  is found, it's given  formatting,\n  // marked as an IDL definition, and returned. If no  is found,\n  // the function returns 'undefined'.\n  function findDfn(parent, name, definitionMap, type, idlElem) {\n    const originalParent = parent;\n    const originalName = name;\n    parent = parent.toLowerCase();\n    switch (type) {\n      case \"operation\":\n        // Overloads all have unique names\n        if (name.search(\"!overload\") !== -1) {\n          name = name.toLowerCase();\n          break;\n        }\n        // Allow linking to both \"method()\" and \"method\" name.\n        const asMethodName = name.toLowerCase() + \"()\";\n        const asFullyQualifiedName = parent + \".\" + name.toLowerCase() + \"()\";\n\n        if (definitionMap[asMethodName] || definitionMap[asFullyQualifiedName]) {\n          const lookupName = definitionMap[asMethodName] ? asMethodName : asFullyQualifiedName;\n          const dfn = findDfn(parent, lookupName, definitionMap, null, idlElem);\n          if (!dfn) {\n            break; // try finding dfn using name, using normal search path...\n          }\n          const lt = dfn[0].dataset.lt ? dfn[0].dataset.lt.split(\"|\") : [];\n          lt.push(lookupName, name);\n          dfn[0].dataset.lt = lt.join(\"|\");\n          if (!definitionMap[name]) {\n            definitionMap[name] = [];\n          }\n          definitionMap[name].push(dfn);\n          return dfn;\n        }\n        // no method alias, so let's find the dfn and add it\n        const dfn = findDfn(parent, name, definitionMap, null, idlElem);\n        if (!dfn) {\n          break;\n        }\n        const lt = dfn[0].dataset.lt ? dfn[0].dataset.lt.split(\"|\") : [];\n        lt.push(asMethodName, name);\n        dfn[0].dataset.lt = lt.reverse().join(\"|\");\n        definitionMap[asMethodName] = [dfn];\n        return dfn;\n      case \"enum\":\n        if (name === \"\") {\n          name = \"the-empty-string\";\n          break;\n        }\n      default:\n        name = name.toLowerCase();\n    }\n    if (unlinkable.has(name)) {\n      return;\n    }\n    var dfnForArray = definitionMap[name];\n    var dfns = [];\n    if (dfnForArray) {\n      // Definitions that have a title and [data-dfn-for] that exactly match the\n      // IDL entity:\n      dfns = dfnForArray.filter(dfn => dfn[0].dataset.dfnFor === parent);\n      // If this is a top-level entity, and we didn't find anything with\n      // an explicitly empty [for], try  that inherited a [for].\n      if (dfns.length === 0 && parent === \"\" && dfnForArray.length === 1) {\n        dfns = dfnForArray;\n      }\n    }\n    // If we haven't found any definitions with explicit [for]\n    // and [title], look for a dotted definition, \"parent.name\".\n    if (dfns.length === 0 && parent !== \"\") {\n      var dottedName = parent + \".\" + name;\n      dfnForArray = definitionMap[dottedName];\n      if (dfnForArray !== undefined && dfnForArray.length === 1) {\n        dfns = dfnForArray;\n        // Found it: update the definition to specify its [for] and data-lt.\n        delete definitionMap[dottedName];\n        dfns[0].attr(\"data-dfn-for\", parent);\n        dfns[0].attr(\"data-lt\", name);\n        if (definitionMap[name] === undefined) {\n          definitionMap[name] = [];\n        }\n        definitionMap[name].push(dfns[0]);\n      }\n    }\n    if (dfns.length > 1) {\n      const msg = `Multiple \\`\\`s for \\`${originalName}\\` ${originalParent ? `in \\`${originalParent}\\`` : \"\"}`;\n      (0, _pubsubhub.pub)(\"error\", new Error(msg));\n    }\n    if (dfns.length === 0) {\n      const showWarnings = type && idlElem && name && idlElem.classList.contains(\"no-link-warnings\") === false;\n      if (showWarnings) {\n        var msg = `No \\`\\` for ${type} \\`${originalName}\\`${originalParent ? \" in `\" + originalParent + \"`\" : \"\"}`;\n        msg += \". [More info](https://github.com/w3c/respec/wiki/WebIDL-thing-is-not-defined).\";\n        (0, _pubsubhub.pub)(\"warn\", msg);\n      }\n      return;\n    }\n    const dfn = dfns[0][0]; // work on actual node, not jquery\n    const id = \"dom-\" + (parent ? parent + \"-\" : \"\") + name.replace(/[()]/g, \"\");\n    dfn.id = id;\n    dfn.dataset.idl = \"\";\n    dfn.dataset.title = dfn.textContent;\n    dfn.dataset.dfnFor = parent;\n    // Mark the definition as code.\n    if (!dfn.querySelector(\"code\") && !dfn.closest(\"code\") && dfn.children) {\n      const code = dfn.ownerDocument.createElement(\"code\");\n      while (dfn.hasChildNodes()) {\n        code.appendChild(dfn.firstChild);\n      }\n      dfn.appendChild(code);\n    }\n    return dfns[0];\n  }\n  var resolveDone;\n\n  const done = exports.done = new Promise(function (resolve) {\n    resolveDone = resolve;\n  });\n\n  function run(conf, doc, cb) {\n    var finish = function () {\n      resolveDone();\n      (0, _pubsubhub.pub)(\"end\", \"core/webidl\");\n      cb();\n    };\n    var $idl = $(\"pre.idl\", doc);\n    if (!$idl.length) {\n      return finish();\n    }\n    registerHelpers();\n    if (!$(\".idl\", doc).not(\"pre\").length) {\n      $(doc).find(\"head link\").first().before($(\"\";\n\n    $(doc).find(\"head link\").first().before(style);\n    var $secs = $(doc).find(\"h2, h3, h4, h5, h6\");\n    $secs.each(function (i, item) {\n      var $item = $(item);\n      if (!$item.hasClass(\"nolink\")) {\n        var resourceID = $item.attr(\"id\");\n        var $par = $item.parent();\n        if ($par.is(\"section\") || $par.is(\"div\")) {\n          if (!$par.hasClass(\"introductory\") && !$par.hasClass(\"nolink\")) {\n            resourceID = $par.attr(\"id\");\n          } else {\n            resourceID = null;\n          }\n        }\n        // if we still have resourceID\n        if (resourceID) {\n          // we have an id.  add a permalink\n          // right after the h* element\n          var theNode = $(\"\");\n          theNode.attr(\"class\", \"permalink\");\n          var ctext = $item.text();\n          var el = $(\"\");\n          el.attr({\n            href: \"#\" + resourceID,\n            \"aria-label\": \"Permalink for \" + ctext,\n            title: \"Permalink for \" + ctext\n          });\n          var sym = $(\"\");\n          sym.append(symbol);\n          el.append(sym);\n          theNode.append(el);\n          // if this is not being put at\n          // page edge, then separate it\n          // from the heading with a\n          // non-breaking space\n          if (!conf.permalinkEdge) {\n            $item.append(\" \");\n          }\n          $item.append(theNode);\n        }\n      }\n    });\n    cb();\n  }\n});\n//# sourceMappingURL=permalinks.js.map;\n",
        +    "define('core/id-headers',[\"exports\"], function (exports) {\n  \"use strict\";\n\n  Object.defineProperty(exports, \"__esModule\", {\n    value: true\n  });\n  exports.run = run;\n  // Module core/id-headers\n  // All headings are expected to have an ID, unless their immediate container has one.\n  // This is currently in core though it comes from a W3C rule. It may move in the future.\n\n  const name = exports.name = \"core/id-headers\";\n\n  function run(conf, doc, cb) {\n    Array.from(document.querySelectorAll(\"h2:not([id]), h3:not([id]), h4:not([id]), h5:not([id]), h6:not([id])\")).forEach(elem => {\n      $(elem).makeID();\n    });\n    cb();\n  }\n});\n//# sourceMappingURL=id-headers.js.map;\n",
        +    "define('core/location-hash',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n  \"use strict\";\n\n  Object.defineProperty(exports, \"__esModule\", {\n    value: true\n  });\n  exports.name = undefined;\n  exports.run = run;\n  const name = exports.name = \"core/location-hash\"; // Module core/location-hash\n  // Resets window.location.hash to jump to the right point in the document\n\n  function run(conf, doc, cb) {\n    // Added message for legacy compat with Aria specs\n    // See https://github.com/w3c/respec/issues/793\n    (0, _pubsubhub.pub)(\"start\", \"core/location-hash\");\n\n    let hash = \"\";\n    try {\n      hash = decodeURIComponent(window.location.hash).substr(1);\n    } catch (err) {\n      hash = \"\";\n    }\n    // Only scroll to the hash if the document hasn't been scrolled yet\n    // this ensures that a page refresh maintains the scroll position\n    if (!hash && !document.documentElement.scrollTop) {\n      return cb();\n    }\n    // Allow some degree of recovery for legacy fragments format.\n    // See https://github.com/w3c/respec/issues/1353\n    const hasLink = !!doc.getElementById(hash);\n    const isLegacyFrag = /\\W/.test(hash);\n    if (!hasLink && isLegacyFrag) {\n      const id = hash.replace(/[\\W]+/gim, \"-\").replace(/^-+/, \"\").replace(/-+$/, \"\");\n      if (document.getElementById(id)) {\n        hash = id;\n      }\n    }\n    window.location.hash = `#${hash}`;\n    cb();\n  }\n});\n//# sourceMappingURL=location-hash.js.map;\n",
        +    "\ndefine('deps/text!core/css/caniuse.css',[],function () { return '/* container for stats */\\n.caniuse-stats {\\n  display: flex;\\n  flex-wrap: wrap;\\n  justify-content: flex-start;\\n  align-items: baseline;\\n  cursor: pointer;\\n}\\n\\nbutton.caniuse-cell {\\n  margin: 1px 1px 0 0;\\n  border: none;\\n}\\n\\n.caniuse-browser {\\n  position: relative;\\n}\\n\\n/* reset styles, hide old versions by default */\\n.caniuse-browser ul {\\n  display: none;\\n  margin: 0;\\n  padding: 0;\\n  list-style: none;\\n  position: absolute;\\n  left: 0;\\n  z-index: 2;\\n  background: #fff;\\n  margin-top: 1px;\\n}\\n\\n.caniuse-stats a {\\n  white-space: nowrap;\\n  align-self: center;\\n  margin-left: .5em;\\n}\\n\\n/* a browser version */\\n.caniuse-cell {\\n  display: flex;\\n  color: rgba(0, 0, 0, 0.8);\\n  font-size: 90%;\\n  height: 0.8cm;\\n  margin-right: 1px;\\n  margin-top: 0;\\n  min-width: 3cm;\\n  overflow: visible;\\n  justify-content: center;\\n  align-items: center;\\n}\\n\\nli.caniuse-cell {\\n  margin-bottom: 1px;\\n}\\n\\n.caniuse-cell:focus {\\n  outline: none;\\n}\\n\\n.caniuse-cell:hover {\\n  color: rgba(0, 0, 0, 1);\\n}\\n\\n/* supports */\\n.caniuse-cell.y {\\n  background: #8bc34a;\\n}\\n\\n/* no support */\\n.caniuse-cell.n {\\n  background: #e53935;\\n}\\n\\n/* not supported by default / partial support etc\\nsee https://github.com/Fyrd/caniuse/blob/master/CONTRIBUTING.md for stats */\\n.caniuse-cell.d,\\n.caniuse-cell.a,\\n.caniuse-cell.x,\\n.caniuse-cell.p {\\n  background: #ffc107;\\n}\\n\\n/* show rest of the browser versions */\\n.caniuse-stats button:focus + ul,\\n.caniuse-stats .caniuse-browser:hover > ul {\\n  display: block;\\n}\\n';});\n\n",
        +    "define('core/caniuse',[\"exports\", \"core/utils\", \"core/pubsubhub\", \"deps/text!core/css/caniuse.css\", \"deps/hyperhtml\"], function (exports, _utils, _pubsubhub, _caniuse) {\n  \"use strict\";\n\n  Object.defineProperty(exports, \"__esModule\", {\n    value: true\n  });\n  exports.name = undefined;\n  exports.run = run;\n\n  var _caniuse2 = _interopRequireDefault(_caniuse);\n\n  function _interopRequireDefault(obj) {\n    return obj && obj.__esModule ? obj : {\n      default: obj\n    };\n  }\n\n  var _extends = Object.assign || function (target) {\n    for (var i = 1; i < arguments.length; i++) {\n      var source = arguments[i];\n\n      for (var key in source) {\n        if (Object.prototype.hasOwnProperty.call(source, key)) {\n          target[key] = source[key];\n        }\n      }\n    }\n\n    return target;\n  };\n\n  const name = exports.name = \"core/caniuse\";\n\n  const GH_USER_CONTENT_URL = \"https://raw.githubusercontent.com/Fyrd/caniuse/master/features-json/\";\n\n  // browser name dictionary\n  const BROWSERS = new Map([[\"chrome\", \"Chrome\"], [\"firefox\", \"Firefox\"], [\"ie\", \"IE\"], [\"edge\", \"Edge\"], [\"android\", \"Android\"], [\"safari\", \"Safari\"], [\"opera\", \"Opera\"], [\"bb\", \"Blackberry\"], [\"and_uc\", \"UC (Android)\"], [\"and_ff\", \"Firefox (Android)\"]]);\n\n  // Keys from https://github.com/Fyrd/caniuse/blob/master/CONTRIBUTING.md\n  const supportTitles = new Map([[\"y\", \"Supported.\"], [\"a\", \"Almost supported (aka Partial support).\"], [\"n\", \"No support, or disabled by default.\"], [\"p\", \"No support, but has Polyfill.\"], [\"u\", \"Support unknown.\"], [\"x\", \"Requires prefix to work.\"], [\"d\", \"Disabled by default (needs to enabled).\"]]);\n\n  async function run(conf) {\n    if (!conf.caniuse) {\n      return; // nothing to do.\n    }\n    normalizeConf(conf);\n    const { caniuse } = conf;\n    if (!caniuse.feature) {\n      return; // no feature to show\n    }\n    const { feature } = caniuse;\n    const featureURL = \"https://caniuse.com/#feat=\" + feature;\n    const link = (0, _utils.createResourceHint)({\n      hint: \"preconnect\",\n      href: \"https://raw.githubusercontent.com\"\n    });\n    document.head.appendChild(link);\n    document.head.appendChild(hyperHTML`\n    `);\n\n    const headDlElem = document.querySelector(\".head dl\");\n    const contentPromise = new Promise(async resolve => {\n      let content;\n      try {\n        const stats = await fetchAndCacheJson(caniuse);\n        content = createTableHTML(caniuse, stats);\n      } catch (err) {\n        console.error(err);\n        const msg = `Couldn't find feature \"${feature}\" on caniuse.com? ` + \"Please check the feature key on [caniuse.com](https://caniuse.com)\";\n        (0, _pubsubhub.pub)(\"error\", msg);\n        content = hyperHTML`caniuse.com`;\n      }\n      resolve(content);\n    });\n    const definitionPair = hyperHTML.bind(document.createDocumentFragment())`\n    
        Can I Use this API?
        \n
        ${{\n any: contentPromise,\n placeholder: \"Fetching data from caniuse.com...\"\n }}
        `;\n headDlElem.appendChild(definitionPair);\n await contentPromise;\n\n // remove from export\n (0, _pubsubhub.pub)(\"amend-user-config\", { caniuse: feature });\n (0, _pubsubhub.sub)(\"beforesave\", outputDoc => {\n hyperHTML.bind(outputDoc.querySelector(\".caniuse-stats\"))`\n caniuse.com`;\n });\n }\n\n /**\n * Normalizes `conf.caniuse` object to hold normalized configuration\n *\n * @param {Object} conf configuration settings\n */\n function normalizeConf(conf) {\n const DEFAULTS = {\n maxAge: 60 * 60 * 24 * 1000, // 24 hours (in ms)\n browsers: [\"chrome\", \"firefox\", \"safari\", \"edge\"],\n versions: 4\n };\n if (typeof conf.caniuse === \"string\") {\n conf.caniuse = _extends({ feature: conf.caniuse }, DEFAULTS);\n return;\n }\n if (Array.isArray(conf.caniuse.browsers)) {\n conf.caniuse.browsers = conf.caniuse.browsers.map(b => b.toLowerCase()).filter(isValidBrowser);\n } else {\n conf.caniuse.browsers = DEFAULTS.browsers;\n }\n Object.assign(conf.caniuse, DEFAULTS, _extends({}, conf.caniuse));\n function isValidBrowser(browser) {\n if (BROWSERS.has(browser)) {\n return true;\n }\n (0, _pubsubhub.pub)(\"warn\", `Ignoring invalid browser \"\\`${browser}\\`\" in ` + \"[`respecConfig.caniuse.browsers`](https://github.com/w3c/respec/wiki/caniuse)\");\n return false;\n }\n }\n\n /**\n * Get stats for canIUse table.\n *\n * @param {Object} caniuseConf normalized respecConfig.caniuse\n * @return {Object} Can I Use stats\n * @throws {Error} on failure\n */\n async function fetchAndCacheJson(caniuseConf) {\n const { apiURL, feature, maxAge } = caniuseConf;\n const url = apiURL ? apiURL.replace(\"{FEATURE}\", feature) : `${GH_USER_CONTENT_URL}${feature}.json`;\n const request = new Request(url);\n const response = await (0, _utils.fetchAndCache)(request, maxAge);\n const { stats } = await response.json();\n return stats;\n }\n\n /**\n * Get HTML element for the canIUse support table.\n *\n * @param {Object} stats CanIUse API results\n * @param {Object} conf respecConfig.caniuse\n */\n function createTableHTML(conf, stats) {\n // render the support table\n return hyperHTML`\n ${conf.browsers.map(browser => addBrowser(browser, conf.versions, stats[browser])).filter(elem => elem)}\n More info\n `;\n\n /**\n * Add a browser and it's support to table.\n *\n * @param {String} browser name of browser (as in CanIUse API response)\n * @param {Number} numVersions number of old browser versions to show\n * @param {Object} browserData stats data from api response\n * @param {Number} tabindex\n */\n function addBrowser(browser, numVersions, browserData) {\n if (!browserData) return;\n const getSupport = version => {\n const supportKeys = browserData[version].split(\"#\", 1)[0] // don't care about footnotes.\n .split(\" \").filter(item => item);\n const titles = supportKeys.filter(key => supportTitles.has(key)).map(key => supportTitles.get(key));\n return {\n support: supportKeys.join(\" \"),\n title: titles.join(\" \")\n };\n };\n const addBrowserVersion = version => {\n const { support, title } = getSupport(version);\n const cssClass = \"caniuse-cell \" + support;\n return `
      • ${version}
      • `;\n };\n\n const [latestVersion, ...olderVersions] = Object.keys(browserData).sort(_utils.semverCompare).slice(-numVersions).reverse();\n const { support, title } = getSupport(latestVersion);\n const cssClass = `caniuse-cell ${support}`;\n return hyperHTML`\n
        \n \n
          \n ${olderVersions.map(addBrowserVersion)}\n
        \n
        `;\n }\n }\n});\n//# sourceMappingURL=caniuse.js.map;\n", + "define('core/exporter',[\"exports\", \"core/utils\", \"core/pubsubhub\", \"deps/hyperhtml\"], function (exports, _utils, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.rsDocToDataURL = rsDocToDataURL;\n\n\n const mimeTypes = new Map([[\"text/html\", \"html\"], [\"application/xml\", \"xml\"]]);\n\n /**\n * Creates a dataURI from a ReSpec document. It also cleans up the document\n * removing various things.\n *\n * @param {String} mimeType mimetype. one of `mimeTypes` above\n * @param {Document} doc document to export. useful for testing purposes\n * @returns a stringified data-uri of document that can be saved.\n */\n /**\n * module: core/exporter\n * Exports a ReSpec document, based on mime type, so it can be saved, etc.\n * Also performs cleanup, removing things that shouldn't be in published documents.\n * That is, elements that have a \"removeOnSave\" css class.\n */\n\n function rsDocToDataURL(mimeType, doc = document) {\n const format = mimeTypes.get(mimeType);\n if (!format) {\n const validTypes = [...mimeTypes.values()].join(\", \");\n const msg = `Invalid format: ${mimeType}. Expected one of: ${validTypes}.`;\n throw new TypeError(msg);\n }\n const data = serialize(format, doc);\n const encodedString = encodeURIComponent(data);\n return `data:${mimeType};charset=utf-8,${encodedString}`;\n }\n\n function serialize(format, doc) {\n const cloneDoc = doc.cloneNode(true);\n cleanup(cloneDoc);\n let result = \"\";\n switch (format) {\n case \"xml\":\n result = new XMLSerializer().serializeToString(cloneDoc);\n break;\n default:\n {\n if (cloneDoc.doctype) {\n result += new XMLSerializer().serializeToString(cloneDoc.doctype);\n }\n result += cloneDoc.documentElement.outerHTML;\n }\n }\n return result;\n }\n\n function cleanup(cloneDoc) {\n const { head, body, documentElement } = cloneDoc;\n cleanupHyper(cloneDoc);\n\n cloneDoc.querySelectorAll(\".removeOnSave, #toc-nav\").forEach(elem => elem.remove());\n body.classList.remove(\"toc-sidebar\");\n (0, _utils.removeReSpec)(documentElement);\n\n const insertions = cloneDoc.createDocumentFragment();\n\n // Move meta viewport, as it controls the rendering on mobile.\n const metaViewport = cloneDoc.querySelector(\"meta[name='viewport']\");\n if (metaViewport && head.firstChild !== metaViewport) {\n insertions.appendChild(metaViewport);\n }\n\n // Move charset to near top, as it needs to be in the first 512 bytes.\n let metaCharset = cloneDoc.querySelector(\"meta[charset], meta[content*='charset=']\");\n if (!metaCharset) {\n metaCharset = hyperHTML``;\n }\n insertions.appendChild(metaCharset);\n\n // Add meta generator\n const respecVersion = `ReSpec ${window.respecVersion || \"Developer Channel\"}`;\n const metaGenerator = hyperHTML`\n \n `;\n\n insertions.appendChild(metaGenerator);\n head.insertBefore(insertions, head.firstChild);\n (0, _pubsubhub.pub)(\"beforesave\", documentElement);\n }\n\n function cleanupHyper({ documentElement: node }) {\n // collect first, or walker will cease too early\n const filter = comment => comment.textContent.startsWith(\"_hyper\");\n const walker = document.createTreeWalker(node, NodeFilter.SHOW_COMMENT, filter);\n for (const comment of [...walkTree(walker)]) {\n comment.remove();\n }\n }\n\n function* walkTree(walker) {\n while (walker.nextNode()) {\n yield walker.currentNode;\n }\n }\n});\n//# sourceMappingURL=exporter.js.map;\n", + "define('ui/save-html',[\"exports\", \"core/ui\", \"core/l10n\", \"core/pubsubhub\", \"core/exporter\", \"deps/hyperhtml\"], function (exports, _ui, _l10n, _pubsubhub, _exporter) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.show = show;\n exports.exportDocument = exportDocument;\n const name = exports.name = \"ui/save-html\";\n\n // Create and download an EPUB 3 version of the content\n // Using (by default) the EPUB 3 conversion service set up at labs.w3.org/epub-generator\n // For more details on that service, see https://github.com/iherman/respec2epub\n // Module ui/save-html\n // Saves content to HTML when asked to\n const epubURL = new URL(\"https://labs.w3.org/epub-generator/cgi-bin/epub-generator.py\");\n epubURL.searchParams.append(\"type\", \"respec\");\n epubURL.searchParams.append(\"url\", document.location.href);\n\n const downloadLinks = [{\n id: \"respec-save-as-html\",\n fileName: \"index.html\",\n title: \"HTML\",\n type: \"text/html\",\n get href() {\n return (0, _exporter.rsDocToDataURL)(this.type);\n }\n }, {\n id: \"respec-save-as-xml\",\n fileName: \"index.xhtml\",\n title: \"XML\",\n type: \"application/xml\",\n get href() {\n return (0, _exporter.rsDocToDataURL)(this.type);\n }\n }, {\n id: \"respec-save-as-epub\",\n fileName: \"spec.epub\",\n title: \"EPUB 3\",\n type: \"application/epub+zip\",\n href: epubURL.href\n }];\n\n function toDownloadLink(details) {\n const { id, href, fileName, title, type } = details;\n return hyperHTML`\n _ui.ui.closeModal()}\n >${title}`;\n }\n\n const saveDialog = {\n async show(button) {\n await document.respecIsReady;\n const div = hyperHTML`\n
        \n ${downloadLinks.map(toDownloadLink)}\n
        `;\n _ui.ui.freshModal(_l10n.l10n[_l10n.lang].save_snapshot, div, button);\n }\n };\n\n const supportsDownload = \"download\" in HTMLAnchorElement.prototype;\n let button;\n if (supportsDownload) {\n button = _ui.ui.addCommand(_l10n.l10n[_l10n.lang].save_snapshot, \"ui/save-html\", \"Ctrl+Shift+Alt+S\", \"💾\");\n }\n\n function show() {\n if (!supportsDownload) return;\n saveDialog.show(button);\n }\n\n function exportDocument(format, mimeType) {\n const msg = \"Exporting via ui/save-html module's `exportDocument()` is deprecated and will be removed. \" + \"Use core/exporter `rsDocToDataURL()` instead.\";\n (0, _pubsubhub.pub)(\"warn\", msg);\n console.warn(msg);\n return (0, _exporter.rsDocToDataURL)(mimeType);\n }\n});\n//# sourceMappingURL=save-html.js.map;\n", + "define('ui/search-specref',[\"exports\", \"core/ui\", \"core/biblio\", \"core/l10n\"], function (exports, _ui, _biblio, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.show = undefined;\n\n\n const button = _ui.ui.addCommand(_l10n.l10n[_l10n.lang].search_specref, \"ui/search-specref\", \"Ctrl+Shift+Alt+space\", \"🔎\"); // Module ui/search-specref\n // Search Specref database\n\n const specrefURL = \"https://specref.herokuapp.com/\";\n const refSearchURL = `${specrefURL}search-refs`;\n const reveseLookupURL = `${specrefURL}reverse-lookup`;\n const form = document.createElement(\"form\");\n const renderer = window.hyperHTML.bind(form);\n const resultList = hyperHTML.bind(document.createElement(\"div\"));\n\n form.id = \"specref-ui\";\n\n function renderResults(resultMap, query, timeTaken) {\n if (!resultMap.size) {\n return resultList`\n

        \n Your search - ${query} -\n did not match any references.\n

        \n `;\n }\n const wires = Array.from(resultMap.entries()).slice(0, 99).map(toDefinitionPair).reduce((collector, pair) => collector.concat(pair), []);\n return resultList`\n

        \n ${resultMap.size} results (${timeTaken} seconds).\n ${resultMap.size > 99 ? \"First 100 results.\" : \"\"}\n

        \n
        ${wires}
        \n `;\n }\n\n function toDefinitionPair([key, entry]) {\n return hyperHTML.wire(entry)`\n
        \n [${key}]\n
        \n
        ${(0, _biblio.wireReference)(entry)}
        \n `;\n }\n\n function resultProcessor({ includeVersions } = { includeVersions: false }) {\n return (...fetchedData) => {\n const combinedResults = fetchedData.reduce((collector, resultObj) => Object.assign(collector, resultObj), {});\n const results = new Map(Object.entries(combinedResults));\n // remove aliases\n Array.from(results.entries()).filter(([, entry]) => entry.aliasOf).map(([key]) => key).reduce((results, key) => results.delete(key) && results, results);\n // Remove versions, if asked to\n if (!includeVersions) {\n Array.from(results.values()).filter(entry => typeof entry === \"object\" && \"versions\" in entry).reduce((collector, entry) => collector.concat(entry.versions), []).forEach(version => {\n results.delete(version);\n });\n }\n // Remove legacy string entries\n Array.from(results.entries()).filter(([, entry]) => typeof entry !== \"object\").reduce((result, [key]) => results.delete(key) && results, results);\n return results;\n };\n }\n\n form.addEventListener(\"submit\", async ev => {\n ev.preventDefault();\n const { searchBox } = form;\n const query = searchBox.value;\n if (!query) {\n searchBox.focus();\n return;\n }\n render({ state: \"Searching Specref…\" });\n const refSearch = new URL(refSearchURL);\n refSearch.searchParams.set(\"q\", query);\n const reverseLookup = new URL(reveseLookupURL);\n reverseLookup.searchParams.set(\"urls\", query);\n try {\n const startTime = performance.now();\n const jsonData = await Promise.all([fetch(refSearch).then(response => response.json()), fetch(reverseLookup).then(response => response.json())]);\n const { checked: includeVersions } = form.includeVersions;\n const processResults = resultProcessor({ includeVersions });\n const results = processResults(...jsonData);\n render({\n query,\n results,\n state: \"\",\n timeTaken: Math.round(performance.now() - startTime) / 1000\n });\n } catch (err) {\n console.error(err);\n render({ state: \"Error! Couldn't do search.\" });\n } finally {\n searchBox.focus();\n }\n });\n\n function show() {\n render();\n _ui.ui.freshModal(_l10n.l10n[_l10n.lang].search_specref, form, button);\n form.querySelector(\"input[type=search]\").focus();\n }\n\n const mast = hyperHTML.wire()`\n
        \n

        \n An Open-Source, Community-Maintained Database of\n Web Standards & Related References.\n

        \n
        \n
        \n \n \n Search\n \n \n
        \n`;\n\n function render({ state, results, timeTaken, query } = { state: \"\" }) {\n if (!results) {\n renderer`
        ${mast}
        `;\n return;\n }\n renderer`\n
        ${mast}
        \n \n \n `;\n }\n\n exports.show = show;\n});\n//# sourceMappingURL=search-specref.js.map;\n", + "define('ui/dfn-list',[\"exports\", \"core/ui\", \"core/l10n\", \"deps/hyperhtml\"], function (exports, _ui, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.show = undefined;\n\n\n const button = _ui.ui.addCommand(_l10n.l10n[_l10n.lang].definition_list, \"ui/dfn-list\", \"Ctrl+Shift+Alt+D\", \"📔\"); /// Module ui/dfn-list\n // Displays all definitions with links to the defining element.\n\n\n const ul = document.createElement(\"ul\");\n ul.classList.add(\"respec-dfn-list\");\n const render = window.hyperHTML.bind(ul);\n\n ul.addEventListener(\"click\", ev => {\n _ui.ui.closeModal();\n ev.stopPropagation();\n });\n\n function show() {\n const definitionLinks = Object.entries(respecConfig.definitionMap).sort(([keyA], [keyB]) => keyA.localeCompare(keyB)).map(([key, $dfns]) => {\n const [dfn] = $dfns[0];\n return window.hyperHTML.wire(dfn, \":li>a\")`\n
      • \n \n ${dfn.textContent}\n \n
      • \n `;\n });\n render`${definitionLinks}`;\n _ui.ui.freshModal(_l10n.l10n[_l10n.lang].list_of_definitions, ul, button);\n }\n\n exports.show = show;\n});\n//# sourceMappingURL=dfn-list.js.map;\n", + "define('ui/about-respec',[\"exports\", \"core/ui\", \"core/l10n\", \"deps/hyperhtml\"], function (exports, _ui, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.show = undefined;\n\n\n // window.respecVersion is added at build time (see tools/builder.js)\n window.respecVersion = window.respecVersion || \"Developer Edition\"; // Module ui/about-respec\n // A simple about dialog with pointer to the help\n\n const div = document.createElement(\"div\");\n const render = hyperHTML.bind(div);\n const button = _ui.ui.addCommand(`About ${window.respecVersion}`, \"ui/about-respec\", \"Ctrl+Shift+Alt+A\", \"ℹ️\");\n\n function show() {\n _ui.ui.freshModal(`${_l10n.l10n[_l10n.lang].about_respec} - ${window.respecVersion}`, div, button);\n let entries = [];\n if (\"getEntriesByType\" in performance) {\n performance.getEntriesByType(\"measure\").sort((a, b) => b.duration - a.duration).map(({ name, duration }) => {\n const fixedSize = duration.toFixed(2);\n const humanDuration = fixedSize > 1000 ? `${Math.round(fixedSize / 1000.0)} second(s)` : `${fixedSize} milliseconds`;\n return { name, duration: humanDuration };\n }).map(perfEntryToTR).reduce((collector, entry) => {\n collector.push(entry);\n return collector;\n }, entries);\n }\n render`\n

        \n ReSpec is a document production toolchain, with a notable focus on W3C specifications.\n

        \n

        \n Documentation,\n Bugs.\n

        \n \n \n \n \n \n \n \n \n ${entries}\n \n`;\n }\n\n function perfEntryToTR({ name, duration }) {\n const render = hyperHTML.bind(document.createElement(\"tr\"));\n const moduleURL = `https://github.com/w3c/respec/tree/develop/src/${name}.js`;\n return render`\n \n \n ${name}\n \n \n \n ${duration} \n \n `;\n }\n\n exports.show = show;\n});\n//# sourceMappingURL=about-respec.js.map;\n", + "define('core/seo',[\"exports\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.run = run;\n /**\n * This Module adds a metatag description to the document, based on the\n * first paragraph of the abstract.\n */\n\n const name = exports.name = \"core/seo\";\n\n async function run(conf, doc, cb) {\n // This is not critical, so let's continue other processing first\n cb();\n await doc.respecIsReady;\n const firstParagraph = doc.querySelector(\"#abstract p:first-of-type\");\n if (!firstParagraph) {\n return; // no abstract, so nothing to do\n }\n insertMetaDescription(firstParagraph);\n }\n\n function insertMetaDescription(firstParagraph) {\n // Normalize whitespace: trim, remove new lines, tabs, etc.\n const doc = firstParagraph.ownerDocument;\n const content = firstParagraph.textContent.replace(/\\s+/, \" \").trim();\n const metaElem = doc.createElement(\"meta\");\n metaElem.name = \"description\";\n metaElem.content = content;\n doc.head.appendChild(metaElem);\n }\n});\n//# sourceMappingURL=seo.js.map;\n", + "define('w3c/seo',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"w3c/seo\"; // Module w3c/seo\n // Manages SEO information for documents\n // e.g. set the canonical URL for the document if configured\n function run(conf, doc, cb) {\n var trLatestUri = conf.shortName ? \"https://www.w3.org/TR/\" + conf.shortName + \"/\" : null;\n switch (conf.canonicalURI) {\n case \"edDraft\":\n if (conf.edDraftURI) {\n conf.canonicalURI = new URL(conf.edDraftURI, doc.location).href;\n } else {\n (0, _pubsubhub.pub)(\"warn\", \"Canonical URI set to edDraft, \" + \"but no edDraftURI is set in configuration\");\n conf.canonicalURI = null;\n }\n break;\n case \"TR\":\n if (trLatestUri) {\n conf.canonicalURI = trLatestUri;\n } else {\n (0, _pubsubhub.pub)(\"warn\", \"Canonical URI set to TR, but \" + \"no shortName is set in configuration\");\n conf.canonicalURI = null;\n }\n break;\n default:\n if (conf.canonicalURI) {\n try {\n conf.canonicalURI = new URL(conf.canonicalURI, doc.location).href;\n } catch (err) {\n (0, _pubsubhub.pub)(\"warn\", \"CanonicalURI is an invalid URL: \" + err.message);\n conf.canonicalURI = null;\n }\n } else if (trLatestUri) {\n conf.canonicalURI = trLatestUri;\n }\n }\n if (conf.canonicalURI) {\n var linkElem = doc.createElement(\"link\");\n linkElem.setAttribute(\"rel\", \"canonical\");\n linkElem.setAttribute(\"href\", conf.canonicalURI);\n doc.head.appendChild(linkElem);\n }\n cb();\n if (conf.doJsonLd) {\n addJSONLDInfo(conf, doc);\n }\n }\n\n async function addJSONLDInfo(conf, doc) {\n await doc.respecIsReady;\n // Content for JSON\n const type = [\"TechArticle\"];\n if (conf.rdfStatus) type.push(conf.rdfStatus);\n\n const jsonld = {\n \"@context\": [\"http://schema.org\", {\n \"@vocab\": \"http://schema.org/\",\n \"@language\": doc.documentElement.lang || \"en\",\n w3p: \"http://www.w3.org/2001/02pd/rec54#\",\n foaf: \"http://xmlns.com/foaf/0.1/\",\n datePublished: { \"@type\": \"http://www.w3.org/2001/XMLSchema#date\" },\n inLanguage: { \"@language\": null },\n isBasedOn: { \"@type\": \"@id\" },\n license: { \"@type\": \"@id\" }\n }],\n id: conf.canonicalURI || conf.thisVersion,\n type,\n name: conf.title,\n inLanguage: doc.documentElement.lang || \"en\",\n license: conf.licenseInfo.url,\n datePublished: conf.dashDate,\n copyrightHolder: {\n name: \"World Wide Web Consortium\",\n url: \"https://www.w3.org/\"\n },\n discussionUrl: conf.issueBase,\n alternativeHeadline: conf.subtitle,\n isBasedOn: conf.prevVersion\n };\n\n // add any additional copyright holders\n if (conf.additionalCopyrightHolders) {\n const addl = Array.isArray(conf.additionalCopyrightHolders) ? conf.additionalCopyrightHolders : [conf.additionalCopyrightHolders];\n jsonld.copyrightHolder = [jsonld.copyrightHolder, ...addl.map(h => ({ name: h }))];\n }\n\n // description from meta description\n const description = doc.head.querySelector(\"meta[name=description]\");\n if (description) {\n jsonld.description = description.content;\n }\n\n // Editors\n if (conf.editors) {\n jsonld.editor = conf.editors.map(addPerson);\n }\n if (conf.authors) {\n jsonld.contributor = conf.authors.map(addPerson);\n }\n\n // normative and informative references\n jsonld.citation = [...conf.normativeReferences, ...conf.informativeReferences].map(ref => conf.biblio[ref]).filter(ref => typeof ref === \"object\").map(addRef);\n\n const script = doc.createElement(\"script\");\n script.type = \"application/ld+json\";\n script.textContent = JSON.stringify(jsonld, null, 2);\n doc.head.appendChild(script);\n }\n\n // Turn editors and authors into a list of JSON-LD relationships\n function addPerson({ name, url, mailto, company, companyURL }) {\n const ed = {\n type: \"Person\",\n name,\n url,\n \"foaf:mbox\": mailto\n };\n if (company || companyURL) {\n ed.worksFor = {\n name: company,\n url: companyURL\n };\n }\n return ed;\n }\n\n // Create a reference URL from the ref\n function addRef(ref) {\n const { href: id, title: name, href: url } = ref;\n return {\n id,\n type: \"TechArticle\",\n name,\n url\n };\n }\n});\n//# sourceMappingURL=seo.js.map;\n", + "\ndefine('deps/text!core/css/github.css',[],function () { return '/*\\n\\ngithub.com style (c) Vasily Polovnyov \\n\\n*/\\n\\n.hljs {\\n display: block;\\n overflow-x: auto;\\n padding: 0.5em;\\n color: #333;\\n background: #f8f8f8;\\n}\\n\\n.hljs-comment,\\n.hljs-quote {\\n color: #998;\\n font-style: italic;\\n}\\n\\n.hljs-keyword,\\n.hljs-selector-tag,\\n.hljs-subst {\\n color: #333;\\n font-weight: bold;\\n}\\n\\n.hljs-number,\\n.hljs-literal,\\n.hljs-variable,\\n.hljs-template-variable,\\n.hljs-tag .hljs-attr {\\n color: #008080;\\n}\\n\\n.hljs-string,\\n.hljs-doctag {\\n color: #d14;\\n}\\n\\n.hljs-title,\\n.hljs-section,\\n.hljs-selector-id {\\n color: #900;\\n font-weight: bold;\\n}\\n\\n.hljs-subst {\\n font-weight: normal;\\n}\\n\\n.hljs-type,\\n.hljs-class .hljs-title {\\n color: #458;\\n font-weight: bold;\\n}\\n\\n.hljs-tag,\\n.hljs-name,\\n.hljs-attribute {\\n color: #000080;\\n font-weight: normal;\\n}\\n\\n.hljs-regexp,\\n.hljs-link {\\n color: #009926;\\n}\\n\\n.hljs-symbol,\\n.hljs-bullet {\\n color: #990073;\\n}\\n\\n.hljs-built_in,\\n.hljs-builtin-name {\\n color: #0086b3;\\n}\\n\\n.hljs-meta {\\n color: #999;\\n font-weight: bold;\\n}\\n\\n.hljs-deletion {\\n background: #fdd;\\n}\\n\\n.hljs-addition {\\n background: #dfd;\\n}\\n\\n.hljs-emphasis {\\n font-style: italic;\\n}\\n\\n.hljs-strong {\\n font-weight: bold;\\n}\\n';});\n\n", + "\ndefine('deps/text!core/../../worker/respec-worker.js',[],function () { return '// ReSpec Worker v0.1.1\\n\"use strict\";\\ntry {\\n importScripts(\"https://www.w3.org/Tools/respec/respec-highlight.js\");\\n hljs.configure({\\n tabReplace: \" \", // 2 spaces\\n languages: [\"abnf\", \"css\", \"http\", \"javascript\", \"json\", \"markdown\", \"xml\"],\\n });\\n} catch (err) {\\n console.error(\"Network error loading/configuring highlighter\", err);\\n}\\n\\nself.addEventListener(\"message\", ({ data: originalData }) => {\\n const data = Object.assign({}, originalData);\\n switch (data.action) {\\n case \"highlight\":\\n const { code } = data;\\n const langs = data.languages.length ? data.languages : undefined;\\n try {\\n const { value, language } = self.hljs.highlightAuto(code, langs);\\n Object.assign(data, { value, language });\\n } catch (err) {\\n console.error(\"Could not transform some code?\", err);\\n // Post back the original code\\n Object.assign(data, { value: code, language: \"\" });\\n }\\n }\\n self.postMessage(data);\\n});\\n';});\n\n", + "define('core/worker',[\"exports\", \"core/utils\", \"deps/text!../../worker/respec-worker.js\"], function (exports, _utils, _respecWorker) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.worker = exports.name = undefined;\n\n var _respecWorker2 = _interopRequireDefault(_respecWorker);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n /**\n * Module core/worker\n *\n * Exports a Web Worker for ReSpec, allowing for\n * multi-threaded processing of things.\n */\n const name = exports.name = \"core/worker\";\n\n // Opportunistically preload syntax highlighter, which is used by the worker\n\n // Opportunistically preload syntax highlighter\n const hint = {\n hint: \"preload\",\n href: \"https://www.w3.org/Tools/respec/respec-highlight.js\",\n as: \"script\"\n };\n const link = (0, _utils.createResourceHint)(hint);\n document.head.appendChild(link);\n\n const workerURL = URL.createObjectURL(new Blob([_respecWorker2.default], { type: \"application/javascript\" }));\n const worker = exports.worker = new Worker(workerURL);\n});\n//# sourceMappingURL=worker.js.map;\n", + "define('core/highlight',[\"exports\", \"deps/text!core/css/github.css\", \"core/worker\"], function (exports, _github, _worker) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _github2 = _interopRequireDefault(_github);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n /**\n * Module core/highlight\n *\n * Performs syntax highlighting to all pre and code elements.\n */\n const name = exports.name = \"core/highlight\";\n\n // Opportunistically insert the style into the head to reduce FOUC.\n const codeStyle = document.createElement(\"style\");\n codeStyle.textContent = _github2.default;\n document.head.appendChild(codeStyle);\n function getLanguageHint(classList) {\n return Array.from(classList).filter(item => item !== \"highlight\" && item !== \"nolinks\").map(item => item.toLowerCase());\n }\n\n async function run(conf) {\n // Nothing to highlight\n if (conf.noHighlightCSS) {\n codeStyle.remove();\n return;\n }\n const highlightables = Array.from(document.querySelectorAll(\"pre:not(.idl):not(.nohighlight), code.highlight\"));\n // Nothing to highlight\n if (highlightables.length === 0) {\n codeStyle.remove();\n return;\n }\n const promisesToHighlight = highlightables.map((element, i) => {\n return new Promise(resolve => {\n if (element.textContent.trim() === \"\") {\n return resolve(); // no work to do\n }\n const done = () => {\n element.setAttribute(\"aria-busy\", \"false\");\n resolve();\n };\n // We always resolve, even if we couldn't actually highlight\n const timeoutId = setTimeout(() => {\n console.error(\"Timed-out waiting for highlight:\", element);\n done();\n }, 4000);\n const msg = {\n action: \"highlight\",\n code: element.textContent,\n id: `highlight:${i}`,\n languages: getLanguageHint(element.classList)\n };\n _worker.worker.addEventListener(\"message\", function listener(ev) {\n const { data: { id, code, language, value } } = ev;\n if (id !== msg.id) {\n return; // not for us!\n }\n element.innerHTML = value;\n if (element.localName === \"pre\") {\n element.classList.add(\"hljs\");\n }\n if (language) {\n element.classList.add(language);\n }\n clearTimeout(timeoutId);\n _worker.worker.removeEventListener(\"message\", listener);\n done();\n });\n element.setAttribute(\"aria-busy\", \"true\");\n _worker.worker.postMessage(msg);\n });\n });\n await Promise.all(promisesToHighlight);\n }\n});\n//# sourceMappingURL=highlight.js.map;\n", + "\ndefine('deps/text!core/images/clipboard.svg',[],function () { return '';});\n\n", + "/*!\n * clipboard.js v2.0.1\n * https://zenorocha.github.io/clipboard.js\n * \n * Licensed MIT © Zeno Rocha\n */\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine('deps/clipboard',[], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ClipboardJS\"] = factory();\n\telse\n\t\troot[\"ClipboardJS\"] = factory();\n})(this, function() {\nreturn /******/ (function(modules) { // webpackBootstrap\n/******/ \t// The module cache\n/******/ \tvar installedModules = {};\n/******/\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(installedModules[moduleId]) {\n/******/ \t\t\treturn installedModules[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = installedModules[moduleId] = {\n/******/ \t\t\ti: moduleId,\n/******/ \t\t\tl: false,\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/\n/******/ \t\t// Execute the module function\n/******/ \t\tmodules[moduleId].call(module.exports, module, module.exports, __webpack_require__);\n/******/\n/******/ \t\t// Flag the module as loaded\n/******/ \t\tmodule.l = true;\n/******/\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/\n/******/\n/******/ \t// expose the modules object (__webpack_modules__)\n/******/ \t__webpack_require__.m = modules;\n/******/\n/******/ \t// expose the module cache\n/******/ \t__webpack_require__.c = installedModules;\n/******/\n/******/ \t// identity function for calling harmony imports with the correct context\n/******/ \t__webpack_require__.i = function(value) { return value; };\n/******/\n/******/ \t// define getter function for harmony exports\n/******/ \t__webpack_require__.d = function(exports, name, getter) {\n/******/ \t\tif(!__webpack_require__.o(exports, name)) {\n/******/ \t\t\tObject.defineProperty(exports, name, {\n/******/ \t\t\t\tconfigurable: false,\n/******/ \t\t\t\tenumerable: true,\n/******/ \t\t\t\tget: getter\n/******/ \t\t\t});\n/******/ \t\t}\n/******/ \t};\n/******/\n/******/ \t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t__webpack_require__.n = function(module) {\n/******/ \t\tvar getter = module && module.__esModule ?\n/******/ \t\t\tfunction getDefault() { return module['default']; } :\n/******/ \t\t\tfunction getModuleExports() { return module; };\n/******/ \t\t__webpack_require__.d(getter, 'a', getter);\n/******/ \t\treturn getter;\n/******/ \t};\n/******/\n/******/ \t// Object.prototype.hasOwnProperty.call\n/******/ \t__webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };\n/******/\n/******/ \t// __webpack_public_path__\n/******/ \t__webpack_require__.p = \"\";\n/******/\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(__webpack_require__.s = 3);\n/******/ })\n/************************************************************************/\n/******/ ([\n/* 0 */\n/***/ (function(module, exports, __webpack_require__) {\n\nvar __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_ARRAY__, __WEBPACK_AMD_DEFINE_RESULT__;(function (global, factory) {\n if (true) {\n !(__WEBPACK_AMD_DEFINE_ARRAY__ = [module, __webpack_require__(7)], __WEBPACK_AMD_DEFINE_FACTORY__ = (factory),\n\t\t\t\t__WEBPACK_AMD_DEFINE_RESULT__ = (typeof __WEBPACK_AMD_DEFINE_FACTORY__ === 'function' ?\n\t\t\t\t(__WEBPACK_AMD_DEFINE_FACTORY__.apply(exports, __WEBPACK_AMD_DEFINE_ARRAY__)) : __WEBPACK_AMD_DEFINE_FACTORY__),\n\t\t\t\t__WEBPACK_AMD_DEFINE_RESULT__ !== undefined && (module.exports = __WEBPACK_AMD_DEFINE_RESULT__));\n } else if (typeof exports !== \"undefined\") {\n factory(module, require('select'));\n } else {\n var mod = {\n exports: {}\n };\n factory(mod, global.select);\n global.clipboardAction = mod.exports;\n }\n})(this, function (module, _select) {\n 'use strict';\n\n var _select2 = _interopRequireDefault(_select);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _typeof = typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\" ? function (obj) {\n return typeof obj;\n } : function (obj) {\n return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj;\n };\n\n function _classCallCheck(instance, Constructor) {\n if (!(instance instanceof Constructor)) {\n throw new TypeError(\"Cannot call a class as a function\");\n }\n }\n\n var _createClass = function () {\n function defineProperties(target, props) {\n for (var i = 0; i < props.length; i++) {\n var descriptor = props[i];\n descriptor.enumerable = descriptor.enumerable || false;\n descriptor.configurable = true;\n if (\"value\" in descriptor) descriptor.writable = true;\n Object.defineProperty(target, descriptor.key, descriptor);\n }\n }\n\n return function (Constructor, protoProps, staticProps) {\n if (protoProps) defineProperties(Constructor.prototype, protoProps);\n if (staticProps) defineProperties(Constructor, staticProps);\n return Constructor;\n };\n }();\n\n var ClipboardAction = function () {\n /**\n * @param {Object} options\n */\n function ClipboardAction(options) {\n _classCallCheck(this, ClipboardAction);\n\n this.resolveOptions(options);\n this.initSelection();\n }\n\n /**\n * Defines base properties passed from constructor.\n * @param {Object} options\n */\n\n\n _createClass(ClipboardAction, [{\n key: 'resolveOptions',\n value: function resolveOptions() {\n var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n this.action = options.action;\n this.container = options.container;\n this.emitter = options.emitter;\n this.target = options.target;\n this.text = options.text;\n this.trigger = options.trigger;\n\n this.selectedText = '';\n }\n }, {\n key: 'initSelection',\n value: function initSelection() {\n if (this.text) {\n this.selectFake();\n } else if (this.target) {\n this.selectTarget();\n }\n }\n }, {\n key: 'selectFake',\n value: function selectFake() {\n var _this = this;\n\n var isRTL = document.documentElement.getAttribute('dir') == 'rtl';\n\n this.removeFake();\n\n this.fakeHandlerCallback = function () {\n return _this.removeFake();\n };\n this.fakeHandler = this.container.addEventListener('click', this.fakeHandlerCallback) || true;\n\n this.fakeElem = document.createElement('textarea');\n // Prevent zooming on iOS\n this.fakeElem.style.fontSize = '12pt';\n // Reset box model\n this.fakeElem.style.border = '0';\n this.fakeElem.style.padding = '0';\n this.fakeElem.style.margin = '0';\n // Move element out of screen horizontally\n this.fakeElem.style.position = 'absolute';\n this.fakeElem.style[isRTL ? 'right' : 'left'] = '-9999px';\n // Move element to the same position vertically\n var yPosition = window.pageYOffset || document.documentElement.scrollTop;\n this.fakeElem.style.top = yPosition + 'px';\n\n this.fakeElem.setAttribute('readonly', '');\n this.fakeElem.value = this.text;\n\n this.container.appendChild(this.fakeElem);\n\n this.selectedText = (0, _select2.default)(this.fakeElem);\n this.copyText();\n }\n }, {\n key: 'removeFake',\n value: function removeFake() {\n if (this.fakeHandler) {\n this.container.removeEventListener('click', this.fakeHandlerCallback);\n this.fakeHandler = null;\n this.fakeHandlerCallback = null;\n }\n\n if (this.fakeElem) {\n this.container.removeChild(this.fakeElem);\n this.fakeElem = null;\n }\n }\n }, {\n key: 'selectTarget',\n value: function selectTarget() {\n this.selectedText = (0, _select2.default)(this.target);\n this.copyText();\n }\n }, {\n key: 'copyText',\n value: function copyText() {\n var succeeded = void 0;\n\n try {\n succeeded = document.execCommand(this.action);\n } catch (err) {\n succeeded = false;\n }\n\n this.handleResult(succeeded);\n }\n }, {\n key: 'handleResult',\n value: function handleResult(succeeded) {\n this.emitter.emit(succeeded ? 'success' : 'error', {\n action: this.action,\n text: this.selectedText,\n trigger: this.trigger,\n clearSelection: this.clearSelection.bind(this)\n });\n }\n }, {\n key: 'clearSelection',\n value: function clearSelection() {\n if (this.trigger) {\n this.trigger.focus();\n }\n\n window.getSelection().removeAllRanges();\n }\n }, {\n key: 'destroy',\n value: function destroy() {\n this.removeFake();\n }\n }, {\n key: 'action',\n set: function set() {\n var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'copy';\n\n this._action = action;\n\n if (this._action !== 'copy' && this._action !== 'cut') {\n throw new Error('Invalid \"action\" value, use either \"copy\" or \"cut\"');\n }\n },\n get: function get() {\n return this._action;\n }\n }, {\n key: 'target',\n set: function set(target) {\n if (target !== undefined) {\n if (target && (typeof target === 'undefined' ? 'undefined' : _typeof(target)) === 'object' && target.nodeType === 1) {\n if (this.action === 'copy' && target.hasAttribute('disabled')) {\n throw new Error('Invalid \"target\" attribute. Please use \"readonly\" instead of \"disabled\" attribute');\n }\n\n if (this.action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {\n throw new Error('Invalid \"target\" attribute. You can\\'t cut text from elements with \"readonly\" or \"disabled\" attributes');\n }\n\n this._target = target;\n } else {\n throw new Error('Invalid \"target\" value, use a valid Element');\n }\n }\n },\n get: function get() {\n return this._target;\n }\n }]);\n\n return ClipboardAction;\n }();\n\n module.exports = ClipboardAction;\n});\n\n/***/ }),\n/* 1 */\n/***/ (function(module, exports, __webpack_require__) {\n\nvar is = __webpack_require__(6);\nvar delegate = __webpack_require__(5);\n\n/**\n * Validates all params and calls the right\n * listener function based on its target type.\n *\n * @param {String|HTMLElement|HTMLCollection|NodeList} target\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listen(target, type, callback) {\n if (!target && !type && !callback) {\n throw new Error('Missing required arguments');\n }\n\n if (!is.string(type)) {\n throw new TypeError('Second argument must be a String');\n }\n\n if (!is.fn(callback)) {\n throw new TypeError('Third argument must be a Function');\n }\n\n if (is.node(target)) {\n return listenNode(target, type, callback);\n }\n else if (is.nodeList(target)) {\n return listenNodeList(target, type, callback);\n }\n else if (is.string(target)) {\n return listenSelector(target, type, callback);\n }\n else {\n throw new TypeError('First argument must be a String, HTMLElement, HTMLCollection, or NodeList');\n }\n}\n\n/**\n * Adds an event listener to a HTML element\n * and returns a remove listener function.\n *\n * @param {HTMLElement} node\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNode(node, type, callback) {\n node.addEventListener(type, callback);\n\n return {\n destroy: function() {\n node.removeEventListener(type, callback);\n }\n }\n}\n\n/**\n * Add an event listener to a list of HTML elements\n * and returns a remove listener function.\n *\n * @param {NodeList|HTMLCollection} nodeList\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNodeList(nodeList, type, callback) {\n Array.prototype.forEach.call(nodeList, function(node) {\n node.addEventListener(type, callback);\n });\n\n return {\n destroy: function() {\n Array.prototype.forEach.call(nodeList, function(node) {\n node.removeEventListener(type, callback);\n });\n }\n }\n}\n\n/**\n * Add an event listener to a selector\n * and returns a remove listener function.\n *\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenSelector(selector, type, callback) {\n return delegate(document.body, selector, type, callback);\n}\n\nmodule.exports = listen;\n\n\n/***/ }),\n/* 2 */\n/***/ (function(module, exports) {\n\nfunction E () {\n // Keep this empty so it's easier to inherit from\n // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n on: function (name, callback, ctx) {\n var e = this.e || (this.e = {});\n\n (e[name] || (e[name] = [])).push({\n fn: callback,\n ctx: ctx\n });\n\n return this;\n },\n\n once: function (name, callback, ctx) {\n var self = this;\n function listener () {\n self.off(name, listener);\n callback.apply(ctx, arguments);\n };\n\n listener._ = callback\n return this.on(name, listener, ctx);\n },\n\n emit: function (name) {\n var data = [].slice.call(arguments, 1);\n var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n var i = 0;\n var len = evtArr.length;\n\n for (i; i < len; i++) {\n evtArr[i].fn.apply(evtArr[i].ctx, data);\n }\n\n return this;\n },\n\n off: function (name, callback) {\n var e = this.e || (this.e = {});\n var evts = e[name];\n var liveEvents = [];\n\n if (evts && callback) {\n for (var i = 0, len = evts.length; i < len; i++) {\n if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n liveEvents.push(evts[i]);\n }\n }\n\n // Remove event from queue to prevent memory leak\n // Suggested by https://github.com/lazd\n // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n (liveEvents.length)\n ? e[name] = liveEvents\n : delete e[name];\n\n return this;\n }\n};\n\nmodule.exports = E;\n\n\n/***/ }),\n/* 3 */\n/***/ (function(module, exports, __webpack_require__) {\n\nvar __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_ARRAY__, __WEBPACK_AMD_DEFINE_RESULT__;(function (global, factory) {\n if (true) {\n !(__WEBPACK_AMD_DEFINE_ARRAY__ = [module, __webpack_require__(0), __webpack_require__(2), __webpack_require__(1)], __WEBPACK_AMD_DEFINE_FACTORY__ = (factory),\n\t\t\t\t__WEBPACK_AMD_DEFINE_RESULT__ = (typeof __WEBPACK_AMD_DEFINE_FACTORY__ === 'function' ?\n\t\t\t\t(__WEBPACK_AMD_DEFINE_FACTORY__.apply(exports, __WEBPACK_AMD_DEFINE_ARRAY__)) : __WEBPACK_AMD_DEFINE_FACTORY__),\n\t\t\t\t__WEBPACK_AMD_DEFINE_RESULT__ !== undefined && (module.exports = __WEBPACK_AMD_DEFINE_RESULT__));\n } else if (typeof exports !== \"undefined\") {\n factory(module, require('./clipboard-action'), require('tiny-emitter'), require('good-listener'));\n } else {\n var mod = {\n exports: {}\n };\n factory(mod, global.clipboardAction, global.tinyEmitter, global.goodListener);\n global.clipboard = mod.exports;\n }\n})(this, function (module, _clipboardAction, _tinyEmitter, _goodListener) {\n 'use strict';\n\n var _clipboardAction2 = _interopRequireDefault(_clipboardAction);\n\n var _tinyEmitter2 = _interopRequireDefault(_tinyEmitter);\n\n var _goodListener2 = _interopRequireDefault(_goodListener);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _typeof = typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\" ? function (obj) {\n return typeof obj;\n } : function (obj) {\n return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj;\n };\n\n function _classCallCheck(instance, Constructor) {\n if (!(instance instanceof Constructor)) {\n throw new TypeError(\"Cannot call a class as a function\");\n }\n }\n\n var _createClass = function () {\n function defineProperties(target, props) {\n for (var i = 0; i < props.length; i++) {\n var descriptor = props[i];\n descriptor.enumerable = descriptor.enumerable || false;\n descriptor.configurable = true;\n if (\"value\" in descriptor) descriptor.writable = true;\n Object.defineProperty(target, descriptor.key, descriptor);\n }\n }\n\n return function (Constructor, protoProps, staticProps) {\n if (protoProps) defineProperties(Constructor.prototype, protoProps);\n if (staticProps) defineProperties(Constructor, staticProps);\n return Constructor;\n };\n }();\n\n function _possibleConstructorReturn(self, call) {\n if (!self) {\n throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\");\n }\n\n return call && (typeof call === \"object\" || typeof call === \"function\") ? call : self;\n }\n\n function _inherits(subClass, superClass) {\n if (typeof superClass !== \"function\" && superClass !== null) {\n throw new TypeError(\"Super expression must either be null or a function, not \" + typeof superClass);\n }\n\n subClass.prototype = Object.create(superClass && superClass.prototype, {\n constructor: {\n value: subClass,\n enumerable: false,\n writable: true,\n configurable: true\n }\n });\n if (superClass) Object.setPrototypeOf ? Object.setPrototypeOf(subClass, superClass) : subClass.__proto__ = superClass;\n }\n\n var Clipboard = function (_Emitter) {\n _inherits(Clipboard, _Emitter);\n\n /**\n * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n * @param {Object} options\n */\n function Clipboard(trigger, options) {\n _classCallCheck(this, Clipboard);\n\n var _this = _possibleConstructorReturn(this, (Clipboard.__proto__ || Object.getPrototypeOf(Clipboard)).call(this));\n\n _this.resolveOptions(options);\n _this.listenClick(trigger);\n return _this;\n }\n\n /**\n * Defines if attributes would be resolved using internal setter functions\n * or custom functions that were passed in the constructor.\n * @param {Object} options\n */\n\n\n _createClass(Clipboard, [{\n key: 'resolveOptions',\n value: function resolveOptions() {\n var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n this.action = typeof options.action === 'function' ? options.action : this.defaultAction;\n this.target = typeof options.target === 'function' ? options.target : this.defaultTarget;\n this.text = typeof options.text === 'function' ? options.text : this.defaultText;\n this.container = _typeof(options.container) === 'object' ? options.container : document.body;\n }\n }, {\n key: 'listenClick',\n value: function listenClick(trigger) {\n var _this2 = this;\n\n this.listener = (0, _goodListener2.default)(trigger, 'click', function (e) {\n return _this2.onClick(e);\n });\n }\n }, {\n key: 'onClick',\n value: function onClick(e) {\n var trigger = e.delegateTarget || e.currentTarget;\n\n if (this.clipboardAction) {\n this.clipboardAction = null;\n }\n\n this.clipboardAction = new _clipboardAction2.default({\n action: this.action(trigger),\n target: this.target(trigger),\n text: this.text(trigger),\n container: this.container,\n trigger: trigger,\n emitter: this\n });\n }\n }, {\n key: 'defaultAction',\n value: function defaultAction(trigger) {\n return getAttributeValue('action', trigger);\n }\n }, {\n key: 'defaultTarget',\n value: function defaultTarget(trigger) {\n var selector = getAttributeValue('target', trigger);\n\n if (selector) {\n return document.querySelector(selector);\n }\n }\n }, {\n key: 'defaultText',\n value: function defaultText(trigger) {\n return getAttributeValue('text', trigger);\n }\n }, {\n key: 'destroy',\n value: function destroy() {\n this.listener.destroy();\n\n if (this.clipboardAction) {\n this.clipboardAction.destroy();\n this.clipboardAction = null;\n }\n }\n }], [{\n key: 'isSupported',\n value: function isSupported() {\n var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['copy', 'cut'];\n\n var actions = typeof action === 'string' ? [action] : action;\n var support = !!document.queryCommandSupported;\n\n actions.forEach(function (action) {\n support = support && !!document.queryCommandSupported(action);\n });\n\n return support;\n }\n }]);\n\n return Clipboard;\n }(_tinyEmitter2.default);\n\n /**\n * Helper function to retrieve attribute value.\n * @param {String} suffix\n * @param {Element} element\n */\n function getAttributeValue(suffix, element) {\n var attribute = 'data-clipboard-' + suffix;\n\n if (!element.hasAttribute(attribute)) {\n return;\n }\n\n return element.getAttribute(attribute);\n }\n\n module.exports = Clipboard;\n});\n\n/***/ }),\n/* 4 */\n/***/ (function(module, exports) {\n\nvar DOCUMENT_NODE_TYPE = 9;\n\n/**\n * A polyfill for Element.matches()\n */\nif (typeof Element !== 'undefined' && !Element.prototype.matches) {\n var proto = Element.prototype;\n\n proto.matches = proto.matchesSelector ||\n proto.mozMatchesSelector ||\n proto.msMatchesSelector ||\n proto.oMatchesSelector ||\n proto.webkitMatchesSelector;\n}\n\n/**\n * Finds the closest parent that matches a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @return {Function}\n */\nfunction closest (element, selector) {\n while (element && element.nodeType !== DOCUMENT_NODE_TYPE) {\n if (typeof element.matches === 'function' &&\n element.matches(selector)) {\n return element;\n }\n element = element.parentNode;\n }\n}\n\nmodule.exports = closest;\n\n\n/***/ }),\n/* 5 */\n/***/ (function(module, exports, __webpack_require__) {\n\nvar closest = __webpack_require__(4);\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction _delegate(element, selector, type, callback, useCapture) {\n var listenerFn = listener.apply(this, arguments);\n\n element.addEventListener(type, listenerFn, useCapture);\n\n return {\n destroy: function() {\n element.removeEventListener(type, listenerFn, useCapture);\n }\n }\n}\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element|String|Array} [elements]\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction delegate(elements, selector, type, callback, useCapture) {\n // Handle the regular Element usage\n if (typeof elements.addEventListener === 'function') {\n return _delegate.apply(null, arguments);\n }\n\n // Handle Element-less usage, it defaults to global delegation\n if (typeof type === 'function') {\n // Use `document` as the first parameter, then apply arguments\n // This is a short way to .unshift `arguments` without running into deoptimizations\n return _delegate.bind(null, document).apply(null, arguments);\n }\n\n // Handle Selector-based usage\n if (typeof elements === 'string') {\n elements = document.querySelectorAll(elements);\n }\n\n // Handle Array-like based usage\n return Array.prototype.map.call(elements, function (element) {\n return _delegate(element, selector, type, callback, useCapture);\n });\n}\n\n/**\n * Finds closest match and invokes callback.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Function}\n */\nfunction listener(element, selector, type, callback) {\n return function(e) {\n e.delegateTarget = closest(e.target, selector);\n\n if (e.delegateTarget) {\n callback.call(element, e);\n }\n }\n}\n\nmodule.exports = delegate;\n\n\n/***/ }),\n/* 6 */\n/***/ (function(module, exports) {\n\n/**\n * Check if argument is a HTML element.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.node = function(value) {\n return value !== undefined\n && value instanceof HTMLElement\n && value.nodeType === 1;\n};\n\n/**\n * Check if argument is a list of HTML elements.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.nodeList = function(value) {\n var type = Object.prototype.toString.call(value);\n\n return value !== undefined\n && (type === '[object NodeList]' || type === '[object HTMLCollection]')\n && ('length' in value)\n && (value.length === 0 || exports.node(value[0]));\n};\n\n/**\n * Check if argument is a string.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.string = function(value) {\n return typeof value === 'string'\n || value instanceof String;\n};\n\n/**\n * Check if argument is a function.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.fn = function(value) {\n var type = Object.prototype.toString.call(value);\n\n return type === '[object Function]';\n};\n\n\n/***/ }),\n/* 7 */\n/***/ (function(module, exports) {\n\nfunction select(element) {\n var selectedText;\n\n if (element.nodeName === 'SELECT') {\n element.focus();\n\n selectedText = element.value;\n }\n else if (element.nodeName === 'INPUT' || element.nodeName === 'TEXTAREA') {\n var isReadOnly = element.hasAttribute('readonly');\n\n if (!isReadOnly) {\n element.setAttribute('readonly', '');\n }\n\n element.select();\n element.setSelectionRange(0, element.value.length);\n\n if (!isReadOnly) {\n element.removeAttribute('readonly');\n }\n\n selectedText = element.value;\n }\n else {\n if (element.hasAttribute('contenteditable')) {\n element.focus();\n }\n\n var selection = window.getSelection();\n var range = document.createRange();\n\n range.selectNodeContents(element);\n selection.removeAllRanges();\n selection.addRange(range);\n\n selectedText = selection.toString();\n }\n\n return selectedText;\n}\n\nmodule.exports = select;\n\n\n/***/ })\n/******/ ]);\n});\n", + "define('core/webidl-clipboard',[\"exports\", \"deps/text!core/images/clipboard.svg\", \"deps/clipboard\"], function (exports, _clipboard, _clipboard3) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _clipboard2 = _interopRequireDefault(_clipboard);\n\n var _clipboard4 = _interopRequireDefault(_clipboard3);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n /**\n * Module core/webidl-clipboard\n *\n * This module adds a button to each IDL pre making it possible to copy\n * well-formatted IDL to the clipboard.\n *\n */\n const name = exports.name = \"core/webidl-clipboard\";\n\n // This button serves a prototype that we clone as needed.\n const copyButton = document.createElement(\"button\");\n copyButton.innerHTML = _clipboard2.default;\n copyButton.title = \"Copy IDL to clipboard\";\n copyButton.classList.add(\"respec-button-copy-paste\", \"removeOnSave\");\n\n const clipboardOps = {\n text: trigger => {\n return document.querySelector(trigger.dataset.clipboardTarget).textContent.replace(/\\ +/gm, \" \").replace(/^\\ /gm, \" \").replace(/^};\\n/gm, \"};\\n\").trim();\n }\n };\n\n async function run(conf, doc, cb) {\n Array.from(doc.querySelectorAll(\"pre.idl\")).map(elem => {\n const button = copyButton.cloneNode(true);\n const definition = elem.querySelector(`span[id^=\"idl-def-\"], span[id^=\"dom-\"]`);\n let target = \"#\";\n if (definition === null && elem.id === \"\") {\n if (elem.parentElement.id === \"idl-index\") {\n target += \"actual-idl-index\";\n } else {\n elem.id = `idl-${String(Math.random()).substr(2)}`;\n target += elem.id;\n }\n } else {\n target += elem.id || definition.id;\n }\n return { button, elem, target };\n }).forEach(({ elem, button, target }) => {\n const wrapper = doc.createElement(\"div\");\n button.dataset.clipboardTarget = target;\n elem.parentElement.replaceChild(wrapper, elem);\n wrapper.appendChild(button);\n wrapper.appendChild(elem);\n });\n const clipboard = new _clipboard4.default(\".respec-button-copy-paste\", clipboardOps);\n clipboard.on(\"success\", e => e.clearSelection());\n cb();\n }\n});\n//# sourceMappingURL=webidl-clipboard.js.map;\n", + "define('core/data-tests',[\"exports\", \"core/pubsubhub\", \"core/l10n\"], function (exports, _pubsubhub, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n /**\n * Module core/data-tests\n *\n * Allows specs to link to test files in a test suite, by adding `details` of where\n * particular tests for a testable assertion can be found.\n *\n * `data-tests` takes a space separated list of URLs, e.g. data-test=\"foo.html bar.html\".\n *\n * Docs: https://github.com/w3c/respec/wiki/data-tests\n */\n const l10n = {\n en: {\n missing_test_suite_uri: \"Found tests in your spec, but missing '\" + \"[`testSuiteURI`](https://github.com/w3c/respec/wiki/testSuiteURI)' in your ReSpec config.\",\n tests: \"tests\",\n test: \"test\"\n }\n };\n\n const name = exports.name = \"core/data-tests\";\n\n const lang = _l10n.lang in l10n ? _l10n.lang : \"en\";\n\n function toListItem(href) {\n const emojiList = [];\n const [testFile] = new URL(href).pathname.split(\"/\").reverse();\n const testParts = testFile.split(\".\");\n let [testFileName] = testParts;\n\n const isSecureTest = testParts.find(part => part === \"https\");\n if (isSecureTest) {\n const requiresConnectionEmoji = document.createElement(\"span\");\n requiresConnectionEmoji.innerHTML = \"🔒\";\n requiresConnectionEmoji.setAttribute(\"aria-label\", \"requires a secure connection\");\n requiresConnectionEmoji.setAttribute(\"title\", \"Test requires HTTPS\");\n testFileName = testFileName.replace(\".https\", \"\");\n emojiList.push(requiresConnectionEmoji);\n }\n\n const isManualTest = testFileName.split(\".\").join(\"-\").split(\"-\").find(part => part === \"manual\");\n if (isManualTest) {\n const manualPerformEmoji = document.createElement(\"span\");\n manualPerformEmoji.innerHTML = \"💪\";\n manualPerformEmoji.setAttribute(\"aria-label\", \"the test must be run manually\");\n manualPerformEmoji.setAttribute(\"title\", \"Manual test\");\n testFileName = testFileName.replace(\"-manual\", \"\");\n emojiList.push(manualPerformEmoji);\n }\n\n const testList = hyperHTML.bind(document.createElement(\"li\"))`\n \n ${testFileName}\n ${emojiList}\n `;\n return testList;\n }\n\n function run(conf) {\n const testables = document.querySelectorAll(\"[data-tests]\");\n if (!testables.length) {\n return;\n }\n if (!conf.testSuiteURI) {\n (0, _pubsubhub.pub)(\"error\", l10n[lang].missing_test_suite_uri);\n return;\n }\n Array.from(testables).filter(elem => elem.dataset.tests)\n // Render details + ul, returns HTMLDetailsElement\n .map(elem => {\n const details = document.createElement(\"details\");\n const renderer = hyperHTML.bind(details);\n const testURLs = elem.dataset.tests.split(/,/gm).map(url => url.trim()).map(url => {\n let href = \"\";\n try {\n href = new URL(url, conf.testSuiteURI).href;\n } catch (err) {\n (0, _pubsubhub.pub)(\"warn\", `${l10n[lang].bad_uri}: ${url}`);\n }\n return href;\n });\n details.classList.add(\"respec-tests-details\", \"removeOnSave\");\n renderer`\n \n tests: ${testURLs.length}\n \n
          ${testURLs.map(toListItem)}
        \n `;\n return { elem, details };\n }).forEach(({ elem, details }) => {\n delete elem.dataset.tests;\n elem.insertAdjacentElement(\"beforeend\", details);\n });\n }\n});\n//# sourceMappingURL=data-tests.js.map;\n", + "define('core/list-sorter',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.sortListItems = sortListItems;\n exports.sortDefinitionTerms = sortDefinitionTerms;\n exports.run = run;\n const name = exports.name = \"core/list-sorter\";\n\n function makeSorter(direction) {\n return ({ textContent: a }, { textContent: b }) => {\n return direction === \"ascending\" ? a.localeCompare(b) : b.localeCompare(a);\n };\n }\n /**\n * Shallow sort list items in OL, and UL elements.\n *\n * @param {HTMLUListElement} elem\n * @returns {DocumentFragment}\n */\n function sortListItems(elem, dir) {\n const elements = getDirectDescendents(elem, \"li\");\n const sortedElements = elements.sort(makeSorter(dir)).reduce((frag, elem) => {\n frag.appendChild(elem);\n return frag;\n }, document.createDocumentFragment());\n return sortedElements;\n }\n\n function getDirectDescendents(elem, wantedDescendentName) {\n let elements;\n try {\n elements = elem.querySelectorAll(`:scope > ${wantedDescendentName}`);\n } catch (err) {\n let tempId = \"\";\n // We give a temporary id, to overcome lack of \":scope\" support in Edge.\n if (!elem.id) {\n tempId = `temp-${String(Math.random()).substr(2)}`;\n elem.id = tempId;\n }\n const query = `#${elem.id} > ${wantedDescendentName}`;\n elements = elem.parentElement.querySelectorAll(query);\n if (tempId) {\n elem.id = \"\";\n }\n }\n return [...elements];\n }\n\n /**\n * Shallow sort a definition list based on its definition terms (dt) elements.\n *\n * @param {HTMLDListElement} dl\n * @returns {DocumentFragment}\n */\n function sortDefinitionTerms(dl, dir) {\n const elements = getDirectDescendents(dl, \"dt\");\n const sortedElements = elements.sort(makeSorter(dir)).reduce((frag, elem) => {\n const { nodeType, nodeName } = elem;\n const children = document.createDocumentFragment();\n let { nextSibling: next } = elem;\n while (next) {\n if (!next.nextSibling) {\n break;\n }\n children.appendChild(next.cloneNode(true));\n const { nodeType: nextType, nodeName: nextName } = next.nextSibling;\n const isSameType = nextType === nodeType && nextName === nodeName;\n if (isSameType) {\n break;\n }\n next = next.nextSibling;\n }\n children.prepend(elem.cloneNode(true));\n frag.appendChild(children);\n return frag;\n }, document.createDocumentFragment());\n return sortedElements;\n }\n\n function run(conf, doc, cb) {\n for (const elem of document.querySelectorAll(\"[data-sort]\")) {\n let sortedElems;\n const dir = elem.dataset.sort || \"ascending\";\n switch (elem.localName) {\n case \"dl\":\n sortedElems = sortDefinitionTerms(elem, dir);\n break;\n case \"ol\":\n case \"ul\":\n sortedElems = sortListItems(elem, dir);\n break;\n default:\n (0, _pubsubhub.pub)(\"warning\", `ReSpec can't sort ${elem.localName} elements.`);\n }\n if (sortedElems) {\n const range = document.createRange();\n range.selectNodeContents(elem);\n range.deleteContents();\n elem.appendChild(sortedElems);\n }\n }\n cb();\n }\n});\n//# sourceMappingURL=list-sorter.js.map;\n", + "\ndefine('deps/text!core/css/var.css',[],function () { return 'var:hover {\\n border-bottom: 1px dotted;\\n cursor: pointer;\\n}\\n\\nvar.respec-hl {\\n color: var(--color, #000);\\n background-color: var(--bg-color);\\n box-shadow: 0 0 0px 2px var(--bg-color);\\n}\\n\\n/* highlight colors\\n https://github.com/w3c/tr-design/issues/152\\n*/\\nvar.respec-hl-c1 {\\n --bg-color: #f4d200;\\n}\\n\\nvar.respec-hl-c2 {\\n --bg-color: #ff87a2;\\n}\\n\\nvar.respec-hl-c3 {\\n --bg-color: #96e885;\\n}\\n\\nvar.respec-hl-c4 {\\n --bg-color: #3eeed2;\\n}\\n\\nvar.respec-hl-c5 {\\n --bg-color: #eacfb6;\\n}\\n\\nvar.respec-hl-c6 {\\n --bg-color: #82ddff;\\n}\\n\\nvar.respec-hl-c7 {\\n --bg-color: #ffbcf2;\\n}\\n\\n@media print {\\n var.respec-hl {\\n background: none;\\n color: #000;\\n box-shadow: unset;\\n }\\n}\\n';});\n\n", + "define('core/highlight-vars',[\"exports\", \"core/pubsubhub\", \"deps/text!core/css/var.css\"], function (exports, _pubsubhub, _var) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _var2 = _interopRequireDefault(_var);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n /**\n * Module core/highlight-vars\n * Highlights occurrences of a within a section on click.\n * Set `conf.highlightVars = true` to enable.\n * Removes highlights from if clicked anywhere else.\n * All is done while keeping in mind that exported html stays clean\n * on export.\n */\n const name = exports.name = \"core/highlight-vars\";\n\n function run(conf) {\n if (!conf.highlightVars) {\n return;\n }\n const styleElement = document.createElement(\"style\");\n styleElement.textContent = _var2.default;\n styleElement.classList.add(\"removeOnSave\");\n document.head.appendChild(styleElement);\n\n [...document.querySelectorAll(\"var\")].forEach(varElem => varElem.addEventListener(\"click\", hightlightListener));\n\n // remove highlights, cleanup empty class/style attributes\n (0, _pubsubhub.sub)(\"beforesave\", outputDoc => {\n [...outputDoc.querySelectorAll(\"var.respec-hl\")].forEach(removeHighlight);\n });\n }\n\n function hightlightListener(ev) {\n ev.stopPropagation();\n const { target: varElem } = ev;\n const hightligtedElems = highlightVars(varElem);\n const resetListener = () => {\n const hlColor = getHighlightColor(varElem);\n hightligtedElems.forEach(el => removeHighlight(el, hlColor));\n [...HL_COLORS.keys()].forEach(key => HL_COLORS.set(key, true));\n };\n if (hightligtedElems.length) {\n document.body.addEventListener(\"click\", resetListener, { once: true });\n }\n }\n\n // availability of highlight colors. colors from var.css\n const HL_COLORS = new Map([[\"respec-hl-c1\", true], [\"respec-hl-c2\", true], [\"respec-hl-c3\", true], [\"respec-hl-c4\", true], [\"respec-hl-c5\", true], [\"respec-hl-c6\", true], [\"respec-hl-c7\", true]]);\n\n function getHighlightColor(target) {\n // return current colors if applicable\n const { value } = target.classList;\n const re = /respec-hl-\\w+/;\n const activeClass = re.test(value) && value.match(re);\n if (activeClass) return activeClass[0];\n\n // first color preference\n if (HL_COLORS.get(\"respec-hl-c1\") === true) return \"respec-hl-c1\";\n\n // otherwise get some other available color\n return [...HL_COLORS.keys()].find(c => HL_COLORS.get(c)) || \"respec-hl-c1\";\n }\n\n function highlightVars(varElem) {\n const textContent = varElem.textContent.trim();\n const parent = varElem.closest(\"section\");\n const highlightColor = getHighlightColor(varElem);\n\n const varsToHighlight = [...parent.querySelectorAll(\"var\")].filter(el => el.textContent.trim() === textContent);\n\n // update availability of highlight color\n const colorStatus = varsToHighlight[0].classList.contains(\"respec-hl\");\n HL_COLORS.set(highlightColor, colorStatus);\n\n // highlight vars\n if (colorStatus) {\n varsToHighlight.forEach(el => removeHighlight(el, highlightColor));\n return [];\n } else {\n varsToHighlight.forEach(el => addHighlight(el, highlightColor));\n }\n return varsToHighlight;\n }\n\n function removeHighlight(el, highlightColor) {\n el.classList.remove(\"respec-hl\", highlightColor);\n // clean up empty class attributes so they don't come in export\n if (!el.classList.length) el.removeAttribute(\"class\");\n }\n\n function addHighlight(elem, highlightColor) {\n elem.classList.add(\"respec-hl\", highlightColor);\n }\n});\n//# sourceMappingURL=highlight-vars.js.map;\n", + "\"use strict\";\n// In case everything else fails, we want the error\nwindow.addEventListener(\"error\", ev => {\n console.error(ev.error, ev.message, ev);\n});\n\n// this is only set in a build, not at all in the dev environment\nrequire.config({\n shim: {\n shortcut: {\n exports: \"shortcut\",\n },\n highlight: {\n exports: \"hljs\",\n },\n },\n paths: {\n \"handlebars.runtime\": \"deps/handlebars\",\n \"deps/highlight\": \"https://www.w3.org/Tools/respec/respec-highlight\",\n },\n deps: [\"deps/hyperhtml\", \"deps/url-search-params\"],\n});\n\ndefine(\n 'profile-oai',[\n // order is significant\n \"deps/domReady\",\n \"core/base-runner\",\n \"core/ui\",\n \"core/l10n\",\n //\"w3c/defaults\",\n \"oai/defaults\",\n \"core/style\",\n \"w3c/style\",\n \"w3c/l10n\",\n \"core/github\",\n \"core/data-include\",\n \"core/markdown\",\n //\"w3c/headers\",\n \"oai/headers\",\n \"w3c/abstract\",\n \"w3c/conformance\",\n \"core/data-transform\",\n \"core/inlines\",\n \"core/dfn\",\n \"w3c/rfc2119\",\n \"core/examples\",\n \"core/issues-notes\",\n \"core/requirements\",\n \"core/best-practices\",\n \"core/figures\",\n \"core/webidl\",\n \"core/data-cite\",\n \"core/biblio\",\n \"core/webidl-index\",\n \"core/link-to-dfn\",\n \"core/contrib\",\n \"core/fix-headers\",\n \"core/structure\",\n \"w3c/informative\",\n \"w3c/permalinks\",\n \"core/id-headers\",\n \"core/location-hash\",\n \"core/caniuse\",\n \"ui/save-html\",\n \"ui/search-specref\",\n \"ui/dfn-list\",\n \"ui/about-respec\",\n \"core/seo\",\n \"w3c/seo\",\n \"core/highlight\",\n \"core/webidl-clipboard\",\n \"core/data-tests\",\n \"core/list-sorter\",\n \"core/highlight-vars\",\n /*Linter must be the last thing to run*/\n \"core/linter\",\n ],\n (domReady, runner, { ui }, ...plugins) => {\n ui.show();\n domReady(async () => {\n try {\n await runner.runAll(plugins);\n await document.respecIsReady;\n } catch (err) {\n console.error(err);\n } finally {\n ui.enable();\n }\n });\n }\n);\n\n" + ] +} \ No newline at end of file diff --git a/oas/v3.0.1.html b/oas/v3.0.1.html index 7c0da96986..c9fc2cea78 100644 --- a/oas/v3.0.1.html +++ b/oas/v3.0.1.html @@ -1,7 +1,15 @@ -OpenAPI Specification
        The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

        State of This Document

        The source-of-truth for the specification is the GitHub markdown file referenced above.
        +OpenAPI Specification + + +
        The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

        Status of This Document

        The source-of-truth for the specification is the GitHub markdown file referenced above.

        OpenAPI Specification

        Version 3.0.1

        -

        The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!rfc2119]] [[!rfc8174]] when, and only when, they appear in all capitals, as shown here.

        +

        The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

        This document is licensed under The Apache License, Version 2.0.

      Introduction

      The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

      @@ -14,9 +22,9 @@

      Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

      Media Types

      Media type definitions are spread across several resources. -The media type definitions SHOULD be in compliance with [[!rfc6838]].

      +The media type definitions SHOULD be in compliance with [[!RFC6838]].

      Some examples of possible media type definitions:

      -
      
      +
      
         text/plain; charset=utf-8
         application/json
         application/vnd.github+json
      @@ -30,7 +38,7 @@
       

      HTTP Status Codes

      The HTTP Status Codes are used to indicate the status of the executed operation. -The available status codes are defined by [[!rfc7231]]section-6) and registered status codes are listed in the IANA Status Code Registry.

      +The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

      Specification

      Versions

      The OpenAPI Specification is versioned using Semantic Versioning 2.0.0 (semver) and follows the semver specification.

      @@ -40,9 +48,9 @@

      Format

      An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

      For example, if a field has an array value, the JSON array representation will be used:

      -
      
      +
      
       {
      -   "field": [ 1, 2, 3 ]
      +   "field": [ 1, 2, 3 ]
       }
       

      All field names in the specification are case sensitive.

      @@ -130,13 +138,13 @@ date string date -As defined by full-date - [!rfc3339] +As defined by full-date - [[!RFC3339]] dateTime string date-time -As defined by date-time - [!rfc3339] +As defined by date-time - [[!RFC3339]] password @@ -150,7 +158,7 @@

      Throughout the specification description fields are noted as supporting CommonMark markdown formatting. Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

      Relative References in URLs

      -

      Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!rfc3986]]section-4.2). +

      Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. Relative references are resolved using the URLs defined in the Server Object as a Base URI.

      Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

      Schema

      @@ -257,35 +265,35 @@

      This object MAY be extended with Specification Extensions.

      Info Object Example:

      -
      
      +
      
       {
      -  "title": "Sample Pet Store App",
      -  "description": "This is a sample server for a pet store.",
      -  "termsOfService": "http://example.com/terms/",
      -  "contact": {
      -    "name": "API Support",
      -    "url": "http://www.example.com/support",
      -    "email": "support@example.com"
      +  "title": "Sample Pet Store App",
      +  "description": "This is a sample server for a pet store.",
      +  "termsOfService": "http://example.com/terms/",
      +  "contact": {
      +    "name": "API Support",
      +    "url": "http://www.example.com/support",
      +    "email": "support@example.com"
         },
      -  "license": {
      -    "name": "Apache 2.0",
      -    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
      +  "license": {
      +    "name": "Apache 2.0",
      +    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
         },
      -  "version": "1.0.1"
      +  "version": "1.0.1"
       }
       
      -
      
      -title: Sample Pet Store App
      -description: This is a sample server for a pet store.
      -termsOfService: http://example.com/terms/
      -contact:
      -  name: API Support
      -  url: http://www.example.com/support
      -  email: support@example.com
      -license:
      -  name: Apache 2.0
      -  url: https://www.apache.org/licenses/LICENSE-2.0.html
      -version: 1.0.1
      +
      
      +title: Sample Pet Store App
      +description: This is a sample server for a pet store.
      +termsOfService: http://example.com/terms/
      +contact:
      +  name: API Support
      +  url: http://www.example.com/support
      +  email: support@example.com
      +license:
      +  name: Apache 2.0
      +  url: https://www.apache.org/licenses/LICENSE-2.0.html
      +version: 1.0.1
       

      Contact Object

      Contact information for the exposed API.

      @@ -318,17 +326,17 @@

      This object MAY be extended with Specification Extensions.

      Contact Object Example:

      -
      
      +
      
       {
      -  "name": "API Support",
      -  "url": "http://www.example.com/support",
      -  "email": "support@example.com"
      +  "name": "API Support",
      +  "url": "http://www.example.com/support",
      +  "email": "support@example.com"
       }
       
      -
      
      -name: API Support
      -url: http://www.example.com/support
      -email: support@example.com
      +
      
      +name: API Support
      +url: http://www.example.com/support
      +email: support@example.com
       

      License Object

      License information for the exposed API.

      @@ -356,15 +364,15 @@

      This object MAY be extended with Specification Extensions.

      License Object Example:

      -
      
      +
      
       {
      -  "name": "Apache 2.0",
      -  "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
      +  "name": "Apache 2.0",
      +  "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
       }
       
      -
      
      -name: Apache 2.0
      -url: https://www.apache.org/licenses/LICENSE-2.0.html
      +
      
      +name: Apache 2.0
      +url: https://www.apache.org/licenses/LICENSE-2.0.html
       

      Server Object

      An object representing a Server.

      @@ -398,88 +406,88 @@

      This object MAY be extended with Specification Extensions.

      Server Object Example

      A single server would be described as:

      -
      
      +
      
       {
      -  "url": "https://development.gigantic-server.com/v1",
      -  "description": "Development server"
      +  "url": "https://development.gigantic-server.com/v1",
      +  "description": "Development server"
       }
       
      -
      
      -url: https://development.gigantic-server.com/v1
      -description: Development server
      +
      
      +url: https://development.gigantic-server.com/v1
      +description: Development server
       

      The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

      -
      
      +
      
       {
      -  "servers": [
      +  "servers": [
           {
      -      "url": "https://development.gigantic-server.com/v1",
      -      "description": "Development server"
      +      "url": "https://development.gigantic-server.com/v1",
      +      "description": "Development server"
           },
           {
      -      "url": "https://staging.gigantic-server.com/v1",
      -      "description": "Staging server"
      +      "url": "https://staging.gigantic-server.com/v1",
      +      "description": "Staging server"
           },
           {
      -      "url": "https://api.gigantic-server.com/v1",
      -      "description": "Production server"
      +      "url": "https://api.gigantic-server.com/v1",
      +      "description": "Production server"
           }
         ]
       }
       
      -
      
      -servers:
      -- url: https://development.gigantic-server.com/v1
      -  description: Development server
      -- url: https://staging.gigantic-server.com/v1
      -  description: Staging server
      -- url: https://api.gigantic-server.com/v1
      -  description: Production server
      +
      
      +servers:
      +- url: https://development.gigantic-server.com/v1
      +  description: Development server
      +- url: https://staging.gigantic-server.com/v1
      +  description: Staging server
      +- url: https://api.gigantic-server.com/v1
      +  description: Production server
       

      The following shows how variables can be used for a server configuration:

      -
      
      +
      
       {
      -  "servers": [
      +  "servers": [
           {
      -      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
      -      "description": "The production API server",
      -      "variables": {
      -        "username": {
      -          "default": "demo",
      -          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
      +      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
      +      "description": "The production API server",
      +      "variables": {
      +        "username": {
      +          "default": "demo",
      +          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
               },
      -        "port": {
      -          "enum": [
      -            "8443",
      -            "443"
      +        "port": {
      +          "enum": [
      +            "8443",
      +            "443"
                 ],
      -          "default": "8443"
      +          "default": "8443"
               },
      -        "basePath": {
      -          "default": "v2"
      +        "basePath": {
      +          "default": "v2"
               }
             }
           }
         ]
       }
       
      -
      
      -servers:
      -- url: https://{username}.gigantic-server.com:{port}/{basePath}
      -  description: The production API server
      -  variables:
      -    username:
      -      # note! no enum here means it is an open value
      -      default: demo
      -      description: this value is assigned by the service provider, in this example `gigantic-server.com`
      -    port:
      -      enum:
      -        - '8443'
      -        - '443'
      -      default: '8443'
      -    basePath:
      -      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
      -      default: v2
      +
      
      +servers:
      +- url: https://{username}.gigantic-server.com:{port}/{basePath}
      +  description: The production API server
      +  variables:
      +    username:
      +      # note! no enum here means it is an open value
      +      default: demo
      +      description: this value is assigned by the service provider, in this example `gigantic-server.com`
      +    port:
      +      enum:
      +        - '8443'
      +        - '443'
      +      default: '8443'
      +    basePath:
      +      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
      +      default: v2
       

      Server Variable Object

      An object representing a Server Variable for server URL template substitution.

      @@ -574,7 +582,7 @@

      This object MAY be extended with Specification Extensions.

      All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

      Field Name Examples:

      -
      
      +
      
       User
       User_1
       User_Name
      @@ -582,88 +590,88 @@
       my.org.User
       

      Components Object Example

      -
      
      -"components": {
      -  "schemas": {
      -    "Category": {
      -      "type": "object",
      -      "properties": {
      -        "id": {
      -          "type": "integer",
      -          "format": "int64"
      +
      
      +"components": {
      +  "schemas": {
      +    "Category": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
               },
      -        "name": {
      -          "type": "string"
      +        "name": {
      +          "type": "string"
               }
             }
           },
      -    "Tag": {
      -      "type": "object",
      -      "properties": {
      -        "id": {
      -          "type": "integer",
      -          "format": "int64"
      +    "Tag": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
               },
      -        "name": {
      -          "type": "string"
      +        "name": {
      +          "type": "string"
               }
             }
           }
         },
      -  "parameters": {
      -    "skipParam": {
      -      "name": "skip",
      -      "in": "query",
      -      "description": "number of items to skip",
      -      "required": true,
      -      "schema": {
      -        "type": "integer",
      -        "format": "int32"
      +  "parameters": {
      +    "skipParam": {
      +      "name": "skip",
      +      "in": "query",
      +      "description": "number of items to skip",
      +      "required": true,
      +      "schema": {
      +        "type": "integer",
      +        "format": "int32"
             }
           },
      -    "limitParam": {
      -      "name": "limit",
      -      "in": "query",
      -      "description": "max records to return",
      -      "required": true,
      -      "schema" : {
      -        "type": "integer",
      -        "format": "int32"
      +    "limitParam": {
      +      "name": "limit",
      +      "in": "query",
      +      "description": "max records to return",
      +      "required": true,
      +      "schema" : {
      +        "type": "integer",
      +        "format": "int32"
             }
           }
         },
      -  "responses": {
      -    "NotFound": {
      -      "description": "Entity not found."
      +  "responses": {
      +    "NotFound": {
      +      "description": "Entity not found."
           },
      -    "IllegalInput": {
      -      "description": "Illegal input for operation."
      +    "IllegalInput": {
      +      "description": "Illegal input for operation."
           },
      -    "GeneralError": {
      -      "description": "General Error",
      -      "content": {
      -        "application/json": {
      -          "schema": {
      -            "$ref": "#/components/schemas/GeneralError"
      +    "GeneralError": {
      +      "description": "General Error",
      +      "content": {
      +        "application/json": {
      +          "schema": {
      +            "$ref": "#/components/schemas/GeneralError"
                 }
               }
             }
           }
         },
      -  "securitySchemes": {
      -    "api_key": {
      -      "type": "apiKey",
      -      "name": "api_key",
      -      "in": "header"
      +  "securitySchemes": {
      +    "api_key": {
      +      "type": "apiKey",
      +      "name": "api_key",
      +      "in": "header"
           },
      -    "petstore_auth": {
      -      "type": "oauth2",
      -      "flows": {
      -        "implicit": {
      -          "authorizationUrl": "http://example.org/api/oauth/dialog",
      -          "scopes": {
      -            "write:pets": "modify pets in your account",
      -            "read:pets": "read your pets"
      +    "petstore_auth": {
      +      "type": "oauth2",
      +      "flows": {
      +        "implicit": {
      +          "authorizationUrl": "http://example.org/api/oauth/dialog",
      +          "scopes": {
      +            "write:pets": "modify pets in your account",
      +            "read:pets": "read your pets"
                 }
               }
             }
      @@ -671,66 +679,66 @@
         }
       }
       
      -
      
      -components:
      -  schemas:
      -    Category:
      -      type: object
      -      properties:
      -        id:
      -          type: integer
      -          format: int64
      -        name:
      -          type: string
      -    Tag:
      -      type: object
      -      properties:
      -        id:
      -          type: integer
      -          format: int64
      -        name:
      -          type: string
      -  parameters:
      -    skipParam:
      -      name: skip
      -      in: query
      -      description: number of items to skip
      -      required: true
      -      schema:
      -        type: integer
      -        format: int32
      -    limitParam:
      -      name: limit
      -      in: query
      -      description: max records to return
      -      required: true
      -      schema:
      -        type: integer
      -        format: int32
      -  responses:
      -    NotFound:
      -      description: Entity not found.
      -    IllegalInput:
      -      description: Illegal input for operation.
      -    GeneralError:
      -      description: General Error
      -      content:
      -        application/json:
      -          schema:
      -            $ref: '#/components/schemas/GeneralError'
      -  securitySchemes:
      -    api_key:
      -      type: apiKey
      -      name: api_key
      -      in: header
      -    petstore_auth:
      -      type: oauth2
      -      flows: 
      -        implicit:
      -          authorizationUrl: http://example.org/api/oauth/dialog
      -          scopes:
      -            write:pets: modify pets in your account
      -            read:pets: read your pets
      +
      
      +components:
      +  schemas:
      +    Category:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +    Tag:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +  parameters:
      +    skipParam:
      +      name: skip
      +      in: query
      +      description: number of items to skip
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +    limitParam:
      +      name: limit
      +      in: query
      +      description: max records to return
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +  responses:
      +    NotFound:
      +      description: Entity not found.
      +    IllegalInput:
      +      description: Illegal input for operation.
      +    GeneralError:
      +      description: General Error
      +      content:
      +        application/json:
      +          schema:
      +            $ref: '#/components/schemas/GeneralError'
      +  securitySchemes:
      +    api_key:
      +      type: apiKey
      +      name: api_key
      +      in: header
      +    petstore_auth:
      +      type: oauth2
      +      flows: 
      +        implicit:
      +          authorizationUrl: http://example.org/api/oauth/dialog
      +          scopes:
      +            write:pets: modify pets in your account
      +            read:pets: read your pets
       

      Paths Object

      Holds the relative paths to the individual endpoints and their operations. @@ -755,35 +763,35 @@

      This object MAY be extended with Specification Extensions.

      Path Templating Matching

      Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

      -
      
      +
      
         /pets/{petId}
         /pets/mine
       

      The following paths are considered identical and invalid:

      -
      
      +
      
         /pets/{petId}
         /pets/{name}
       

      The following may lead to ambiguous resolution:

      -
      
      +
      
         /{entity}/me
         /books/{id}
       

      Paths Object Example

      -
      
      +
      
       {
      -  "/pets": {
      -    "get": {
      -      "description": "Returns all pets from the system that the user has access to",
      -      "responses": {
      -        "200": {          
      -          "description": "A list of pets.",
      -          "content": {
      -            "application/json": {
      -              "schema": {
      -                "type": "array",
      -                "items": {
      -                  "$ref": "#/components/schemas/pet"
      +  "/pets": {
      +    "get": {
      +      "description": "Returns all pets from the system that the user has access to",
      +      "responses": {
      +        "200": {          
      +          "description": "A list of pets.",
      +          "content": {
      +            "application/json": {
      +              "schema": {
      +                "type": "array",
      +                "items": {
      +                  "$ref": "#/components/schemas/pet"
                       }
                     }
                   }
      @@ -794,19 +802,19 @@
         }
       }
       
      -
      
      -/pets:
      -  get:
      -    description: Returns all pets from the system that the user has access to
      -    responses:
      -      '200':
      -        description: A list of pets.
      -        content:
      -          application/json:
      -            schema:
      -              type: array
      -              items:
      -                $ref: '#/components/schemas/pet'
      +
      
      +/pets:
      +  get:
      +    description: Returns all pets from the system that the user has access to
      +    responses:
      +      '200':
      +        description: A list of pets.
      +        content:
      +          application/json:
      +            schema:
      +              type: array
      +              items:
      +                $ref: '#/components/schemas/pet'
       

      Path Item Object

      Describes the operations available on a single path. @@ -891,85 +899,85 @@

      This object MAY be extended with Specification Extensions.

      Path Item Object Example

      -
      
      +
      
       {
      -  "get": {
      -    "description": "Returns pets based on ID",
      -    "summary": "Find pets by ID",
      -    "operationId": "getPetsById",
      -    "responses": {
      -      "200": {
      -        "description": "pet response",
      -        "content": {
      -          "*/*": {
      -            "schema": {
      -              "type": "array",
      -              "items": {
      -                "$ref": "#/components/schemas/Pet"
      +  "get": {
      +    "description": "Returns pets based on ID",
      +    "summary": "Find pets by ID",
      +    "operationId": "getPetsById",
      +    "responses": {
      +      "200": {
      +        "description": "pet response",
      +        "content": {
      +          "*/*": {
      +            "schema": {
      +              "type": "array",
      +              "items": {
      +                "$ref": "#/components/schemas/Pet"
                     }
                   }
                 }
               }
             },
      -      "default": {
      -        "description": "error payload",
      -        "content": {
      -          "text/html": {
      -            "schema": {
      -              "$ref": "#/components/schemas/ErrorModel"
      +      "default": {
      +        "description": "error payload",
      +        "content": {
      +          "text/html": {
      +            "schema": {
      +              "$ref": "#/components/schemas/ErrorModel"
                   }
                 }
               }
             }
           }
         },
      -  "parameters": [
      +  "parameters": [
           {
      -      "name": "id",
      -      "in": "path",
      -      "description": "ID of pet to use",
      -      "required": true,
      -      "schema": {
      -        "type": "array",
      -        "items": {
      -          "type": "string"
      +      "name": "id",
      +      "in": "path",
      +      "description": "ID of pet to use",
      +      "required": true,
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
               }
             },
      -      "style": "simple"
      +      "style": "simple"
           }
         ]
       }
       
      -
      
      -get:
      -  description: Returns pets based on ID
      -  summary: Find pets by ID
      -  operationId: getPetsById
      -  responses:
      -    '200':
      -      description: pet response
      -      content:
      -        '*/*' :
      -          schema:
      -            type: array
      -            items:
      -              $ref: '#/components/schemas/Pet'
      -    default:
      -      description: error payload
      -      content:
      -        'text/html':
      -          schema:
      -            $ref: '#/components/schemas/ErrorModel'
      -parameters:
      -- name: id
      -  in: path
      -  description: ID of pet to use
      -  required: true
      -  schema:
      -    type: array
      -    style: simple
      -    items:
      -      type: string  
      +
      
      +get:
      +  description: Returns pets based on ID
      +  summary: Find pets by ID
      +  operationId: getPetsById
      +  responses:
      +    '200':
      +      description: pet response
      +      content:
      +        '*/*' :
      +          schema:
      +            type: array
      +            items:
      +              $ref: '#/components/schemas/Pet'
      +    default:
      +      description: error payload
      +      content:
      +        'text/html':
      +          schema:
      +            $ref: '#/components/schemas/ErrorModel'
      +parameters:
      +- name: id
      +  in: path
      +  description: ID of pet to use
      +  required: true
      +  schema:
      +    type: array
      +    style: simple
      +    items:
      +      type: string  
       

      Operation Object

      Describes a single API operation on a path.

      @@ -1016,7 +1024,7 @@ requestBody Request Body Object ¦ Reference Object -The request body applicable for this operation. The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [[!rfc7231]]section-4.3.1) has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers. +The request body applicable for this operation. The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers. responses @@ -1047,110 +1055,110 @@

      This object MAY be extended with Specification Extensions.

      Operation Object Example

      -
      
      +
      
       {
      -  "tags": [
      -    "pet"
      +  "tags": [
      +    "pet"
         ],
      -  "summary": "Updates a pet in the store with form data",
      -  "operationId": "updatePetWithForm",
      -  "parameters": [
      +  "summary": "Updates a pet in the store with form data",
      +  "operationId": "updatePetWithForm",
      +  "parameters": [
           {
      -      "name": "petId",
      -      "in": "path",
      -      "description": "ID of pet that needs to be updated",
      -      "required": true,
      -      "schema": {
      -        "type": "string"
      +      "name": "petId",
      +      "in": "path",
      +      "description": "ID of pet that needs to be updated",
      +      "required": true,
      +      "schema": {
      +        "type": "string"
             }
           }
         ],
      -  "requestBody": {
      -    "content": {
      -      "application/x-www-form-urlencoded": {
      -        "schema": {
      -          "type": "object",
      -           "properties": {
      -              "name": { 
      -                "description": "Updated name of the pet",
      -                "type": "string"
      +  "requestBody": {
      +    "content": {
      +      "application/x-www-form-urlencoded": {
      +        "schema": {
      +          "type": "object",
      +           "properties": {
      +              "name": { 
      +                "description": "Updated name of the pet",
      +                "type": "string"
                     },
      -              "status": {
      -                "description": "Updated status of the pet",
      -                "type": "string"
      +              "status": {
      +                "description": "Updated status of the pet",
      +                "type": "string"
                    }
                  },
      -        "required": ["status"] 
      +        "required": ["status"] 
               }
             }
           }
         },
      -  "responses": {
      -    "200": {
      -      "description": "Pet updated.",
      -      "content": {
      -        "application/json": {},
      -        "application/xml": {}
      +  "responses": {
      +    "200": {
      +      "description": "Pet updated.",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
             }
           },
      -    "405": {
      -      "description": "Invalid input",
      -      "content": {
      -        "application/json": {},
      -        "application/xml": {}
      +    "405": {
      +      "description": "Invalid input",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
             }
           }
         },
      -  "security": [
      +  "security": [
           {
      -      "petstore_auth": [
      -        "write:pets",
      -        "read:pets"
      +      "petstore_auth": [
      +        "write:pets",
      +        "read:pets"
             ]
           }
         ]
       }
       
      -
      
      -tags:
      -- pet
      -summary: Updates a pet in the store with form data
      -operationId: updatePetWithForm
      -parameters:
      -- name: petId
      -  in: path
      -  description: ID of pet that needs to be updated
      -  required: true
      -  schema:
      -    type: string
      -requestBody:
      -  content:
      -    'application/x-www-form-urlencoded':
      -      schema:
      -       properties:
      -          name: 
      -            description: Updated name of the pet
      -            type: string
      -          status:
      -            description: Updated status of the pet
      -            type: string
      -       required:
      -         - status
      -responses:
      -  '200':
      -    description: Pet updated.
      -    content: 
      -      'application/json': {}
      -      'application/xml': {}
      -  '405':
      -    description: Invalid input
      -    content: 
      -      'application/json': {}
      -      'application/xml': {}
      -security:
      -- petstore_auth:
      -  - write:pets
      -  - read:pets
      +
      
      +tags:
      +- pet
      +summary: Updates a pet in the store with form data
      +operationId: updatePetWithForm
      +parameters:
      +- name: petId
      +  in: path
      +  description: ID of pet that needs to be updated
      +  required: true
      +  schema:
      +    type: string
      +requestBody:
      +  content:
      +    'application/x-www-form-urlencoded':
      +      schema:
      +       properties:
      +          name: 
      +            description: Updated name of the pet
      +            type: string
      +          status:
      +            description: Updated status of the pet
      +            type: string
      +       required:
      +         - status
      +responses:
      +  '200':
      +    description: Pet updated.
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +  '405':
      +    description: Invalid input
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +security:
      +- petstore_auth:
      +  - write:pets
      +  - read:pets
       

      External Documentation Object

      Allows referencing an external resource for extended documentation.

      @@ -1178,15 +1186,15 @@

      This object MAY be extended with Specification Extensions.

      External Documentation Object Example

      -
      
      +
      
       {
      -  "description": "Find more info here",
      -  "url": "https://example.com"
      +  "description": "Find more info here",
      +  "url": "https://example.com"
       }
       
      -
      
      -description: Find more info here
      -url: https://example.com
      +
      
      +description: Find more info here
      +url: https://example.com
       

      Parameter Object

      Describes a single operation parameter.

      @@ -1196,7 +1204,7 @@
      • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
      • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
      • -
      • header - Custom headers that are expected as part of the request. Note that [[!rfc7230]]page-22) states header names are case insensitive.
      • +
      • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
      • cookie - Used to pass a specific cookie value to the API.

      Fixed Fields

      @@ -1265,7 +1273,7 @@ allowReserved boolean -Determines whether the parameter value SHOULD allow reserved characters, as defined by [[!rfc3986]]section-2.2) :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false. +Determines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false. schema @@ -1319,25 +1327,25 @@ matrix primitive, array, object path -Path-style parameters defined by [[!rfc6570]]section-3.2.7) +Path-style parameters defined by [[!RFC6570]] label primitive, array, object path -Label style parameters defined by [[!rfc6570]]section-3.2.5) +Label style parameters defined by [[!RFC6570]] form primitive, array, object query, cookie -Form style parameters defined by [[!rfc6570]]section-3.2.8). This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0. +Form style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0. simple array path, header -Simple style parameters defined by [[!rfc6570]]section-3.2.2). This option replaces collectionFormat with a csv value from OpenAPI 2.0. +Simple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0. spaceDelimited @@ -1361,7 +1369,7 @@

      Style Examples

      Assume a parameter named color has one of the following values:

      -
      
      +
      
          string -> "blue"
          array -> ["blue","black","brown"]
          object -> { "R": 100, "G": 200, "B": 150 }
      @@ -1472,125 +1480,125 @@
       

      This object MAY be extended with Specification Extensions.

      Parameter Object Examples

      A header parameter with an array of 64 bit integer numbers:

      -
      
      +
      
       {
      -  "name": "token",
      -  "in": "header",
      -  "description": "token to be passed as a header",
      -  "required": true,
      -  "schema": {
      -    "type": "array",
      -    "items": {
      -      "type": "integer",
      -      "format": "int64"
      +  "name": "token",
      +  "in": "header",
      +  "description": "token to be passed as a header",
      +  "required": true,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "integer",
      +      "format": "int64"
           }
         },
      -  "style": "simple"
      +  "style": "simple"
       }
       
      -
      
      -name: token
      -in: header
      -description: token to be passed as a header
      -required: true
      -schema:
      -  type: array
      -  items:
      -    type: integer
      -    format: int64
      -style: simple
      +
      
      +name: token
      +in: header
      +description: token to be passed as a header
      +required: true
      +schema:
      +  type: array
      +  items:
      +    type: integer
      +    format: int64
      +style: simple
       

      A path parameter of a string value:

      -
      
      +
      
       {
      -  "name": "username",
      -  "in": "path",
      -  "description": "username to fetch",
      -  "required": true,
      -  "schema": {
      -    "type": "string"
      +  "name": "username",
      +  "in": "path",
      +  "description": "username to fetch",
      +  "required": true,
      +  "schema": {
      +    "type": "string"
         }
       }
       
      -
      
      -name: username
      -in: path
      -description: username to fetch
      -required: true
      -schema:
      -  type: string
      +
      
      +name: username
      +in: path
      +description: username to fetch
      +required: true
      +schema:
      +  type: string
       

      An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

      -
      
      +
      
       {
      -  "name": "id",
      -  "in": "query",
      -  "description": "ID of the object to fetch",
      -  "required": false,
      -  "schema": {
      -    "type": "array",
      -    "items": {
      -      "type": "string"
      +  "name": "id",
      +  "in": "query",
      +  "description": "ID of the object to fetch",
      +  "required": false,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
           }
         },
      -  "style": "form",
      -  "explode": true
      +  "style": "form",
      +  "explode": true
       }
       
      -
      
      -name: id
      -in: query
      -description: ID of the object to fetch
      -required: false
      -schema:
      -  type: array
      -  items:
      -    type: string
      -style: form
      -explode: true
      +
      
      +name: id
      +in: query
      +description: ID of the object to fetch
      +required: false
      +schema:
      +  type: array
      +  items:
      +    type: string
      +style: form
      +explode: true
       

      A free-form query parameter, allowing undefined parameters of a specific type:

      -
      
      +
      
       {
      -  "in": "query",
      -  "name": "freeForm",
      -  "schema": {
      -    "type": "object",
      -    "additionalProperties": {
      -      "type": "integer"
      +  "in": "query",
      +  "name": "freeForm",
      +  "schema": {
      +    "type": "object",
      +    "additionalProperties": {
      +      "type": "integer"
           },
         },
      -  "style": "form"
      +  "style": "form"
       }
       
      -
      
      -in: query
      -name: freeForm
      -schema:
      -  type: object
      -  additionalProperties:
      -    type: integer
      -style: form
      +
      
      +in: query
      +name: freeForm
      +schema:
      +  type: object
      +  additionalProperties:
      +    type: integer
      +style: form
       

      A complex parameter using content to define serialization:

      -
      
      +
      
       {
      -  "in": "query",
      -  "name": "coordinates",
      -  "content": {
      -    "application/json": {
      -      "schema": {
      -        "type": "object",
      -        "required": [
      -          "lat",
      -          "long"
      +  "in": "query",
      +  "name": "coordinates",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "object",
      +        "required": [
      +          "lat",
      +          "long"
               ],
      -        "properties": {
      -          "lat": {
      -            "type": "number"
      +        "properties": {
      +          "lat": {
      +            "type": "number"
                 },
      -          "long": {
      -            "type": "number"
      +          "long": {
      +            "type": "number"
                 }
               }
             }
      @@ -1598,21 +1606,21 @@
         }
       }
       
      -
      
      -in: query
      -name: coordinates
      -content:
      -  application/json:
      -    schema:
      -      type: object
      -      required:
      -        - lat
      -        - long
      -      properties:
      -        lat:
      -          type: number
      -        long:
      -          type: number
      +
      
      +in: query
      +name: coordinates
      +content:
      +  application/json:
      +    schema:
      +      type: object
      +      required:
      +        - lat
      +        - long
      +      properties:
      +        lat:
      +          type: number
      +        long:
      +          type: number
       

      Request Body Object

      Describes a single request body.

      @@ -1646,104 +1654,104 @@

      This object MAY be extended with Specification Extensions.

      Request Body Examples

      A request body with a referenced model definition.

      -
      
      +
      
       {
      -  "description": "user to add to the system",
      -  "content": {
      -    "application/json": {
      -      "schema": {
      -        "$ref": "#/components/schemas/User"
      +  "description": "user to add to the system",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
             },
      -      "examples": {
      -          "user" : {
      -            "summary": "User Example", 
      -            "externalValue": "http://foo.bar/examples/user-example.json"
      +      "examples": {
      +          "user" : {
      +            "summary": "User Example", 
      +            "externalValue": "http://foo.bar/examples/user-example.json"
                 } 
               }
           },
      -    "application/xml": {
      -      "schema": {
      -        "$ref": "#/components/schemas/User"
      +    "application/xml": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
             },
      -      "examples": {
      -          "user" : {
      -            "summary": "User example in XML",
      -            "externalValue": "http://foo.bar/examples/user-example.xml"
      +      "examples": {
      +          "user" : {
      +            "summary": "User example in XML",
      +            "externalValue": "http://foo.bar/examples/user-example.xml"
                 }
               }
           },
      -    "text/plain": {
      -      "examples": {
      -        "user" : {
      -            "summary": "User example in Plain text",
      -            "externalValue": "http://foo.bar/examples/user-example.txt" 
      +    "text/plain": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in Plain text",
      +            "externalValue": "http://foo.bar/examples/user-example.txt" 
               }
             } 
           },
      -    "*/*": {
      -      "examples": {
      -        "user" : {
      -            "summary": "User example in other format",
      -            "externalValue": "http://foo.bar/examples/user-example.whatever"
      +    "*/*": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in other format",
      +            "externalValue": "http://foo.bar/examples/user-example.whatever"
               }
             }
           }
         }
       }
       
      -
      
      -description: user to add to the system
      -content: 
      -  'application/json':
      -    schema:
      -      $ref: '#/components/schemas/User'
      -    examples:
      -      user:
      -        summary: User Example
      -        externalValue: 'http://foo.bar/examples/user-example.json'
      -  'application/xml':
      -    schema:
      -      $ref: '#/components/schemas/User'
      -    examples:
      -      user:
      -        summary: User Example in XML
      -        externalValue: 'http://foo.bar/examples/user-example.xml'
      -  'text/plain':
      -    examples:
      -      user:
      -        summary: User example in text plain format
      -        externalValue: 'http://foo.bar/examples/user-example.txt'
      -  '*/*':
      -    examples:
      -      user: 
      -        summary: User example in other format
      -        externalValue: 'http://foo.bar/examples/user-example.whatever'
      +
      
      +description: user to add to the system
      +content: 
      +  'application/json':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User Example
      +        externalValue: 'http://foo.bar/examples/user-example.json'
      +  'application/xml':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User Example in XML
      +        externalValue: 'http://foo.bar/examples/user-example.xml'
      +  'text/plain':
      +    examples:
      +      user:
      +        summary: User example in text plain format
      +        externalValue: 'http://foo.bar/examples/user-example.txt'
      +  '*/*':
      +    examples:
      +      user: 
      +        summary: User example in other format
      +        externalValue: 'http://foo.bar/examples/user-example.whatever'
       

      A body parameter that is an array of string values:

      -
      
      +
      
       {
      -  "description": "user to add to the system",
      -  "content": {
      -    "text/plain": {
      -      "schema": {
      -        "type": "array",
      -        "items": {
      -          "type": "string"
      +  "description": "user to add to the system",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
               }
             }
           }
         }
       }
       
      -
      
      -description: user to add to the system
      -required: true
      -content:
      -  text/plain:
      -    schema:
      -      type: array
      -      items:
      -        type: string
      +
      
      +description: user to add to the system
      +required: true
      +content:
      +  text/plain:
      +    schema:
      +      type: array
      +      items:
      +        type: string
       

      Media Type Object

      Each Media Type Object provides schema and examples for the media type identified by its key.

      @@ -1781,140 +1789,140 @@

      This object MAY be extended with Specification Extensions.

      Media Type Examples

      -
      
      +
      
       {
      -  "application/json": {
      -    "schema": {
      -         "$ref": "#/components/schemas/Pet"
      +  "application/json": {
      +    "schema": {
      +         "$ref": "#/components/schemas/Pet"
           },
      -    "examples": {
      -      "cat" : {
      -        "summary": "An example of a cat",
      -        "value": 
      +    "examples": {
      +      "cat" : {
      +        "summary": "An example of a cat",
      +        "value": 
                 {
      -            "name": "Fluffy",
      -            "petType": "Cat",
      -            "color": "White",
      -            "gender": "male",
      -            "breed": "Persian"
      +            "name": "Fluffy",
      +            "petType": "Cat",
      +            "color": "White",
      +            "gender": "male",
      +            "breed": "Persian"
                 }
             },
      -      "dog": {
      -        "summary": "An example of a dog with a cat's name",
      -        "value" :  { 
      -          "name": "Puma",
      -          "petType": "Dog",
      -          "color": "Black",
      -          "gender": "Female",
      -          "breed": "Mixed"
      +      "dog": {
      +        "summary": "An example of a dog with a cat's name",
      +        "value" :  { 
      +          "name": "Puma",
      +          "petType": "Dog",
      +          "color": "Black",
      +          "gender": "Female",
      +          "breed": "Mixed"
               },
      -      "frog": {
      -          "$ref": "#/components/examples/frog-example"
      +      "frog": {
      +          "$ref": "#/components/examples/frog-example"
               }
             }
           }
         }
       }
       
      -
      
      -application/json: 
      -  schema:
      -    $ref: "#/components/schemas/Pet"
      -  examples:
      -    cat:
      -      summary: An example of a cat
      -      value:
      -        name: Fluffy
      -        petType: Cat
      -        color: White
      -        gender: male
      -        breed: Persian
      -    dog:
      -      summary: An example of a dog with a cat's name
      -      value:
      -        name: Puma
      -        petType: Dog
      -        color: Black
      -        gender: Female
      -        breed: Mixed
      -    frog:
      -      $ref: "#/components/examples/frog-example"
      +
      
      +application/json: 
      +  schema:
      +    $ref: "#/components/schemas/Pet"
      +  examples:
      +    cat:
      +      summary: An example of a cat
      +      value:
      +        name: Fluffy
      +        petType: Cat
      +        color: White
      +        gender: male
      +        breed: Persian
      +    dog:
      +      summary: An example of a dog with a cat's name
      +      value:
      +        name: Puma
      +        petType: Dog
      +        color: Black
      +        gender: Female
      +        breed: Mixed
      +    frog:
      +      $ref: "#/components/examples/frog-example"
       

      Considerations for File Uploads

      In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type. Specifically:

      -
      
      -# content transferred with base64 encoding
      -schema:
      -  type: string
      -  format: base64
      -
      -
      
      -# content transferred in binary (octet-stream):
      -schema:
      -  type: string
      -  format: binary
      +
      
      +# content transferred with base64 encoding
      +schema:
      +  type: string
      +  format: base64
      +
      +
      
      +# content transferred in binary (octet-stream):
      +schema:
      +  type: string
      +  format: binary
       

      These examples apply to either input payloads of file uploads or response payloads.

      A requestBody for submitting a file in a POST operation may look like the following example:

      -
      
      -requestBody:
      -  content:
      -    application/octet-stream:
      -      # any media type is accepted, functionally equivalent to `*/*`
      -      schema:
      -        # a binary file of any type
      -        type: string
      -        format: binary
      +
      
      +requestBody:
      +  content:
      +    application/octet-stream:
      +      # any media type is accepted, functionally equivalent to `*/*`
      +      schema:
      +        # a binary file of any type
      +        type: string
      +        format: binary
       

      In addition, specific media types MAY be specified:

      -
      
      -# multiple, specific media types may be specified:
      -requestBody:
      -  content:
      -      # a binary file of type png or jpeg
      -    'image/jpeg':
      -      schema:
      -        type: string
      -        format: binary
      -    'image/png':
      -      schema:
      -        type: string
      -        format: binary        
      +
      
      +# multiple, specific media types may be specified:
      +requestBody:
      +  content:
      +      # a binary file of type png or jpeg
      +    'image/jpeg':
      +      schema:
      +        type: string
      +        format: binary
      +    'image/png':
      +      schema:
      +        type: string
      +        format: binary        
       

      To upload multiple files, a multipart media type MUST be used:

      -
      
      -requestBody:
      -  content:
      -    multipart/form-data:
      -      schema:
      -        properties:
      -          # The property name 'file' will be used for all files.
      -          file:
      -            type: array
      -            items:
      -              type: string
      -              format: binary
      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        properties:
      +          # The property name 'file' will be used for all files.
      +          file:
      +            type: array
      +            items:
      +              type: string
      +              format: binary
       
       

      Support for x-www-form-urlencoded Request Bodies

      -

      To submit content using form url encoding via [[!rfc1866]], the following +

      To submit content using form url encoding via [[!RFC1866]], the following definition may be used:

      -
      
      -requestBody:
      -  content:
      -    application/x-www-form-urlencoded:
      -      schema:
      -        type: object
      -        properties:
      -          id:
      -            type: string
      -            format: uuid
      -          address:
      -            # complex types are stringified to support RFC 1866
      -            type: object
      -            properties: {}
      -
      -

      In this example, the contents in the requestBody MUST be stringified per [[!rfc1866]]) when passed to the server. In addition, the address field complex object will be stringified.

      +
      
      +requestBody:
      +  content:
      +    application/x-www-form-urlencoded:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # complex types are stringified to support RFC 1866
      +            type: object
      +            properties: {}
      +
      +

      In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

      When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object's style property as form.

      Special Considerations for multipart Content

      It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

      @@ -1925,34 +1933,34 @@
    5. If the property is a type: string with format: binary or format: base64 (aka a file object), the default Content-Type is application/octet-stream
    6. Examples:

      -
      
      -requestBody:
      -  content:
      -    multipart/form-data:
      -      schema:
      -        type: object
      -        properties:
      -          id:
      -            type: string
      -            format: uuid
      -          address:
      -            # default Content-Type for objects is `application/json`
      -            type: object
      -            properties: {}
      -          profileImage:
      -            # default Content-Type for string/binary is `application/octet-stream`
      -            type: string
      -            format: binary
      -          children:
      -            # default Content-Type for arrays is based on the `inner` type (text/plain here)
      -            type: array
      -            items:
      -              type: string
      -          addresses:
      -            # default Content-Type for arrays is based on the `inner` type (object shown, so `application/json` in this example)
      -            type: array
      -            items:
      -              type: '#/components/schemas/Address'
      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # default Content-Type for objects is `application/json`
      +            type: object
      +            properties: {}
      +          profileImage:
      +            # default Content-Type for string/binary is `application/octet-stream`
      +            type: string
      +            format: binary
      +          children:
      +            # default Content-Type for arrays is based on the `inner` type (text/plain here)
      +            type: array
      +            items:
      +              type: string
      +          addresses:
      +            # default Content-Type for arrays is based on the `inner` type (object shown, so `application/json` in this example)
      +            type: array
      +            items:
      +              type: '#/components/schemas/Address'
       

      An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

      Encoding Object

      @@ -1990,48 +1998,48 @@ allowReserved boolean -Determines whether the parameter value SHOULD allow reserved characters, as defined by [[!rfc3986]]section-2.2) :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded. +Determines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.

      This object MAY be extended with Specification Extensions.

      Encoding Object Example

      -
      
      -requestBody:
      -  content:
      -    multipart/mixed:
      -      schema:
      -        type: object
      -        properties:
      -          id:
      -            # default is text/plain
      -            type: string
      -            format: uuid
      -          address:
      -            # default is application/json
      -            type: object
      -            properties: {}
      -          historyMetadata:
      -            # need to declare XML format!
      -            description: metadata in XML format
      -            type: object
      -            properties: {}
      -          profileImage:
      -            # default is application/octet-stream, need to declare an image type only!
      -            type: string
      -            format: binary
      -      encoding:
      -        historyMetadata:
      -          # require XML Content-Type in utf-8 encoding
      -          contentType: application/xml; charset=utf-8
      -        profileImage:
      -          # only accept png/jpeg
      -          contentType: image/png, image/jpeg
      -          headers:
      -            X-Rate-Limit-Limit:
      -              description: The number of allowed requests in the current period
      -              schema:
      -                type: integer
      +
      
      +requestBody:
      +  content:
      +    multipart/mixed:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            # default is text/plain
      +            type: string
      +            format: uuid
      +          address:
      +            # default is application/json
      +            type: object
      +            properties: {}
      +          historyMetadata:
      +            # need to declare XML format!
      +            description: metadata in XML format
      +            type: object
      +            properties: {}
      +          profileImage:
      +            # default is application/octet-stream, need to declare an image type only!
      +            type: string
      +            format: binary
      +      encoding:
      +        historyMetadata:
      +          # require XML Content-Type in utf-8 encoding
      +          contentType: application/xml; charset=utf-8
      +        profileImage:
      +          # only accept png/jpeg
      +          contentType: image/png, image/jpeg
      +          headers:
      +            X-Rate-Limit-Limit:
      +              description: The number of allowed requests in the current period
      +              schema:
      +                type: integer
       

      Responses Object

      A container for the expected responses of an operation. @@ -2079,43 +2087,43 @@

      This object MAY be extended with Specification Extensions.

      Responses Object Example

      A 200 response for a successful operation and a default response for others (implying an error):

      -
      
      +
      
       {
      -  "200": {
      -    "description": "a pet to be returned",
      -    "content": {
      -      "application/json": {
      -        "schema": {
      -          "$ref": "#/components/schemas/Pet"
      +  "200": {
      +    "description": "a pet to be returned",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/Pet"
               }
             }
           }
         },
      -  "default": {
      -    "description": "Unexpected error",
      -    "content": {
      -      "application/json": {
      -        "schema": {
      -          "$ref": "#/components/schemas/ErrorModel"
      +  "default": {
      +    "description": "Unexpected error",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/ErrorModel"
               }
             }
           }
         }
       }
       
      -
      
      -'200':
      -  description: a pet to be returned
      -  content: 
      -    application/json:
      -      schema:
      -        $ref: '#/components/schemas/Pet'
      -default:
      -  description: Unexpected error
      -  content:
      -    application/json:
      -      schema:
      -        $ref: '#/components/schemas/ErrorModel'
      +
      
      +'200':
      +  description: a pet to be returned
      +  content: 
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/Pet'
      +default:
      +  description: Unexpected error
      +  content:
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/ErrorModel'
       

      Response Object

      Describes a single response from an API Operation, including design-time, static @@ -2138,7 +2146,7 @@ headers Map[string, Header Object ¦ Reference Object] -Maps a header name to its definition. [[!rfc7230]]page-22) states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored. +Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored. content @@ -2155,113 +2163,113 @@

      This object MAY be extended with Specification Extensions.

      Response Object Examples

      Response of an array of a complex type:

      -
      
      +
      
       {
      -  "description": "A complex object array response",
      -  "content": {
      -    "application/json": {
      -      "schema": {
      -        "type": "array",
      -        "items": {
      -          "$ref": "#/components/schemas/VeryComplexType"
      +  "description": "A complex object array response",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "$ref": "#/components/schemas/VeryComplexType"
               }
             }
           }
         }
       }
       
      -
      
      -description: A complex object array response
      -content: 
      -  application/json:
      -    schema: 
      -      type: array
      -      items:
      -        $ref: '#/components/schemas/VeryComplexType'
      +
      
      +description: A complex object array response
      +content: 
      +  application/json:
      +    schema: 
      +      type: array
      +      items:
      +        $ref: '#/components/schemas/VeryComplexType'
       

      Response with a string type:

      -
      
      +
      
       {
      -  "description": "A simple string response",
      -  "content": {
      -    "text/plain": {
      -      "schema": {
      -        "type": "string"
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string"
             }
           }
         }
       
       }
       
      -
      
      -description: A simple string response
      -content:
      -  text/plain:
      -    schema:
      -      type: string
      +
      
      +description: A simple string response
      +content:
      +  text/plain:
      +    schema:
      +      type: string
       

      Plain text response with headers:

      -
      
      +
      
       {
      -  "description": "A simple string response",
      -  "content": {
      -    "text/plain": {
      -      "schema": {
      -        "type": "string"
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string"
             }
           }
         },
      -  "headers": {
      -    "X-Rate-Limit-Limit": {
      -      "description": "The number of allowed requests in the current period",
      -      "schema": {
      -        "type": "integer"
      +  "headers": {
      +    "X-Rate-Limit-Limit": {
      +      "description": "The number of allowed requests in the current period",
      +      "schema": {
      +        "type": "integer"
             }
           },
      -    "X-Rate-Limit-Remaining": {
      -      "description": "The number of remaining requests in the current period",
      -      "schema": {
      -        "type": "integer"
      +    "X-Rate-Limit-Remaining": {
      +      "description": "The number of remaining requests in the current period",
      +      "schema": {
      +        "type": "integer"
             }
           },
      -    "X-Rate-Limit-Reset": {
      -      "description": "The number of seconds left in the current period",
      -      "schema": {
      -        "type": "integer"
      +    "X-Rate-Limit-Reset": {
      +      "description": "The number of seconds left in the current period",
      +      "schema": {
      +        "type": "integer"
             }
           }
         }
       }
       
      -
      
      -description: A simple string response
      -content:
      -  text/plain:
      -    schema:
      -      type: string
      -    example: 'whoa!'
      -headers:
      -  X-Rate-Limit-Limit:
      -    description: The number of allowed requests in the current period
      -    schema:
      -      type: integer
      -  X-Rate-Limit-Remaining:
      -    description: The number of remaining requests in the current period
      -    schema:
      -      type: integer
      -  X-Rate-Limit-Reset:
      -    description: The number of seconds left in the current period
      -    schema:
      -      type: integer
      +
      
      +description: A simple string response
      +content:
      +  text/plain:
      +    schema:
      +      type: string
      +    example: 'whoa!'
      +headers:
      +  X-Rate-Limit-Limit:
      +    description: The number of allowed requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Remaining:
      +    description: The number of remaining requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Reset:
      +    description: The number of seconds left in the current period
      +    schema:
      +      type: integer
       

      Response with no return value:

      -
      
      +
      
       {
      -  "description": "object created"
      +  "description": "object created"
       }
       
      -
      
      -description: object created
      +
      
      +description: object created
       

      Callback Object

      A map of possible out-of band callbacks related to the parent operation. @@ -2289,26 +2297,26 @@

      The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. A simple example might be $request.body#/url. However, using a runtime expression the complete HTTP message can be accessed. -This includes accessing any part of a body that a JSON Pointer [[!rfc6901]] can reference.

      +This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

      For example, given the following HTTP request:

      -
      
      -POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
      -Host: example.org
      -Content-Type: application/json
      -Content-Length: 187
      +
      
      +POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
      +Host: example.org
      +Content-Type: application/json
      +Content-Length: 187
       
      -{
      -  "failedUrl" : "http://clientdomain.com/failed",
      -  "successUrls" : [
      -    "http://clientdomain.com/fast",
      -    "http://clientdomain.com/medium",
      -    "http://clientdomain.com/slow"
      +{
      +  "failedUrl" : "http://clientdomain.com/failed",
      +  "successUrls" : [
      +    "http://clientdomain.com/fast",
      +    "http://clientdomain.com/medium",
      +    "http://clientdomain.com/slow"
         ] 
       }
       
      -201 Created
      -Location: http://example.org/subscription/1
      -
      +201 Created +Location: http://example.org/subscription/1 +

      The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

      @@ -2354,19 +2362,19 @@

      Callback Object Example

      The following example shows a callback to the URL specified by the id and email property in the request body.

      -
      
      -myWebhook:
      -  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
      -    post:
      -      requestBody:
      -        description: Callback payload
      -        content: 
      -          'application/json':
      -            schema:
      -              $ref: '#/components/schemas/SomePayload'
      -      responses:
      -        '200':
      -          description: webhook successfully processed and no retries will be performed
      +
      
      +myWebhook:
      +  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
      +    post:
      +      requestBody:
      +        description: Callback payload
      +        content: 
      +          'application/json':
      +            schema:
      +              $ref: '#/components/schemas/SomePayload'
      +      responses:
      +        '200':
      +          description: webhook successfully processed and no retries will be performed
       

      Example Object

      Fixed Fields

      @@ -2406,63 +2414,63 @@ of its associated value. Tooling implementations MAY choose to validate compatibility automatically, and reject the example value(s) if incompatible.

      Example Object Example

      -
      
      -# in a model
      -schemas:
      -  properties:
      -    name:
      -      type: string
      -      examples:
      -        name:
      -          $ref: http://example.org/petapi-examples/openapi.json#/components/examples/name-example
      +
      
      +# in a model
      +schemas:
      +  properties:
      +    name:
      +      type: string
      +      examples:
      +        name:
      +          $ref: http://example.org/petapi-examples/openapi.json#/components/examples/name-example
       
      -# in a request body:
      -  requestBody:
      -    content:
      -      'application/json':
      -        schema:
      -          $ref: '#/components/schemas/Address'
      -        examples: 
      -          foo:
      -            summary: A foo example
      -            value: {"foo": "bar"}
      -          bar:
      -            summary: A bar example
      -            value: {"bar": "baz"}
      -      'application/xml':
      -        examples: 
      -          xmlExample:
      -            summary: This is an example in XML
      -            externalValue: 'http://example.org/examples/address-example.xml'
      -      'text/plain':
      -        examples:
      -          textExample: 
      -            summary: This is a text example
      -            externalValue: 'http://foo.bar/examples/address-example.txt' 
      +# in a request body:
      +  requestBody:
      +    content:
      +      'application/json':
      +        schema:
      +          $ref: '#/components/schemas/Address'
      +        examples: 
      +          foo:
      +            summary: A foo example
      +            value: {"foo": "bar"}
      +          bar:
      +            summary: A bar example
      +            value: {"bar": "baz"}
      +      'application/xml':
      +        examples: 
      +          xmlExample:
      +            summary: This is an example in XML
      +            externalValue: 'http://example.org/examples/address-example.xml'
      +      'text/plain':
      +        examples:
      +          textExample: 
      +            summary: This is a text example
      +            externalValue: 'http://foo.bar/examples/address-example.txt' 
       
       
      -# in a parameter
      -  parameters:
      -    - name: 'zipCode'
      -      in: 'query'
      -      schema:
      -        type: 'string'
      -        format: 'zip-code'
      -        examples:
      -          zip-example: 
      -            $ref: '#/components/examples/zip-example'
      +# in a parameter
      +  parameters:
      +    - name: 'zipCode'
      +      in: 'query'
      +      schema:
      +        type: 'string'
      +        format: 'zip-code'
      +        examples:
      +          zip-example: 
      +            $ref: '#/components/examples/zip-example'
       
      -# in a response
      -  responses:
      -    '200':
      -      description: your car appointment has been booked
      -      content: 
      -        application/json:
      -          schema:
      -            $ref: '#/components/schemas/SuccessResponse'
      -          examples:
      -            confirmation-success:
      -              $ref: '#/components/examples/confirmation-success'
      +# in a response
      +  responses:
      +    '200':
      +      description: your car appointment has been booked
      +      content: 
      +        application/json:
      +          schema:
      +            $ref: '#/components/schemas/SuccessResponse'
      +          examples:
      +            confirmation-success:
      +              $ref: '#/components/examples/confirmation-success'
       

      Link Object

      The Link object represents a possible design-time link for a response. @@ -2518,60 +2526,60 @@ for specifications with external references.

      Examples

      Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

      -
      
      -paths:
      -  /users/{id}:
      -    parameters:
      -    - name: id
      -      in: path
      -      required: true
      -      description: the user identifier, as userId 
      -      schema:
      -        type: string
      -    get:
      -      responses:
      -        '200':
      -          description: the user being returned
      -          content:
      -            application/json:
      -              schema:
      -                type: object
      -                properties:
      -                  uuid: # the unique user id
      -                    type: string
      -                    format: uuid
      -          links:
      -            address:
      -              # the target link operationId
      -              operationId: getUserAddress
      -              parameters:
      -                # get the `id` field from the request path parameter named `id`
      -                userId: $request.path.id
      -  # the path item of the linked operation
      -  /users/{userid}/address:
      -    parameters:
      -    - name: userid
      -      in: path
      -      required: true
      -      description: the user identifier, as userId 
      -      schema:
      -        type: string
      -    # linked operation
      -    get:
      -      operationId: getUserAddress
      -      responses:
      -        '200':
      -          description: the user's address
      +
      
      +paths:
      +  /users/{id}:
      +    parameters:
      +    - name: id
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +    get:
      +      responses:
      +        '200':
      +          description: the user being returned
      +          content:
      +            application/json:
      +              schema:
      +                type: object
      +                properties:
      +                  uuid: # the unique user id
      +                    type: string
      +                    format: uuid
      +          links:
      +            address:
      +              # the target link operationId
      +              operationId: getUserAddress
      +              parameters:
      +                # get the `id` field from the request path parameter named `id`
      +                userId: $request.path.id
      +  # the path item of the linked operation
      +  /users/{userid}/address:
      +    parameters:
      +    - name: userid
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +    # linked operation
      +    get:
      +      operationId: getUserAddress
      +      responses:
      +        '200':
      +          description: the user's address
       

      When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

      Values from the response body can be used to drive a linked operation.

      -
      
      -links:
      -  address:
      -    operationId: getUserAddressByUUID
      -    parameters:
      -      # get the `uuid` field from the `uuid` field in the response body
      -      userUuid: $response.body#/uuid
      +
      
      +links:
      +  address:
      +    operationId: getUserAddressByUUID
      +    parameters:
      +      # get the `uuid` field from the `uuid` field in the response body
      +      userUuid: $response.body#/uuid
       

      Clients follow all links at their discretion. Neither permissions, nor the capability to make a successful call to that link, is guaranteed @@ -2579,22 +2587,22 @@

      OperationRef Examples

      As references to operationId MAY NOT be possible (the operationId is an optional value), references MAY also be made through a relative operationRef:

      -
      
      -links:
      -  UserRepositories:
      -    # returns array of '#/components/schemas/repository'
      -    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
      -    parameters:
      -      username: $response.body#/username
      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
       

      or an absolute operationRef:

      -
      
      -links:
      -  UserRepositories:
      -    # returns array of '#/components/schemas/repository'
      -    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
      -    parameters:
      -      username: $response.body#/username
      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
       

      Note that in the use of operationRef, the escaped forward-slash is necessary when using JSON references.

      @@ -2602,17 +2610,17 @@

      Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

      The runtime expression is defined by the following [Augmented Backus-Naur Form] syntax

      -
      
      +
      
             expression = ( "$url" | "$method" | "$statusCode" | "$request." source | "$response." source )
             source = ( header-reference | query-reference | path-reference | body-reference )  
             header-reference = "header." token
             query-reference = "query." name  
             path-reference = "path." name
             body-reference = "body" ["#" fragment]
      -      fragment = a JSON Pointer [[!rfc6901]]  
      +      fragment = a JSON Pointer [RFC 6901](https://tools.ietf.org/html/rfc6901)  
             name = *( char )
      -      char = as per RFC [7159]section-7)
      -      token = as per RFC [7230]section-3.2.6)
      +      char = as per RFC [7159](https://tools.ietf.org/html/rfc7159#section-7)
      +      token = as per RFC [7230](https://tools.ietf.org/html/rfc7230#section-3.2.6)
       

      The name identifier is case-sensitive, whereas token is not.

      The table below provides examples of runtime expressions and examples of their use in a value:

      @@ -2674,18 +2682,18 @@

      Header Object Example

      A simple header of type integer:

      -
      
      +
      
       {
      -  "description": "The number of allowed requests in the current period",
      -  "schema": {
      -    "type": "integer"
      +  "description": "The number of allowed requests in the current period",
      +  "schema": {
      +    "type": "integer"
         }
       }
       
      -
      
      -description: The number of allowed requests in the current period
      -schema:
      -  type: integer
      +
      
      +description: The number of allowed requests in the current period
      +schema:
      +  type: integer
       

      Tag Object

      Adds metadata to a single tag that is used by the Operation Object. @@ -2719,15 +2727,15 @@

      This object MAY be extended with Specification Extensions.

      Tag Object Example

      -
      
      +
      
       {
      -	"name": "pet",
      -	"description": "Pets operations"
      +	"name": "pet",
      +	"description": "Pets operations"
       }
       
      -
      
      -name: pet
      -description: Pets operations
      +
      
      +name: pet
      +description: Pets operations
       

      Reference Object

      A simple object to allow referencing other components in the specification, internally and externally.

      @@ -2752,31 +2760,31 @@

      This object cannot be extended with additional properties and any properties added SHALL be ignored.

      Reference Object Example

      -
      
      +
      
       {
      -	"$ref": "#/components/schemas/Pet"
      +	"$ref": "#/components/schemas/Pet"
       }
       
      -
      
      -$ref: '#/components/schemas/Pet'
      +
      
      +$ref: '#/components/schemas/Pet'
       

      Relative Schema Document Example

      -
      
      +
      
       {
      -  "$ref": "Pet.json"
      +  "$ref": "Pet.json"
       }
       
      -
      
      -$ref: Pet.yaml
      +
      
      +$ref: Pet.yaml
       

      Relative Documents With Embedded Schema Example

      -
      
      +
      
       {
      -  "$ref": "definitions.json#/Pet"
      +  "$ref": "definitions.json#/Pet"
       }
       
      -
      
      -$ref: definitions.yaml#/Pet
      +
      
      +$ref: definitions.yaml#/Pet
       

      Schema Object

      The Schema Object allows the definition of input and output data types. @@ -2892,152 +2900,152 @@ The XML Object contains additional information about the available options.

      Schema Object Examples

      Primitive Sample
      -
      
      +
      
       {
      -  "type": "string",
      -  "format": "email"
      +  "type": "string",
      +  "format": "email"
       }
       
      -
      
      -type: string
      -format: email
      +
      
      +type: string
      +format: email
       
      Simple Model
      -
      
      +
      
       {
      -  "type": "object",
      -  "required": [
      -    "name"
      +  "type": "object",
      +  "required": [
      +    "name"
         ],
      -  "properties": {
      -    "name": {
      -      "type": "string"
      +  "properties": {
      +    "name": {
      +      "type": "string"
           },
      -    "address": {
      -      "$ref": "#/components/schemas/Address"
      +    "address": {
      +      "$ref": "#/components/schemas/Address"
           },
      -    "age": {
      -      "type": "integer",
      -      "format": "int32",
      -      "minimum": 0
      +    "age": {
      +      "type": "integer",
      +      "format": "int32",
      +      "minimum": 0
           }
         }
       }
       
      -
      
      -type: object
      -required:
      -- name
      -properties:
      -  name:
      -    type: string
      -  address:
      -    $ref: '#/components/schemas/Address'
      -  age:
      -    type: integer
      -    format: int32
      -    minimum: 0
      +
      
      +type: object
      +required:
      +- name
      +properties:
      +  name:
      +    type: string
      +  address:
      +    $ref: '#/components/schemas/Address'
      +  age:
      +    type: integer
      +    format: int32
      +    minimum: 0
       
      Model with Map/Dictionary Properties

      For a simple string to string mapping:

      -
      
      +
      
       {
      -  "type": "object",
      -  "additionalProperties": {
      -    "type": "string"
      +  "type": "object",
      +  "additionalProperties": {
      +    "type": "string"
         }
       }
       
      -
      
      -type: object
      -additionalProperties:
      -  type: string
      +
      
      +type: object
      +additionalProperties:
      +  type: string
       

      For a string to model mapping:

      -
      
      +
      
       {
      -  "type": "object",
      -  "additionalProperties": {
      -    "$ref": "#/components/schemas/ComplexModel"
      +  "type": "object",
      +  "additionalProperties": {
      +    "$ref": "#/components/schemas/ComplexModel"
         }
       }
       
      -
      
      -type: object
      -additionalProperties:
      -  $ref: '#/components/schemas/ComplexModel'
      +
      
      +type: object
      +additionalProperties:
      +  $ref: '#/components/schemas/ComplexModel'
       
      Model with Example
      -
      
      +
      
       {
      -  "type": "object",
      -  "properties": {
      -    "id": {
      -      "type": "integer",
      -      "format": "int64"
      +  "type": "object",
      +  "properties": {
      +    "id": {
      +      "type": "integer",
      +      "format": "int64"
           },
      -    "name": {
      -      "type": "string"
      +    "name": {
      +      "type": "string"
           }
         },
      -  "required": [
      -    "name"
      +  "required": [
      +    "name"
         ],
      -  "example": {
      -    "name": "Puma",
      -    "id": 1
      +  "example": {
      +    "name": "Puma",
      +    "id": 1
         }
       }
       
      -
      
      -type: object
      -properties:
      -  id:
      -    type: integer
      -    format: int64
      -  name:
      -    type: string
      -required:
      -- name
      -example:
      -  name: Puma
      -  id: 1
      +
      
      +type: object
      +properties:
      +  id:
      +    type: integer
      +    format: int64
      +  name:
      +    type: string
      +required:
      +- name
      +example:
      +  name: Puma
      +  id: 1
       
      Models with Composition
      -
      
      +
      
       {
      -  "components": {
      -    "schemas": {
      -      "ErrorModel": {
      -        "type": "object",
      -        "required": [
      -          "message",
      -          "code"
      +  "components": {
      +    "schemas": {
      +      "ErrorModel": {
      +        "type": "object",
      +        "required": [
      +          "message",
      +          "code"
               ],
      -        "properties": {
      -          "message": {
      -            "type": "string"
      +        "properties": {
      +          "message": {
      +            "type": "string"
                 },
      -          "code": {
      -            "type": "integer",
      -            "minimum": 100,
      -            "maximum": 600
      +          "code": {
      +            "type": "integer",
      +            "minimum": 100,
      +            "maximum": 600
                 }
               }
             },
      -      "ExtendedErrorModel": {
      -        "allOf": [
      +      "ExtendedErrorModel": {
      +        "allOf": [
                 {
      -            "$ref": "#/components/schemas/ErrorModel"
      +            "$ref": "#/components/schemas/ErrorModel"
                 },
                 {
      -            "type": "object",
      -            "required": [
      -              "rootCause"
      +            "type": "object",
      +            "required": [
      +              "rootCause"
                   ],
      -            "properties": {
      -              "rootCause": {
      -                "type": "string"
      +            "properties": {
      +              "rootCause": {
      +                "type": "string"
                     }
                   }
                 }
      @@ -3047,100 +3055,100 @@
         }
       }
       
      -
      
      -components:
      -  schemas:
      -    ErrorModel:
      -      type: object
      -      required:
      -      - message
      -      - code
      -      properties:
      -        message:
      -          type: string
      -        code:
      -          type: integer
      -          minimum: 100
      -          maximum: 600
      -    ExtendedErrorModel:
      -      allOf:
      -      - $ref: '#/components/schemas/ErrorModel'
      -      - type: object
      -        required:
      -        - rootCause
      -        properties:
      -          rootCause:
      -            type: string
      +
      
      +components:
      +  schemas:
      +    ErrorModel:
      +      type: object
      +      required:
      +      - message
      +      - code
      +      properties:
      +        message:
      +          type: string
      +        code:
      +          type: integer
      +          minimum: 100
      +          maximum: 600
      +    ExtendedErrorModel:
      +      allOf:
      +      - $ref: '#/components/schemas/ErrorModel'
      +      - type: object
      +        required:
      +        - rootCause
      +        properties:
      +          rootCause:
      +            type: string
       
      Models with Polymorphism Support
      -
      
      +
      
       {
      -  "components": {
      -    "schemas": {
      -      "Pet": {
      -        "type": "object",
      -        "discriminator": {
      -          "propertyName": "petType"
      +  "components": {
      +    "schemas": {
      +      "Pet": {
      +        "type": "object",
      +        "discriminator": {
      +          "propertyName": "petType"
               },
      -        "properties": {
      -          "name": {
      -            "type": "string"
      +        "properties": {
      +          "name": {
      +            "type": "string"
                 },
      -          "petType": {
      -            "type": "string"
      +          "petType": {
      +            "type": "string"
                 }
               },
      -        "required": [
      -          "name",
      -          "petType"
      +        "required": [
      +          "name",
      +          "petType"
               ]
             },
      -      "Cat": {
      -        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
      -        "allOf": [
      +      "Cat": {
      +        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
      +        "allOf": [
                 {
      -            "$ref": "#/components/schemas/Pet"
      +            "$ref": "#/components/schemas/Pet"
                 },
                 {
      -            "type": "object",
      -            "properties": {
      -              "huntingSkill": {
      -                "type": "string",
      -                "description": "The measured skill for hunting",
      -                "default": "lazy",
      -                "enum": [
      -                  "clueless",
      -                  "lazy",
      -                  "adventurous",
      -                  "aggressive"
      +            "type": "object",
      +            "properties": {
      +              "huntingSkill": {
      +                "type": "string",
      +                "description": "The measured skill for hunting",
      +                "default": "lazy",
      +                "enum": [
      +                  "clueless",
      +                  "lazy",
      +                  "adventurous",
      +                  "aggressive"
                       ]
                     }
                   },
      -            "required": [
      -              "huntingSkill"
      +            "required": [
      +              "huntingSkill"
                   ]
                 }
               ]
             },
      -      "Dog": {
      -        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
      -        "allOf": [
      +      "Dog": {
      +        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
      +        "allOf": [
                 {
      -            "$ref": "#/components/schemas/Pet"
      +            "$ref": "#/components/schemas/Pet"
                 },
                 {
      -            "type": "object",
      -            "properties": {
      -              "packSize": {
      -                "type": "integer",
      -                "format": "int32",
      -                "description": "the size of the pack the dog is from",
      -                "default": 0,
      -                "minimum": 0
      +            "type": "object",
      +            "properties": {
      +              "packSize": {
      +                "type": "integer",
      +                "format": "int32",
      +                "description": "the size of the pack the dog is from",
      +                "default": 0,
      +                "minimum": 0
                     }
                   },
      -            "required": [
      -              "packSize"
      +            "required": [
      +              "packSize"
                   ]
                 }
               ]
      @@ -3149,51 +3157,51 @@
         }
       }
       
      -
      
      -components:
      -  schemas:
      -    Pet:
      -      type: object
      -      discriminator:
      -        propertyName: petType
      -      properties:
      -        name:
      -          type: string
      -        petType:
      -          type: string
      -      required:
      -      - name
      -      - petType
      -    Cat:  ## "Cat" will be used as the discriminator value
      -      description: A representation of a cat
      -      allOf:
      -      - $ref: '#/components/schemas/Pet'
      -      - type: object
      -        properties:
      -          huntingSkill:
      -            type: string
      -            description: The measured skill for hunting
      -            enum:
      -            - clueless
      -            - lazy
      -            - adventurous
      -            - aggressive
      -        required:
      -        - huntingSkill
      -    Dog:  ## "Dog" will be used as the discriminator value
      -      description: A representation of a dog
      -      allOf:
      -      - $ref: '#/components/schemas/Pet'
      -      - type: object
      -        properties:
      -          packSize:
      -            type: integer
      -            format: int32
      -            description: the size of the pack the dog is from
      -            default: 0
      -            minimum: 0
      -        required:
      -        - packSize
      +
      
      +components:
      +  schemas:
      +    Pet:
      +      type: object
      +      discriminator:
      +        propertyName: petType
      +      properties:
      +        name:
      +          type: string
      +        petType:
      +          type: string
      +      required:
      +      - name
      +      - petType
      +    Cat:  ## "Cat" will be used as the discriminator value
      +      description: A representation of a cat
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          huntingSkill:
      +            type: string
      +            description: The measured skill for hunting
      +            enum:
      +            - clueless
      +            - lazy
      +            - adventurous
      +            - aggressive
      +        required:
      +        - huntingSkill
      +    Dog:  ## "Dog" will be used as the discriminator value
      +      description: A representation of a dog
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          packSize:
      +            type: integer
      +            format: int32
      +            description: the size of the pack the dog is from
      +            default: 0
      +            minimum: 0
      +        required:
      +        - packSize
       

      Discriminator Object

      When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

      @@ -3222,7 +3230,7 @@

      The discriminator attribute is legal only when using one of the composite keywords oneOf, anyOf, allOf.

      In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

      -
      
      +
      
       MyResponseType:
         oneOf:
         - $ref: '#/components/schemas/Cat'
      @@ -3230,7 +3238,7 @@
         - $ref: '#/components/schemas/Lizard'
       

      which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

      -
      
      +
      
       MyResponseType:
         oneOf:
         - $ref: '#/components/schemas/Cat'
      @@ -3240,7 +3248,7 @@
           propertyName: pet_type
       

      The expectation now is that a property with name pet_type MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

      -
      
      +
      
       {
         "id": 12345,
         "pet_type": "Cat"
      @@ -3248,7 +3256,7 @@
       

      Will indicate that the Cat schema be used in conjunction with this payload.

      In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

      -
      
      +
      
       MyResponseType:
         oneOf:
         - $ref: '#/components/schemas/Cat'
      @@ -3265,7 +3273,7 @@
       

      When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

      In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

      For example:

      -
      
      +
      
       components:
         schemas:
           Pet:
      @@ -3305,14 +3313,14 @@
                   type: boolean
       

      a payload like this:

      -
      
      +
      
       {
         "pet_type": "Cat",
         "name": "misty"
       }
       

      will indicate that the Cat schema be used. Likewise this schema:

      -
      
      +
      
       {
         "pet_type": "cachorro",
         "bark": "soft"
      @@ -3365,294 +3373,294 @@
       

      The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

      No XML Element

      Basic string property:

      -
      
      +
      
       {
      -    "animals": {
      -        "type": "string"
      +    "animals": {
      +        "type": "string"
           }
       }
       
      -
      
      -animals:
      -  type: string
      +
      
      +animals:
      +  type: string
       
      -
      
      -<animals>...</animals>
      +
      
      +<animals>...</animals>
       

      Basic string array property (wrapped is false by default):

      -
      
      +
      
       {
      -    "animals": {
      -        "type": "array",
      -        "items": {
      -            "type": "string"
      +    "animals": {
      +        "type": "array",
      +        "items": {
      +            "type": "string"
               }
           }
       }
       
      -
      
      -animals:
      -  type: array
      -  items:
      -    type: string
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
       
      -
      
      -<animals>...</animals>
      -<animals>...</animals>
      -<animals>...</animals>
      +
      
      +<animals>...</animals>
      +<animals>...</animals>
      +<animals>...</animals>
       
      XML Name Replacement
      -
      
      +
      
       {
      -  "animals": {
      -    "type": "string",
      -    "xml": {
      -      "name": "animal"
      +  "animals": {
      +    "type": "string",
      +    "xml": {
      +      "name": "animal"
           }
         }
       }
       
      -
      
      -animals:
      -  type: string
      -  xml:
      -    name: animal
      +
      
      +animals:
      +  type: string
      +  xml:
      +    name: animal
       
      -
      
      -<animal>...</animal>
      +
      
      +<animal>...</animal>
       
      XML Attribute, Prefix and Namespace

      In this example, a full model definition is shown.

      -
      
      +
      
       {
      -  "Person": {
      -    "type": "object",
      -    "properties": {
      -      "id": {
      -        "type": "integer",
      -        "format": "int32",
      -        "xml": {
      -          "attribute": true
      +  "Person": {
      +    "type": "object",
      +    "properties": {
      +      "id": {
      +        "type": "integer",
      +        "format": "int32",
      +        "xml": {
      +          "attribute": true
               }
             },
      -      "name": {
      -        "type": "string",
      -        "xml": {
      -          "namespace": "http://example.com/schema/sample",
      -          "prefix": "sample"
      +      "name": {
      +        "type": "string",
      +        "xml": {
      +          "namespace": "http://example.com/schema/sample",
      +          "prefix": "sample"
               }
             }
           }
         }
       }
       
      -
      
      -Person:
      -  type: object
      -  properties:
      -    id:
      -      type: integer
      -      format: int32
      -      xml:
      -        attribute: true
      -    name:
      -      type: string
      -      xml:
      -        namespace: http://example.com/schema/sample
      -        prefix: sample
      -
      -
      
      -<Person id="123">
      -    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
      -</Person>
      +
      
      +Person:
      +  type: object
      +  properties:
      +    id:
      +      type: integer
      +      format: int32
      +      xml:
      +        attribute: true
      +    name:
      +      type: string
      +      xml:
      +        namespace: http://example.com/schema/sample
      +        prefix: sample
      +
      +
      
      +<Person id="123">
      +    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
      +</Person>
       
      XML Arrays

      Changing the element names:

      -
      
      +
      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string",
      -      "xml": {
      -        "name": "animal"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
             }
           }
         }
       }
       
      -
      
      -animals:
      -  type: array
      -  items:
      -    type: string
      -    xml:
      -      name: animal
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
       
      -
      
      -<animal>value</animal>
      -<animal>value</animal>
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
       

      The external name property has no effect on the XML:

      -
      
      +
      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string",
      -      "xml": {
      -        "name": "animal"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
             }
           },
      -    "xml": {
      -      "name": "aliens"
      +    "xml": {
      +      "name": "aliens"
           }
         }
       }
       
      -
      
      -animals:
      -  type: array
      -  items:
      -    type: string
      -    xml:
      -      name: animal
      -  xml:
      -    name: aliens
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
       
      -
      
      -<animal>value</animal>
      -<animal>value</animal>
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
       

      Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

      -
      
      +
      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
           },
      -    "xml": {
      -      "wrapped": true
      +    "xml": {
      +      "wrapped": true
           }
         }
       }
       
      -
      
      -animals:
      -  type: array
      -  items:
      -    type: string
      -  xml:
      -    wrapped: true
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    wrapped: true
       
      -
      
      -<animals>
      -  <animals>value</animals>
      -  <animals>value</animals>
      -</animals>
      +
      
      +<animals>
      +  <animals>value</animals>
      +  <animals>value</animals>
      +</animals>
       

      To overcome the naming problem in the example above, the following definition can be used:

      -
      
      +
      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string",
      -      "xml": {
      -        "name": "animal"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
             }
           },
      -    "xml": {
      -      "wrapped": true
      +    "xml": {
      +      "wrapped": true
           }
         }
       }
       
      -
      
      -animals:
      -  type: array
      -  items:
      -    type: string
      -    xml:
      -      name: animal
      -  xml:
      -    wrapped: true
      -
      -
      
      -<animals>
      -  <animal>value</animal>
      -  <animal>value</animal>
      -</animals>
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</animals>
       

      Affecting both internal and external names:

      -
      
      +
      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string",
      -      "xml": {
      -        "name": "animal"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
             }
           },
      -    "xml": {
      -      "name": "aliens",
      -      "wrapped": true
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
           }
         }
       }
       
      -
      
      -animals:
      -  type: array
      -  items:
      -    type: string
      -    xml:
      -      name: animal
      -  xml:
      -    name: aliens
      -    wrapped: true
      -
      -
      
      -<aliens>
      -  <animal>value</animal>
      -  <animal>value</animal>
      -</aliens>
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</aliens>
       

      If we change the external element but not the internal ones:

      -
      
      +
      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
           },
      -    "xml": {
      -      "name": "aliens",
      -      "wrapped": true
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
           }
         }
       }
       
      -
      
      -animals:
      -  type: array
      -  items:
      -    type: string
      -  xml:
      -    name: aliens
      -    wrapped: true
      -
      -
      
      -<aliens>
      -  <aliens>value</aliens>
      -  <aliens>value</aliens>
      -</aliens>
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <aliens>value</aliens>
      +  <aliens>value</aliens>
      +</aliens>
       

      Security Scheme Object

      Defines a security scheme that can be used by the operations. -Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!rfc6749]], and OpenID Connect Discovery.

      +Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

      Fixed Fields

      @@ -3692,7 +3700,7 @@ - + @@ -3717,65 +3725,65 @@

      This object MAY be extended with Specification Extensions.

      Security Scheme Object Example

      Basic Authentication Sample
      -
      
      +
      
       {
      -  "type": "http",
      -  "scheme": "basic"
      +  "type": "http",
      +  "scheme": "basic"
       }
       
      -
      
      -type: http
      -scheme: basic
      +
      
      +type: http
      +scheme: basic
       
      API Key Sample
      -
      
      +
      
       {
      -  "type": "apiKey",
      -  "name": "api_key",
      -  "in": "header"
      +  "type": "apiKey",
      +  "name": "api_key",
      +  "in": "header"
       }
       
      -
      
      -type: apiKey
      -name: api_key
      -in: header
      +
      
      +type: apiKey
      +name: api_key
      +in: header
       
      JWT Bearer Sample
      -
      
      +
      
       {
      -  "type": "http",
      -  "scheme": "bearer",
      -  "bearerFormat": "JWT",
      +  "type": "http",
      +  "scheme": "bearer",
      +  "bearerFormat": "JWT",
       }
       
      -
      
      -type: http
      -scheme: bearer
      -bearerFormat: JWT
      +
      
      +type: http
      +scheme: bearer
      +bearerFormat: JWT
       
      Implicit OAuth2 Sample
      -
      
      +
      
       {
      -  "type": "oauth2",
      -  "flows": {
      -    "implicit": {
      -      "authorizationUrl": "https://example.com/api/oauth/dialog",
      -      "scopes": {
      -        "write:pets": "modify pets in your account",
      -        "read:pets": "read your pets"
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
             }
           }
         }
       }
       
      -
      
      -type: oauth2
      -flows: 
      -  implicit:
      -    authorizationUrl: https://example.com/api/oauth/dialog
      -    scopes:
      -      write:pets: modify pets in your account
      -      read:pets: read your pets
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
       

      OAuth Flows Object

      Allows configuration of the supported OAuth Flows.

      @@ -3853,42 +3861,42 @@
      scheme string httpREQUIRED. The name of the HTTP Authorization scheme to be used in the [Authorization header as defined in RFC7235]section-5.1).REQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]].
      bearerFormat

      This object MAY be extended with Specification Extensions.

      OAuth Flow Object Examples

      -
      
      +
      
       {
      -  "type": "oauth2",
      -  "flows": {
      -    "implicit": {
      -      "authorizationUrl": "https://example.com/api/oauth/dialog",
      -      "scopes": {
      -        "write:pets": "modify pets in your account",
      -        "read:pets": "read your pets"
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
             }
           },
      -    "authorizationCode": {
      -      "authorizationUrl": "https://example.com/api/oauth/dialog",
      -      "tokenUrl": "https://example.com/api/oauth/token",
      -      "scopes": {
      -        "write:pets": "modify pets in your account",
      -        "read:pets": "read your pets"
      +    "authorizationCode": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "tokenUrl": "https://example.com/api/oauth/token",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
             }
           }
         }
       }
       
      -
      
      -type: oauth2
      -flows: 
      -  implicit:
      -    authorizationUrl: https://example.com/api/oauth/dialog
      -    scopes:
      -      write:pets: modify pets in your account
      -      read:pets: read your pets
      -  authorizationCode:
      -    authorizationUrl: https://example.com/api/oauth/dialog
      -    tokenUrl: https://example.com/api/oauth/token
      -    scopes:
      -      write:pets: modify pets in your account
      -      read:pets: read your pets 
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
      +  authorizationCode:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    tokenUrl: https://example.com/api/oauth/token
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets 
       

      Security Requirement Object

      Lists the required security schemes to execute this operation. @@ -3915,27 +3923,27 @@

      Security Requirement Object Examples

      Non-OAuth2 Security Requirement
      -
      
      +
      
       {
      -  "api_key": []
      +  "api_key": []
       }
       
      -
      
      -api_key: []
      +
      
      +api_key: []
       
      OAuth2 Security Requirement
      -
      
      +
      
       {
      -  "petstore_auth": [
      -    "write:pets",
      -    "read:pets"
      +  "petstore_auth": [
      +    "write:pets",
      +    "read:pets"
         ]
       }
       
      -
      
      -petstore_auth:
      -- write:pets
      -- read:pets
      +
      
      +petstore_auth:
      +- write:pets
      +- read:pets
       

      Specification Extensions

      While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

      From 1d5c5cbad272bd754d34d4928f8398cedeec953b Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Wed, 28 Nov 2018 10:53:06 +0000 Subject: [PATCH 005/152] draft registry content --- LICENSE | 201 ++++++++++++++++++ README.md | 12 ++ _config.yml | 32 +++ api/alternative-schema.json | 4 + api/draft-feature.json | 4 + api/extension.json | 4 + api/format.json | 4 + api/registries.json | 4 + api/site.json | 4 + assets/css/style.scss | 26 +++ assets/img/draft.png | Bin 0 -> 46269 bytes registries/_alternative-schema/jsonSchema.md | 18 ++ registries/_alternative-schema/xmlSchema.md | 18 ++ .../_draft-feature/alternativeSchema.md | 33 +++ registries/_extension/x-twitter.md | 40 ++++ registries/_format/commonmark.md | 20 ++ registries/_format/html.md | 19 ++ registries/_format/int8.md | 20 ++ registries/_format/uint8.md | 21 ++ registry/alternative-schema.md | 22 ++ registry/draft-feature.md | 22 ++ registry/extension.md | 22 ++ registry/format.md | 22 ++ registry/index.md | 24 +++ rss/feed.xml | 25 +++ 25 files changed, 621 insertions(+) create mode 100644 LICENSE create mode 100644 README.md create mode 100644 _config.yml create mode 100644 api/alternative-schema.json create mode 100644 api/draft-feature.json create mode 100644 api/extension.json create mode 100644 api/format.json create mode 100644 api/registries.json create mode 100644 api/site.json create mode 100644 assets/css/style.scss create mode 100644 assets/img/draft.png create mode 100644 registries/_alternative-schema/jsonSchema.md create mode 100644 registries/_alternative-schema/xmlSchema.md create mode 100644 registries/_draft-feature/alternativeSchema.md create mode 100644 registries/_extension/x-twitter.md create mode 100644 registries/_format/commonmark.md create mode 100644 registries/_format/html.md create mode 100644 registries/_format/int8.md create mode 100644 registries/_format/uint8.md create mode 100644 registry/alternative-schema.md create mode 100644 registry/draft-feature.md create mode 100644 registry/extension.md create mode 100644 registry/format.md create mode 100644 registry/index.md create mode 100644 rss/feed.xml diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000000..261eeb9e9f --- /dev/null +++ b/LICENSE @@ -0,0 +1,201 @@ + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + 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. diff --git a/README.md b/README.md new file mode 100644 index 0000000000..fa4a0ebe4a --- /dev/null +++ b/README.md @@ -0,0 +1,12 @@ +# OpenAPI Initiative Registry + +This site contains the OpenAPI Initiative Registry and content for the HTML versions of the OpenAPI Specification. + +## Registry + +* Proceed to [Registry](/registry/index.html) + +## The Specification + +* [Markdown source-of-truth](https://github.com/OAI/OpenAPI-Specification) +* [HTML Specification versions](https://openapis.org/specification) diff --git a/_config.yml b/_config.yml new file mode 100644 index 0000000000..4175c0b24e --- /dev/null +++ b/_config.yml @@ -0,0 +1,32 @@ +theme: jekyll-theme-dinky +title: OpenAPI Initiative Registry - DRAFT CONTENT +description: Extensible data value repository +show_downloads: true +collections_dir: /registries +collections: + posts: + hidden: true + object: + slug: object + name: Object Registry + hidden: true + format: + slug: format + name: Format Registry + output: true + permalink: /registry/:collection/:title + extension: + slug: extension + name: Specification Extension Registry + output: true + permalink: /registry/:collection/:title + draft-feature: + slug: draft-feature + name: Draft Features Registry + output: true + permalink: /registry/:collection/:title + alternative-schema: + slug: alternative-schema + name: Alternative Schema Type Registry + output: true + permalink: /registry/:collection/:title diff --git a/api/alternative-schema.json b/api/alternative-schema.json new file mode 100644 index 0000000000..54df82dfd5 --- /dev/null +++ b/api/alternative-schema.json @@ -0,0 +1,4 @@ +--- +--- +{{ site.alternative-schema | jsonify }} + diff --git a/api/draft-feature.json b/api/draft-feature.json new file mode 100644 index 0000000000..7663a1fb4c --- /dev/null +++ b/api/draft-feature.json @@ -0,0 +1,4 @@ +--- +--- +{{ site.draft-feature | jsonify }} + diff --git a/api/extension.json b/api/extension.json new file mode 100644 index 0000000000..54cd4ae033 --- /dev/null +++ b/api/extension.json @@ -0,0 +1,4 @@ +--- +--- +{{ site.extension | jsonify }} + diff --git a/api/format.json b/api/format.json new file mode 100644 index 0000000000..693d349cdc --- /dev/null +++ b/api/format.json @@ -0,0 +1,4 @@ +--- +--- +{{ site.format | jsonify }} + diff --git a/api/registries.json b/api/registries.json new file mode 100644 index 0000000000..9507cb0c20 --- /dev/null +++ b/api/registries.json @@ -0,0 +1,4 @@ +--- +--- +{{ site.collections | jsonify }} + diff --git a/api/site.json b/api/site.json new file mode 100644 index 0000000000..6ff3841e59 --- /dev/null +++ b/api/site.json @@ -0,0 +1,4 @@ +--- +--- +{{ site | jsonify }} + diff --git a/assets/css/style.scss b/assets/css/style.scss new file mode 100644 index 0000000000..72c5761ef1 --- /dev/null +++ b/assets/css/style.scss @@ -0,0 +1,26 @@ +--- +--- + +@import "{{ site.theme }}"; + +h1,h2,h3 { color: #629b34; } + +a[href] { color: #45512c; } + +footer { display: none; } + +header > ul > li { + background: #629b34; + box-shadow: inset 0px 1px 1px 0 rgba(33,2,38, 1); +} + +header > ul > li:hover { + background: #45512c; +} + +section:first-of-type { + background-image: url("../img/draft.png"); + background-size: 30%; + background-repeat: repeat; +} + diff --git a/assets/img/draft.png b/assets/img/draft.png new file mode 100644 index 0000000000000000000000000000000000000000..2141470ae717b9eed1d5176aa9a8e212e0f9f9c5 GIT binary patch literal 46269 zcmYIv2Q*yY8!gdW^xiwsLv$mAkZ4Ini{6RRqxarhh+cj~h+Z>#@12M`M(+$p@80GA z-g=f<%e`}P=A7@GZ}0u>FXDr$0v5Y@Q z@i%ib1~=<(RtyU7R6dyTnqwd#F(AE@llkmEzu#gTtvBPbb>%hMaG|Lol98nNF^MxG zfz(=(%#<>~dbm3ckxFb@!__W`f&$YvdS*(7$;1+MN8mSmwF=Y3N5{ETaz*Cr{Xoz@ z*WUgN*3K=APO~2^{LhSi)XcQ3*YyjXJl$WSvrh5^ra72~i{Yr)%}Vy9Pt&Z~i9Acw zz?K3@q(1Ov@AGgbz2%YJ7EJJgME)bm#;DOL=hIK5Uw}*bkGUF;x8*}LA1^*zk^cV+ zlK(x?pk;PV!V#IbuPWF53>ninDi@Q9N%u}~92tA}@$n=$7Gpg@U|T4rQaI9gRN;vI zKXTe16-t0#0k3@c>5$G+oKWCQ>QeQhHZqT6aD;(L2a_?P2(2K12^-AGWUVu2&pLXI zTRi>(cpDmJ>r{z09<`-IVu1Xj-L0H!=8K)?)3B08%4-P|B(cHhqW|UV%Z~nRXX9}N z8)*LDcWoC+W1d6k(QA{vZ2GIue z>%rfTA5D^h8?&7|Dr@zZ*a>z@WSF&+zgo9aPV|<->Xka;7OVS0V1zNSdGzbyp5&Zb z9W|y^P8oI?FkvX8x7VOuB83yb;fSIO4lh%03&vU3m;czP0) zBFtXm?tn}*I%9slO>aus-!eDgLz4N$pB$0ZK{_U*-f_}DABPPEYGd7q(n+3wGi1mcW;H) zDRLm#cyL6BS9kM_3hs2Hf^o6nGKR9T?m_ibIku@b@R}BND}f|no}O>;@SgJu9#o8< z(sZnc=X8qu|G`UW<|V@-!@`s4b)O{2=ZPOI9>)f&N*pm+o)AIK=bnOY-)S>;Q&<0% zsju2_bz+Ar2}Pk&M^|itgd&GAHw-bETA-`ntfL40YDTSJ%G|#`K%5^|_5~%{+*I{t zC1~;E4Okle+m1FcUj|j8ZW=O);r%BxFL?Q>Fo|$4r5qb5jG{#bir5IVzE$e#`_g)U ztA2Kx7n@8h^(Qofj6wg4=Hp(e#z{4#e?H+7$vP_JXg$m1%cmn4<6^r}De_LPgriaS zWA`1Dy1j>ZVoG&_m(^_or2Du#lVF3L*Pjc%wdVLvvU8!xJnN^h@0}r-swG))sU4VF zWH9cWvY41tjR+?ttohMjeDuE$Or<5k`6XxN!wK$97&;=>hH& z{Ge+w__-nplr4L!mhsp}T>j&Pdx_ms81I7=prkcj!@)}{CubxcKNv@Yl2G@=eaeN& z?PZ;;k8Z@`iluYY+!=<%N-*$HE=81JoI zf8@=$@Nv2n#$m|&LIql*Pj*sXtBI(ACDf)0^+Xw-qTsD#NT&kH_r;8q~@DObO|%>N^1uIgP0 zjJ~i&AwAh~@-VV)5~eWnGkojgKh{M9lzKh{!3bH1IxHb3#rpWWkyp4^Xopn-U(ELA z8v18Bh)hZ>u-^^{bi=_;D8w`gafjeAaHLOfu6W6qUqCygZPhjj_hI= zT3f$374=_@Q$t0S#f*v(B4Vpv;ev{yYFR#6Z5(Vk^-swnDQnp-YTN9F*6rQ5RBJ1_ z@V*T?enp?s8L9w^wmRSRZ_QayIux7sueWU&`|{}q8SBJm=zA8G<#C8u1|R}Q)E5;r z@%hWUGjb|5n|m+5`JJgNmeN%9oF$9Qn~- z2V7cGB*ijt3AHeSaylCy5)3K2u*mPKu@7RJF={E^1E+vy+rz0^tyq{8Cul1t2W-7SOx9>6lO(kkqi5FE{Hc0P}QkO`{y8aASugw zYJtMEnd7n_NlhwbO(m!<)(A{8BSpe2(;4r1B%(L#oT+yH*Osq}+Zbn-0z{ZcY|ys2 zPIq|WQF8qvhZmp!_dMt4USy%m(oWKn&t9~PqaUJM+Y`CkhAKW+GAIqFp&4l0eRw>q zoJ45gf%zoa<%vFtIClanbUYS{yb!MP5tqMiNZ6&+pUCk*BnA}bUi{&)E@cnz%AnJ64&T{zyZZ4J0-c_`HYbgzejSwyfDya2 z5~v=TsGXWqks_0q#HFxk`;B&zP{DxVma_J*7Xbw|7)^Az4mL&NC&q;7tjRFyOmhDV zorJcPK&k#D`;Zo{YMkos>f!3&Z@B(9S=I_o9X2#WtpgG*iP1N2^gux>EhT#a`-#X% z(7Q;XE_b|~DR&#f2Z|oit@g{Cm9lE)+6AkGf40*5u2(t-(}z&_HdPalYx>$B^Kl3C zu8#8JeX|OahlGGDXFy>X;!ay`19S74OV#jI5t>+bPqVh4h&&(O*tnKH?PD_6cdV^& z0iC3;snbf&MvOsf9kLUuJtEfu!|`0BP3ZKHnLfpy$U%s1B^`rIekORUxX z|E4PNF>xv~fY&~CxyXH%*LXrJi88#u>icYBiR7$!Mo4C$>uWgoY!n%KZE6S=Hcj;rdSqEU$F z_Igdyo@yy^y2dK22Qetzy<6HM;XV+&MT1&oUCmnLY2y_QyPESoq+Z25RlD4@35J^nv9f$KV#?5b2Wg`aSVs8TM*kj7_<%+ z4zbTk>>4W}g^dlmYKH{te`sh@KLOJVeT&oln1peO8QvbqUB!)5!|mE_A@lvxH-P=7 zu)emiV+-ApvezTfo2cd|PSk}%AA()oP{^7R^T zuOr4T8Hu&}4f3ipJBM1dRWAT98sk}NIb7XbO7>}5>d+#0kyMah*nAATLF6hu&SNFF z!@@nrA`i%9p-oooj__wuj&qS;rZl%Oc0ST(m&oPnCHZWfrko=TPpJ=Wl_xmK5?b5y zQDAIZGfNW6Nw^agK4ot96c%+GMp(iBrcZR}G8+4Tixligcv}#pn3njQ_TB7=NH3qd z2duef^Ifew_(dob^6^uN2EvU?*xio0RFF?A1%evFM_v69(s{g#mOZ7^%hPk3*KeP; zV?-k*${;&CzwK@uY}Q7_JIXRjdQN-K3@0T~0Q>xXy0x_&FT_ zK1|6V+KWCger@TAYruP3j)h__dt)3M0GwV@a4^M`p>4%&7!)9tQj8!yQQE4 zf2@(z=z40eiFZKo*QoJ}?n&jLchd(AincSB8IfJdse(WlG>#fP(NFRD689L>IpC0V z`|ju$K4e*`!BtIN6Tw5Ix?)?*@B6)ls{$c|RcXLaQt{AS$|rR(-_Qv;Fy1Rn82=WC zMrX4{cqppil`hmPpcpeovq;r_m`mXoiL!QhqWL43jIE?vhPF)n5uLasi>CXfIJXEU z$L5wApxOi9{PE|1GX|ik;$HZ%>1b^B76JWBAyQs9cc{hRG>ekb`K-6N z?;R+6F#=D*5vYRT8}P`pKA1BNt`=75)7E&oW0u$-izRFi)n9l!td9w5Ty18K4-5`c zW=+6iVuIcOB?u%>V6^3iEfW@aKF`TQby7ZA4|Z-zu4zdTZAM;$vfA&48c};sFP})S zD%@k<49=-$!`JKIn|sx^D11!1Nk@x?+8>WL_P-T43*rD+!=^2&0Yy)X260q|W>Gm; zY_2(Kw8@^@5$Yto4mN;FKriU(Wu_8qjk_wapQeeyJJ(;%gScZ@|(w*2Pi9! zq;BT=r>d}OEyzt=Zd`q>-h!=PTI5{yn@kr}Q`3MCVI<|gJcAcHg#WpPOEs{kPC6zZ zsk%VW5djPWqB5)IjD13Z!LQ>PT@d=d!w>QqmJ(xFF>~sV=;QCPI*6w9!+B`^LJ-Rg zHnn=<_vPm%e%31d$Shs;&!Cb6ttA)iDVw-BeP!XZqy4gKP2FEC!cP$AZV)8Jcy}jv z^|idUI=fJlOk=&l8lSiy_lC#iQ*J*V^BF!>*|Isz-+uviS}D81$RyY10v)ENK_Z{+J!cyPrrju z9$mDxCp%(J;^R0E(P$;nflH4-EnJG)wS`nqEgs#zS4bzPG6s-N1XDs7?p-iKR0Pr%B^9B-jH~rY)(i7sO-ri(JmY@+sVPnVSi3)lnB!~~!)tEB zv0xPu7=yG=2L@xO80OM64}{#ix%>S6ZJqrjS6t8zZ7Dk?F_{F=edxabU{7E#!35Q3 za@7@`El?+5sXE$`w4roR_ex|$CAUORd97nKU6NqqoqVvQ>gPELa-If-@$&K%f}ln9 z3S}OU$Gp8zH%#Y3tB{5|!J_5KERyh+PgQ)LCD`WQ48c5FMB85Rnw904u$-mDZTw1O zjS5_-X@%3(eUg`v+R*4LluXh5%`P%Otrnp$UDLtDBLQ}j#)20_$OpJO1S{DM6GwMt z6c7`ql!Mt9Y_-5>Snn`RS<82<6uqdGM5dMIi{8?mRsLWAos}Pi7G8S#K&;Ui%h|qx zEdP@&0g~6?og9fYMzp_Uto1WRnoIlQ*jd%c{rp)7MsLiowE|iv$Fr*An3HD}@3*w) z4J@rkmB|!YtEAfh)st^=Y1Mmg;mGMKCtrgTmp28*gt3b^pF{~Kdalx37j?FSsOfgA z*9J-p#4)687EWr@uGl}H^SA71yR$UTuSZMt4UVYV?ijLmoFo2WAN{QcvqBy<9FXUa z*AADoOJ`O3IkvYBrUA&~TWlBA^r>}4WD%Tz*gy*=%OZ&yPOjm;wtIaO1z_SaT|vCX zP}epg?d~mY%lTa$uW+MJ24E3LIdsVr+g_?;J#|y(d1)4AVXqd9Jl-MZZn-|cv1sF$ z^HPmMYWgCuShgFdKO$YP>J@HiqWu{^gb{R}oqwgz$2NaVSo^{WDpNfzLCS}BhgWri zd`Dme4aS=n(bq54ZVXo^@}NtZs@xxb_)b75Z& zcHg$%c{{LF9D{a*+RRL7)I&*9VPjfF1-_jPJ29=JXlWZ(+GY*+BpAKw>l%7*Aubv3 zO_4ku9Z=ifO?PU_>|0k%6A!=8;A_~G78-8PHsDg9TI$3%y0%6HIlS{s3(1A=J<= z+uW}qWs#%nA98-@1}QJs&t-$SZQm>z@5zIr^R>T+F-7}iokVz9IE??6mZR40a0j=+ zJ{gvK$J7n>5&^0k-<)>3X9~i{e*90$s#dB*ENAsSVEmWHRB>(gOXfDb;8I;xzA8jS zln)?bOIu~TeycOnbmpF^rd0GP)-xsopJr%P#rxl&o_v5O|XQvc*hP z*s6eyPqITu4cheCK=JE%uB0F>QL!_orJ9pW2b|`wNESM$(yMg}f~W7JtdT$rsqk(t zF$m2bSb3fD6Zz8m(gh^d(OYSMS`x~R4CQSrywi$cf_6It3L_Mw^bzkZG%=5#;ny23 z58TW5&QWPBc1z9)RdFigrZ~8(uQ>ZtMoy%7c)F*ijgP2hty$fhj-F|9c;PMHn{a_= zSn%!-jlCm8*bzDmiaDj8nP~|8&YcNcZ~yp+uV!!bsHD5IB?(xt4?VMOnMlDfn-nk4 zRhNGL#k!l3-k#}V+_i%Kk|1UMEK6#422{mIQYVpop}kY_;ry>d817ni%qjIGvrT$^ zg|$GdKGnHv$k(I7Oe!P*_(7`dDgjwaGA>zteJW;{ikE+pFu$9cIwcb`1j#O&#z}tyG0`jF!Fsz;ts_urWz9X-1J! zKx~e9eW2^6b5ZG%`DOjaY>j3TwasjWZ+dF}iUUvdVR2zagUih`%XjQIgOXn{(wc z)}Exi(jj$)B0fkBof3KtTSFDrsc5xB`*@2&j>1ksBDx!Mt?f1PB4e(9Hw^hWi%xu+ zG)ksa0x1q514I6_7&RA8dzFFoEp*kP$FTZx%dNGiG%5SEhN@TAYT}nu{o>S4| z_6m8t|3~>uU3&&{f5{_gY74!15yq%|augk28bXj>k4w{N(g>&Zw)=VEmiTf1bgoz6 z`}A6Lmym5-S@74C&uoQ~x@!D3|5`*E+JWRGIW!?2Vd>ra=|+tpf%{-2?BHbL>b`t_ zYwA&3Iw)e@ZG^It)f_sNyM}8`gPc{^Nt|t+nY9s}Tgy*pFwe?!g z%-?mO>6qvMVf=W8k&%08abRQ{;jLnW@09hjRc(bG=R|4D;;b=W_NEDzI#K2L^&h>* zG(MZAyAN#mVnvSX!AVN7@%oUk;5xwQB^cH<$zp~>G$LvOLw-xeN<#?I=w)iwR%(|X)*v<$U4$2_eW4_M@0Tfd`->}fkB z^g&+LN5347r3ccyp8fe!84nCF4EXr?9lN_ivi<-acdcQ)My)KWN&z~dG1qj z?r{FeQx-B)VhTb(quI09qGRDLPFGn9YcRI~0|gj5jS^^d9gh7488ymLjbTyNJ+sBk z_N&Togi|o*iAd?OmR^Ejsc<4wyxzR)P+#@R`t2W7kwr~<3dzpT_ykebj{x|&pGTj2 z26O8yhf(4yZ_PEhSfEGn4wwD0ao1a}afZgZNC-c7gI+{A1a%N5d@K7XI5mWE_dk|+ zhclIzW&z7v!01Ptk8iRXNGc>k%Y<+ zBi3A%#3K3pD9bRNKA(R(ko z=;JD=!assK|8b~v&f~$Q6DuO*JCW83pn2uuzOUaG){i0lc6Y?RfMP^0^ z{T%fQNwll@Cy!b2-=iCr}KBo5h;se{|Kjk50Qw(NC@mP0FP=;XMTT0BMo;X=7&-Y2fZ zxdu<>m%Wa6?P`YMg|7*fu~S6VBYWHl;cM`n{22Xy90;BWDt!#Bpk8nHptU`WTY%Q^ zIQxE8R?c*b_pgr2jQ%)>xg9q#_ce;X8|)tAV{Gl6 zUJ;b>4s}$kth)x;Yh-9CC7ZjZ+>&n7Jx-10*ENDGa$v8itKz-aJHQh52Wx38v}6qo zHEksx{PFUFnG~P4xHf)AIC>jVMaL^7{D{p0=cSfEO9@ay++tS}wQ1FOe3|HDvx9ET z9mnv+&Pgj?Fv1--M|cNoRAdN=Qevr_W8^3epE4MOG`#tFpF_1GN{^m#`R)~jil5ms-Vrs+_TuCNN5lRr+?K8&{ z>3p#0w7H+RrO+moXB+V@mM@B#)y?}x>B}N-CGVMJUlN^{J_7XD~ScgumJjiYe4?i5k<>|7R5H@orynL0`1DAA|o!*$nz9ff%NFKX2Bm5Gc zk>8mqs7uOBje?O=nJQu{D{hI@UX3|A%xLXDQJ=oclv^FYA1|mU*8>=Y=`N)JwbD&u zfUouE=OPhEEHmLRQXPASZy29aT~q#0x&p4VH5U#Th)q8>2$zCYLq^-oV z^DPFc_1^k^O({zQSZ|q_z^x_b&3uat9wcS7Jhhw(q8l@B-E`?q8pS(`M17r&XTrMo z{#HHi3#I5Nt|WC<6}5T7P!*E5)OJREf`5vFDdJL|kM8{I@{HQyMM?Z3_t&g2rZQlp zZjx}0TURszvy(3DB?q;NLGx|k(c=ejhh${^vWShD1A&<38yikxUMo}Jkq2V0j)L6DJtTH%9 zTURF78$hxb`!HG=IySG<2NxZwb;~}VLh1N-$xV>oJ{`yZ>KfgU#!!Fz+n?Ejizl)E z;uXNwfcyxkL-39&l^$f#j-q4oIq5ICoonz^w&(QxbXJ|c*~QlLSW0pV>gNOLoK6>j z3|uJH7!#O!Amg^uD2qV5H*!yK6wVvX3s>UW?kJct6#i~fjFk(!@(P;iugPM&cz)O` z^dm0lmMf6bNUu$>drftz#dkl^C5x;i>6b(=barx|r&ldOD`)j}mciD6ebrDo;`3DKamC(y-&|ypQ>ve{O$v?}d$#JNToYz+27v6S;a6~*Mg~9-JVv|vKoxR#V3MIZ>`jyjcZK)TD2MmRzc+ILTYH&D0~c;=sKM1;Cl(|>w7JE zeop&KYzS5SOxv*O8i2Y-4u8U>72(N*(O+<-_< z@wQ~28YHKQjEk6~;-!X#q_(^`A5b;TlJBIjA4>h`vGST0WN447#yxa*>6Z7XX)U~TcB*yH61)SLA$m@qNdZD|pFVr}vlu0Z z15lv!9sSiR(@FS*eGvsHpDY==As7|Z6pQqUcFW>Y)x@g@_M7L2SID=GN_~k#mq3Zn z(n|n%&INq=}_*(y$|XR6JfSvxsReY$hUFSM5eXJ?c|}GzfCz&x7$*nR^m)CUAP{m z+x}&xFyzj&1v7YW(=3ACt)}=*`O_&|cx-DL1AQuoQZJobNBAhc~{cM*kE>JpdefXX| zB#)I#_5J%DR!@{u*4x2o{kz*$+OXSN{eD;R&E)d2rgzWCI2V*G`=&}Cj~{DDK&`pb`rY-K@D8vQ`T zdXT`O7tQbJk={4!_mHMg;4iM49LmQ^{kLW{x#!S%N0viD%TS?Q_}jWE=bTnX^_|kQ zTs2L4H~~FKE)jmy>n?5 z2+O-T)=ltEF^U^fri`9Q=vd#c{clT7-CF|h?G*KIISbMIuFULzR@A^0njZ{TVgf64 zHq*!W^+$}TaaP`b_nDXd%|Oa)6GSzyGp#VIb??8#Z7H_fNZLz1_N04b1M2y?W|1ee z_vTNl&2TpcbCNH0*_}c49Cka^ue>c1D&tB=38Z^TQ>@UXP5ZhrK!(~ zU@{f}*$~_4QDw#-jG2;{23=C+lzli`T5&ogRV`mC#OU%F37ejR(0krT_ zGTMu3t$Mcl`zWoO;|g+F3YFa z!sM{NWtch&fd(OC`CNaCy|Jvqd)n5uml5562eWKqa9Hq-I^5K*lF3{^T=2OQ;h_&F3zgwySGpRS$CQ2 zGjd81=C4%EWtbKO`X$hPs~8!*P(;A8q{*j%e=oQ2xc_Bj?ccqjr*9LXD@S%)V^sTG!jXIC$7aUHi^Q{KW2zS*q8fH7;k^m7b zn0Q-A6C&BYB*DxS6x+3Ue_31W((!j`1* zKowBjPIx6&AP|0m>ilpqXZIP+PtG*-5|B-7R=@p@DLy{;s3D+ZEAi8~F?&*%kYj1- zj;_;uNgBRMVuGHBsL4uPnZh))bs3}TxTw2WKT&ug504)}?GD2i4d=em3kO2Cy0{f! z2A+Ff(Zou|*eq|l&TaL}A>_)w30rYU^hn0Ze05n^Q+ znj2nu&9gsMf5?>AtB&U}(4?ER$9ZXoj4e9XhJ%q-#Zfpxyw$2Um*d$AZ6M`J%>`mwR#a`VIp3#RV+Ce*X7s&YWK9jK8avOabVGYS!*|kE-z;fqu%7RcRwyO%;Xk3iiCc`!Y->!{ z*P1fA)|ssj>%!8~F)rl4qZmPT;nKOSJU3}3%v+HoALdieaa{3)>YT?-bJ^(crG<` z0|}Hj(AJga5L)bwoBsL;up2DA@1(-8+Yc2{(Cz*g+R-Ffn*6%HUlGYI;UnHw2G6}Zd-ZrdX4uzFses_aUnG`n%FXPu@96f$zhOZ{J9IU15k*PiCn&|j;&Vl8!u6T-L>_f5bsRBtT+A!3&C`1lU=l(+E zZJk1^m8N6ZyMM6!W<*^QLnGCB^zD{+xq4Ken*vByA2{#Pfbs!Vl)D0d$>r_C=Fg59 zkLsm@5pel+R_U`=S!?QM70RNrS4~%aNvmfsS@v0N{`$Q4fxK3ebG2<5it*)$=NWG+ zr+x$It{b3DiZF~6&KjSI0fI>ncWMcQMda~oM`n*|iM_;!w>E^eU3-O<2S^@MZ}jB*c_&ZR z1b7Wh<;!P==9g98A0}v$*n52cAuk&u(lu)-F||_@6Kd|X-8a44szhVgSN47@n3s8J z)wy^qEpLBS+Q=l^%F76sv+vB~IbP^L*N|d9f>?&u@VUwXPVsmdcIR4`>I|Ikk*e1t zE&pZs%$F&uUf8FHX@a_PH-{wQ#wSM)rZjY!mb1=qx{@El>QgvG&j53`vzg1Acp+}- zyHUDcOU27@HhQB4-03M)ovyhTn>*R^vZ0QL4wS;ZTF>8LYPlx<)HvwHPy{L*7>yX; z1oI)Jqn?2Y5WZKUfh@>7&-1sjZLlv@XLO^U+p!zxN&F#DbvCbjtKT}T_12o9kH~ow zZ*&OX!|xO=8`n~Yi|Q+NqNi-E{$S{pgAP zBmpL=j`^AtfJJ#NCiUi6$O<~=uv0ct*}CdKU;ZO7qbad!QqNgSU*ci6~t*4uWz>+uf3{M%urp!mq(1QVI+LJdDS5r z-!khNT*tad#d1ohC0FP7@_g++Qz;;3+eFB5pZZ+zA4{hy30tj9Z>M8|^M=Uc6HuiXQI*ZFk4315qbT6~`g zLj5b^UH0Eg74&f;UkopwmmOQEALgRBp}d5*cV zV6-~6&vQdKCxxS?CS#43Ry$8EuON3#k{?@!wZt{1PFBMB4NP?Aug0jY-@-kkJ2##VKtTgq3BR9d2Vd3Lg_WqYKwP=)nzA%w6@ZbP0U{@7dO6B$QwS z=%J~;yZL}#O)P=*@BlF-*Ho$p3mP6c&OIfAN3%*PW#Xbo}(5WdF*PbAS2$HpK8L`ZyrUD47Bs#ktKPtfFKn&vSOf{%08^;1R8YyejIMi>95pBEhLZS|uCp2}AUg*&Su-xzr|@mq>wG;oEN~msN^E$+Y9_^P$y-JeNgy zR^c^btA&++0*)A64grhT-K$n9?dAF@w-_g_dtn#At$IM6t4}^kouya{XqFzW>+Fg4 zjVZKiN6S*01+*Pxsf`NLm#+J{4KrS~8tlWq)k|c{G%kMl1&d14-g1eC1v@DF?9?ib zMsU=^_pqP;8*7k)KRnrw+$=zA1h7Gij#Y{ja6VHcS^%2Sthz9`i2z}hz%0DxRmbU} zV-Ea{nF=jeVg}^C-5VxCQW zpe6Q6H9^ZGGj3toR#<>cAfnW^PzfF$aIJebmwvYFHG^{fx`L~6JJaN`O);ryWXQYc z?qysIeS!3-fC^H>YyDd1?-kh*`>wBV)QIK^PLThjrlYS&Mp1ulD7QZaSBw1LNb~Vj z?YX{@>y$sFKe)Pw?*NvqX@{N{Ao>+}ejF2MF{n z^E77*YpJ((Any=04Zx+$nO)uujWiPG18hkkT^ZTTjm+eF!Fks8MOWfKBpVjvl23Rk zP_nOMobadSSFx3BQ@iHwl4D-;s?f2oft-i}p4TrIS6rL5r$njgbzxNco`{9W{(`S& z@=pdzTH|DSY5Facw*IPp`B?Kx20;0jA1(6<-Kh#0Cm7CmUf_&%J$8x;E{y*GI9>`p z>X8?G(b4$bGt-dc%e2f5_w+v6A=w@R-6+Db4E=UvHFtp2DWkeFV#;txG%ORCiE@wS zrS<%z=gKE;y40?zFSLQaRF)%okn`0Q`-L?`^13WDVPTY@uuV20gqZj8P%(+3SDFu+MR@@n;LKK@zY=Kq}g z3(l_2*>IM3Ryfgo{01lB$3C)#nSR^*Cbe1M>6z8H$KZD!kn3wMC@tHg)!RSnM1f zsezZ(vAW>=3d}btQV^>>X1Vdc_!EZak#IOSsVB_d@YzgJ(W~RhnJqGOwpTp$SA? zio0wJvHknX%_JM{D(i*b>EG-d*fMo^bVapnh|s!f(&K#luYs8&>hiO>z7Y(N(%ZVW z_H=07pF9RJw`e@6ca^xUvNvcgh;fwlkX3_ew1>&LnKXD-i|RYLC=K_?98 zviNJ*-Ejz48rT8|{HOQ7TOi-xfhrmZI@v6V-}I|s<~A4x3rE=2jh#CJjiHBc_gHgb zczh4oc2L(GO0aDLeT76-Els7SRkWUFLPEK)NXnjrD zi^s1rUkFnP%s{Q}hNc@KJ9VGU_pQ^&&@tH{@qXBP)v?c9@_>vV6H=J&p(;u`e?uQL zpq>O>2fA*T*0UC&(O&uqaMMhA*$5Hy%)_Rf(r*B4w`48nfO0fY^~>c)KDar?orAPB z_2Pjd1jvM?ChK=g#qo|)ggF+jv(*W>gFnbxIGC*Jq8`nvL@2NP(o)e%nj!VWWcmAb z1j?IYqjId5y%~-qCjMMP)xD9Bi^qLf-J&b;WKExpzG3aK2tQ;l_u?-Hx_4O=yz$p+ zTn{HG4Yy0BzvcqisNd(g61jR}PqVZ%#`$x{@WYqK>JH7-5PwVK!Q&vd0b|7}xyJ2u}Ne9HA<7$=O5tmeV_tE_G$`Tx8Cq;mjL zp?5A9i3S?lv{`5(@^0m#EhKOm6>d!xFGch+#Yc)drcPYi*5i(U8=66GWEk5$8K=sD zbnrm={MF62h7{OZK;=y(5S4C#Lou|Tr81j=Yz+^v;zwIM&5XL8qd{VQ{@FfoQ_Gt? zo~R!G(E`cMC&6^?QCl$Yy+hBDiYaT%o0C$Db&<%08&r7tV7%PeDpql>?~N=x>6slQUCf`a=Vu>uAK z{b35Bwi??D$A&ITbVsp*xi=M_*$P8|wGSvY0f56>bYh!+Rfp5fTg*`0Wgg1c3~UJ_O-}{y^^l%5fv<+=l1L+TC~6kWWBm zWYZHQ&WL9u|JH z6=h3v_%OEE)Z6c|v6a>4JnB`nyK9k{S-4(zeerCop1Ouzq!{2c@HtUCrVg%JvJAaZYN&wk|je02+RPxiov zvZjs=6=$Rgt3SnD+NBXX(nE1=;%Q6X9i%w+G&+Y#6`7QdrcMwQ>j6t1hhp1R6z9{l zG;1)`K*MYitDYjkt{N>mzR#%@wPUF{@p{ZcJ+Yk==bJE=LtxEo&fSFiBryo?PwdE> zz~MR7py2a2AajeN;J zix=d7D|`84#pfx>wV?jwb^Gp-xP=&fP<_=G5IpfZ?sVO|!D1xZ&;vfp91ub%u4Npv zl@DjH$4QFW^{ot_JV(LbS9@3`p1V-ONy3m=yG~nEa`W#V`QV(+S6{DxQ9bhjp_Y>_ zFyh0ev|#{JWPIPjdz{j)NkbR8YWkUQEMYZx81NT-=21;gLnECL>*QIpg{PD1#>Qyt z*7Pd&Yu7;^do9$~?cvh9`yB>7@j2B-Y!tGyY1e%%7W=`yI9=ZkemA0aMWiyN^c1-w z3@?Ka+#x^jo7geUpIdwuf!}O0(ZrXYV4!e-s->l4@k1b3V#UU_E`xRr7N?^x5SUB?IXML^Wg$GovClfXq&jAIsvf@+?fU6PxaORR84J4ZVVx_Y^m z_jXJrI!2uA>Mb*25Ah|sKAxy~pgx;N^@YQ!A0RBEzfEr`oGa-#C92E(5M{Jf9bnR3 zi1i9qFJD@FvgF~C)fMaSDHEc5W=#3KtN!Etd*O_8@9Qg~&ezndXTNIlar%zD;ggKl zzxjGESM3&Kf4&7_vnZ!4YhOT=qO0*1^MBze^jrI|)Lv%ZFMCd6h$Gh5O}}|?q8P;x zlXGGNM>zstwfYxN;W;6MDsJp+1t-5Z>ipfXo=V+pIUL_Bbg7%45k*ooHWt({t8>xf z2i?Yg(YB0_eC(aiooT8!e%Vdj{NAwTMBtYUKb03K6>g*LSY6ZXh{Eyn^O&^{m9USe zV4F9NZ#31a%N8qH;w@MvH_BNoc4u6jgxos16z32Yj1~Gl=9QD!P3^-(pQbO&a$;QP z{AhkC$w>ikS&TCJN@|d98#hmlGzf-32(y*v!*1od-?~DTHb-6W$OV}N-T+8~I~&s4 z`9`Vi?R_}-2K`S>YpLn9^RU>^0Kyo*1N#ry+DA@lCog* zP421Iu2fJ`b2`M_jya~_s97Pz7Ua#r?bu>9rx|b~ZinW(WcCsgR4X7D2T?lYuLj@R zx)(VVmS!SO7-dev2Q4L}$bUf;a)EA}Yv*({cju&6cA%?9v$t|ys#1e!@7 zzUKGzC7kKGX5o7+usRR;XYQXms^V%-Nk^%BBN#oVbvJh*#OGd@_Ke8Yxt2WCqof~t z=V#e@$&afb&Th&gB0h3VxCrRw4!aXf4`CFkYz*)>oxlC5&aKysw51&>;DB~Vvluu* zYtE=xR$8EUYM<(duXy-=qf5pF!Z2;HYFn=MB&f|D!d_}2A=bRm_I7k1QuIgMX7#|a z;@w`jciy&2#VlVM!)~oY-K6)NMgk|;H+0%A( zG6q8e^23yGY#Nz(cp15I(cf4T#8bY?%zjIgh+iYh^x}%}w(Pp>w3Mvt!Ut}TWM z=wPCBEUbS~?hLzzzI*6$tm_jG#FCPhC$Z6mdmiZ|=r4C3iOFLEpV)xnb2EQV_JPHD z(y|TWGs&!czMdR6lq3HSFGILGmcTQJdUFJ9C7A{4m1a6{(O${ulKgHZZj#gzNhv(e zIi?5Sw~XRDx#6~84MydEd#|P^>5K3r-Kf}BP>;J^7Uh{?9h@<4{v2=3Q#-NwS0_{0 zjQJ(S9~qK7@C+I6!73UmT!+HLWampX4s?02@KyPCfFT$uLS3Zp#8RqVEvrI&32Hey z>CBbXEa5!&2>ah-+4<%LOJ9$^+`f705Nf1$gxbOnJyXTD_m(ZOYnttADw;TbrnC!Z z7b)-t2fS(qR1uXgBgSmlOEj=EQsc+4^QoJSM1?(MGK@Rm(V2Zw4Yaiy$~bndLuO5i z!sZQ{LrHQn>Jy@6X#sGz&-Xbzso-IzGyhymR}c?Brj_!uoJf!z7l?-F%t?nAvJ8)hHwyGY|2_>q=AnwCIrqHdZI-#0^}HSBJWy-ZHL=i8r`IkIcOo z1(l`<(>OC*JzP3a>_p!iRd$uH`T2mjeZ4T=gE_u5)iNmN zenYWv7xes$UBllt#p?1UAd?&?MTdo05iZt#3g!L??b~1IMBSbeOY=Y9PurA|wl`!Jo2%gjXW@5nCm z_=UU9>-6+${7?ceS742e#oPNsZ)c32_R?a5RJ2z=i8AWEB-0l+WxBN|Ty$nE*DbIC zjxI!}@yEER6uv;OsJP*MoDZRT$H2)MlYVxqe5XB%ah`9hbTioKLNhux! z3*_CfM&IYVCs)j9W)hYu1j;e%Nw<~DjcAvZ>(Y_>k|_Z%K02W~%ZB`|2Lg;OCo0(! z-I0UAWus!@WsnrGWO^TICu}G|s4(%+u(3ww(&tvO5uy?B~2i~jkOC*J<0toJG6 za3ti`gAbety0x8`2aU#h;LrSpfCJ#hSlmDiTawa9f>O(@oG%9Owh>kk-A}Kg#L9o& z2jL{~c}xK(-bS2WrS3!|eWNqLrGd{6V_P_Ff{G@q+29xR29er&=}~9+b0gF?2|`rT z8^NShxpDoIF5G;=+1IYI!xe`tJD*XywYMar6G3IUr88LYrx^n**@zFUxK^b;JRas_ zj^fr}@FqxTTDf1K!(h9eS=Q7&(5+o|L#^JPpF77{;=yo0q=in~_y4w%6R{}ub=V$9uk%DhaZAe$l$g(axgK2# zM`3?>r}=%SpD7tEO)r#iFBoR8Z;U})cnl1&W_Csflpc)g-s!zP;D>s=Tf?0v1i~CoiRmP|1oYd+4TT#dq98{av>HLC#I? zT_H^sC&p)1{Lyj^k#kw2q1ZO@W2fzuT=f(c7*77*tQ{-ye0~I>#Aml%gEz_FzE8r= zWIni)YrSH4A*4Rsi&Pn%m#vB?Ukm6BSRAY2nqXI_Aju2zT1Jhm40_M7UYB{a;2^}t zh5^?n# zbOcXMo5COnm+6S-`R8hywPT1Sv}dJ)+%2y*j|okQo^o`QHTmxSi58`PXoJDliQBZo zf5~S&j2GJS`$yGA=jv&Z$@)>1y2;A*Lp>b2r#8VsP48fNL*qi7LKYNdL?_)PJ~s-{ z$&O5odKN7WN=@2TV?57x>~k3}R0AZjRojDO&FjxMbii6j;n+sAXN)^OH;e zXLT@|vIbS0-T$sCT~oI@{8cTFnMi!}$KoR=jj8*4;-}<2?Q^hLzA`qHw_wbi!)s zqTcN>X$#mFEii4sqcf)bCS)BUzxwz_*;hA!<6CnA0WG9Z^r(8I%Srrb%~a8`82(^~ zpgS3>WoE(sCk3G#gBOm!CH(bdN%etsRGMOiQdQtk5rrE8nF_iz5&YlY5yG}t+zhuE z6Ah@=f;y-4Fme8DmIO_S$t!yTDJ`VnV0f^;U9dWZMYkumyZVIQnl-5!rN~0l%iuH} zgWutKqb&N381tN1hXF&G3fzwvij4+BozydP{WUx#l}xD=(m*)FSnv#aIk|J_a_ZE; zF$R&XQa;~wGW z1VooL|6pJaBQdd5JtwPsFpOS?Zu!p1BRI&mPHnw(RooiwwavabetA7s#72Ah&9U9i(y}IWBR+C~O|B zfvFJBxCiDGt83CNo`CG8W9FacR5SlwQ7FM0`K3kW8#%N#g=h>F1B9MmDOM11=@{!WBPeP@^{`co*`=a>lZdzgkFFy@ zWjTdk`<2em#VgUj9Qx-el8vomt;FiAPN4)>tW*ox%tI`1G`vz-m+x`MsqvngiFr^G z8lB}3@ymwYDg*ZB)~C$>MKn6Y$J{uCQ>VQCfo0`fXhf-*c^#gDah2PH#FxWkrO#|v zb#HLhJVtxr`_L#_@*3C*GpMu?^#zZAKSfh3izJT6I^b4@5NJ}IljwHFq$Ml2@|Q0C z_d*_{%Ni#H)~UaWEK}vxkzVHR>_k=$ls311$=b5M(5yhG)bXv3Fb&6c3CHGqJA*Y` z*xc@%e-A0HCNqEV31NpTCQ_`b9bpn?${+4;5E;*`GNpSrpg7MTn^WOx|Er5;J&>=B zxh}j00uR};%iuaEoibvyvBd~^E}#iWPD zMUkZi|9;QEx_GSD&KeQtyHBcsxAhNI5298FkC-O3{T z!}0twb|7lSIbOO%lX#R`heZb@`cspg7W>m$H&(6q|90Ym3~udgkcdaKLs$`(O}|x$ zV?ZH^PHeuD;cJTy_LaNhB;6TIl=a}CTAFuNL#K`8H1zX+ZX*Y|-h>z>hCRMO{pt!% zz!elD$3xdvJr}l6zZNGBBEtF~jbs$IFuFo=83=|xV87L((vMJs+9vA{&Cvs=(tZ6F z2OnyL=%6;Mv0U_sFQQft#0n+DNw%8L6;sJX2|}?*z_|z~>oKrk!n}xMA%pyD!oD45 zs~dpiH15)1(%(#RTi0}Z zW2wUFYX5`xE;u*`#9t`3^na&IHo*P~!*x-i?#uVa9+MFzN{x1<13L>VM-64xeD}~ox{e!Yg;qf+ z&QJM9@gUr{r*mxhgwj$Q9;bZu^{&6JiKyJ(#)(rh9c%uq&`4~!>i{-OfhOZ${MqjM zea-V6JngzTP||$=AjwqW6NNtNc;iDh;34`ZxmDtuDzLcTUNKeIW6sGfqvT8CLVPwq z0Q-r*py$)2S5hN<8tL2Qi@tmPT|Vf4M>DwW{==3rqzi_t-6zFwK=6 zC?;6;&yDIkYYuP4l26M_dSV&Rgm1@V@F>ryMPqS3ov+L1;td?f^nzazokZ#$*l+JQ z53NpjZ9sJYC7Rc0*ufb>Tyup-1qEDV|2KP?V*Ox7NUzA%;zQTLvnIU7jg!Jh|QPda}0qS z%mcSX{Z9wKnHDOPnyXua^^rBsgo_oBasx#eG04)#BO zXFCtGd*qmsbgNg)=TLj*?TNat3pAa93X2@iF4MLA73bqt)A92YWIjq0d zETIw-c;kLcn`{J_aU>IFS=GQR&JKpFG||^^ZGM^t6^bLhW2Z=al0R7F6B~I<09Z0YOQy zGia(sy(74a3p?h~01KB6HoRpZvrdTrukzW>XV6;y1WtRXS42=lpp>VSB73WLaL;mU zXQ9CJTDZuwdku@KfdgI8OLfmA!8y7>24wSY{(c(20!9{aeIA*?p-0`g`)HPgXvVdW z5@Da+;UBHSV-O!)wLQS_EF5!OoLY(gS;KcYgqB-`hhG;K>JoluO}dFvpow(;s}t4R zJ3xzySxjExKe?SBnq&VL!IzkaWi0SC)6rmvx)(*HCm(h-Oe4k<3?+os5icKrwH-1uX>TMQuO!r2*V?tf2{zT<8?^`=DB zTV~aH$NP^%O?qftOB4%>(5`RpUE^7sWIva`7`2(5~kdKYY{FISOG<8 ztRxanTt7l>cLFMcc1!HJCC@vn{TqbxD+V38#1ir^$gN$!*H1ou3U_z!6OgZWMBRES zPCwN865Ee~$-%Cv0B_^@UDrAA^d9p;HNPG&1GdhML)}B%@YOxQy#G><^{2G*D6Anj zfb4cQZ#Fu5%An@|>a?ET#OAl?=r6j7k^*%M_a*DNu~m{E#2}W$zjQLavU=2crWe0v}k;8Jxp{1{F7Th zq4)0AwRa2y+lrA`OT6U^s@cV<<_3}4NCuaJWrYRde!JIZK~Vc|Lg46mv>TO34mYEi zmtPf{A`d~2Svr%@O|;^bJOBcU(T?`1bveQn00<^sEGCRK!)azetN`s@0tJFNT?9@}?Z$M`JV!osvNQL|F`-2@s!JQt8TfqO^2Wb!YkSq|%6dB%W9I6>PDzB(()S7n z7*T+cl@y`2VI~N{WmDd&<>SuLZQ8Bo)w8MS1Wk)Jb$A(?M{#vvie(~euxm5dmkA{j zzSxTXa2=T@Y9p(8K&+HqTBnIuYB7ofL;&7Gb0I0MErl=s6FZS^Pm6op?nLG@*D{b#~A{^q&%eSo>|3Oi53< zxHPskM?F^Q_Y=O%@v0D@>+-I~wS`XH75=T9(;-HZU8?IjbbX-tegGWr1n6&-w$$k% zi{^Q!orT-Szb%8BinTx02z&42Xl03zcSuie^uU<{1DCiQ0#+Fe%RGnGx0gkdO`INN zgK$*a!=p%`S)F?n^v6MiUgV3#r(?_HJiM-1{^UFZVBtyxzo~D83~qi{xzNG;9uY21 z`hhrT4WJv14$SXS4Zp?%t5-cQZyVBfd4Hmm)DPgx?mf1;dVPlE(otRl8ac;OD|DEQ z?y8;+#DcHRrWlGiqO77)DIa?8VvD3!jxzMj=3y~z6U(b_P0qpPLS?>sNipr~lO}2y zOi(8j^|Ug}?q+8s2tf%*CSsHMi!avEe9K}z(=Q(;#^+OS{I%REmXS*6zVlJi7=R~__ESDXn#LIOJHzXITyw7WkWulm}gRncI;*a24& zi&=ROp$6m}$7=w}bgA)BJR_f{?1(TXmAZP9iV_us*d)mMOAjddARCNti zN6Obkkf{Hoj8GrH`16r{)1eo}Nc6&;s2BcacOVm`^7*nzoBYta@mEB~*WdC0`}l8V zU=5lnba1{6Jnis^5=h14u5y#}KKAT7zpJ{vNFxwc8#aH+DWs%aFp$)l?vXm_<@Lki7%IX=Q0h781^ift!&-t z1Q~pFmWdmEI@Wf)KmmW_eh-B#n5@rNN#wZS6H^YwTDCMHF~9&ijcWvWzHWdnwwA)g zcc2Dn2hcMCp!9BbL*rR6%l?zC#rC4!gt$BL%9+D-HG-^ad7f(ml4$ii`wMrWEGArZ zgQfF(Qh3T&g(ZD_mEE0mPu|`!+C7?=#Ra0O!mFVJU<47QfHiEi2y z3KwfGGdQxK;hbXXQyP_2cFV%v+deisGm_G+!OIoyK9gNbcuBnR9!5koNJnTwZOa!t zFybwuzDIYL4jyyqg{ZpB2bv>y%$v}_H;yYmn8&u0sx~mX*|mqecq(qIAyEG^$Yp%z z_%_!bH+CUB3^yA;4R+9<67KIAxg=HbH7bnD0>JZxmE>_2KGb5txrCbb z=nM+_L-vH|SYEYYGp>uyvD!q?D$n#IBR=wZd)k0Ok|-hpmA6~MB86XVy)ypHoX^t> zP3h&0VWI$C^}m9hukYUk?caKxkJclac16F&a}-H(!_9bC@2}xM6IpD+&FjEr$knru z-||Dnu-&!-#c7ea4L%-U*V7oW7RZuq$FFjrY;#8?qH#W~y;~e%Q(;#C5i#5vo45D! zYGO;|q_>+;Y6y*I1m?NV`Pl3k^CCZzBx&xWC2kJ6$;9>}23NB`F^1HZp7&ZNXZHU0 ziCA7D&EKsn1SC^WU5)(C;q$_@f7g`a&si}9eVhJZJw#cYHD;ax(lXm;uDQ-PsOnub zoCmgu;?&Hj%~4DbI15gYUQY>9d7BJUS^Z#16XG!=$d{NOr6U~Mw{}_D>6x%1AoNjd zFtXO;n?@wm%raVi6BKzaANHKLZ>qOd&1XvckOtZB=++TP8TYY&UB@arezi*m#s;FF z|9&05dRicUv0vVvvrjt&^r+dm2kT2`#a6G8t2TUb6LEScfnGeh3`+2Yc|_HsJ<0qz zlI19IG@2*Q1=1D9YJ;V)!3q)>I{PgDYFvNB*nZ=a=!{7f?+U4*%xHpef&h46o61D+ z(9Uao+!CQtVT!oZ6ASp6rnURKqKt{7Q6xT!7Ct}$5$xm-vg!S!%>AT|VC9szAyf81 zri)=i`J0`7I;%&G>TaoFlPy3V6o=p$&il;jh`8l*=-&A;*aN{MYD`0o~qO^OD+rfYnSAgP=ypK|`@RT186L(J7RKEZ$bYVSiwNGLTUVFVjXx~APi zBnno+Ib{@-w%I;U!wJ?`K5k<;3kRM#5lT}f>NvQDzVKMSh)n)>B>jj47GB>Un`y8= z*$-`nkV}cfcrZ$!TqvbzL9yW)*jN|BpO62%smdqF%j}-t)p^zig$4q0ChU&>Knbp5 zQ{=E-$8O$T5v~^1nz^ZpU|(}sA(sRggF|}(B1*!Nr6{bvVRqtHbj$xFfI@8-Je%-b zFA?^KP+M_0p?~uC$x*>R*frb_``?=T!GOGH;${%>cX;*9UBi!zAg)DeM&1hG9m_eUq7b7|iV z{hkby&6so%7aIfnrdT+q<^I7zPiBz`;cSTfO=>iYoX@gBoL>BS(D^^-hEg7W7>`V& z^!zLmAf}h;*%j5c4jf>aa2AB0++&YbS4@o%QGac)<&fV^48~lhT}w~j|AR^`Q>0S$ zHPVAZ0`4k(mEH+<=77K4**2}nDEAh<^aRU7+h#tNH)a5+MZrdLx`9s4ynOo5ic||A zkWgrYtS>r~F6D2CO#@-{vF$@f1KHZt+n3H!__WTdSV4L+-JCmY;hLN7>uiGnKydc- za=d>A+8*IjsL4f7B3i7tybyk0S#|4DIXyK-Ry zh0(q|JYUQZt#*F;@nuW;wFBb-XK;VfEAFu*qI?O91ZnM;C(SC!c2&;hkuP(yYUc_U z;V)Jo`9ee24A~F{4Hb{aIL!U2*W7!ddDaiF!~NWx%hdtFgjsbIdr8;l`iM;Qt}zfn z{4ub>k~^qeF)9g{_N((vUUys<;xsLk@;}fyHO`M(z=4gxGcb5un*+!zxdp;!9@Hus zwH?b{1~iY4zp=-gfv&MaTRW}YIUbcNA2@eyEK46bJrj#4b;4dzsod;c22#ZG+t_sv z%9(MDRaSX*vxXuy7UjRv!8NmjvF%Zx*RvmEJz(?ah+s4yvKoK zCQ3F#Ha4MMZ@|fP{lN@Z!){frf%ZiYvi_Gbwd)U?6UUneqiu!rlqI8YKi^K6%bfXv zx{EdccD}tvWn~@Rqi1g0b?kT-T&DoW92BsKaUH3WB{PLyd(w95Q4-o56gUwbg%nXK zHKY4O6As0#Ll|>0=KA8j!9hHonauzikNXP|6morbUZfEq@$c9@tIab~{$}14S*DG( zef&Wfz8E4eLx}dImSMPnHT^?qBJBZZ5-r=@l0V26($-F+$rEhNqs-0EfKe67E!Nio z>y@OCL5Wh^Q!B0G#C8Qv%Wp6>wOoc#7=W_rbPi5{104%*$d#}tOBtOIG3j0YwK!B8 zcksEl63C$o=Ve&^Z{J|kjPgGf5*S#$_H#u${tltXN8q36nt-VrUr^^TusAIGu7|uUq?(7Eomy+aQ&vbxF zGwUCs`JED)pP)^nDv(~^@4nuS)2pc?fcE{W@Rh7rSh@R6IP?_XOIL+*?w^eWYkFf6 zn34Kp`*in=6k?IA&6zJg?Ncz)Db!~{dvLTu-uV6T{J9YB zV7gABnai#`9Uo0ZO3Pr3dNJCEaiwQL?=HtbJ`qk^yx8+}LgAmL<7+S5<1>NJ7z`&< z2A2W~w3sbvq>QENfdHAc5imDA3SIHTE)dY%mX+soD-XuqUDW7U_Y}af>&_V;q7UA& zFYga*BFLdae|1JU#XwzBtYLzDvAqzOCby~giu~=_TcM}v%HO|ceKB-mJBj`ra$Kg| zn`d_2;D*d*O9^rkW^+Qu3&cPO07G+a?n~5We{_z+bxrjKIDL+47dsrVbG zYHNu8Vdf+pGq(bJvH6FZ_7A!%>@od!K0izTuKjwC4tO64vfWkhf%zNXhG5h}OKeLG zatP7Xn|th%13`<|>OWHV+-#=|ipRWa&NZjMagh$et%Nq&dueCr-sOA+<5a@~#$M}` z(?=8^WcMwYNW;i<+vWAF?TTUnkiI>68-4-^R5eFN_5TH=aBF<&W*fNZ((d8Mzn7{h z*Ft5xWCemJ#lRP;4pA#y0Hg22&`P~Nnc!i1T(9$_C)wbSjEWyETa0@G-b%uHc4H$# zWlJFHjhMeS9_x3gEm&T0TZ;cWAQ`I5DEVz0M@<6__c5y{`Y@{MxqmvDHZ ztX~Duw)}Y$L@NZgZv$jjOLOb zZo>Q54g4z@qiu$Bg}Df7s`HTYYJ&*3Ma{2WV!`IGPlh{@5G`Y>)^;`RBq`C<%O3A6 zLSiunBY;y@L_rO($DZI=t=yH${}+XOzIYa4-|%_0`-Qeu1bt2``Xl<2SUsAPQfE!T z4kb7nQv#)PcCL3EXA#wmQf*$~FcPCznSQC_HY);EkMG0EQ5cS9#YJQd0Y>?fAKtuQ zbgSx$0S+DitdNQU0l36zBw^Z%e0Ei;&E4vAyLF8VT&Y4qY3&KXZs4T+hWGRRBV2qE z9ws!{qUXJ`R+XXJ_Je`6`_29Fc}xM^6YU><%&4_&6G9aFQHQV(ngk)7-M@|&a7FyH zMWEKwE8h(6>uFe!YUqd0H2YLvLuFDoN-X)Ka2h{gG07v;V)YIQp{hpo5^s~c*Er2S zqe!RejIy`wu`*7l-(4(*s0lU?WIPoqW^59c=E zE7Xi+jP>}=IS*Ip4sD87_$=oOn+a?@?Wz83r}?a{l6A>V$RabM8UKsZsNtcUix0bK zSKk|vGfw@K2*jwFxY%bdnG_Z%m+>;vra-iq9_X+0)MpM0@n@#CKJs!c5rA4F6lf|? z6p;39z!x;+C&*@2xl!bef(W%Xkyw(H#fzxQiz+nDo-vawluU=3f5XZq3@~dbKKtYmH|s)F z3aETE(!NGJFtWFoF16s?6X}SL-IGTmcB4}eT&;A(I}v^Rr^C$6w_EwBu+@9h*_^_!pHGtS#YDi;16IzvW$jsE;$?Er4T)SnTNDJ?n_3 zjWsk{9q!Tw8Fh4sjbtm7`&II14J1#SDs-s`TW{laJ9g6!#wh3xnA^GRPJizv@{={sDN9lu{pv_TjQBEBg>9S9%e9Ke~ZZ`-4m2URH=F zve7E>C0UWq5?6#pI`RwIgNe&!ONp?3f`0r%JG#85JRkQ!utlgB_3^^TW!sz%IiXcq zUO=BQOijCwKv0QhQGWP!q=sJ!*i+`0^mjR--Br_Mf?HRPLbz2HWH_S^^9M$JNU03a zVSDj1TUwpXGuhG9QEZ;AS~OmuyLetK0!%-Y$*H8jU7}5w_3UApaA^p!E*~QqNI&0Xtbl~7-xnwK)SoRQ-Q)&J+0AO=H#XMlbye`_J&gu(kUdOPKN2UyIPT- zFKyG8XPKU;hJ`c?r4)Ye9`H~DIPFt*Dd?YXcEPx()tCh1)*R4SiaESxw3MDv{WGBF z(K+cLHq4d-J)@z#gkpOF;L`e&F6+w{#+E&x5TTaaY*0U*jxS%(mS;@mnAhZy%Z-*l z^0U-8F)$|E<4#l+uiYCUfZ@HM=FvKPweT|TOMKpwFT=IHEca;ckx}}MO!slY1mArr z65n`~J5ae($F?*gYEyKQAb?+`p~ZU(6Dbt@uyGYUx>+y~c>&ukvB~jo8ntnV`hRXv z77XPz3GM4jDp|td2B>WbNo8<7@ZAey#XpXCs#BCk(AphBaeyR~ZRrz_p8Ehe zYyy`CjUPBXCNps+*J3Ab)$-=St{02^bH68Sgn|j^J~cdd)|m;kXqLzttj_$ICf5&E z2RaRa35@EK52|Jsm| zZ1B@%SX%s7zPnXL3_1)YjK{6GpWQdf*B-kc*lAn)ejC#39PZq=IpK*v;l>I`r{17XRouwXj?6}^n3`zEdkf>A7`n{X?nka6A>1v zzk1FRlbK9jeF)$g2dvX)5CxVcl>@iM&*GT3=D43N5iFdQsm{!(?>!Ekl9SxoMw}C+ z%`BF%^|`Ekzb~gD>*GrxaM{mUoq$;)u&z6_+k{o3_48Nk*$a=}Uget93T32Q=GitI zESX^^egH)!W6>cKR4?$)%zESd%%Sv!gyvHdkm+e zETXX4PbJqnM8s7L2HH#I>@8V~Qp~b{+-5=2 zArPzXH`}?o{l?LZY|y~Z6JdLx`X#0<;??iGQ@-Kwim(n~H?c143udlK2NK~Zg89za zzEq5KT5P1drIQ@z)$gpQ!@ssH@lPfXZ+X278$GQ@etW%)pln-%b%0xDbaGbVcf0vg zKc4*!s5k)(bzbOzn~6z=JJR1tx|Y!7oMo>)E>mZK^D=N8|ETRdF}U1#Yi_^jQw!0q z1~T~H-+*jrR*}mV?uOis>y4#PKmGjUUTl2p-IRH@(mxx28K81?QFk}KaB4;^-9G#H zua3L$r|Ea{oOBQ0jDThr7_r25&DFemiNf<=ef?xlHTf{`xYS#p+$n;p0cGOvSv6s1 zXJChPTWBU$RKF3op@j&%Eko-<%aZmYYc6BaSbOM((6kgWBCM|`#xoeuox4jz%Bps8 zIFMa2YAn32Jz?8Wi`CHMI?EnIY6#w`PX@ScHT;@6=}?9FDUQGqw3**e=z%e%qvDbL z@UJz_$rnK@@^^M9@;jcRD~}lQzCA^XbIH?$>et!^J(GP4H#ByNYS)5=RFWg;LJSFS z_x6^7%RdOdAy_8u7qW0ndUgxOb=D=_z`dFP_xg_#>SYOR&Cw^yf&ESC5%uEGs8Tch zf+UxUV&h|8>Bw7Gw@bzC65(SWF*=%1DrV4lfT)uK1xz8SBbrM`-8V-h2;HTbG~e7g z8{;`4jADUlA<@Jy@nC!P5qI#Mt*^(qU{0w=C%}_*%jI|?!w@kizO^&^?oV^RfycA~ zIifFV1<^j_7VV_n`_2~3yzHqv5s1{XU{8T9QDQ?&0o)=$ZW5kc^n~=m#t%d2<|2o) zw?0cu%%^rIIj;8y5uLlKqg6Oed{}{?bf3^hEH;Udw+YEVL1-gY%qWWtMbLsTQE^Z zB}ybP&>HQX@Buy9<_5{&H_8lDA@tM8d66|;l08j2Um#w7UR`Fs{*%$u*U`as1}^D& z&QA@srDt$AxMBaQ8`KTf$ijF+fXsR;1Qg@DI6!#9C{;-*yA*>&I z4b3fJ35s5q0Ba+5>FFObG{^wy1z799?0{f&0J%!k@+h+9JuV%|)`uUa^|Dc}+D%+ytqknN^%c<|m2sM}_ zT_&^=n8ihr!o`2bRhkg&LjhwS|6J2?)ru=*kN*dYcuTDdi9akUzI*S*Rk@s&H9KXH zba!Wj!p8f81kfCv37;rjcMza!4d*s2v?2$>`TF$jRCh+U3i`q$Dwwh5i`Q=(s(y4j z6H=RgFb-E=UVNhX7F4FwV-EKlqP6hDGUSMcj*U#dg0cp`h4T(pFR5|O4e8^Cyw}8t zfK^_d3KAdXKOuA6q|-7>u84zIB^bFfL&I^K*Il&-ZIiuV!^E3graq}fH|t!}EsIhg zQ#cM)%Tg|ZGV;F60d6x6tW*k9a{Y2XCp`kn6SED7k{pjs6O>)@thEnK`ttu?0HlF@ znFOOtxV$p5oG}QCFJS$CoB?0qQ`yv6Y?V)nPo6;V1(28LC(?-MIu=Ox)F+R+$ck8A zZsk_Xpqpc@i|Z`t30D?gnE78W8qOS(9$aP02$Up~$ZJ2ODPVq(AO0HiY*jroQ#Ca0 z2RcjqLoEQ(=$co1ozmk|D0cG~%v86Fk)k!D5GPzM!;ko=yrZ!P*ooyaH^bY=9Tm<6 z=qCRqGkd8f!d2z$0pb^9`B|s(E7Oi z(Co-q4+RaYT;4~SGp*0ckoPP(A@5~w;vYGylK8#njI|I2qs zcH)t}Yk}2IJnd@rs>Rh6P+EeI*}=QX^LCyp3tkHSPJalx_l+@IQ!3t=#?Zbc3}OS| z32*}~DKCX78Un@$jC%Lzxj6lEwA5^CpHjBDYwJD|J!pCU^XUI0ldCW?}oo-y(XiJw|EMkrMr@|fiF=i0&c1F!jdLn zUXY9}=fU!X8p=Cjx6>ezV=Eaz%1!Jj z*Cwp(CZXvs;7E@suDyGsLs=~quU~lef`xn?Qbp}aSlgXcUCs%fK7{Q?yDCP|%Q1oRti_>!I{S#ppX;}> z0v7F3?YgT28L{?@Rnrb9xT!bI zyqThjv9V5*)b6C0Ud$Vb)|W}bdQsTzLw6))Y6#B(L-iuVT+4|QW{^YU1)GX#gN@%2 zLntzOh8XK2l*aCXZ4ZF58tfVxWqL7n!Mp`x!>JF-L*E9PZ*TRPLK<3uen}^&wQYM* zC=IGgG_JDgUz@)0LQiDMXL&F0tG=5AtyOm&w~tw_mz5`F4sUT%Ke0YU{f^|En0heR zN@u3^h&QRp_yvsuMQ{WMM=&-ZZVZV`{~a1;B9um>@7V;Ed4ZgkgI)YPDFHN$G4xvv z9L{fIaTjA>4^B?nrjKYON;IgSKH)IDomW+r`CbYD42Zybb9wvnI!#6e-e&fcb?lkt z|F!kiQBg%*`+$gmQqs~PASK-mBZ#zgOAVa@B14LFcc-Et9YZ$^&4@@0sWZSxmvsFu zzVG_h?_2BRzsuZp@44sfv(MhobIyJYmWnr9_WYMm{laC}V8+D2Zl9%;?~OY&O{Bjo zwfObOKp#)|iRVwMXF`()3=E};QETU-koP%N4;@Y3c(*eYWh^GT_h{iUIAT6ujmmuG*6itj#KSMvyTmhM-q z8M6G`On;pJ{f()Zg~qa08Bh|bSfTAy^=;fqj=cn`y<7M^(zaz-tE$!!_7iKLpNq~= zGs{79D;(wt?|Z+PnG0{Qr+6E7%AwI&?aD*2mDRIf$NI#W+#|kcfj2Da^$E}FNtW9aMCs}-q+R1f z>e2$Z?kZtPanMKnrO*04r|wor*~})pT6dkewoQm?@3)=ITxlSnXN^uoC_reJ!_Mk; z-aqW-d2ww6KgDd?RD4^WGBzFj%1YAX-oDoIuh)DR&)p&W2Bv#eT0YV}YON~jmoZzo zKl)k~RRZ$L4PoA{TE0OAn%8(55q=b#PbX}Hx{t2{UJTHgnh)kgKmN)gnC;U_l4K)O z#1UOgz7wF|vY&N(OJJy>`L5sna$`K<|3MiW*jleZg4)J ziPlEt8&*LtLOOz=a$9;I9NZO-9nn-!x9OnpJHn)c5D@oHX!^eUE4E>xxE;nYcMJ3O z|4>8+Nd1kvz&fDBB3ARbOmfk#uXyyb>Zu)Z*xBZ4B4A_ji}EpW@g2nI5S`XA3cvfO<1uU)N9=o`QL6c5c* z=7c_W;|wiBcGkq1g$`@<4;~yTbH8dwP-B(Y$kpzQM-|_hGKIh>_2q*rJ&zP^nc@j9 z2nB9wclw5!jxkoYOh$7XbatH3|EtkAfxk{z?Y#Xo1^92m+uvugi(u!iBz%WX1Wdu_ z#k9F%*rLv<%{SWz$FoShljfHIJ1Q$5M=Gl)@-L^VVSCK*sx9}*s3l#F&`QFz6j`Oq{) z771SBZ>)3|!OM!9Hn#r$Yr6#UQ&w5OV-|OA{`^f`6IZOQ9Casfa1={ZA1!7vu4s?# z+cW018&beB;U!`EE4yoqPPEVy^Ap=#aE5Lkn92f$=hO!EWZeD9{aAuWk&w^)$!kIy z5EO^=EueS+eEE*jNxKjXI|j=whhcx}s!MRhj@sAG$Y~**_TWAY{$`1LX7(>VLb$ot zQ%q@H17#Z-_Vcg;7lslfO0IWw)vOuiW)b@1M1^gmu+Z&K5 zrvW&X_Y3SC78!!RPtZ3PxlF$~u9b}^&EJSOFleeL3XP%UE;8SfEi7p!XLL;n_W4a1 zlsR_2QZs$B?jfmim|nR8nwVqoMBHR@MPR8gs%&F5+c^KmvzzZo-t!5()NX%KP$Phi zR5!;N{Eh&O&S+{L3&g@dni&fV_R-rg92T&NruQEcC^GNm-}OVs25-$)x=-o^&azO-uABXk^l zxwLjZlKaiDXg4LN zlA#$=Q5@~JJH!Q_RjJoBeYMBhn@tL`kd^6yS6M9(cay7_9~h}>2k@pI*oc+<=M zkVD94Nr}qUR!YVt`1Z%Z8mZr~P}{vA_|gV*eF!! z6yBmmT77)28KUBR`mU8~CBeVoWhA=hnA8SE2;)H=X7>~wnFMtKL)b^B2jmDWDgM^Mhs}(Q=7UCj-ylo5_0LbU|@&ZWvvW zu2i}YVOR${ zJ(;CH@a%YvS!W*fzY9^PWEmncy|FM#x_?tCKDbcgqhxA)AKygZ72KB}WLl4(@`%2l z#Isx7Si4keA;L#-Ch|I5+9*QwUb)5*(b7-p!$UIVk-bBLr8Gbsw}}6^5=9)E;3dO$ zBhf(bPmlX!pjpwzDZf{cYBt7Yw$Emo7P@O~Cc^KRi+xfU?d+xaCYL4CK<>GS z?1oyluT=LeGoFh&s#u7S$A5U0c3MN=z1VFeO;X<9{P;8%9KKilfgi!)agA$6(kXWV zoKMc_d18MCYydn>0vsJDaEErEu@8@eIm)vLT*eqh%Z|2m2V6EGkxi2g#k>clvEPJt zG4OYpoTmqVQXE)^1{7!?;H+>#E3cSOkC}xiK0ej*8HQ0DJmsa)MmsPY(d#T)NP>n* zKlLNXybMVzY&g2;@-QfDUx|oC6uXTF4 z-i!>dPv%#Cs*NIfWQ2AGbp1Y_%vMmVsI{E|GNpqjrc@4_yk@^mUHN{hLtG} z;w|ZC_;edWQ%_oI2AajACxIZ$9V$$fZhsi4XG0E}jHU=?IDB&}Fj^0+%9jaOLMx2q z9(zYT%M7;`S05z3$P{DBz(cSCbkww;Mnb+VuQMbiVDy@;OG;+E78nB~4f09(O8bQu zw1QNp*ob$8CaO~>P?pVY97X?XbRB7Wyxq}CJ;zb*QP9Ze$rxH{+wt+3moJqr)$OC4 z>ms+62EUXht5+H9VDgh2fwbwZq|b*=?LVHeH6M)cZMB=WkH$^7z@#Y^=LMb5u?0V@ zAjdY}hmK#I^4413knT|j+i7}=a*tr$LQhHcFQ3Z1s?r(GKPcQqlwSWJA8BEE>lV~q zX`3DOMgdnoney)EsI=B^AKbQFKB;zfjF|A62+Hu??AU#ILq}+!nUv5r$4P8M zUXb=~iURSW6(`ktkYy7nw}S}GUW0o{{}NE_jf5g0B%LTDI19Inptl zqCS&#A7+9J_zsL=KJNlZg@0Xiu^P>5e(&~LiGT%2PQhCsT40i~~3FJF6 zRn5*5^&JzAlV_TuFqVAA5XLQksN~@G5|8GLaGJC9EB+aBdXRQQ@lsOLIQ7lec7jnB z9kQOjw2t__;p|{5FYHdvFCtb_7Fn|V_#w>%!RcFy7Pjx;J}LCK73AmNc+uJqUQ33y z#BmW`V1vtAWz3*)&Y(|Kp{;yWym>t-f13l%3>$InY-_2ZSr_XR^wLV+rSl9 z+KIz-{}ea90@QxtD}C|Mvi&Uf%y;H(TnWF2W0x^yOa|6U*7uT2#wu(9xv=1+MxgY z{dwnt=Hs0c7Jrwm=YZyjBhfY9AqTdmBrh>B6x-=gaW2fLazaG&Q~CgsjfVc2dM*#C zu9vLqMqh){zJ!0-sHFWXz3}K|_-zOkHU`-hLRtLi3&W6?eK=ym%>;CVW5J`zC%K)J zK=b>rNELGX>}ZNWKU+Y9*+1Fpulf?Oeym~a+t2y~qLY(-qs`7#<13Ow^G41u`9Rje zjO0CH#1DaruuOFq99fr4wt-0t;^Wjdc-#@hBTF||Pbt($-*u9M`=0apUvau);T167 zh~paY-RP1<9Vlv)A$T%ocI7Hwk#=UZkZSPdn7si7Gu3#mydJ8vPZxU*q?o>xEg-+N zJ)i0tf!9c{m}Xw1<1xZnw}3x*)Ps&ExJKui;^LWTNTc@Rp1i4dhq88R8Rfj${W#H< zuUk_CF8>sOfFZ=DC)EudjvmM$);c+sLb)xX~;~zZRafUj}mVz}_$G zP3I`jPKP9{eNg-kBJjBezd=PrK3wSjyQ9Hl%y$KQmXLYrMq<0{XEv?^n>U2A?mJFD zt7J}#>KcX66>qK?3J-*rh4i*t{dKo-sO~HXh(L(A-6d}M4O)R1OS$HUBV`lfRok?v zqVO}`@q17hSkdu3EW~J4?Hm;U(P!a(wbJi0C03=PKT5Scs*t6sCtt>Y6|)UJf*E)` zm}V}D@EC2b=qH~wY3316}V&X^T#EA;_MUn6OOGvN*_y=Z$TYS;>5 zA8xOv>K4_5qEE!sLkswd*wj^3mn^2(|Ll&Wk_sX|agOi+*&W3^mm#FLtwp9ne=R#9 z;n3&P6yz@c)iZVJE8>Rsbb(Bl)P77)dw!haz0MDz;iXdm9OKt z$+raDbD<^|+^4d^U+vJ@WLPHMZd}TkHOGK|DrPCw`9A>yrVL7Bk|9#lsimW zPVnsS^E1u*S?UQP{|e|BU!xO_X=ql>%)?1B8L3srDvx4;WyWPj8U0qe!pxy6bz}{g z&^X`4c`HJ{@mZzQesEy_g^`QYO_d_9EpCzHd>;*a%--O@D?ph-kiB78-$QQt06WEc zQ|7$ch)$jj7v8{kemMgEm>>BT)E`cKwQDl`KoSlWev}sG z!_WY^JaI+IRswLPLL1Lr(3HrTkkY~H#0j%RQvWFl44uSgA~OUhCR)vL!+eL!!C6Pa z(i&Y4-UfYygI|XDTyYQmnAbE;JtlgW=cb2lmcVF!3_3xbrBQy_Wa!TRHQL`5@xYsu z%$UTF#`uugYSyGbhdq{^9Rc`1Lguz7;f{!-N&!$x=VPVS`n8fn)-O;&z8Uc|n{6vRr zK4wva+~xkGU0+|o^MDX--(4d$Vwe~1*IC$zG!cKCIeUb6%o`B>1v4h>A3BL!`oTka zxZDD{e@4)$Q|n{iZ22p@ChdBKFr|93;!SudDDNtaj<^$+#KXhEkp3OZbX~)^sjTF? z#I=PYFa|v})=sXT7eY6!G_ujO2Y%m@KdxVS2yj>$QzI)u3X~`bDg%-+?{cJO^OB#- zRQ^t_e1+het^B$SKp8&EhC9*xU)hzuz89BjSQ)C7qc8H)b z#3k1v8PhADP~W7TNR8`W_RV*pK60M=)C> z&f%+34esdIdOmWdi8BCt)SuH3I0ed8w26ejXub+sgI}uCoG%|bvtu_sPD(YOx+hWP zFe?CPfdGKS$aU>P*~It9h@Tpjn7$s&%FzCt7tMqd;x28)JbayU5QFq%5viAe~l3e$buz306}kY<6bFZa;-v?R5n7 z#6D#X=Pm(Djj)*Peedd=ot*~NQqEDto6KG76d}XFAU%DlB(KY)Rz~`RmAuE0^=~b2 zqa&R>eypsjzBiw1Y*Pjm{3>#7*S8t+yp*sv%ps_Og;t32WKyrej;06*3AE`uzvGYR ze=ebptdrA2ZYQ=u_l>WwgYyGDO13Xw6 z{8l*;bHW(6gU#x>>6gvG0!_QFzERN8QjCMbER=^9RlShpFB2Fx?Al{-2(J#vLXbav zL!Oa<3-qmCZijlFFJI^N8xztcA}e=JlNHoBO8LEpBLzSt9AeDXdgrofD&l%O`<9j& z-6Qkne#=w3Yx&LkFAONSeb3YyDCy?Cg$pB5iy94{Z}{;x^Dt^n(dL+Lb8N7`fTZU} zreLCbw0)w@_S?MZvsH+j|5x-H*VuG{PF%H?4#^lN(<`Uf8{ba+hPaQb7E-2-5qG8- zDLR)Ik5poHQvMR9Lh(@~!D`FI?FVY^u}e@;h8^8k(v|OKSHFzb>wr?H>ZqkZ)=TP} zi=?b>b#~*KmIaJ7vVFrn;u8jdydCR9#jY<$>P9sfuX3AK(2nTGCA+u;n<(fs4?>tyk<@b47^H^cOb-o1nZp%4!e?GNL%1;=3m^HMr)mVzzGl#6Gvt#l~ zF_CUa|KU$bV&S$1^_Z3jZ?jlIVt|~v340YmA(q!?95bgbX1{~HFeep5qs1+*on%BM zvjbLkVIfx9U36==cQiuGktbT(eXp2=ah4!CR zmGMp~k$l?)AR+9mK7E|t#PU-`nQi4)BmOqh9qZ)FWkE3+;qWOs;pzIO%RKPHV`IvX z`u73fv&Ll5K%*qc|E#<+*bSlJ9Dw^~vHbni&%>XZY;d8O*kuwR7YE7OFg*CQ7}<&; zLE5MFqxBggWQwNq?y+412L~yuw)8wqr(T@m&K34~`asUjL6p87cpExXqdVV})`shi zcw8v7W~_M$D!0bhet_Z*<6joK8A5zzV`U*?VYZ$zS#5Lfa`nl`MmMx6h+mM59s>#U z5?p$rCa|yGA@UX60hp}xRsi~GcR0r1i8rdRx2JExa4VIEz_Q6Gy}}}JM_^94EfKa_M<$Lb_Zk@R)2KBdP#1ax+QUuFMX`@Qq>_6)zS$=dN z(&B5@*UZm*8%Azl8fU<6!8KkAOlR?T3OV{Oxf!2(elq#(?A(*gG+}l1Q0N;Md**_U zipFHdDOH#Qu`$w`j>K7=uRe3r;GO3_&R$a}?k*2pB>(zJHhGzA`^y8Rqr_@Y`$74N zpN>@~_w>pXe1LF@O9p?3qvJ&_S5f61o_M)h)OOo1y4#?tBRi~?Wo_2rE`-_NFu_<| z)BZWLbI{TeyL&)zQPJbcIfeHrQOl%Lf8)6H8lp7uEZI(PM7ef+ZY``PCacNFYhruK z)ith(U)R#5Nqob9t5FB=OoYkbVWRE~v*DX7s~Llu0~o^zAnBmpom%(#9Nd z02$RE1)MulR%-Io4RM+E;oEd9um1Df$7MM%@*p9E0=Hm>h+S`qC=wm?M zhivU8$$`VzO0oq*LQ`-d4(pefnsnB#AVL*5HjC07XX{aaCfD>e2D9pNHnU}V717xh zknhs$Z=225Vl64kVu!#w)Fa$^@7R{$E&iA@bn(+fQ240-YDvtZd7Pr-20H5u)lhsl z8j<8X`g$gi5(adpgzcyBd%#vCxeG(z$chteBiNc^`wk$+>C+DQ{<6Bt6CJ<#cP}LS zbF{Z9sQM}AY;C@;!+b+ zP>*yw)TZ|x+Wg>2f~u+vh}X#4CZ+rIyX11DKF@un&SQ-&?^}9XTaGaUFBe`Zb0%v; zfT!%i1<)i8BAqjOZ%mdHx81lJ=QgmvXN;pu_H%cME;HELQ<)qVnp-!ij&}OmCXQa3 zHyLT$Z02c-nw7{yT2wwGSCL1ZC-yVEbumA`v~rBhzL{@gfVNU==KQ3^wO3We?%Nj? zz&mJjqkTj_9WxL$w~H%&a`n;Wks~qCEj6Q&}#uuoWOhykQc34?Z)m1(CFU$%$Ye+Tum(s6Z|s&Abr(`qo;Y zcY%#eevvjOj5TIePSQhI1`bS+b)(T1f_F5EUNQy-KDJzWWPc9u z38L?6UAGzU!V)-e^q%*NY00lxP#A4WS~KmB{GGoAQ+7OxF|-HL6<%VPHgeOL?U6q# zGh5%9`9NF^zB*HXyIe;L$#Pw{fO?w|d5t)|OwPx?V(n;hmb=Nb%r*S%J-6F}ot(Xg zBxY59sqAJ_g5YX5E~qYL+j^5a_8Tf#Cxj04Iv(p!l!}4Uw)y;!=+`=up3<~DJKXY? za}`BxmUcQ}v*7(lpks-Z^6WkHpWXn-nF_D_9v(-Y1K#kx_X_>-^U=aCA`k#4;e7su zC(ffBp~^#>kMQo9;_Ns5i5G~yx9xEuU3kd_3Dh(TKixlJX$MG*{_>MP!)f#Qw1Wt2 z6z)1_*z+INqS!Ql920=S?-ZajA5_2fH6XGPfS*uZi+?yHs|F|j!t)f!f2HA{UkU1c zfGr+6DhmTYPmV*s^IWSWSRRUFgblS5E9}>~w_0u}97_4HXFX)7+tw5S%h+V0#mIQQ z2BksOx6i)ah!dt|wA9n$3WwCNKJ<~vojR!n-il&u@PFUEu!?9+Ur3Vg9k!p_$BKYL zLZ{NfIr?s%{RM?oeWWN0)add3s$rvL&y=(;kPW4Rgmj{#4aY;ylS;ymZclKi7{9z+ zr^YNHR=8%2sJx4O+pG!a@8yrxU*p58CK3&bqRQ)qmoH}czBd4}TOG4@DvmC2=n<(* z-nq+7^AX9YNr6$dJ_UnX`F0Mh8>gO#=Gzj%!TVa4#N^<=v3I${N1s=K7s7 z4)YruIQ7dHrAKM4ZYudmR)W!n5|cWfa(=zV5#%)QiD9V&!6iox z2x2yR2G%nv6n44`SAKgIh8ICc>Rk-pAHXH$(5zlY7*U~(z^JJBK@(a>%!n`yMYB~> zhJ=@A&K9jUH4R^)E5?7lhAd%WlMIJsoh_yel~xn&Y)yBjO8`pRcZ3&Pr7bhyc}JjR zth#5;^9A2IWwtD@XlEJ+pxv!lCX{mm*~ViS(lZOaFZlp{IxKxdH&XT_bt_H>Tt}oa z&|MstYCehd+vzTFVzx@!`|cSng4i&?M_Db_OMeW@W;8I=m|kTG(D0gbj1?W0=8STQ zsvm!7qeFv$a?W7HO!o`pb?41U51K6u%q!>vW>VAvmM#^qCS&|Ntn2`v`8`I3n&H7G zkzDJO&u26e6e$Ma>_&huV37-GU8) zFq#)Oe#cgxdO|4I<1Y$6yBGzTo+t6iUj$sUR{`;>ebNURqIxqdt%V=jN)pfAn?*nE zVi@)t^_#@XihoWS&M;Qk!t>0Mi8Cz+Hz!D}A!B zMG4#^ZpqvP zQi)=<=j$H+y(xZB$QnY=?vN9I&$#ePu>$tNO~4^8W>>2$IS$b}!x)%ubtRw~3-{<$ zU6F)~=Vb#XGa2o}IWW@{rXhBe{QHaOqqu=0myu;+f!Kw;VH^2SmoNr-g{XQad^dm^ z(@SWFWU<2l=w9`9_+R7w_up+Xd}+uLqB_<(b(XX_e&lCsMXV47m+mp_XZX@}aX+6{ znAu;XyBOF>WvRUY18knN;lamxCx586GsAGc%ap>22(enYhu2#eP}f)TJ;2O1R5kSb zwR8*L<-!0LwV`NSaqIe;8mi6{tivee550U9si>(~-rfri4SV#O?z7|to2+au`fvD~ z3crc-ddN8Y@4H-A*ZzyDQ&yeS0*21-dj2Z+Gd0G)L!%bRj|YI;jcIqu);}o4Hw6q% z9JlwVnFjZ1UkqNv(@SCVv2^O30*}iY#^2QaCb;5Ap2rdgS0ZaeuF3%aa+SY6yZq^$ zOiUP2Qq5BSHnUq!!-!W?vf(W?*WEy5nTL++RYrzc|CN%$?KheT0m6q4b(9vy2Jjj^4(| z(8HeUX@31y87(GlHJUdELLB2KXwU)OXbx;~y8-4N*Dj($wc`o* zAqVgMI`kkVCXP?m>l%J&{g1K(aT(jD(8e$#p2eTw=;p~0Pi+rhly*B~n=q=3r7n4B z>VMO@i#fO@ydlpe9-jLz3dxD}IICa*jM1RJ=U*O?lD5_1z@#I2(B0z5W&AmyM+v|1 z!D_JVFzvHo#y)@qBhW%R$2C2zvfmpP`Jl;jr|t|;wR$s3`o-N8Lg)nzV(d_PK7P#^ zQ5I$#XszD=%{$b*ms7tB_;pj=RjoZYgFa>-7MlTp4{!oZVY}v zORVshQ$z)~Hupd&Yh(Kpbj#>m>F8^!%{71l%BL(6AAkZit9Ca-)e5$9GC}&(ydk=+t5p z#J9&OSoi+(^3KZjTl}Y=Gt1~V3Xc=(zKTk+vqfK(ZhCtX1Do_fevclCNSAc1a5YoB z=w=3UcO!U6{h;#jyMETSPvhY=9ji2(9ezvSHW+1fr`!sNqmxe`^PSE3@h~%YO>iM@ zd!Ma{eAfC0b?MqO#GZ}JU>@Am*U>{U;@wQ|up!N9A3Elk@=+?W7|NeNVhx$Jk z{}jOg=Z^n80|;;azdQbW@!x0s_m2Pjf#z6u3!C=8cKuUy|L30mv)bL68}NDmF8=o& f|GC}v`4!RfN-%!AAaxZ6@b?m=p;V<{8T$VK15)*3 literal 0 HcmV?d00001 diff --git a/registries/_alternative-schema/jsonSchema.md b/registries/_alternative-schema/jsonSchema.md new file mode 100644 index 0000000000..4858d359d9 --- /dev/null +++ b/registries/_alternative-schema/jsonSchema.md @@ -0,0 +1,18 @@ +--- +owner: darrel_miller +issue: 1532 +description: JSON Schema +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +The `{{ page.slug }}` `alternativeSchema` `type` refers to [JSON Schema](http://json-schema.org/) in any version. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_alternative-schema/xmlSchema.md b/registries/_alternative-schema/xmlSchema.md new file mode 100644 index 0000000000..278585d6d8 --- /dev/null +++ b/registries/_alternative-schema/xmlSchema.md @@ -0,0 +1,18 @@ +--- +owner: darrel_miller +issue: 1532 +description: xml Schema +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +The `{{ page.slug }}` `alternativeSchema` `type` refers to [xml Schema](https://www.w3.org/XML/Schema) in any version. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_draft-feature/alternativeSchema.md b/registries/_draft-feature/alternativeSchema.md new file mode 100644 index 0000000000..12e3681793 --- /dev/null +++ b/registries/_draft-feature/alternativeSchema.md @@ -0,0 +1,33 @@ +--- +owner: darrel_miller +issue: 1532 +description: x-oas-draft-alternativeSchema + +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +#### Media Type Object + + +##### Fixed Fields + +Field Name | Type | Description +---|:---:|--- +alternativeSchemas | [[alternative Schema Object](#alternativeSchemaObject)] | List of alternative schemas. These schemas can be used in addition to, or as an alternative to any existing `schema` property. If both OAS Schema and alternative schemas are present then both the OAS schema and one of the alternative schemas SHOULD be respected. Alternative schemas MUST be processed in order. It is sufficient for tooling to process just the first alternative schema they are capable of processing in order to consider the content as valid. If tooling cannot process any alternative schemas, then they MAY issue a warning, but MUST not report the OpenAPI description as invalid. + +#### Alternative Schema Object + +This object makes it possible to reference an external file that contains a schema that does not follow the OAS specification. + +##### Fixed Fields + +| Field Name | Type | Description | +|---|:---:|---| +type | `string` | **REQUIRED**. The value MUST match one of the values identified in the alternative Schema Registry name of the tag. +externalValue | `url` | **REQUIRED**. This is a absolute or relative reference to an external file containing a schema of a known type. + +This object MAY be extended with [Specification Extensions](#specificationExtensions). diff --git a/registries/_extension/x-twitter.md b/registries/_extension/x-twitter.md new file mode 100644 index 0000000000..46ae0c186e --- /dev/null +++ b/registries/_extension/x-twitter.md @@ -0,0 +1,40 @@ +--- +slug: x-twitter +name: x-twitter +owner: mike_ralphson +issue: +description: Used to hold a reference to the API provider's Twitter account. +schema: + type: string +objects: [ "contactObject" ] + +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +The `x-twitter` extension is used to hold a reference to the API provider's Twitter account. It can appear as a property in the following objects: `{{page.objects|jsonify}}`. + +### Schema + +```yaml +{{page.schema}} +``` + +### Example + +```yaml +openapi: 3.0.0 +info: + title: My API + version: 1.0.0 + contact: + x-twitter: APIs-guru +``` + +Used by: (informational) + +* APIs.guru + diff --git a/registries/_format/commonmark.md b/registries/_format/commonmark.md new file mode 100644 index 0000000000..eae36a490e --- /dev/null +++ b/registries/_format/commonmark.md @@ -0,0 +1,20 @@ +--- +slug: commonmark +owner: MikeRalphson +description: commonmark-formatted text +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `string`. + +The `{{page.slug}}` format represents [CommonMark](https://commonmark.org/) formatted text. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_format/html.md b/registries/_format/html.md new file mode 100644 index 0000000000..354de85eb6 --- /dev/null +++ b/registries/_format/html.md @@ -0,0 +1,19 @@ +--- +owner: MikeRalphson +description: HTML-formatted text +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `string`. + +The `{{page.slug}}` format represents HTML-formatted text. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_format/int8.md b/registries/_format/int8.md new file mode 100644 index 0000000000..9c76166894 --- /dev/null +++ b/registries/_format/int8.md @@ -0,0 +1,20 @@ +--- +owner: MikeRalphson +issue: 845 +description: signed 8-bit integer +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `number`. + +The `{{page.slug}}` format represents a signed 8-bit integer, with the range -128 to 127. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_format/uint8.md b/registries/_format/uint8.md new file mode 100644 index 0000000000..9474479519 --- /dev/null +++ b/registries/_format/uint8.md @@ -0,0 +1,21 @@ +--- +owner: MikeRalphson +issue: 845 +description: unsigned 8-bit integer +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `number`. + +The `{{page.slug}}` format represents an unsigned 8-bit integer, with the range 0 to 255. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + diff --git a/registry/alternative-schema.md b/registry/alternative-schema.md new file mode 100644 index 0000000000..f558b6df06 --- /dev/null +++ b/registry/alternative-schema.md @@ -0,0 +1,22 @@ +--- +layout: default +permalink: /registry/alternative-schema/index.html +--- + +# Alternative Schema Type Registry + +## Master Issue + +* [#1532](https://github.com/OAI/OpenAPI-Specification/issues/1532) + +## Contributing + +Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value. + +## Values + +|Value|Description|Issue| +|---|---|---| +{% for value in site.alternative-schema %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} | +{% endfor %} + diff --git a/registry/draft-feature.md b/registry/draft-feature.md new file mode 100644 index 0000000000..53987354dd --- /dev/null +++ b/registry/draft-feature.md @@ -0,0 +1,22 @@ +--- +layout: default +permalink: /registry/draft-feature/index.html +--- + +# Draft Features Registry + +## Master Issue + +* [#1531](https://github.com/OAI/OpenAPI-Specification/pull/1531) + +## Contributing + +Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value. + +## Values + +|Value|Description|Issue| +|---|---|---| +{% for value in site.draft-feature %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} | +{% endfor %} + diff --git a/registry/extension.md b/registry/extension.md new file mode 100644 index 0000000000..6691c64f5c --- /dev/null +++ b/registry/extension.md @@ -0,0 +1,22 @@ +--- +layout: default +permalink: /registry/extension/index.html +--- + +# Extensions Registry + +## Master Issue + +* [#1351](https://github.com/OAI/OpenAPI-Specification/issues/1351) + +## Contributing + +Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value. + +## Values + +|Value|Description|Issue| +|---|---|---| +{% for value in site.extension %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} | +{% endfor %} + diff --git a/registry/format.md b/registry/format.md new file mode 100644 index 0000000000..592f848eaf --- /dev/null +++ b/registry/format.md @@ -0,0 +1,22 @@ +--- +layout: default +permalink: /registry/format/index.html +--- + +# Formats Registry + +## Master Issue + +* [#845](https://github.com/OAI/OpenAPI-Specification/issues/845) + +## Contributing + +Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value. + +## Values + +|Value|Description|Issue| +|---|---|---| +{% for value in site.format %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} | +{% endfor %} + diff --git a/registry/index.md b/registry/index.md new file mode 100644 index 0000000000..6189e53c53 --- /dev/null +++ b/registry/index.md @@ -0,0 +1,24 @@ +--- +layout: default +permalink: /registry/index.html +--- + +## Contributing + +Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value. + +### Contents + +{% for registry in site.collections %}{% unless registry.hidden %}* {{ registry.name }}{% endunless %} +{% endfor %} + +#### API access + +* [registries.json](/api/registries.json) - Registries meta-registry +{% for registry in site.collections %}{% unless registry.hidden %}* {{ registry.slug }}.json{% endunless %} +{% endfor %} + +#### RSS feed + +* [feed.xml](/rss/feed.xml) + diff --git a/rss/feed.xml b/rss/feed.xml new file mode 100644 index 0000000000..f43e1043bb --- /dev/null +++ b/rss/feed.xml @@ -0,0 +1,25 @@ +--- +layout: none +--- + + + + {{ site.title | xml_escape }} + {{ site.description | xml_escape }} + {{ site.url }}{{ site.baseurl }}/ + + {% for reg in site.collections %} + {% assign name = reg.label %} + {% for value in site.[name] %} + + {{ value.slug | xml_escape }} + {{ value.description | xml_escape }} + {{ reg.label }} + {% if value.date %}{{ value.date | date: "%a, %d %b %Y %H:%M:%S %z" }}{% else %}{{ 'now' | date: "%a, %d %b %Y %H:%M:%S %z" }}{% endif %} + {{ value.url }} + {{ value.url }} + + {% endfor %} + {% endfor %} + + From e7f201cc83b4fd6d90df99ca6285ffb8feff9f6d Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Sat, 8 Dec 2018 03:37:52 +0000 Subject: [PATCH 006/152] Update index.md with clearer title and desc. --- index.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/index.md b/index.md index a0ba023253..5fc131da89 100644 --- a/index.md +++ b/index.md @@ -1,7 +1,16 @@ -## Current major version +--- +title: OpenAPI Initiative gh-pages repository +description: HTML Spec. and extensible registry +--- +# OpenAPI Initiative Registry -* [v3.0.0](oas/v3.0.0.html) +This site contains the OpenAPI Initiative Registry and content for the HTML versions of the OpenAPI Specification. -## Previous major version +## Registry -* [v2.0](oas/v2.0.html) +* Proceed to [Registry](/registry/index.html) + +## The Specification + +* [Markdown source-of-truth](https://github.com/OAI/OpenAPI-Specification) +* [HTML Specification versions](https://openapis.org/specification) From 81409a680c9e2e12290eafc373827f9a668dfdc9 Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Wed, 2 Jan 2019 21:01:36 +0000 Subject: [PATCH 007/152] Add v3.0.2 respec/html --- oas/v3.0.2.html | 4055 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 4055 insertions(+) create mode 100644 oas/v3.0.2.html diff --git a/oas/v3.0.2.html b/oas/v3.0.2.html new file mode 100644 index 0000000000..3490b52277 --- /dev/null +++ b/oas/v3.0.2.html @@ -0,0 +1,4055 @@ +OpenAPI Specification + + +
      The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

      Status of This Document

      The source-of-truth for the specification is the GitHub markdown file referenced above.
      +

      OpenAPI Specification

      +

      Version 3.0.2

      +

      The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

      +

      This document is licensed under The Apache License, Version 2.0.

      +

      Introduction

      +

      The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

      +

      An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

      + +

      Definitions

      +

      OpenAPI Document

      +

      A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

      +

      Path Templating

      +

      Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

      +

      Media Types

      +

      Media type definitions are spread across several resources. +The media type definitions SHOULD be in compliance with [[!RFC6838]].

      +

      Some examples of possible media type definitions:

      +
      
      +  text/plain; charset=utf-8
      +  application/json
      +  application/vnd.github+json
      +  application/vnd.github.v3+json
      +  application/vnd.github.v3.raw+json
      +  application/vnd.github.v3.text+json
      +  application/vnd.github.v3.html+json
      +  application/vnd.github.v3.full+json
      +  application/vnd.github.v3.diff
      +  application/vnd.github.v3.patch
      +
      +

      HTTP Status Codes

      +

      The HTTP Status Codes are used to indicate the status of the executed operation. +The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

      +

      Specification

      +

      Versions

      +

      The OpenAPI Specification is versioned using Semantic Versioning 2.0.0 (semver) and follows the semver specification.

      +

      The major.minor portion of the semver (for example 3.0) SHALL designate the OAS feature set. Typically, .patch versions address errors in this document, not the feature set. Tooling which supports OAS 3.0 SHOULD be compatible with all OAS 3.0.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.0.0 and 3.0.1 for example.

      +

      Subsequent minor version releases of the OpenAPI Specification (incrementing the minor version number) SHOULD NOT interfere with tooling developed to a lower minor version and same major version. Thus a hypothetical 3.1.0 specification SHOULD be usable with tooling designed for 3.0.0.

      +

      An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the semantic version of the OAS that it uses. (OAS 2.0 documents contain a top-level version field named swagger and value "2.0".)

      +

      Format

      +

      An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

      +

      For example, if a field has an array value, the JSON array representation will be used:

      +
      
      +{
      +   "field": [ 1, 2, 3 ]
      +}
      +
      +

      All field names in the specification are case sensitive. +This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

      +

      The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

      +

      Patterned fields MUST have unique names within the containing object.

      +

      In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

      + +

      Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

      +

      Document Structure

      +

      An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

      +

      It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

      +

      Data Types

      +

      Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. +Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. +null is not supported as a type (see nullable for an alternative solution). +Models are defined using the Schema Object, which is an extended subset of JSON Schema Specification Wright Draft 00.

      +

      Primitives have an optional modifier property: format. +OAS uses several known formats to define in fine detail the data type being used. +However, to support documentation needs, the format property is an open string-valued property, and can have any value. +Formats such as "email", "uuid", and so on, MAY be used even though undefined by this specification. +Types that are not accompanied by a format property follow the type definition in the JSON Schema. Tools that do not recognize a specific format MAY default back to the type alone, as if the format is not specified.

      +

      The formats defined by the OAS are:

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      typeformatComments
      integerint32signed 32 bits
      integerint64signed 64 bits (a.k.a long)
      numberfloat
      numberdouble
      string
      stringbytebase64 encoded characters
      stringbinaryany sequence of octets
      boolean
      stringdateAs defined by full-date - [[!RFC3339]]
      stringdate-timeAs defined by date-time - [[!RFC3339]]
      stringpasswordA hint to UIs to obscure input.
      +

      Rich Text Formatting

      +

      Throughout the specification description fields are noted as supporting CommonMark markdown formatting. +Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

      +

      Relative References in URLs

      +

      Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. +Relative references are resolved using the URLs defined in the Server Object as a Base URI.

      +

      Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

      +

      Schema

      +

      In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

      +

      OpenAPI Object

      +

      This is the root document object of the OpenAPI document.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      openapistringREQUIRED. This string MUST be the semantic version number of the OpenAPI Specification version that the OpenAPI document uses. The openapi field SHOULD be used by tooling specifications and clients to interpret the OpenAPI document. This is not related to the API info.version string.
      infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
      servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
      pathsPaths ObjectREQUIRED. The available paths and operations for the API.
      componentsComponents ObjectAn element to hold various schemas for the specification.
      security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition.
      tags[Tag Object]A list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
      externalDocsExternal Documentation ObjectAdditional external documentation.
      +

      This object MAY be extended with Specification Extensions.

      +

      Info Object

      +

      The object provides metadata about the API. +The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      titlestringREQUIRED. The title of the application.
      descriptionstringA short description of the application. CommonMark syntax MAY be used for rich text representation.
      termsOfServicestringA URL to the Terms of Service for the API. MUST be in the format of a URL.
      contactContact ObjectThe contact information for the exposed API.
      licenseLicense ObjectThe license information for the exposed API.
      versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
      +

      This object MAY be extended with Specification Extensions.

      +

      Info Object Example

      +
      
      +{
      +  "title": "Sample Pet Store App",
      +  "description": "This is a sample server for a pet store.",
      +  "termsOfService": "http://example.com/terms/",
      +  "contact": {
      +    "name": "API Support",
      +    "url": "http://www.example.com/support",
      +    "email": "support@example.com"
      +  },
      +  "license": {
      +    "name": "Apache 2.0",
      +    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
      +  },
      +  "version": "1.0.1"
      +}
      +
      +
      
      +title: Sample Pet Store App
      +description: This is a sample server for a pet store.
      +termsOfService: http://example.com/terms/
      +contact:
      +  name: API Support
      +  url: http://www.example.com/support
      +  email: support@example.com
      +license:
      +  name: Apache 2.0
      +  url: https://www.apache.org/licenses/LICENSE-2.0.html
      +version: 1.0.1
      +
      +

      Contact Object

      +

      Contact information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringThe identifying name of the contact person/organization.
      urlstringThe URL pointing to the contact information. MUST be in the format of a URL.
      emailstringThe email address of the contact person/organization. MUST be in the format of an email address.
      +

      This object MAY be extended with Specification Extensions.

      +

      Contact Object Example

      +
      
      +{
      +  "name": "API Support",
      +  "url": "http://www.example.com/support",
      +  "email": "support@example.com"
      +}
      +
      +
      
      +name: API Support
      +url: http://www.example.com/support
      +email: support@example.com
      +
      +

      License Object

      +

      License information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The license name used for the API.
      urlstringA URL to the license used for the API. MUST be in the format of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      License Object Example

      +
      
      +{
      +  "name": "Apache 2.0",
      +  "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
      +}
      +
      +
      
      +name: Apache 2.0
      +url: https://www.apache.org/licenses/LICENSE-2.0.html
      +
      +

      Server Object

      +

      An object representing a Server.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
      descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
      variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
      +

      This object MAY be extended with Specification Extensions.

      +

      Server Object Example

      +

      A single server would be described as:

      +
      
      +{
      +  "url": "https://development.gigantic-server.com/v1",
      +  "description": "Development server"
      +}
      +
      +
      
      +url: https://development.gigantic-server.com/v1
      +description: Development server
      +
      +

      The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

      +
      
      +{
      +  "servers": [
      +    {
      +      "url": "https://development.gigantic-server.com/v1",
      +      "description": "Development server"
      +    },
      +    {
      +      "url": "https://staging.gigantic-server.com/v1",
      +      "description": "Staging server"
      +    },
      +    {
      +      "url": "https://api.gigantic-server.com/v1",
      +      "description": "Production server"
      +    }
      +  ]
      +}
      +
      +
      
      +servers:
      +- url: https://development.gigantic-server.com/v1
      +  description: Development server
      +- url: https://staging.gigantic-server.com/v1
      +  description: Staging server
      +- url: https://api.gigantic-server.com/v1
      +  description: Production server
      +
      +

      The following shows how variables can be used for a server configuration:

      +
      
      +{
      +  "servers": [
      +    {
      +      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
      +      "description": "The production API server",
      +      "variables": {
      +        "username": {
      +          "default": "demo",
      +          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
      +        },
      +        "port": {
      +          "enum": [
      +            "8443",
      +            "443"
      +          ],
      +          "default": "8443"
      +        },
      +        "basePath": {
      +          "default": "v2"
      +        }
      +      }
      +    }
      +  ]
      +}
      +
      +
      
      +servers:
      +- url: https://{username}.gigantic-server.com:{port}/{basePath}
      +  description: The production API server
      +  variables:
      +    username:
      +      # note! no enum here means it is an open value
      +      default: demo
      +      description: this value is assigned by the service provider, in this example `gigantic-server.com`
      +    port:
      +      enum:
      +        - '8443'
      +        - '443'
      +      default: '8443'
      +    basePath:
      +      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
      +      default: v2
      +
      +

      Server Variable Object

      +

      An object representing a Server Variable for server URL template substitution.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      enum[string]An enumeration of string values to be used if the substitution options are from a limited set.
      defaultstringREQUIRED. The default value to use for substitution, which SHALL be sent if an alternate value is not supplied. Note this behavior is different than the Schema Object’s treatment of default values, because in those cases parameter values are optional.
      descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
      +

      This object MAY be extended with Specification Extensions.

      +

      Components Object

      +

      Holds a set of reusable objects for different aspects of the OAS. +All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      schemasMap[string, Schema Object ¦ Reference Object]An object to hold reusable Schema Objects.
      responsesMap[string, Response Object ¦ Reference Object]An object to hold reusable Response Objects.
      parametersMap[string, Parameter Object ¦ Reference Object]An object to hold reusable Parameter Objects.
      examplesMap[string, Example Object ¦ Reference Object]An object to hold reusable Example Objects.
      requestBodiesMap[string, Request Body Object ¦ Reference Object]An object to hold reusable Request Body Objects.
      headersMap[string, Header Object ¦ Reference Object]An object to hold reusable Header Objects.
      securitySchemesMap[string, Security Scheme Object ¦ Reference Object]An object to hold reusable Security Scheme Objects.
      linksMap[string, Link Object ¦ Reference Object]An object to hold reusable Link Objects.
      callbacksMap[string, Callback Object ¦ Reference Object]An object to hold reusable Callback Objects.
      +

      This object MAY be extended with Specification Extensions.

      +

      All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

      +

      Field Name Examples:

      +
      
      +User
      +User_1
      +User_Name
      +user-name
      +my.org.User
      +
      +

      Components Object Example

      +
      
      +"components": {
      +  "schemas": {
      +    "GeneralError": {
      +      "type": "object",
      +      "properties": {
      +        "code": {
      +          "type": "integer",
      +          "format": "int32"
      +        },
      +        "message": {
      +          "type": "string"
      +        }
      +      }
      +    },
      +    "Category": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      }
      +    },
      +    "Tag": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      }
      +    }
      +  },
      +  "parameters": {
      +    "skipParam": {
      +      "name": "skip",
      +      "in": "query",
      +      "description": "number of items to skip",
      +      "required": true,
      +      "schema": {
      +        "type": "integer",
      +        "format": "int32"
      +      }
      +    },
      +    "limitParam": {
      +      "name": "limit",
      +      "in": "query",
      +      "description": "max records to return",
      +      "required": true,
      +      "schema" : {
      +        "type": "integer",
      +        "format": "int32"
      +      }
      +    }
      +  },
      +  "responses": {
      +    "NotFound": {
      +      "description": "Entity not found."
      +    },
      +    "IllegalInput": {
      +      "description": "Illegal input for operation."
      +    },
      +    "GeneralError": {
      +      "description": "General Error",
      +      "content": {
      +        "application/json": {
      +          "schema": {
      +            "$ref": "#/components/schemas/GeneralError"
      +          }
      +        }
      +      }
      +    }
      +  },
      +  "securitySchemes": {
      +    "api_key": {
      +      "type": "apiKey",
      +      "name": "api_key",
      +      "in": "header"
      +    },
      +    "petstore_auth": {
      +      "type": "oauth2",
      +      "flows": {
      +        "implicit": {
      +          "authorizationUrl": "http://example.org/api/oauth/dialog",
      +          "scopes": {
      +            "write:pets": "modify pets in your account",
      +            "read:pets": "read your pets"
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    GeneralError:
      +      type: object
      +      properties:
      +        code:
      +          type: integer
      +          format: int32
      +        message:
      +          type: string
      +    Category:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +    Tag:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +  parameters:
      +    skipParam:
      +      name: skip
      +      in: query
      +      description: number of items to skip
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +    limitParam:
      +      name: limit
      +      in: query
      +      description: max records to return
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +  responses:
      +    NotFound:
      +      description: Entity not found.
      +    IllegalInput:
      +      description: Illegal input for operation.
      +    GeneralError:
      +      description: General Error
      +      content:
      +        application/json:
      +          schema:
      +            $ref: '#/components/schemas/GeneralError'
      +  securitySchemes:
      +    api_key:
      +      type: apiKey
      +      name: api_key
      +      in: header
      +    petstore_auth:
      +      type: oauth2
      +      flows: 
      +        implicit:
      +          authorizationUrl: http://example.org/api/oauth/dialog
      +          scopes:
      +            write:pets: modify pets in your account
      +            read:pets: read your pets
      +
      +

      Paths Object

      +

      Holds the relative paths to the individual endpoints and their operations. +The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a slash. The path is appended (no relative URL resolution) to the expanded URL from the Server Object's url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
      +

      This object MAY be extended with Specification Extensions.

      +

      Path Templating Matching

      +

      Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

      +
      
      +  /pets/{petId}
      +  /pets/mine
      +
      +

      The following paths are considered identical and invalid:

      +
      
      +  /pets/{petId}
      +  /pets/{name}
      +
      +

      The following may lead to ambiguous resolution:

      +
      
      +  /{entity}/me
      +  /books/{id}
      +
      +

      Paths Object Example

      +
      
      +{
      +  "/pets": {
      +    "get": {
      +      "description": "Returns all pets from the system that the user has access to",
      +      "responses": {
      +        "200": {          
      +          "description": "A list of pets.",
      +          "content": {
      +            "application/json": {
      +              "schema": {
      +                "type": "array",
      +                "items": {
      +                  "$ref": "#/components/schemas/pet"
      +                }
      +              }
      +            }
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +/pets:
      +  get:
      +    description: Returns all pets from the system that the user has access to
      +    responses:
      +      '200':
      +        description: A list of pets.
      +        content:
      +          application/json:
      +            schema:
      +              type: array
      +              items:
      +                $ref: '#/components/schemas/pet'
      +
      +

      Path Item Object

      +

      Describes the operations available on a single path. +A Path Item MAY be empty, due to ACL constraints. +The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringAllows for an external definition of this path item. The referenced structure MUST be in the format of a Path Item Object. If there are conflicts between the referenced definition and this Path Item’s definition, the behavior is undefined.
      summarystringAn optional, string summary, intended to apply to all operations in this path.
      descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
      getOperation ObjectA definition of a GET operation on this path.
      putOperation ObjectA definition of a PUT operation on this path.
      postOperation ObjectA definition of a POST operation on this path.
      deleteOperation ObjectA definition of a DELETE operation on this path.
      optionsOperation ObjectA definition of a OPTIONS operation on this path.
      headOperation ObjectA definition of a HEAD operation on this path.
      patchOperation ObjectA definition of a PATCH operation on this path.
      traceOperation ObjectA definition of a TRACE operation on this path.
      servers[Server Object]An alternative server array to service all operations in this path.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      +

      This object MAY be extended with Specification Extensions.

      +

      Path Item Object Example

      +
      
      +{
      +  "get": {
      +    "description": "Returns pets based on ID",
      +    "summary": "Find pets by ID",
      +    "operationId": "getPetsById",
      +    "responses": {
      +      "200": {
      +        "description": "pet response",
      +        "content": {
      +          "*/*": {
      +            "schema": {
      +              "type": "array",
      +              "items": {
      +                "$ref": "#/components/schemas/Pet"
      +              }
      +            }
      +          }
      +        }
      +      },
      +      "default": {
      +        "description": "error payload",
      +        "content": {
      +          "text/html": {
      +            "schema": {
      +              "$ref": "#/components/schemas/ErrorModel"
      +            }
      +          }
      +        }
      +      }
      +    }
      +  },
      +  "parameters": [
      +    {
      +      "name": "id",
      +      "in": "path",
      +      "description": "ID of pet to use",
      +      "required": true,
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
      +        }
      +      },
      +      "style": "simple"
      +    }
      +  ]
      +}
      +
      +
      
      +get:
      +  description: Returns pets based on ID
      +  summary: Find pets by ID
      +  operationId: getPetsById
      +  responses:
      +    '200':
      +      description: pet response
      +      content:
      +        '*/*' :
      +          schema:
      +            type: array
      +            items:
      +              $ref: '#/components/schemas/Pet'
      +    default:
      +      description: error payload
      +      content:
      +        'text/html':
      +          schema:
      +            $ref: '#/components/schemas/ErrorModel'
      +parameters:
      +- name: id
      +  in: path
      +  description: ID of pet to use
      +  required: true
      +  schema:
      +    type: array
      +    style: simple
      +    items:
      +      type: string  
      +
      +

      Operation Object

      +

      Describes a single API operation on a path.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
      summarystringA short summary of what the operation does.
      descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
      operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. The operationId value is case-sensitive. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      requestBodyRequest Body Object ¦ Reference ObjectThe request body applicable for this operation. The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers.
      responsesResponses ObjectREQUIRED. The list of possible responses as they are returned from executing this operation.
      callbacksMap[string, Callback Object ¦ Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses. The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.
      deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
      security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
      servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
      +

      This object MAY be extended with Specification Extensions.

      +

      Operation Object Example

      +
      
      +{
      +  "tags": [
      +    "pet"
      +  ],
      +  "summary": "Updates a pet in the store with form data",
      +  "operationId": "updatePetWithForm",
      +  "parameters": [
      +    {
      +      "name": "petId",
      +      "in": "path",
      +      "description": "ID of pet that needs to be updated",
      +      "required": true,
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  ],
      +  "requestBody": {
      +    "content": {
      +      "application/x-www-form-urlencoded": {
      +        "schema": {
      +          "type": "object",
      +           "properties": {
      +              "name": { 
      +                "description": "Updated name of the pet",
      +                "type": "string"
      +              },
      +              "status": {
      +                "description": "Updated status of the pet",
      +                "type": "string"
      +             }
      +           },
      +        "required": ["status"] 
      +        }
      +      }
      +    }
      +  },
      +  "responses": {
      +    "200": {
      +      "description": "Pet updated.",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
      +      }
      +    },
      +    "405": {
      +      "description": "Method Not Allowed",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
      +      }
      +    }
      +  },
      +  "security": [
      +    {
      +      "petstore_auth": [
      +        "write:pets",
      +        "read:pets"
      +      ]
      +    }
      +  ]
      +}
      +
      +
      
      +tags:
      +- pet
      +summary: Updates a pet in the store with form data
      +operationId: updatePetWithForm
      +parameters:
      +- name: petId
      +  in: path
      +  description: ID of pet that needs to be updated
      +  required: true
      +  schema:
      +    type: string
      +requestBody:
      +  content:
      +    'application/x-www-form-urlencoded':
      +      schema:
      +       properties:
      +          name: 
      +            description: Updated name of the pet
      +            type: string
      +          status:
      +            description: Updated status of the pet
      +            type: string
      +       required:
      +         - status
      +responses:
      +  '200':
      +    description: Pet updated.
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +  '405':
      +    description: Method Not Allowed
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +security:
      +- petstore_auth:
      +  - write:pets
      +  - read:pets
      +
      +

      External Documentation Object

      +

      Allows referencing an external resource for extended documentation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA short description of the target documentation. CommonMark syntax MAY be used for rich text representation.
      urlstringREQUIRED. The URL for the target documentation. Value MUST be in the format of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      External Documentation Object Example

      +
      
      +{
      +  "description": "Find more info here",
      +  "url": "https://example.com"
      +}
      +
      +
      
      +description: Find more info here
      +url: https://example.com
      +
      +

      Parameter Object

      +

      Describes a single operation parameter.

      +

      A unique parameter is defined by a combination of a name and location.

      +

      Parameter Locations

      +

      There are four possible parameter locations specified by the in field:

      +
        +
      • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
      • +
      • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
      • +
      • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
      • +
      • cookie - Used to pass a specific cookie value to the API.
      • +
      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
      • If in is "path", the name field MUST correspond to the associated path segment from the path field in the Paths Object. See Path Templating for further information.
      • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
      • For all other cases, the name corresponds to the parameter name used by the in property.
      instringREQUIRED. The location of the parameter. Possible values are “query”, “header”, “path” or “cookie”.
      descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
      requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is “path”, this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
      deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage. Default value is false.
      allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored. Use of this property is NOT RECOMMENDED, as it is likely to be removed in a later revision.
      +

      The rules for serialization of the parameter are specified in one of two ways. +For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
      explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
      allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
      schemaSchema Object ¦ Reference ObjectThe schema defining the type used for the parameter.
      exampleAnyExample of the media type. The example SHOULD match the specified schema and encoding properties if present. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
      examplesMap[ string, Example Object ¦ Reference Object]Examples of the media type. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
      +

      For more complex scenarios, the content property can define the media type and schema of the parameter. +A parameter MUST contain either a schema property, or a content property, but not both. +When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
      +

      Style Values

      +

      In order to support common ways of serializing simple parameters, a set of style values are defined.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      styletypeinComments
      matrixprimitive, array, objectpathPath-style parameters defined by [[!RFC6570]]
      labelprimitive, array, objectpathLabel style parameters defined by [[!RFC6570]]
      formprimitive, array, objectquery, cookieForm style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
      simplearraypath, headerSimple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0.
      spaceDelimitedarrayquerySpace separated array values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
      pipeDelimitedarrayqueryPipe separated array values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
      deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
      +

      Style Examples

      +

      Assume a parameter named color has one of the following values:

      +
      
      +   string -> "blue"
      +   array -> ["blue","black","brown"]
      +   object -> { "R": 100, "G": 200, "B": 150 }
      +
      +

      The following table shows examples of rendering differences for each value.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      styleexplodeemptystringarrayobject
      matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
      matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
      labelfalse..blue.blue.black.brown.R.100.G.200.B.150
      labeltrue..blue.blue.black.brown.R=100.G=200.B=150
      formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
      formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
      simplefalsen/ablueblue,black,brownR,100,G,200,B,150
      simpletruen/ablueblue,black,brownR=100,G=200,B=150
      spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
      pipeDelimitedfalsen/an/ablue¦black¦brownR¦100¦G¦200
      deepObjecttruen/an/an/acolor\R=100&color\G=200&color\B=150
      +

      This object MAY be extended with Specification Extensions.

      +

      Parameter Object Examples

      +

      A header parameter with an array of 64 bit integer numbers:

      +
      
      +{
      +  "name": "token",
      +  "in": "header",
      +  "description": "token to be passed as a header",
      +  "required": true,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "integer",
      +      "format": "int64"
      +    }
      +  },
      +  "style": "simple"
      +}
      +
      +
      
      +name: token
      +in: header
      +description: token to be passed as a header
      +required: true
      +schema:
      +  type: array
      +  items:
      +    type: integer
      +    format: int64
      +style: simple
      +
      +

      A path parameter of a string value:

      +
      
      +{
      +  "name": "username",
      +  "in": "path",
      +  "description": "username to fetch",
      +  "required": true,
      +  "schema": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +name: username
      +in: path
      +description: username to fetch
      +required: true
      +schema:
      +  type: string
      +
      +

      An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

      +
      
      +{
      +  "name": "id",
      +  "in": "query",
      +  "description": "ID of the object to fetch",
      +  "required": false,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    }
      +  },
      +  "style": "form",
      +  "explode": true
      +}
      +
      +
      
      +name: id
      +in: query
      +description: ID of the object to fetch
      +required: false
      +schema:
      +  type: array
      +  items:
      +    type: string
      +style: form
      +explode: true
      +
      +

      A free-form query parameter, allowing undefined parameters of a specific type:

      +
      
      +{
      +  "in": "query",
      +  "name": "freeForm",
      +  "schema": {
      +    "type": "object",
      +    "additionalProperties": {
      +      "type": "integer"
      +    },
      +  },
      +  "style": "form"
      +}
      +
      +
      
      +in: query
      +name: freeForm
      +schema:
      +  type: object
      +  additionalProperties:
      +    type: integer
      +style: form
      +
      +

      A complex parameter using content to define serialization:

      +
      
      +{
      +  "in": "query",
      +  "name": "coordinates",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "object",
      +        "required": [
      +          "lat",
      +          "long"
      +        ],
      +        "properties": {
      +          "lat": {
      +            "type": "number"
      +          },
      +          "long": {
      +            "type": "number"
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +in: query
      +name: coordinates
      +content:
      +  application/json:
      +    schema:
      +      type: object
      +      required:
      +        - lat
      +        - long
      +      properties:
      +        lat:
      +          type: number
      +        long:
      +          type: number
      +
      +

      Request Body Object

      +

      Describes a single request body.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
      contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
      requiredbooleanDetermines if the request body is required in the request. Defaults to false.
      +

      This object MAY be extended with Specification Extensions.

      +

      Request Body Examples

      +

      A request body with a referenced model definition.

      +
      
      +{
      +  "description": "user to add to the system",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
      +      },
      +      "examples": {
      +          "user" : {
      +            "summary": "User Example", 
      +            "externalValue": "http://foo.bar/examples/user-example.json"
      +          } 
      +        }
      +    },
      +    "application/xml": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
      +      },
      +      "examples": {
      +          "user" : {
      +            "summary": "User example in XML",
      +            "externalValue": "http://foo.bar/examples/user-example.xml"
      +          }
      +        }
      +    },
      +    "text/plain": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in Plain text",
      +            "externalValue": "http://foo.bar/examples/user-example.txt" 
      +        }
      +      } 
      +    },
      +    "*/*": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in other format",
      +            "externalValue": "http://foo.bar/examples/user-example.whatever"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: user to add to the system
      +content: 
      +  'application/json':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User Example
      +        externalValue: 'http://foo.bar/examples/user-example.json'
      +  'application/xml':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User Example in XML
      +        externalValue: 'http://foo.bar/examples/user-example.xml'
      +  'text/plain':
      +    examples:
      +      user:
      +        summary: User example in text plain format
      +        externalValue: 'http://foo.bar/examples/user-example.txt'
      +  '*/*':
      +    examples:
      +      user: 
      +        summary: User example in other format
      +        externalValue: 'http://foo.bar/examples/user-example.whatever'
      +
      +

      A body parameter that is an array of string values:

      +
      
      +{
      +  "description": "user to add to the system",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: user to add to the system
      +required: true
      +content:
      +  text/plain:
      +    schema:
      +      type: array
      +      items:
      +        type: string
      +
      +

      Media Type Object

      +

      Each Media Type Object provides schema and examples for the media type identified by its key.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      schemaSchema Object ¦ Reference ObjectThe schema defining the content of the request, response, or parameter.
      exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
      examplesMap[ string, Example Object ¦ Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
      encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
      +

      This object MAY be extended with Specification Extensions.

      +

      Media Type Examples

      +
      
      +{
      +  "application/json": {
      +    "schema": {
      +         "$ref": "#/components/schemas/Pet"
      +    },
      +    "examples": {
      +      "cat" : {
      +        "summary": "An example of a cat",
      +        "value": 
      +          {
      +            "name": "Fluffy",
      +            "petType": "Cat",
      +            "color": "White",
      +            "gender": "male",
      +            "breed": "Persian"
      +          }
      +      },
      +      "dog": {
      +        "summary": "An example of a dog with a cat's name",
      +        "value" :  { 
      +          "name": "Puma",
      +          "petType": "Dog",
      +          "color": "Black",
      +          "gender": "Female",
      +          "breed": "Mixed"
      +        },
      +      "frog": {
      +          "$ref": "#/components/examples/frog-example"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +application/json: 
      +  schema:
      +    $ref: "#/components/schemas/Pet"
      +  examples:
      +    cat:
      +      summary: An example of a cat
      +      value:
      +        name: Fluffy
      +        petType: Cat
      +        color: White
      +        gender: male
      +        breed: Persian
      +    dog:
      +      summary: An example of a dog with a cat's name
      +      value:
      +        name: Puma
      +        petType: Dog
      +        color: Black
      +        gender: Female
      +        breed: Mixed
      +    frog:
      +      $ref: "#/components/examples/frog-example"
      +
      +

      Considerations for File Uploads

      +

      In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type. Specifically:

      +
      
      +# content transferred with base64 encoding
      +schema:
      +  type: string
      +  format: base64
      +
      +
      
      +# content transferred in binary (octet-stream):
      +schema:
      +  type: string
      +  format: binary
      +
      +

      These examples apply to either input payloads of file uploads or response payloads.

      +

      A requestBody for submitting a file in a POST operation may look like the following example:

      +
      
      +requestBody:
      +  content:
      +    application/octet-stream:
      +      # any media type is accepted, functionally equivalent to `*/*`
      +      schema:
      +        # a binary file of any type
      +        type: string
      +        format: binary
      +
      +

      In addition, specific media types MAY be specified:

      +
      
      +# multiple, specific media types may be specified:
      +requestBody:
      +  content:
      +      # a binary file of type png or jpeg
      +    'image/jpeg':
      +      schema:
      +        type: string
      +        format: binary
      +    'image/png':
      +      schema:
      +        type: string
      +        format: binary        
      +
      +

      To upload multiple files, a multipart media type MUST be used:

      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        properties:
      +          # The property name 'file' will be used for all files.
      +          file:
      +            type: array
      +            items:
      +              type: string
      +              format: binary
      +
      +
      +

      Support for x-www-form-urlencoded Request Bodies

      +

      To submit content using form url encoding via [[!RFC1866]], the following +definition may be used:

      +
      
      +requestBody:
      +  content:
      +    application/x-www-form-urlencoded:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # complex types are stringified to support RFC 1866
      +            type: object
      +            properties: {}
      +
      +

      In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

      +

      When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object's style property as form.

      +

      Special Considerations for multipart Content

      +

      It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

      +

      When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred — thus, the following default Content-Types are defined for multipart:

      +
        +
      • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
      • +
      • If the property is complex, or an array of complex values, the default Content-Type is application/json
      • +
      • If the property is a type: string with format: binary or format: base64 (aka a file object), the default Content-Type is application/octet-stream
      • +
      +

      Examples:

      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # default Content-Type for objects is `application/json`
      +            type: object
      +            properties: {}
      +          profileImage:
      +            # default Content-Type for string/binary is `application/octet-stream`
      +            type: string
      +            format: binary
      +          children:
      +            # default Content-Type for arrays is based on the `inner` type (text/plain here)
      +            type: array
      +            items:
      +              type: string
      +          addresses:
      +            # default Content-Type for arrays is based on the `inner` type (object shown, so `application/json` in this example)
      +            type: array
      +            items:
      +              type: '#/components/schemas/Address'
      +
      +

      An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

      +

      Encoding Object

      +

      A single encoding definition applied to a single schema property.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for string with format being binaryapplication/octet-stream; for other primitive types – text/plain; for object - application/json; for array – the default is defined based on the inner type. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
      headersMap[string, Header Object ¦ Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
      stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      +

      This object MAY be extended with Specification Extensions.

      +

      Encoding Object Example

      +
      
      +requestBody:
      +  content:
      +    multipart/mixed:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            # default is text/plain
      +            type: string
      +            format: uuid
      +          address:
      +            # default is application/json
      +            type: object
      +            properties: {}
      +          historyMetadata:
      +            # need to declare XML format!
      +            description: metadata in XML format
      +            type: object
      +            properties: {}
      +          profileImage:
      +            # default is application/octet-stream, need to declare an image type only!
      +            type: string
      +            format: binary
      +      encoding:
      +        historyMetadata:
      +          # require XML Content-Type in utf-8 encoding
      +          contentType: application/xml; charset=utf-8
      +        profileImage:
      +          # only accept png/jpeg
      +          contentType: image/png, image/jpeg
      +          headers:
      +            X-Rate-Limit-Limit:
      +              description: The number of allowed requests in the current period
      +              schema:
      +                type: integer
      +
      +

      Responses Object

      +

      A container for the expected responses of an operation. +The container maps a HTTP response code to the expected response.

      +

      The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. +However, documentation is expected to cover a successful operation response and any known errors.

      +

      The default MAY be used as a default response object for all HTTP codes +that are not covered individually by the specification.

      +

      The Responses Object MUST contain at least one response code, and it +SHOULD be the response for a successful operation call.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      defaultResponse Object ¦ Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses. A Reference Object can link to a response that the OpenAPI Object’s components/responses section defines.
      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      HTTP Status CodeResponse Object ¦ Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. A Reference Object can link to a response that is defined in the OpenAPI Object’s components/responses section. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. Only the following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
      +

      This object MAY be extended with Specification Extensions.

      +

      Responses Object Example

      +

      A 200 response for a successful operation and a default response for others (implying an error):

      +
      
      +{
      +  "200": {
      +    "description": "a pet to be returned",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/Pet"
      +        }
      +      }
      +    }
      +  },
      +  "default": {
      +    "description": "Unexpected error",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/ErrorModel"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +'200':
      +  description: a pet to be returned
      +  content: 
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/Pet'
      +default:
      +  description: Unexpected error
      +  content:
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/ErrorModel'
      +
      +

      Response Object

      +

      Describes a single response from an API Operation, including design-time, static +links to operations based on the response.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringREQUIRED. A short description of the response. CommonMark syntax MAY be used for rich text representation.
      headersMap[string, Header Object ¦ Reference Object]Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
      contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
      linksMap[string, Link Object ¦ Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
      +

      This object MAY be extended with Specification Extensions.

      +

      Response Object Examples

      +

      Response of an array of a complex type:

      +
      
      +{
      +  "description": "A complex object array response",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "$ref": "#/components/schemas/VeryComplexType"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: A complex object array response
      +content: 
      +  application/json:
      +    schema: 
      +      type: array
      +      items:
      +        $ref: '#/components/schemas/VeryComplexType'
      +
      +

      Response with a string type:

      +
      
      +{
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  }
      +
      +}
      +
      +
      
      +description: A simple string response
      +content:
      +  text/plain:
      +    schema:
      +      type: string
      +
      +

      Plain text response with headers:

      +
      
      +{
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  },
      +  "headers": {
      +    "X-Rate-Limit-Limit": {
      +      "description": "The number of allowed requests in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    },
      +    "X-Rate-Limit-Remaining": {
      +      "description": "The number of remaining requests in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    },
      +    "X-Rate-Limit-Reset": {
      +      "description": "The number of seconds left in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: A simple string response
      +content:
      +  text/plain:
      +    schema:
      +      type: string
      +    example: 'whoa!'
      +headers:
      +  X-Rate-Limit-Limit:
      +    description: The number of allowed requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Remaining:
      +    description: The number of remaining requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Reset:
      +    description: The number of seconds left in the current period
      +    schema:
      +      type: integer
      +
      +

      Response with no return value:

      +
      
      +{
      +  "description": "object created"
      +}
      +
      +
      
      +description: object created
      +
      +

      Callback Object

      +

      A map of possible out-of band callbacks related to the parent operation. +Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. +The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {expression}Path Item ObjectA Path Item Object used to define a callback request and expected responses. A complete example is available.
      +

      This object MAY be extended with Specification Extensions.

      +

      Key Expression

      +

      The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. +A simple example might be $request.body#/url. +However, using a runtime expression the complete HTTP message can be accessed. +This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

      +

      For example, given the following HTTP request:

      +
      
      +POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
      +Host: example.org
      +Content-Type: application/json
      +Content-Length: 187
      +
      +{
      +  "failedUrl" : "http://clientdomain.com/failed",
      +  "successUrls" : [
      +    "http://clientdomain.com/fast",
      +    "http://clientdomain.com/medium",
      +    "http://clientdomain.com/slow"
      +  ] 
      +}
      +
      +201 Created
      +Location: http://example.org/subscription/1
      +
      +

      The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      ExpressionValue
      $urlhttp://example.org/subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning
      $methodPOST
      $request.path.eventTypemyevent
      $request.query.queryUrlhttp://clientdomain.com/stillrunning
      $request.header.content-Typeapplication/json
      $request.body#/failedUrlhttp://clientdomain.com/failed
      $request.body#/successUrls/2http://clientdomain.com/medium
      $response.header.Locationhttp://example.org/subscription/1
      +

      Callback Object Example

      +

      The following example shows a callback to the URL specified by the id and email property in the request body.

      +
      
      +myWebhook:
      +  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
      +    post:
      +      requestBody:
      +        description: Callback payload
      +        content: 
      +          'application/json':
      +            schema:
      +              $ref: '#/components/schemas/SomePayload'
      +      responses:
      +        '200':
      +          description: webhook successfully processed and no retries will be performed
      +
      +

      Example Object

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      summarystringShort description for the example.
      descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
      valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
      externalValuestringA URL that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive.
      +

      This object MAY be extended with Specification Extensions.

      +

      In all cases, the example value is expected to be compatible with the type schema +of its associated value. Tooling implementations MAY choose to +validate compatibility automatically, and reject the example value(s) if incompatible.

      +

      Example Object Examples

      +

      In a model:

      +
      
      +schemas:
      +  properties:
      +    name:
      +      type: string
      +      examples:
      +        name:
      +          $ref: http://example.org/petapi-examples/openapi.json#/components/examples/name-example
      +
      +

      In a request body:

      +
      
      +requestBody:
      +  content:
      +    'application/json':
      +      schema:
      +        $ref: '#/components/schemas/Address'
      +      examples: 
      +        foo:
      +          summary: A foo example
      +          value: {"foo": "bar"}
      +        bar:
      +          summary: A bar example
      +          value: {"bar": "baz"}
      +    'application/xml':
      +      examples: 
      +        xmlExample:
      +          summary: This is an example in XML
      +          externalValue: 'http://example.org/examples/address-example.xml'
      +    'text/plain':
      +      examples:
      +        textExample: 
      +          summary: This is a text example
      +          externalValue: 'http://foo.bar/examples/address-example.txt'
      +
      +

      In a parameter:

      +
      
      +parameters:
      +  - name: 'zipCode'
      +    in: 'query'
      +    schema:
      +      type: 'string'
      +      format: 'zip-code'
      +      examples:
      +        zip-example: 
      +          $ref: '#/components/examples/zip-example'
      +
      +

      In a response:

      +
      
      +responses:
      +  '200':
      +    description: your car appointment has been booked
      +    content: 
      +      application/json:
      +        schema:
      +          $ref: '#/components/schemas/SuccessResponse'
      +        examples:
      +          confirmation-success:
      +            $ref: '#/components/examples/confirmation-success'
      +
      +

      Link Object

      +

      The Link object represents a possible design-time link for a response. +The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

      +

      Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

      +

      For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      operationRefstringA relative or absolute reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition.
      operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
      parametersMap[string, Any ¦ {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
      requestBodyAny ¦ {expression}A literal value or {expression} to use as a request body when calling the target operation.
      descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
      serverServer ObjectA server object to be used by the target operation.
      +

      This object MAY be extended with Specification Extensions.

      +

      A linked operation MUST be identified using either an operationRef or operationId. +In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. +Because of the potential for name clashes, the operationRef syntax is preferred +for specifications with external references.

      +

      Examples

      +

      Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

      +
      
      +paths:
      +  /users/{id}:
      +    parameters:
      +    - name: id
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +    get:
      +      responses:
      +        '200':
      +          description: the user being returned
      +          content:
      +            application/json:
      +              schema:
      +                type: object
      +                properties:
      +                  uuid: # the unique user id
      +                    type: string
      +                    format: uuid
      +          links:
      +            address:
      +              # the target link operationId
      +              operationId: getUserAddress
      +              parameters:
      +                # get the `id` field from the request path parameter named `id`
      +                userId: $request.path.id
      +  # the path item of the linked operation
      +  /users/{userid}/address:
      +    parameters:
      +    - name: userid
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +    # linked operation
      +    get:
      +      operationId: getUserAddress
      +      responses:
      +        '200':
      +          description: the user's address
      +
      +

      When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

      +

      Values from the response body can be used to drive a linked operation.

      +
      
      +links:
      +  address:
      +    operationId: getUserAddressByUUID
      +    parameters:
      +      # get the `uuid` field from the `uuid` field in the response body
      +      userUuid: $response.body#/uuid
      +
      +

      Clients follow all links at their discretion. +Neither permissions, nor the capability to make a successful call to that link, is guaranteed +solely by the existence of a relationship.

      +

      OperationRef Examples

      +

      As references to operationId MAY NOT be possible (the operationId is an optional +value), references MAY also be made through a relative operationRef:

      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
      +
      +

      or an absolute operationRef:

      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
      +
      +

      Note that in the use of operationRef, the escaped forward-slash is necessary when +using JSON references.

      +

      Runtime Expressions

      +

      Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. +This mechanism is used by Link Objects and Callback Objects.

      +

      The runtime expression is defined by the following [Augmented Backus-Naur Form] syntax

      +
      
      +      expression = ( "$url" | "$method" | "$statusCode" | "$request." source | "$response." source )
      +      source = ( header-reference | query-reference | path-reference | body-reference )  
      +      header-reference = "header." token
      +      query-reference = "query." name  
      +      path-reference = "path." name
      +      body-reference = "body" ["#" fragment]
      +      fragment = a JSON Pointer [RFC 6901](https://tools.ietf.org/html/rfc6901)  
      +      name = *( char )
      +      char = as per RFC [7159](https://tools.ietf.org/html/rfc7159#section-7)
      +      token = as per RFC [7230](https://tools.ietf.org/html/rfc7230#section-3.2.6)
      +
      +

      The name identifier is case-sensitive, whereas token is not.

      +

      The table below provides examples of runtime expressions and examples of their use in a value:

      +

      Examples

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Source Locationexample expressionnotes
      HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
      Requested media type$request.header.accept
      Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
      Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
      Request URL$url
      Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
      Response header$response.header.ServerSingle header values only are available
      +

      Runtime expressions preserve the type of the referenced value. +Expressions can be embedded into string values by surrounding the expression with {} curly braces.

      +

      Header Object

      +

      The Header Object follows the structure of the Parameter Object with the following changes:

      +
        +
      1. name MUST NOT be specified, it is given in the corresponding headers map.
      2. +
      3. in MUST NOT be specified, it is implicitly in header.
      4. +
      5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
      6. +
      +

      Header Object Example

      +

      A simple header of type integer:

      +
      
      +{
      +  "description": "The number of allowed requests in the current period",
      +  "schema": {
      +    "type": "integer"
      +  }
      +}
      +
      +
      
      +description: The number of allowed requests in the current period
      +schema:
      +  type: integer
      +
      +

      Tag Object

      +

      Adds metadata to a single tag that is used by the Operation Object. +It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The name of the tag.
      descriptionstringA short description for the tag. CommonMark syntax MAY be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
      +

      This object MAY be extended with Specification Extensions.

      +

      Tag Object Example

      +
      
      +{
      +	"name": "pet",
      +	"description": "Pets operations"
      +}
      +
      +
      
      +name: pet
      +description: Pets operations
      +
      +

      Reference Object

      +

      A simple object to allow referencing other components in the specification, internally and externally.

      +

      The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

      +

      For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringREQUIRED. The reference string.
      +

      This object cannot be extended with additional properties and any properties added SHALL be ignored.

      +

      Reference Object Example

      +
      
      +{
      +	"$ref": "#/components/schemas/Pet"
      +}
      +
      +
      
      +$ref: '#/components/schemas/Pet'
      +
      +

      Relative Schema Document Example

      +
      
      +{
      +  "$ref": "Pet.json"
      +}
      +
      +
      
      +$ref: Pet.yaml
      +
      +

      Relative Documents With Embedded Schema Example

      +
      
      +{
      +  "$ref": "definitions.json#/Pet"
      +}
      +
      +
      
      +$ref: definitions.yaml#/Pet
      +
      +

      Schema Object

      +

      The Schema Object allows the definition of input and output data types. +These types can be objects, but also primitives and arrays. +This object is an extended subset of the JSON Schema Specification Wright Draft 00.

      +

      For more information about the properties, see JSON Schema Core and JSON Schema Validation. +Unless stated otherwise, the property definitions follow the JSON Schema.

      +

      Properties

      +

      The following properties are taken directly from the JSON Schema definition and follow the same specifications:

      +
        +
      • title
      • +
      • multipleOf
      • +
      • maximum
      • +
      • exclusiveMaximum
      • +
      • minimum
      • +
      • exclusiveMinimum
      • +
      • maxLength
      • +
      • minLength
      • +
      • pattern (This string SHOULD be a valid regular expression, according to the ECMA 262 regular expression dialect)
      • +
      • maxItems
      • +
      • minItems
      • +
      • uniqueItems
      • +
      • maxProperties
      • +
      • minProperties
      • +
      • required
      • +
      • enum
      • +
      +

      The following properties are taken from the JSON Schema definition but their definitions were adjusted to the OpenAPI Specification.

      +
        +
      • type - Value MUST be a string. Multiple types via an array are not supported.
      • +
      • allOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • oneOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • anyOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • not - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • items - Value MUST be an object and not an array. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. items MUST be present if the type is array.
      • +
      • properties - Property definitions MUST be a Schema Object and not a standard JSON Schema (inline or referenced).
      • +
      • additionalProperties - Value can be boolean or object. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. Consistent with JSON Schema, additionalProperties defaults to true.
      • +
      • description - CommonMark syntax MAY be used for rich text representation.
      • +
      • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
      • +
      • default - The default value represents what would be assumed by the consumer of the input as the value of the schema if one is not provided. Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object defined at the same level. For example, if type is string, then default can be "foo" but cannot be 1.
      • +
      +

      Alternatively, any time a Schema Object can be used, a Reference Object can be used in its place. This allows referencing definitions instead of defining them inline.

      +

      Additional properties defined by the JSON Schema specification that are not mentioned here are strictly unsupported.

      +

      Other than the JSON Schema subset fields, the following fields MAY be used for further schema documentation:

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      nullablebooleanAllows sending a null value for the defined schema. Default value is false.
      discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
      readOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “read only”. This means that it MAY be sent as part of a response but SHOULD NOT be sent as part of the request. If the property is marked as readOnly being true and is in the required list, the required will take effect on the response only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
      writeOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “write only”. Therefore, it MAY be sent as part of a request but SHOULD NOT be sent as part of the response. If the property is marked as writeOnly being true and is in the required list, the required will take effect on the request only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
      xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
      externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
      exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.
      deprecatedbooleanSpecifies that a schema is deprecated and SHOULD be transitioned out of usage. Default value is false.
      +

      This object MAY be extended with Specification Extensions.

      +
      Composition and Inheritance (Polymorphism)
      +

      The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. +allOf takes an array of object definitions that are validated independently but together compose a single object.

      +

      While composition offers model extensibility, it does not imply a hierarchy between the models. +To support polymorphism, the OpenAPI Specification adds the discriminator field. +When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. +As such, the discriminator field MUST be a required field. +There are two ways to define the value of a discriminator for an inheriting instance.

      +
        +
      • Use the schema name.
      • +
      • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. +As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
      • +
      +
      XML Modeling
      +

      The xml property allows extra definitions when translating the JSON definition to XML. +The XML Object contains additional information about the available options.

      +

      Schema Object Examples

      +
      Primitive Sample
      +
      
      +{
      +  "type": "string",
      +  "format": "email"
      +}
      +
      +
      
      +type: string
      +format: email
      +
      +
      Simple Model
      +
      
      +{
      +  "type": "object",
      +  "required": [
      +    "name"
      +  ],
      +  "properties": {
      +    "name": {
      +      "type": "string"
      +    },
      +    "address": {
      +      "$ref": "#/components/schemas/Address"
      +    },
      +    "age": {
      +      "type": "integer",
      +      "format": "int32",
      +      "minimum": 0
      +    }
      +  }
      +}
      +
      +
      
      +type: object
      +required:
      +- name
      +properties:
      +  name:
      +    type: string
      +  address:
      +    $ref: '#/components/schemas/Address'
      +  age:
      +    type: integer
      +    format: int32
      +    minimum: 0
      +
      +
      Model with Map/Dictionary Properties
      +

      For a simple string to string mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  type: string
      +
      +

      For a string to model mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "$ref": "#/components/schemas/ComplexModel"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  $ref: '#/components/schemas/ComplexModel'
      +
      +
      Model with Example
      +
      
      +{
      +  "type": "object",
      +  "properties": {
      +    "id": {
      +      "type": "integer",
      +      "format": "int64"
      +    },
      +    "name": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "name"
      +  ],
      +  "example": {
      +    "name": "Puma",
      +    "id": 1
      +  }
      +}
      +
      +
      
      +type: object
      +properties:
      +  id:
      +    type: integer
      +    format: int64
      +  name:
      +    type: string
      +required:
      +- name
      +example:
      +  name: Puma
      +  id: 1
      +
      +
      Models with Composition
      +
      
      +{
      +  "components": {
      +    "schemas": {
      +      "ErrorModel": {
      +        "type": "object",
      +        "required": [
      +          "message",
      +          "code"
      +        ],
      +        "properties": {
      +          "message": {
      +            "type": "string"
      +          },
      +          "code": {
      +            "type": "integer",
      +            "minimum": 100,
      +            "maximum": 600
      +          }
      +        }
      +      },
      +      "ExtendedErrorModel": {
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/ErrorModel"
      +          },
      +          {
      +            "type": "object",
      +            "required": [
      +              "rootCause"
      +            ],
      +            "properties": {
      +              "rootCause": {
      +                "type": "string"
      +              }
      +            }
      +          }
      +        ]
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    ErrorModel:
      +      type: object
      +      required:
      +      - message
      +      - code
      +      properties:
      +        message:
      +          type: string
      +        code:
      +          type: integer
      +          minimum: 100
      +          maximum: 600
      +    ExtendedErrorModel:
      +      allOf:
      +      - $ref: '#/components/schemas/ErrorModel'
      +      - type: object
      +        required:
      +        - rootCause
      +        properties:
      +          rootCause:
      +            type: string
      +
      +
      Models with Polymorphism Support
      +
      
      +{
      +  "components": {
      +    "schemas": {
      +      "Pet": {
      +        "type": "object",
      +        "discriminator": {
      +          "propertyName": "petType"
      +        },
      +        "properties": {
      +          "name": {
      +            "type": "string"
      +          },
      +          "petType": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "petType"
      +        ]
      +      },
      +      "Cat": {
      +        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/Pet"
      +          },
      +          {
      +            "type": "object",
      +            "properties": {
      +              "huntingSkill": {
      +                "type": "string",
      +                "description": "The measured skill for hunting",
      +                "default": "lazy",
      +                "enum": [
      +                  "clueless",
      +                  "lazy",
      +                  "adventurous",
      +                  "aggressive"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "huntingSkill"
      +            ]
      +          }
      +        ]
      +      },
      +      "Dog": {
      +        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/Pet"
      +          },
      +          {
      +            "type": "object",
      +            "properties": {
      +              "packSize": {
      +                "type": "integer",
      +                "format": "int32",
      +                "description": "the size of the pack the dog is from",
      +                "default": 0,
      +                "minimum": 0
      +              }
      +            },
      +            "required": [
      +              "packSize"
      +            ]
      +          }
      +        ]
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    Pet:
      +      type: object
      +      discriminator:
      +        propertyName: petType
      +      properties:
      +        name:
      +          type: string
      +        petType:
      +          type: string
      +      required:
      +      - name
      +      - petType
      +    Cat:  ## "Cat" will be used as the discriminator value
      +      description: A representation of a cat
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          huntingSkill:
      +            type: string
      +            description: The measured skill for hunting
      +            enum:
      +            - clueless
      +            - lazy
      +            - adventurous
      +            - aggressive
      +        required:
      +        - huntingSkill
      +    Dog:  ## "Dog" will be used as the discriminator value
      +      description: A representation of a dog
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          packSize:
      +            type: integer
      +            format: int32
      +            description: the size of the pack the dog is from
      +            default: 0
      +            minimum: 0
      +        required:
      +        - packSize
      +
      +

      Discriminator Object

      +

      When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

      +

      When using the discriminator, inline schemas will not be considered.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
      mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
      +

      The discriminator object is legal only when using one of the composite keywords oneOf, anyOf, allOf.

      +

      In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +
      +

      which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +  discriminator:
      +    propertyName: petType
      +
      +

      The expectation now is that a property with name petType MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

      +
      
      +{
      +  "id": 12345,
      +  "petType": "Cat"
      +}
      +
      +

      Will indicate that the Cat schema be used in conjunction with this payload.

      +

      In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +  discriminator:
      +    propertyName: petType
      +    mapping:
      +      dog: '#/components/schemas/Dog'
      +      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +
      +

      Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

      +

      When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

      +

      In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

      +

      For example:

      +
      
      +components:
      +  schemas:
      +    Pet:
      +      type: object
      +      required:
      +      - petType
      +      properties:
      +        petType:
      +          type: string
      +      discriminator:
      +        propertyName: petType
      +        mapping:
      +          dog: Dog
      +    Cat:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Cat`
      +        properties:
      +          name:
      +            type: string
      +    Dog:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Dog`
      +        properties:
      +          bark:
      +            type: string
      +    Lizard:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Lizard`
      +        properties:
      +          lovesRocks:
      +            type: boolean
      +
      +

      a payload like this:

      +
      
      +{
      +  "petType": "Cat",
      +  "name": "misty"
      +}
      +
      +

      will indicate that the Cat schema be used. Likewise this schema:

      +
      
      +{
      +  "petType": "dog",
      +  "bark": "soft"
      +}
      +
      +

      will map to Dog because of the definition in the mappings element.

      +

      XML Object

      +

      A metadata object that allows for more fine-tuned XML model definitions.

      +

      When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. +See examples for expected behavior.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
      namespacestringThe URI of the namespace definition. Value MUST be in the form of an absolute URI.
      prefixstringThe prefix to be used for the name.
      attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
      wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
      +

      This object MAY be extended with Specification Extensions.

      +

      XML Object Examples

      +

      The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

      +
      No XML Element
      +

      Basic string property:

      +
      
      +{
      +    "animals": {
      +        "type": "string"
      +    }
      +}
      +
      +
      
      +animals:
      +  type: string
      +
      +
      
      +<animals>...</animals>
      +
      +

      Basic string array property (wrapped is false by default):

      +
      
      +{
      +    "animals": {
      +        "type": "array",
      +        "items": {
      +            "type": "string"
      +        }
      +    }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +
      +
      
      +<animals>...</animals>
      +<animals>...</animals>
      +<animals>...</animals>
      +
      +
      XML Name Replacement
      +
      
      +{
      +  "animals": {
      +    "type": "string",
      +    "xml": {
      +      "name": "animal"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: string
      +  xml:
      +    name: animal
      +
      +
      
      +<animal>...</animal>
      +
      +
      XML Attribute, Prefix and Namespace
      +

      In this example, a full model definition is shown.

      +
      
      +{
      +  "Person": {
      +    "type": "object",
      +    "properties": {
      +      "id": {
      +        "type": "integer",
      +        "format": "int32",
      +        "xml": {
      +          "attribute": true
      +        }
      +      },
      +      "name": {
      +        "type": "string",
      +        "xml": {
      +          "namespace": "http://example.com/schema/sample",
      +          "prefix": "sample"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +Person:
      +  type: object
      +  properties:
      +    id:
      +      type: integer
      +      format: int32
      +      xml:
      +        attribute: true
      +    name:
      +      type: string
      +      xml:
      +        namespace: http://example.com/schema/sample
      +        prefix: sample
      +
      +
      
      +<Person id="123">
      +    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
      +</Person>
      +
      +
      XML Arrays
      +

      Changing the element names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      The external name property has no effect on the XML:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animals>value</animals>
      +  <animals>value</animals>
      +</animals>
      +
      +

      To overcome the naming problem in the example above, the following definition can be used:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</animals>
      +
      +

      Affecting both internal and external names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</aliens>
      +
      +

      If we change the external element but not the internal ones:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <aliens>value</aliens>
      +  <aliens>value</aliens>
      +</aliens>
      +
      +

      Security Scheme Object

      +

      Defines a security scheme that can be used by the operations. +Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeApplies ToDescription
      typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "oauth2", "openIdConnect".
      descriptionstringAnyA short description for security scheme. CommonMark syntax MAY be used for rich text representation.
      namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
      instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
      schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]].
      bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
      flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
      openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      Security Scheme Object Example

      +
      Basic Authentication Sample
      +
      
      +{
      +  "type": "http",
      +  "scheme": "basic"
      +}
      +
      +
      
      +type: http
      +scheme: basic
      +
      +
      API Key Sample
      +
      
      +{
      +  "type": "apiKey",
      +  "name": "api_key",
      +  "in": "header"
      +}
      +
      +
      
      +type: apiKey
      +name: api_key
      +in: header
      +
      +
      JWT Bearer Sample
      +
      
      +{
      +  "type": "http",
      +  "scheme": "bearer",
      +  "bearerFormat": "JWT",
      +}
      +
      +
      
      +type: http
      +scheme: bearer
      +bearerFormat: JWT
      +
      +
      Implicit OAuth2 Sample
      +
      
      +{
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
      +
      +

      OAuth Flows Object

      +

      Allows configuration of the supported OAuth Flows.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
      passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
      clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
      authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
      +

      This object MAY be extended with Specification Extensions.

      +

      OAuth Flow Object

      +

      Configuration details for a supported OAuth Flow

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeApplies ToDescription
      authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL.
      tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL.
      refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL.
      scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it.
      +

      This object MAY be extended with Specification Extensions.

      +

      OAuth Flow Object Examples

      +
      
      +{
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    },
      +    "authorizationCode": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "tokenUrl": "https://example.com/api/oauth/token",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
      +  authorizationCode:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    tokenUrl: https://example.com/api/oauth/token
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets 
      +
      +

      Security Requirement Object

      +

      Lists the required security schemes to execute this operation. +The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

      +

      Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. +This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

      +

      When a list of Security Requirement Objects is defined on the OpenAPI Object or Operation Object, only one of the Security Requirement Objects in the list needs to be satisfied to authorize the request.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution. For other security scheme types, the array MUST be empty.
      +

      Security Requirement Object Examples

      +
      Non-OAuth2 Security Requirement
      +
      
      +{
      +  "api_key": []
      +}
      +
      +
      
      +api_key: []
      +
      +
      OAuth2 Security Requirement
      +
      
      +{
      +  "petstore_auth": [
      +    "write:pets",
      +    "read:pets"
      +  ]
      +}
      +
      +
      
      +petstore_auth:
      +- write:pets
      +- read:pets
      +
      +

      Specification Extensions

      +

      While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

      +

      The extensions properties are implemented as patterned fields that are always prefixed by "x-".

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. Can have any valid JSON format value.
      +

      The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

      +

      Security Filtering

      +

      Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

      +

      The reasoning is to allow an additional layer of access control over the documentation. +While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

      +

      Two examples of this:

      +
        +
      1. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
      2. +
      3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the Paths Object, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
      4. +
      +

      Appendix A: Revision History

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      VersionDateNotes
      3.0.22018-10-08Patch release of the OpenAPI Specification 3.0.2
      3.0.12017-12-06Patch release of the OpenAPI Specification 3.0.1
      3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
      3.0.0-rc22017-06-16rc2 of the 3.0 specification
      3.0.0-rc12017-04-27rc1 of the 3.0 specification
      3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
      2.02015-12-31Donation of Swagger 2.0 to the Open API Initiative
      2.02014-09-08Release of Swagger 2.0
      1.22014-03-14Initial release of the formal document.
      1.12012-08-22Release of Swagger 1.1
      1.02011-08-10First release of the Swagger Specification
      + From 523ad5747c7be6e523bef8768fa13a8a37044ea0 Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Mon, 14 Jan 2019 07:43:11 +0000 Subject: [PATCH 008/152] Hand-craft API templates for leaner output --- api/alternative-schema.json | 12 ++++++++++-- api/draft-feature.json | 12 ++++++++++-- api/extension.json | 14 ++++++++++++-- api/format.json | 13 +++++++++++-- api/registries.json | 6 ++++-- registries/_alternative-schema/jsonSchema.md | 2 +- registries/_alternative-schema/xmlSchema.md | 2 +- registries/_draft-feature/alternativeSchema.md | 2 +- registries/_extension/x-twitter.md | 5 +---- registries/_format/commonmark.md | 5 +++-- registries/_format/html.md | 4 +++- registries/_format/int8.md | 3 ++- registries/_format/uint8.md | 3 ++- 13 files changed, 61 insertions(+), 22 deletions(-) diff --git a/api/alternative-schema.json b/api/alternative-schema.json index 54df82dfd5..813043a66a 100644 --- a/api/alternative-schema.json +++ b/api/alternative-schema.json @@ -1,4 +1,12 @@ --- --- -{{ site.alternative-schema | jsonify }} - +{ +{% for page in site.alternative-schema %}"{{ page.slug }}": { + "slug": "{{ page.slug }}", + "title": "{{ page.title }}", + "issue": "{{ page.issue }}", + "description": "{{ page.description }}", + "owner": "{{ page.owner }}" +}{% unless forloop.last %},{% endunless %} +{% endfor %} +} diff --git a/api/draft-feature.json b/api/draft-feature.json index 7663a1fb4c..7ee771d60e 100644 --- a/api/draft-feature.json +++ b/api/draft-feature.json @@ -1,4 +1,12 @@ --- --- -{{ site.draft-feature | jsonify }} - +{ +{% for page in site.draft-feature %}"{{ page.slug }}": { + "slug": "{{ page.slug }}", + "title": "{{ page.title }}", + "issue": "{{ page.issue }}", + "description": "{{ page.description }}", + "owner": "{{ page.owner }}" +}{% unless forloop.last %},{% endunless %} +{% endfor %} +} diff --git a/api/extension.json b/api/extension.json index 54cd4ae033..45b948fdc2 100644 --- a/api/extension.json +++ b/api/extension.json @@ -1,4 +1,14 @@ --- --- -{{ site.extension | jsonify }} - +{ +{% for page in site.extension %}"{{ page.slug }}": { + "slug": "{{ page.slug }}", + "title": "{{ page.title }}", + "issue": "{{ page.issue }}", + "description": "{{ page.description }}", + "owner": "{{ page.owner }}", + "objects": {{ page.objects | jsonify }}, + "schema": {{ page.schema | jsonify }} +}{% unless forloop.last %},{% endunless %} +{% endfor %} +} diff --git a/api/format.json b/api/format.json index 693d349cdc..3f57f3ae6f 100644 --- a/api/format.json +++ b/api/format.json @@ -1,4 +1,13 @@ --- --- -{{ site.format | jsonify }} - +{ +{% for page in site.format %}"{{ page.slug }}": { + "slug": "{{ page.slug }}", + "title": "{{ page.title }}", + "issue": "{{ page.issue }}", + "description": "{{ page.description }}", + "owner": "{{ page.owner }}", + "base_type": "{{ page.base_type" }}" +}{% unless forloop.last %},{% endunless %} +{% endfor %} +} diff --git a/api/registries.json b/api/registries.json index 9507cb0c20..aae5e7149c 100644 --- a/api/registries.json +++ b/api/registries.json @@ -1,4 +1,6 @@ --- --- -{{ site.collections | jsonify }} - +[ +{% for collection in site.collections %}"{{ collection.slug }}"{% unless forloop.last %},{% endunless %} +{% endfor %} +] diff --git a/registries/_alternative-schema/jsonSchema.md b/registries/_alternative-schema/jsonSchema.md index 4858d359d9..6f49ba65f2 100644 --- a/registries/_alternative-schema/jsonSchema.md +++ b/registries/_alternative-schema/jsonSchema.md @@ -1,5 +1,5 @@ --- -owner: darrel_miller +owner: darrelmiller issue: 1532 description: JSON Schema layout: default diff --git a/registries/_alternative-schema/xmlSchema.md b/registries/_alternative-schema/xmlSchema.md index 278585d6d8..f8da45a5e0 100644 --- a/registries/_alternative-schema/xmlSchema.md +++ b/registries/_alternative-schema/xmlSchema.md @@ -1,5 +1,5 @@ --- -owner: darrel_miller +owner: darrelmiller issue: 1532 description: xml Schema layout: default diff --git a/registries/_draft-feature/alternativeSchema.md b/registries/_draft-feature/alternativeSchema.md index 12e3681793..01147f2b40 100644 --- a/registries/_draft-feature/alternativeSchema.md +++ b/registries/_draft-feature/alternativeSchema.md @@ -1,5 +1,5 @@ --- -owner: darrel_miller +owner: darrelmiller issue: 1532 description: x-oas-draft-alternativeSchema diff --git a/registries/_extension/x-twitter.md b/registries/_extension/x-twitter.md index 46ae0c186e..0b05ec9910 100644 --- a/registries/_extension/x-twitter.md +++ b/registries/_extension/x-twitter.md @@ -1,13 +1,10 @@ --- -slug: x-twitter -name: x-twitter -owner: mike_ralphson +owner: MikeRalphson issue: description: Used to hold a reference to the API provider's Twitter account. schema: type: string objects: [ "contactObject" ] - layout: default --- diff --git a/registries/_format/commonmark.md b/registries/_format/commonmark.md index eae36a490e..959b597e2a 100644 --- a/registries/_format/commonmark.md +++ b/registries/_format/commonmark.md @@ -1,7 +1,8 @@ --- -slug: commonmark owner: MikeRalphson description: commonmark-formatted text +base_type: string +issue: layout: default --- @@ -9,7 +10,7 @@ layout: default ## {{ page.slug }} - {{ page.description }} -Base type: `string`. +Base type: `{{ page.base_type }}`. The `{{page.slug}}` format represents [CommonMark](https://commonmark.org/) formatted text. diff --git a/registries/_format/html.md b/registries/_format/html.md index 354de85eb6..49b89db7b0 100644 --- a/registries/_format/html.md +++ b/registries/_format/html.md @@ -1,6 +1,8 @@ --- owner: MikeRalphson description: HTML-formatted text +base_type: string +issue: layout: default --- @@ -8,7 +10,7 @@ layout: default ## {{ page.slug }} - {{ page.description }} -Base type: `string`. +Base type: `{{ page.base_type}}`. The `{{page.slug}}` format represents HTML-formatted text. diff --git a/registries/_format/int8.md b/registries/_format/int8.md index 9c76166894..38524e7a7b 100644 --- a/registries/_format/int8.md +++ b/registries/_format/int8.md @@ -2,6 +2,7 @@ owner: MikeRalphson issue: 845 description: signed 8-bit integer +base_type: number layout: default --- @@ -9,7 +10,7 @@ layout: default ## {{ page.slug }} - {{ page.description }} -Base type: `number`. +Base type: `{{ page.base_type }}`. The `{{page.slug}}` format represents a signed 8-bit integer, with the range -128 to 127. diff --git a/registries/_format/uint8.md b/registries/_format/uint8.md index 9474479519..e9919ab03c 100644 --- a/registries/_format/uint8.md +++ b/registries/_format/uint8.md @@ -2,6 +2,7 @@ owner: MikeRalphson issue: 845 description: unsigned 8-bit integer +base_type: number layout: default --- @@ -9,7 +10,7 @@ layout: default ## {{ page.slug }} - {{ page.description }} -Base type: `number`. +Base type: `{{ page.base_type }}`. The `{{page.slug}}` format represents an unsigned 8-bit integer, with the range 0 to 255. From b24e2fd281a997efdb940879a3d58716dfccab7a Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Fri, 21 Feb 2020 14:41:18 +0000 Subject: [PATCH 009/152] gh-pages: add v3.0.3.html (#2151) --- index.md | 2 +- oas/v3.0.3.html | 4088 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 4089 insertions(+), 1 deletion(-) create mode 100644 oas/v3.0.3.html diff --git a/index.md b/index.md index 5fc131da89..4a80db926e 100644 --- a/index.md +++ b/index.md @@ -13,4 +13,4 @@ This site contains the OpenAPI Initiative Registry and content for the HTML vers ## The Specification * [Markdown source-of-truth](https://github.com/OAI/OpenAPI-Specification) -* [HTML Specification versions](https://openapis.org/specification) +* [HTML Specification version](oas/v3.0.3.html) diff --git a/oas/v3.0.3.html b/oas/v3.0.3.html new file mode 100644 index 0000000000..42a69bce68 --- /dev/null +++ b/oas/v3.0.3.html @@ -0,0 +1,4088 @@ +OpenAPI Specification
      The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

      Status of This Document

      The source-of-truth for the specification is the GitHub markdown file referenced above.
      +

      OpenAPI Specification

      +

      Version 3.0.3

      +

      The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

      +

      This document is licensed under The Apache License, Version 2.0.

      +

      Introduction

      +

      The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

      +

      An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

      + +

      Definitions

      +

      OpenAPI Document

      +

      A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

      +

      Path Templating

      +

      Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.

      +

      Each template expression in the path MUST correspond to a path parameter that is included in the Path Item itself and/or in each of the Path Item’s Operations.

      +

      Media Types

      +

      Media type definitions are spread across several resources. +The media type definitions SHOULD be in compliance with [[!RFC6838]].

      +

      Some examples of possible media type definitions:

      +
      
      +  text/plain; charset=utf-8
      +  application/json
      +  application/vnd.github+json
      +  application/vnd.github.v3+json
      +  application/vnd.github.v3.raw+json
      +  application/vnd.github.v3.text+json
      +  application/vnd.github.v3.html+json
      +  application/vnd.github.v3.full+json
      +  application/vnd.github.v3.diff
      +  application/vnd.github.v3.patch
      +
      +

      HTTP Status Codes

      +

      The HTTP Status Codes are used to indicate the status of the executed operation. +The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

      +

      Specification

      +

      Versions

      +

      The OpenAPI Specification is versioned using Semantic Versioning 2.0.0 (semver) and follows the semver specification.

      +

      The major.minor portion of the semver (for example 3.0) SHALL designate the OAS feature set. Typically, .patch versions address errors in this document, not the feature set. Tooling which supports OAS 3.0 SHOULD be compatible with all OAS 3.0.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.0.0 and 3.0.1 for example.

      +

      Each new minor version of the OpenAPI Specification SHALL allow any OpenAPI document that is valid against any previous minor version of the Specification, within the same major version, to be updated to the new Specification version with equivalent semantics. Such an update MUST only require changing the openapi property to the new minor version.

      +

      For example, a valid OpenAPI 3.0.2 document, upon changing its openapi property to 3.1.0, SHALL be a valid OpenAPI 3.1.0 document, semantically equivalent to the original OpenAPI 3.0.2 document. New minor versions of the OpenAPI Specification MUST be written to ensure this form of backward compatibility.

      +

      An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the semantic version of the OAS that it uses. (OAS 2.0 documents contain a top-level version field named swagger and value "2.0".)

      +

      Format

      +

      An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

      +

      For example, if a field has an array value, the JSON array representation will be used:

      +
      
      +{
      +   "field": [ 1, 2, 3 ]
      +}
      +
      +

      All field names in the specification are case sensitive. +This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

      +

      The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

      +

      Patterned fields MUST have unique names within the containing object.

      +

      In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

      + +

      Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

      +

      Document Structure

      +

      An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

      +

      It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

      +

      Data Types

      +

      Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. +Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. +null is not supported as a type (see nullable for an alternative solution). +Models are defined using the Schema Object, which is an extended subset of JSON Schema Specification Wright Draft 00.

      +

      Primitives have an optional modifier property: format. +OAS uses several known formats to define in fine detail the data type being used. +However, to support documentation needs, the format property is an open string-valued property, and can have any value. +Formats such as "email", "uuid", and so on, MAY be used even though undefined by this specification. +Types that are not accompanied by a format property follow the type definition in the JSON Schema. Tools that do not recognize a specific format MAY default back to the type alone, as if the format is not specified.

      +

      The formats defined by the OAS are:

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      typeformatComments
      integerint32signed 32 bits
      integerint64signed 64 bits (a.k.a long)
      numberfloat
      numberdouble
      string
      stringbytebase64 encoded characters
      stringbinaryany sequence of octets
      boolean
      stringdateAs defined by full-date - [[!RFC3339]]
      stringdate-timeAs defined by date-time - [[!RFC3339]]
      stringpasswordA hint to UIs to obscure input.
      +

      Rich Text Formatting

      +

      Throughout the specification description fields are noted as supporting CommonMark markdown formatting. +Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

      +

      Relative References in URLs

      +

      Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. +Relative references are resolved using the URLs defined in the Server Object as a Base URI.

      +

      Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

      +

      Schema

      +

      In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

      +

      OpenAPI Object

      +

      This is the root document object of the OpenAPI document.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      openapistringREQUIRED. This string MUST be the semantic version number of the OpenAPI Specification version that the OpenAPI document uses. The openapi field SHOULD be used by tooling specifications and clients to interpret the OpenAPI document. This is not related to the API info.version string.
      infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
      servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
      pathsPaths ObjectREQUIRED. The available paths and operations for the API.
      componentsComponents ObjectAn element to hold various schemas for the specification.
      security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition. To make security optional, an empty security requirement ({}) can be included in the array.
      tags[Tag Object]A list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
      externalDocsExternal Documentation ObjectAdditional external documentation.
      +

      This object MAY be extended with Specification Extensions.

      +

      Info Object

      +

      The object provides metadata about the API. +The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      titlestringREQUIRED. The title of the API.
      descriptionstringA short description of the API. CommonMark syntax MAY be used for rich text representation.
      termsOfServicestringA URL to the Terms of Service for the API. MUST be in the format of a URL.
      contactContact ObjectThe contact information for the exposed API.
      licenseLicense ObjectThe license information for the exposed API.
      versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
      +

      This object MAY be extended with Specification Extensions.

      +

      Info Object Example

      +
      
      +{
      +  "title": "Sample Pet Store App",
      +  "description": "This is a sample server for a pet store.",
      +  "termsOfService": "http://example.com/terms/",
      +  "contact": {
      +    "name": "API Support",
      +    "url": "http://www.example.com/support",
      +    "email": "support@example.com"
      +  },
      +  "license": {
      +    "name": "Apache 2.0",
      +    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
      +  },
      +  "version": "1.0.1"
      +}
      +
      +
      
      +title: Sample Pet Store App
      +description: This is a sample server for a pet store.
      +termsOfService: http://example.com/terms/
      +contact:
      +  name: API Support
      +  url: http://www.example.com/support
      +  email: support@example.com
      +license:
      +  name: Apache 2.0
      +  url: https://www.apache.org/licenses/LICENSE-2.0.html
      +version: 1.0.1
      +
      +

      Contact Object

      +

      Contact information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringThe identifying name of the contact person/organization.
      urlstringThe URL pointing to the contact information. MUST be in the format of a URL.
      emailstringThe email address of the contact person/organization. MUST be in the format of an email address.
      +

      This object MAY be extended with Specification Extensions.

      +

      Contact Object Example

      +
      
      +{
      +  "name": "API Support",
      +  "url": "http://www.example.com/support",
      +  "email": "support@example.com"
      +}
      +
      +
      
      +name: API Support
      +url: http://www.example.com/support
      +email: support@example.com
      +
      +

      License Object

      +

      License information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The license name used for the API.
      urlstringA URL to the license used for the API. MUST be in the format of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      License Object Example

      +
      
      +{
      +  "name": "Apache 2.0",
      +  "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
      +}
      +
      +
      
      +name: Apache 2.0
      +url: https://www.apache.org/licenses/LICENSE-2.0.html
      +
      +

      Server Object

      +

      An object representing a Server.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
      descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
      variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
      +

      This object MAY be extended with Specification Extensions.

      +

      Server Object Example

      +

      A single server would be described as:

      +
      
      +{
      +  "url": "https://development.gigantic-server.com/v1",
      +  "description": "Development server"
      +}
      +
      +
      
      +url: https://development.gigantic-server.com/v1
      +description: Development server
      +
      +

      The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

      +
      
      +{
      +  "servers": [
      +    {
      +      "url": "https://development.gigantic-server.com/v1",
      +      "description": "Development server"
      +    },
      +    {
      +      "url": "https://staging.gigantic-server.com/v1",
      +      "description": "Staging server"
      +    },
      +    {
      +      "url": "https://api.gigantic-server.com/v1",
      +      "description": "Production server"
      +    }
      +  ]
      +}
      +
      +
      
      +servers:
      +- url: https://development.gigantic-server.com/v1
      +  description: Development server
      +- url: https://staging.gigantic-server.com/v1
      +  description: Staging server
      +- url: https://api.gigantic-server.com/v1
      +  description: Production server
      +
      +

      The following shows how variables can be used for a server configuration:

      +
      
      +{
      +  "servers": [
      +    {
      +      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
      +      "description": "The production API server",
      +      "variables": {
      +        "username": {
      +          "default": "demo",
      +          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
      +        },
      +        "port": {
      +          "enum": [
      +            "8443",
      +            "443"
      +          ],
      +          "default": "8443"
      +        },
      +        "basePath": {
      +          "default": "v2"
      +        }
      +      }
      +    }
      +  ]
      +}
      +
      +
      
      +servers:
      +- url: https://{username}.gigantic-server.com:{port}/{basePath}
      +  description: The production API server
      +  variables:
      +    username:
      +      # note! no enum here means it is an open value
      +      default: demo
      +      description: this value is assigned by the service provider, in this example `gigantic-server.com`
      +    port:
      +      enum:
      +        - '8443'
      +        - '443'
      +      default: '8443'
      +    basePath:
      +      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
      +      default: v2
      +
      +

      Server Variable Object

      +

      An object representing a Server Variable for server URL template substitution.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      enum[string]An enumeration of string values to be used if the substitution options are from a limited set. The array SHOULD NOT be empty.
      defaultstringREQUIRED. The default value to use for substitution, which SHALL be sent if an alternate value is not supplied. Note this behavior is different than the Schema Object’s treatment of default values, because in those cases parameter values are optional. If the enum is defined, the value SHOULD exist in the enum’s values.
      descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
      +

      This object MAY be extended with Specification Extensions.

      +

      Components Object

      +

      Holds a set of reusable objects for different aspects of the OAS. +All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      schemasMap[string, Schema Object ¦ Reference Object]An object to hold reusable Schema Objects.
      responsesMap[string, Response Object ¦ Reference Object]An object to hold reusable Response Objects.
      parametersMap[string, Parameter Object ¦ Reference Object]An object to hold reusable Parameter Objects.
      examplesMap[string, Example Object ¦ Reference Object]An object to hold reusable Example Objects.
      requestBodiesMap[string, Request Body Object ¦ Reference Object]An object to hold reusable Request Body Objects.
      headersMap[string, Header Object ¦ Reference Object]An object to hold reusable Header Objects.
      securitySchemesMap[string, Security Scheme Object ¦ Reference Object]An object to hold reusable Security Scheme Objects.
      linksMap[string, Link Object ¦ Reference Object]An object to hold reusable Link Objects.
      callbacksMap[string, Callback Object ¦ Reference Object]An object to hold reusable Callback Objects.
      +

      This object MAY be extended with Specification Extensions.

      +

      All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

      +

      Field Name Examples:

      +
      
      +User
      +User_1
      +User_Name
      +user-name
      +my.org.User
      +
      +

      Components Object Example

      +
      
      +"components": {
      +  "schemas": {
      +    "GeneralError": {
      +      "type": "object",
      +      "properties": {
      +        "code": {
      +          "type": "integer",
      +          "format": "int32"
      +        },
      +        "message": {
      +          "type": "string"
      +        }
      +      }
      +    },
      +    "Category": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      }
      +    },
      +    "Tag": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      }
      +    }
      +  },
      +  "parameters": {
      +    "skipParam": {
      +      "name": "skip",
      +      "in": "query",
      +      "description": "number of items to skip",
      +      "required": true,
      +      "schema": {
      +        "type": "integer",
      +        "format": "int32"
      +      }
      +    },
      +    "limitParam": {
      +      "name": "limit",
      +      "in": "query",
      +      "description": "max records to return",
      +      "required": true,
      +      "schema" : {
      +        "type": "integer",
      +        "format": "int32"
      +      }
      +    }
      +  },
      +  "responses": {
      +    "NotFound": {
      +      "description": "Entity not found."
      +    },
      +    "IllegalInput": {
      +      "description": "Illegal input for operation."
      +    },
      +    "GeneralError": {
      +      "description": "General Error",
      +      "content": {
      +        "application/json": {
      +          "schema": {
      +            "$ref": "#/components/schemas/GeneralError"
      +          }
      +        }
      +      }
      +    }
      +  },
      +  "securitySchemes": {
      +    "api_key": {
      +      "type": "apiKey",
      +      "name": "api_key",
      +      "in": "header"
      +    },
      +    "petstore_auth": {
      +      "type": "oauth2",
      +      "flows": {
      +        "implicit": {
      +          "authorizationUrl": "http://example.org/api/oauth/dialog",
      +          "scopes": {
      +            "write:pets": "modify pets in your account",
      +            "read:pets": "read your pets"
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    GeneralError:
      +      type: object
      +      properties:
      +        code:
      +          type: integer
      +          format: int32
      +        message:
      +          type: string
      +    Category:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +    Tag:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +  parameters:
      +    skipParam:
      +      name: skip
      +      in: query
      +      description: number of items to skip
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +    limitParam:
      +      name: limit
      +      in: query
      +      description: max records to return
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +  responses:
      +    NotFound:
      +      description: Entity not found.
      +    IllegalInput:
      +      description: Illegal input for operation.
      +    GeneralError:
      +      description: General Error
      +      content:
      +        application/json:
      +          schema:
      +            $ref: '#/components/schemas/GeneralError'
      +  securitySchemes:
      +    api_key:
      +      type: apiKey
      +      name: api_key
      +      in: header
      +    petstore_auth:
      +      type: oauth2
      +      flows: 
      +        implicit:
      +          authorizationUrl: http://example.org/api/oauth/dialog
      +          scopes:
      +            write:pets: modify pets in your account
      +            read:pets: read your pets
      +
      +

      Paths Object

      +

      Holds the relative paths to the individual endpoints and their operations. +The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a forward slash (/). The path is appended (no relative URL resolution) to the expanded URL from the Server Object's url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
      +

      This object MAY be extended with Specification Extensions.

      +

      Path Templating Matching

      +

      Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

      +
      
      +  /pets/{petId}
      +  /pets/mine
      +
      +

      The following paths are considered identical and invalid:

      +
      
      +  /pets/{petId}
      +  /pets/{name}
      +
      +

      The following may lead to ambiguous resolution:

      +
      
      +  /{entity}/me
      +  /books/{id}
      +
      +

      Paths Object Example

      +
      
      +{
      +  "/pets": {
      +    "get": {
      +      "description": "Returns all pets from the system that the user has access to",
      +      "responses": {
      +        "200": {          
      +          "description": "A list of pets.",
      +          "content": {
      +            "application/json": {
      +              "schema": {
      +                "type": "array",
      +                "items": {
      +                  "$ref": "#/components/schemas/pet"
      +                }
      +              }
      +            }
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +/pets:
      +  get:
      +    description: Returns all pets from the system that the user has access to
      +    responses:
      +      '200':
      +        description: A list of pets.
      +        content:
      +          application/json:
      +            schema:
      +              type: array
      +              items:
      +                $ref: '#/components/schemas/pet'
      +
      +

      Path Item Object

      +

      Describes the operations available on a single path. +A Path Item MAY be empty, due to ACL constraints. +The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringAllows for an external definition of this path item. The referenced structure MUST be in the format of a Path Item Object. In case a Path Item Object field appears both in the defined object and the referenced object, the behavior is undefined.
      summarystringAn optional, string summary, intended to apply to all operations in this path.
      descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
      getOperation ObjectA definition of a GET operation on this path.
      putOperation ObjectA definition of a PUT operation on this path.
      postOperation ObjectA definition of a POST operation on this path.
      deleteOperation ObjectA definition of a DELETE operation on this path.
      optionsOperation ObjectA definition of a OPTIONS operation on this path.
      headOperation ObjectA definition of a HEAD operation on this path.
      patchOperation ObjectA definition of a PATCH operation on this path.
      traceOperation ObjectA definition of a TRACE operation on this path.
      servers[Server Object]An alternative server array to service all operations in this path.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      +

      This object MAY be extended with Specification Extensions.

      +

      Path Item Object Example

      +
      
      +{
      +  "get": {
      +    "description": "Returns pets based on ID",
      +    "summary": "Find pets by ID",
      +    "operationId": "getPetsById",
      +    "responses": {
      +      "200": {
      +        "description": "pet response",
      +        "content": {
      +          "*/*": {
      +            "schema": {
      +              "type": "array",
      +              "items": {
      +                "$ref": "#/components/schemas/Pet"
      +              }
      +            }
      +          }
      +        }
      +      },
      +      "default": {
      +        "description": "error payload",
      +        "content": {
      +          "text/html": {
      +            "schema": {
      +              "$ref": "#/components/schemas/ErrorModel"
      +            }
      +          }
      +        }
      +      }
      +    }
      +  },
      +  "parameters": [
      +    {
      +      "name": "id",
      +      "in": "path",
      +      "description": "ID of pet to use",
      +      "required": true,
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
      +        }
      +      },
      +      "style": "simple"
      +    }
      +  ]
      +}
      +
      +
      
      +get:
      +  description: Returns pets based on ID
      +  summary: Find pets by ID
      +  operationId: getPetsById
      +  responses:
      +    '200':
      +      description: pet response
      +      content:
      +        '*/*' :
      +          schema:
      +            type: array
      +            items:
      +              $ref: '#/components/schemas/Pet'
      +    default:
      +      description: error payload
      +      content:
      +        'text/html':
      +          schema:
      +            $ref: '#/components/schemas/ErrorModel'
      +parameters:
      +- name: id
      +  in: path
      +  description: ID of pet to use
      +  required: true
      +  schema:
      +    type: array
      +    items:
      +      type: string  
      +  style: simple
      +
      +

      Operation Object

      +

      Describes a single API operation on a path.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
      summarystringA short summary of what the operation does.
      descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
      operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. The operationId value is case-sensitive. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      requestBodyRequest Body Object ¦ Reference ObjectThe request body applicable for this operation. The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers.
      responsesResponses ObjectREQUIRED. The list of possible responses as they are returned from executing this operation.
      callbacksMap[string, Callback Object ¦ Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses.
      deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
      security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. To make security optional, an empty security requirement ({}) can be included in the array. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
      servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
      +

      This object MAY be extended with Specification Extensions.

      +

      Operation Object Example

      +
      
      +{
      +  "tags": [
      +    "pet"
      +  ],
      +  "summary": "Updates a pet in the store with form data",
      +  "operationId": "updatePetWithForm",
      +  "parameters": [
      +    {
      +      "name": "petId",
      +      "in": "path",
      +      "description": "ID of pet that needs to be updated",
      +      "required": true,
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  ],
      +  "requestBody": {
      +    "content": {
      +      "application/x-www-form-urlencoded": {
      +        "schema": {
      +          "type": "object",
      +          "properties": {
      +            "name": { 
      +              "description": "Updated name of the pet",
      +              "type": "string"
      +            },
      +            "status": {
      +              "description": "Updated status of the pet",
      +              "type": "string"
      +            }
      +          },
      +          "required": ["status"] 
      +        }
      +      }
      +    }
      +  },
      +  "responses": {
      +    "200": {
      +      "description": "Pet updated.",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
      +      }
      +    },
      +    "405": {
      +      "description": "Method Not Allowed",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
      +      }
      +    }
      +  },
      +  "security": [
      +    {
      +      "petstore_auth": [
      +        "write:pets",
      +        "read:pets"
      +      ]
      +    }
      +  ]
      +}
      +
      +
      
      +tags:
      +- pet
      +summary: Updates a pet in the store with form data
      +operationId: updatePetWithForm
      +parameters:
      +- name: petId
      +  in: path
      +  description: ID of pet that needs to be updated
      +  required: true
      +  schema:
      +    type: string
      +requestBody:
      +  content:
      +    'application/x-www-form-urlencoded':
      +      schema:
      +       properties:
      +          name: 
      +            description: Updated name of the pet
      +            type: string
      +          status:
      +            description: Updated status of the pet
      +            type: string
      +       required:
      +         - status
      +responses:
      +  '200':
      +    description: Pet updated.
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +  '405':
      +    description: Method Not Allowed
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +security:
      +- petstore_auth:
      +  - write:pets
      +  - read:pets
      +
      +

      External Documentation Object

      +

      Allows referencing an external resource for extended documentation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA short description of the target documentation. CommonMark syntax MAY be used for rich text representation.
      urlstringREQUIRED. The URL for the target documentation. Value MUST be in the format of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      External Documentation Object Example

      +
      
      +{
      +  "description": "Find more info here",
      +  "url": "https://example.com"
      +}
      +
      +
      
      +description: Find more info here
      +url: https://example.com
      +
      +

      Parameter Object

      +

      Describes a single operation parameter.

      +

      A unique parameter is defined by a combination of a name and location.

      +

      Parameter Locations

      +

      There are four possible parameter locations specified by the in field:

      +
        +
      • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
      • +
      • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
      • +
      • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
      • +
      • cookie - Used to pass a specific cookie value to the API.
      • +
      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
      • If in is "path", the name field MUST correspond to a template expression occurring within the path field in the Paths Object. See Path Templating for further information.
      • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
      • For all other cases, the name corresponds to the parameter name used by the in property.
      instringREQUIRED. The location of the parameter. Possible values are "query", "header", "path" or "cookie".
      descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
      requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is "path", this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
      deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage. Default value is false.
      allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored. Use of this property is NOT RECOMMENDED, as it is likely to be removed in a later revision.
      +

      The rules for serialization of the parameter are specified in one of two ways. +For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
      explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
      allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
      schemaSchema Object ¦ Reference ObjectThe schema defining the type used for the parameter.
      exampleAnyExample of the parameter’s potential value. The example SHOULD match the specified schema and encoding properties if present. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema that contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
      examplesMap[ string, Example Object ¦ Reference Object]Examples of the parameter’s potential value. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema that contains an example, the examples value SHALL override the example provided by the schema.
      +

      For more complex scenarios, the content property can define the media type and schema of the parameter. +A parameter MUST contain either a schema property, or a content property, but not both. +When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
      +

      Style Values

      +

      In order to support common ways of serializing simple parameters, a set of style values are defined.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      styletypeinComments
      matrixprimitive, array, objectpathPath-style parameters defined by [[!RFC6570]]
      labelprimitive, array, objectpathLabel style parameters defined by [[!RFC6570]]
      formprimitive, array, objectquery, cookieForm style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
      simplearraypath, headerSimple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0.
      spaceDelimitedarrayquerySpace separated array values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
      pipeDelimitedarrayqueryPipe separated array values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
      deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
      +

      Style Examples

      +

      Assume a parameter named color has one of the following values:

      +
      
      +   string -> "blue"
      +   array -> ["blue","black","brown"]
      +   object -> { "R": 100, "G": 200, "B": 150 }
      +
      +

      The following table shows examples of rendering differences for each value.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      styleexplodeemptystringarrayobject
      matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
      matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
      labelfalse..blue.blue.black.brown.R.100.G.200.B.150
      labeltrue..blue.blue.black.brown.R=100.G=200.B=150
      formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
      formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
      simplefalsen/ablueblue,black,brownR,100,G,200,B,150
      simpletruen/ablueblue,black,brownR=100,G=200,B=150
      spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
      pipeDelimitedfalsen/an/ablue¦black¦brownR¦100¦G¦200¦B¦150
      deepObjecttruen/an/an/acolor\R=100&color\G=200&color\B=150
      +

      This object MAY be extended with Specification Extensions.

      +

      Parameter Object Examples

      +

      A header parameter with an array of 64 bit integer numbers:

      +
      
      +{
      +  "name": "token",
      +  "in": "header",
      +  "description": "token to be passed as a header",
      +  "required": true,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "integer",
      +      "format": "int64"
      +    }
      +  },
      +  "style": "simple"
      +}
      +
      +
      
      +name: token
      +in: header
      +description: token to be passed as a header
      +required: true
      +schema:
      +  type: array
      +  items:
      +    type: integer
      +    format: int64
      +style: simple
      +
      +

      A path parameter of a string value:

      +
      
      +{
      +  "name": "username",
      +  "in": "path",
      +  "description": "username to fetch",
      +  "required": true,
      +  "schema": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +name: username
      +in: path
      +description: username to fetch
      +required: true
      +schema:
      +  type: string
      +
      +

      An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

      +
      
      +{
      +  "name": "id",
      +  "in": "query",
      +  "description": "ID of the object to fetch",
      +  "required": false,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    }
      +  },
      +  "style": "form",
      +  "explode": true
      +}
      +
      +
      
      +name: id
      +in: query
      +description: ID of the object to fetch
      +required: false
      +schema:
      +  type: array
      +  items:
      +    type: string
      +style: form
      +explode: true
      +
      +

      A free-form query parameter, allowing undefined parameters of a specific type:

      +
      
      +{
      +  "in": "query",
      +  "name": "freeForm",
      +  "schema": {
      +    "type": "object",
      +    "additionalProperties": {
      +      "type": "integer"
      +    },
      +  },
      +  "style": "form"
      +}
      +
      +
      
      +in: query
      +name: freeForm
      +schema:
      +  type: object
      +  additionalProperties:
      +    type: integer
      +style: form
      +
      +

      A complex parameter using content to define serialization:

      +
      
      +{
      +  "in": "query",
      +  "name": "coordinates",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "object",
      +        "required": [
      +          "lat",
      +          "long"
      +        ],
      +        "properties": {
      +          "lat": {
      +            "type": "number"
      +          },
      +          "long": {
      +            "type": "number"
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +in: query
      +name: coordinates
      +content:
      +  application/json:
      +    schema:
      +      type: object
      +      required:
      +        - lat
      +        - long
      +      properties:
      +        lat:
      +          type: number
      +        long:
      +          type: number
      +
      +

      Request Body Object

      +

      Describes a single request body.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
      contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
      requiredbooleanDetermines if the request body is required in the request. Defaults to false.
      +

      This object MAY be extended with Specification Extensions.

      +

      Request Body Examples

      +

      A request body with a referenced model definition.

      +
      
      +{
      +  "description": "user to add to the system",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
      +      },
      +      "examples": {
      +          "user" : {
      +            "summary": "User Example", 
      +            "externalValue": "http://foo.bar/examples/user-example.json"
      +          } 
      +        }
      +    },
      +    "application/xml": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
      +      },
      +      "examples": {
      +          "user" : {
      +            "summary": "User example in XML",
      +            "externalValue": "http://foo.bar/examples/user-example.xml"
      +          }
      +        }
      +    },
      +    "text/plain": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in Plain text",
      +            "externalValue": "http://foo.bar/examples/user-example.txt" 
      +        }
      +      } 
      +    },
      +    "*/*": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in other format",
      +            "externalValue": "http://foo.bar/examples/user-example.whatever"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: user to add to the system
      +content: 
      +  'application/json':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User Example
      +        externalValue: 'http://foo.bar/examples/user-example.json'
      +  'application/xml':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User Example in XML
      +        externalValue: 'http://foo.bar/examples/user-example.xml'
      +  'text/plain':
      +    examples:
      +      user:
      +        summary: User example in text plain format
      +        externalValue: 'http://foo.bar/examples/user-example.txt'
      +  '*/*':
      +    examples:
      +      user: 
      +        summary: User example in other format
      +        externalValue: 'http://foo.bar/examples/user-example.whatever'
      +
      +

      A body parameter that is an array of string values:

      +
      
      +{
      +  "description": "user to add to the system",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: user to add to the system
      +required: true
      +content:
      +  text/plain:
      +    schema:
      +      type: array
      +      items:
      +        type: string
      +
      +

      Media Type Object

      +

      Each Media Type Object provides schema and examples for the media type identified by its key.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      schemaSchema Object ¦ Reference ObjectThe schema defining the content of the request, response, or parameter.
      exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
      examplesMap[ string, Example Object ¦ Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
      encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
      +

      This object MAY be extended with Specification Extensions.

      +

      Media Type Examples

      +
      
      +{
      +  "application/json": {
      +    "schema": {
      +         "$ref": "#/components/schemas/Pet"
      +    },
      +    "examples": {
      +      "cat" : {
      +        "summary": "An example of a cat",
      +        "value": 
      +          {
      +            "name": "Fluffy",
      +            "petType": "Cat",
      +            "color": "White",
      +            "gender": "male",
      +            "breed": "Persian"
      +          }
      +      },
      +      "dog": {
      +        "summary": "An example of a dog with a cat's name",
      +        "value" :  { 
      +          "name": "Puma",
      +          "petType": "Dog",
      +          "color": "Black",
      +          "gender": "Female",
      +          "breed": "Mixed"
      +        },
      +      "frog": {
      +          "$ref": "#/components/examples/frog-example"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +application/json: 
      +  schema:
      +    $ref: "#/components/schemas/Pet"
      +  examples:
      +    cat:
      +      summary: An example of a cat
      +      value:
      +        name: Fluffy
      +        petType: Cat
      +        color: White
      +        gender: male
      +        breed: Persian
      +    dog:
      +      summary: An example of a dog with a cat's name
      +      value:
      +        name: Puma
      +        petType: Dog
      +        color: Black
      +        gender: Female
      +        breed: Mixed
      +    frog:
      +      $ref: "#/components/examples/frog-example"
      +
      +

      Considerations for File Uploads

      +

      In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type. Specifically:

      +
      
      +# content transferred with base64 encoding
      +schema:
      +  type: string
      +  format: base64
      +
      +
      
      +# content transferred in binary (octet-stream):
      +schema:
      +  type: string
      +  format: binary
      +
      +

      These examples apply to either input payloads of file uploads or response payloads.

      +

      A requestBody for submitting a file in a POST operation may look like the following example:

      +
      
      +requestBody:
      +  content:
      +    application/octet-stream:
      +      schema:
      +        # a binary file of any type
      +        type: string
      +        format: binary
      +
      +

      In addition, specific media types MAY be specified:

      +
      
      +# multiple, specific media types may be specified:
      +requestBody:
      +  content:
      +      # a binary file of type png or jpeg
      +    'image/jpeg':
      +      schema:
      +        type: string
      +        format: binary
      +    'image/png':
      +      schema:
      +        type: string
      +        format: binary        
      +
      +

      To upload multiple files, a multipart media type MUST be used:

      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        properties:
      +          # The property name 'file' will be used for all files.
      +          file:
      +            type: array
      +            items:
      +              type: string
      +              format: binary
      +
      +
      +

      Support for x-www-form-urlencoded Request Bodies

      +

      To submit content using form url encoding via [[!RFC1866]], the following +definition may be used:

      +
      
      +requestBody:
      +  content:
      +    application/x-www-form-urlencoded:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # complex types are stringified to support RFC 1866
      +            type: object
      +            properties: {}
      +
      +

      In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

      +

      When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object's style property as form.

      +

      Special Considerations for multipart Content

      +

      It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

      +

      When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred — thus, the following default Content-Types are defined for multipart:

      +
        +
      • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
      • +
      • If the property is complex, or an array of complex values, the default Content-Type is application/json
      • +
      • If the property is a type: string with format: binary or format: base64 (aka a file object), the default Content-Type is application/octet-stream
      • +
      +

      Examples:

      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # default Content-Type for objects is `application/json`
      +            type: object
      +            properties: {}
      +          profileImage:
      +            # default Content-Type for string/binary is `application/octet-stream`
      +            type: string
      +            format: binary
      +          children:
      +            # default Content-Type for arrays is based on the `inner` type (text/plain here)
      +            type: array
      +            items:
      +              type: string
      +          addresses:
      +            # default Content-Type for arrays is based on the `inner` type (object shown, so `application/json` in this example)
      +            type: array
      +            items:
      +              type: '#/components/schemas/Address'
      +
      +

      An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

      +

      Encoding Object

      +

      A single encoding definition applied to a single schema property.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for string with format being binaryapplication/octet-stream; for other primitive types – text/plain; for object - application/json; for array – the default is defined based on the inner type. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
      headersMap[string, Header Object ¦ Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
      stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
      +

      This object MAY be extended with Specification Extensions.

      +

      Encoding Object Example

      +
      
      +requestBody:
      +  content:
      +    multipart/mixed:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            # default is text/plain
      +            type: string
      +            format: uuid
      +          address:
      +            # default is application/json
      +            type: object
      +            properties: {}
      +          historyMetadata:
      +            # need to declare XML format!
      +            description: metadata in XML format
      +            type: object
      +            properties: {}
      +          profileImage:
      +            # default is application/octet-stream, need to declare an image type only!
      +            type: string
      +            format: binary
      +      encoding:
      +        historyMetadata:
      +          # require XML Content-Type in utf-8 encoding
      +          contentType: application/xml; charset=utf-8
      +        profileImage:
      +          # only accept png/jpeg
      +          contentType: image/png, image/jpeg
      +          headers:
      +            X-Rate-Limit-Limit:
      +              description: The number of allowed requests in the current period
      +              schema:
      +                type: integer
      +
      +

      Responses Object

      +

      A container for the expected responses of an operation. +The container maps a HTTP response code to the expected response.

      +

      The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. +However, documentation is expected to cover a successful operation response and any known errors.

      +

      The default MAY be used as a default response object for all HTTP codes +that are not covered individually by the specification.

      +

      The Responses Object MUST contain at least one response code, and it +SHOULD be the response for a successful operation call.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      defaultResponse Object ¦ Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses. A Reference Object can link to a response that the OpenAPI Object’s components/responses section defines.
      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      HTTP Status CodeResponse Object ¦ Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. A Reference Object can link to a response that is defined in the OpenAPI Object’s components/responses section. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. Only the following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
      +

      This object MAY be extended with Specification Extensions.

      +

      Responses Object Example

      +

      A 200 response for a successful operation and a default response for others (implying an error):

      +
      
      +{
      +  "200": {
      +    "description": "a pet to be returned",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/Pet"
      +        }
      +      }
      +    }
      +  },
      +  "default": {
      +    "description": "Unexpected error",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/ErrorModel"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +'200':
      +  description: a pet to be returned
      +  content: 
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/Pet'
      +default:
      +  description: Unexpected error
      +  content:
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/ErrorModel'
      +
      +

      Response Object

      +

      Describes a single response from an API Operation, including design-time, static +links to operations based on the response.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringREQUIRED. A short description of the response. CommonMark syntax MAY be used for rich text representation.
      headersMap[string, Header Object ¦ Reference Object]Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
      contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
      linksMap[string, Link Object ¦ Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
      +

      This object MAY be extended with Specification Extensions.

      +

      Response Object Examples

      +

      Response of an array of a complex type:

      +
      
      +{
      +  "description": "A complex object array response",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "$ref": "#/components/schemas/VeryComplexType"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: A complex object array response
      +content: 
      +  application/json:
      +    schema: 
      +      type: array
      +      items:
      +        $ref: '#/components/schemas/VeryComplexType'
      +
      +

      Response with a string type:

      +
      
      +{
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  }
      +
      +}
      +
      +
      
      +description: A simple string response
      +content:
      +  text/plain:
      +    schema:
      +      type: string
      +
      +

      Plain text response with headers:

      +
      
      +{
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string",
      +        "example": "whoa!"
      +      }
      +    }
      +  },
      +  "headers": {
      +    "X-Rate-Limit-Limit": {
      +      "description": "The number of allowed requests in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    },
      +    "X-Rate-Limit-Remaining": {
      +      "description": "The number of remaining requests in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    },
      +    "X-Rate-Limit-Reset": {
      +      "description": "The number of seconds left in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: A simple string response
      +content:
      +  text/plain:
      +    schema:
      +      type: string
      +    example: 'whoa!'
      +headers:
      +  X-Rate-Limit-Limit:
      +    description: The number of allowed requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Remaining:
      +    description: The number of remaining requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Reset:
      +    description: The number of seconds left in the current period
      +    schema:
      +      type: integer
      +
      +

      Response with no return value:

      +
      
      +{
      +  "description": "object created"
      +}
      +
      +
      
      +description: object created
      +
      +

      Callback Object

      +

      A map of possible out-of band callbacks related to the parent operation. +Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. +The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {expression}Path Item ObjectA Path Item Object used to define a callback request and expected responses. A complete example is available.
      +

      This object MAY be extended with Specification Extensions.

      +

      Key Expression

      +

      The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. +A simple example might be $request.body#/url. +However, using a runtime expression the complete HTTP message can be accessed. +This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

      +

      For example, given the following HTTP request:

      +
      
      +POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
      +Host: example.org
      +Content-Type: application/json
      +Content-Length: 187
      +
      +{
      +  "failedUrl" : "http://clientdomain.com/failed",
      +  "successUrls" : [
      +    "http://clientdomain.com/fast",
      +    "http://clientdomain.com/medium",
      +    "http://clientdomain.com/slow"
      +  ] 
      +}
      +
      +201 Created
      +Location: http://example.org/subscription/1
      +
      +

      The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      ExpressionValue
      $urlhttp://example.org/subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning
      $methodPOST
      $request.path.eventTypemyevent
      $request.query.queryUrlhttp://clientdomain.com/stillrunning
      $request.header.content-Typeapplication/json
      $request.body#/failedUrlhttp://clientdomain.com/failed
      $request.body#/successUrls/2http://clientdomain.com/medium
      $response.header.Locationhttp://example.org/subscription/1
      +

      Callback Object Examples

      +

      The following example uses the user provided queryUrl query string parameter to define the callback URL. This is an example of how to use a callback object to describe a WebHook callback that goes with the subscription operation to enable registering for the WebHook.

      +
      
      +myCallback:
      +  '{$request.query.queryUrl}':
      +    post:
      +      requestBody:
      +        description: Callback payload
      +        content: 
      +          'application/json':
      +            schema:
      +              $ref: '#/components/schemas/SomePayload'
      +      responses:
      +        '200':
      +          description: callback successfully processed
      +
      +

      The following example shows a callback where the server is hard-coded, but the query string parameters are populated from the id and email property in the request body.

      +
      
      +transactionCallback:
      +  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
      +    post:
      +      requestBody:
      +        description: Callback payload
      +        content: 
      +          'application/json':
      +            schema:
      +              $ref: '#/components/schemas/SomePayload'
      +      responses:
      +        '200':
      +          description: callback successfully processed
      +
      +

      Example Object

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      summarystringShort description for the example.
      descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
      valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
      externalValuestringA URL that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive.
      +

      This object MAY be extended with Specification Extensions.

      +

      In all cases, the example value is expected to be compatible with the type schema +of its associated value. Tooling implementations MAY choose to +validate compatibility automatically, and reject the example value(s) if incompatible.

      +

      Example Object Examples

      +

      In a request body:

      +
      
      +requestBody:
      +  content:
      +    'application/json':
      +      schema:
      +        $ref: '#/components/schemas/Address'
      +      examples: 
      +        foo:
      +          summary: A foo example
      +          value: {"foo": "bar"}
      +        bar:
      +          summary: A bar example
      +          value: {"bar": "baz"}
      +    'application/xml':
      +      examples: 
      +        xmlExample:
      +          summary: This is an example in XML
      +          externalValue: 'http://example.org/examples/address-example.xml'
      +    'text/plain':
      +      examples:
      +        textExample: 
      +          summary: This is a text example
      +          externalValue: 'http://foo.bar/examples/address-example.txt'
      +
      +

      In a parameter:

      +
      
      +parameters:
      +  - name: 'zipCode'
      +    in: 'query'
      +    schema:
      +      type: 'string'
      +      format: 'zip-code'
      +    examples:
      +      zip-example: 
      +        $ref: '#/components/examples/zip-example'
      +
      +

      In a response:

      +
      
      +responses:
      +  '200':
      +    description: your car appointment has been booked
      +    content: 
      +      application/json:
      +        schema:
      +          $ref: '#/components/schemas/SuccessResponse'
      +        examples:
      +          confirmation-success:
      +            $ref: '#/components/examples/confirmation-success'
      +
      +

      Link Object

      +

      The Link object represents a possible design-time link for a response. +The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

      +

      Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

      +

      For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      operationRefstringA relative or absolute URI reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition.
      operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
      parametersMap[string, Any ¦ {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
      requestBodyAny ¦ {expression}A literal value or {expression} to use as a request body when calling the target operation.
      descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
      serverServer ObjectA server object to be used by the target operation.
      +

      This object MAY be extended with Specification Extensions.

      +

      A linked operation MUST be identified using either an operationRef or operationId. +In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. +Because of the potential for name clashes, the operationRef syntax is preferred +for specifications with external references.

      +

      Examples

      +

      Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

      +
      
      +paths:
      +  /users/{id}:
      +    parameters:
      +    - name: id
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +    get:
      +      responses:
      +        '200':
      +          description: the user being returned
      +          content:
      +            application/json:
      +              schema:
      +                type: object
      +                properties:
      +                  uuid: # the unique user id
      +                    type: string
      +                    format: uuid
      +          links:
      +            address:
      +              # the target link operationId
      +              operationId: getUserAddress
      +              parameters:
      +                # get the `id` field from the request path parameter named `id`
      +                userId: $request.path.id
      +  # the path item of the linked operation
      +  /users/{userid}/address:
      +    parameters:
      +    - name: userid
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +    # linked operation
      +    get:
      +      operationId: getUserAddress
      +      responses:
      +        '200':
      +          description: the user's address
      +
      +

      When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

      +

      Values from the response body can be used to drive a linked operation.

      +
      
      +links:
      +  address:
      +    operationId: getUserAddressByUUID
      +    parameters:
      +      # get the `uuid` field from the `uuid` field in the response body
      +      userUuid: $response.body#/uuid
      +
      +

      Clients follow all links at their discretion. +Neither permissions, nor the capability to make a successful call to that link, is guaranteed +solely by the existence of a relationship.

      +

      OperationRef Examples

      +

      As references to operationId MAY NOT be possible (the operationId is an optional +field in an Operation Object), references MAY also be made through a relative operationRef:

      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
      +
      +

      or an absolute operationRef:

      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
      +
      +

      Note that in the use of operationRef, the escaped forward-slash is necessary when +using JSON references.

      +

      Runtime Expressions

      +

      Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. +This mechanism is used by Link Objects and Callback Objects.

      +

      The runtime expression is defined by the following [ABNF] syntax

      +
      
      +      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
      +      source = ( header-reference / query-reference / path-reference / body-reference )
      +      header-reference = "header." token
      +      query-reference = "query." name  
      +      path-reference = "path." name
      +      body-reference = "body" ["#" json-pointer ]
      +      json-pointer    = *( "/" reference-token )
      +      reference-token = *( unescaped / escaped )
      +      unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
      +         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
      +      escaped         = "~" ( "0" / "1" )
      +        ; representing '~' and '/', respectively
      +      name = *( CHAR )
      +      token = 1*tchar
      +      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
      +        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
      +
      +

      Here, json-pointer is taken from [[!RFC6901]], char from [[!RFC7159]] and token from [[!RFC7230]].

      +

      The name identifier is case-sensitive, whereas token is not.

      +

      The table below provides examples of runtime expressions and examples of their use in a value:

      +

      Examples

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Source Locationexample expressionnotes
      HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
      Requested media type$request.header.accept
      Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
      Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
      Request URL$url
      Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
      Response header$response.header.ServerSingle header values only are available
      +

      Runtime expressions preserve the type of the referenced value. +Expressions can be embedded into string values by surrounding the expression with {} curly braces.

      +

      Header Object

      +

      The Header Object follows the structure of the Parameter Object with the following changes:

      +
        +
      1. name MUST NOT be specified, it is given in the corresponding headers map.
      2. +
      3. in MUST NOT be specified, it is implicitly in header.
      4. +
      5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
      6. +
      +

      Header Object Example

      +

      A simple header of type integer:

      +
      
      +{
      +  "description": "The number of allowed requests in the current period",
      +  "schema": {
      +    "type": "integer"
      +  }
      +}
      +
      +
      
      +description: The number of allowed requests in the current period
      +schema:
      +  type: integer
      +
      +

      Tag Object

      +

      Adds metadata to a single tag that is used by the Operation Object. +It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The name of the tag.
      descriptionstringA short description for the tag. CommonMark syntax MAY be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
      +

      This object MAY be extended with Specification Extensions.

      +

      Tag Object Example

      +
      
      +{
      +	"name": "pet",
      +	"description": "Pets operations"
      +}
      +
      +
      
      +name: pet
      +description: Pets operations
      +
      +

      Reference Object

      +

      A simple object to allow referencing other components in the specification, internally and externally.

      +

      The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

      +

      For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringREQUIRED. The reference string.
      +

      This object cannot be extended with additional properties and any properties added SHALL be ignored.

      +

      Reference Object Example

      +
      
      +{
      +	"$ref": "#/components/schemas/Pet"
      +}
      +
      +
      
      +$ref: '#/components/schemas/Pet'
      +
      +

      Relative Schema Document Example

      +
      
      +{
      +  "$ref": "Pet.json"
      +}
      +
      +
      
      +$ref: Pet.yaml
      +
      +

      Relative Documents With Embedded Schema Example

      +
      
      +{
      +  "$ref": "definitions.json#/Pet"
      +}
      +
      +
      
      +$ref: definitions.yaml#/Pet
      +
      +

      Schema Object

      +

      The Schema Object allows the definition of input and output data types. +These types can be objects, but also primitives and arrays. +This object is an extended subset of the JSON Schema Specification Wright Draft 00.

      +

      For more information about the properties, see JSON Schema Core and JSON Schema Validation. +Unless stated otherwise, the property definitions follow the JSON Schema.

      +

      Properties

      +

      The following properties are taken directly from the JSON Schema definition and follow the same specifications:

      +
        +
      • title
      • +
      • multipleOf
      • +
      • maximum
      • +
      • exclusiveMaximum
      • +
      • minimum
      • +
      • exclusiveMinimum
      • +
      • maxLength
      • +
      • minLength
      • +
      • pattern (This string SHOULD be a valid regular expression, according to the Ecma-262 Edition 5.1 regular expression dialect)
      • +
      • maxItems
      • +
      • minItems
      • +
      • uniqueItems
      • +
      • maxProperties
      • +
      • minProperties
      • +
      • required
      • +
      • enum
      • +
      +

      The following properties are taken from the JSON Schema definition but their definitions were adjusted to the OpenAPI Specification.

      +
        +
      • type - Value MUST be a string. Multiple types via an array are not supported.
      • +
      • allOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • oneOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • anyOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • not - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
      • +
      • items - Value MUST be an object and not an array. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. items MUST be present if the type is array.
      • +
      • properties - Property definitions MUST be a Schema Object and not a standard JSON Schema (inline or referenced).
      • +
      • additionalProperties - Value can be boolean or object. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. Consistent with JSON Schema, additionalProperties defaults to true.
      • +
      • description - CommonMark syntax MAY be used for rich text representation.
      • +
      • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
      • +
      • default - The default value represents what would be assumed by the consumer of the input as the value of the schema if one is not provided. Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object defined at the same level. For example, if type is string, then default can be "foo" but cannot be 1.
      • +
      +

      Alternatively, any time a Schema Object can be used, a Reference Object can be used in its place. This allows referencing definitions instead of defining them inline.

      +

      Additional properties defined by the JSON Schema specification that are not mentioned here are strictly unsupported.

      +

      Other than the JSON Schema subset fields, the following fields MAY be used for further schema documentation:

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      nullablebooleanA true value adds "null" to the allowed type specified by the type keyword, only if type is explicitly defined within the same Schema Object. Other Schema Object constraints retain their defined behavior, and therefore may disallow the use of null as a value. A false value leaves the specified or default type unmodified. The default value is false.
      discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
      readOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “read only”. This means that it MAY be sent as part of a response but SHOULD NOT be sent as part of the request. If the property is marked as readOnly being true and is in the required list, the required will take effect on the response only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
      writeOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “write only”. Therefore, it MAY be sent as part of a request but SHOULD NOT be sent as part of the response. If the property is marked as writeOnly being true and is in the required list, the required will take effect on the request only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
      xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
      externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
      exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.
      deprecatedbooleanSpecifies that a schema is deprecated and SHOULD be transitioned out of usage. Default value is false.
      +

      This object MAY be extended with Specification Extensions.

      +
      Composition and Inheritance (Polymorphism)
      +

      The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. +allOf takes an array of object definitions that are validated independently but together compose a single object.

      +

      While composition offers model extensibility, it does not imply a hierarchy between the models. +To support polymorphism, the OpenAPI Specification adds the discriminator field. +When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. +As such, the discriminator field MUST be a required field. +There are two ways to define the value of a discriminator for an inheriting instance.

      +
        +
      • Use the schema name.
      • +
      • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. +As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
      • +
      +
      XML Modeling
      +

      The xml property allows extra definitions when translating the JSON definition to XML. +The XML Object contains additional information about the available options.

      +

      Schema Object Examples

      +
      Primitive Sample
      +
      
      +{
      +  "type": "string",
      +  "format": "email"
      +}
      +
      +
      
      +type: string
      +format: email
      +
      +
      Simple Model
      +
      
      +{
      +  "type": "object",
      +  "required": [
      +    "name"
      +  ],
      +  "properties": {
      +    "name": {
      +      "type": "string"
      +    },
      +    "address": {
      +      "$ref": "#/components/schemas/Address"
      +    },
      +    "age": {
      +      "type": "integer",
      +      "format": "int32",
      +      "minimum": 0
      +    }
      +  }
      +}
      +
      +
      
      +type: object
      +required:
      +- name
      +properties:
      +  name:
      +    type: string
      +  address:
      +    $ref: '#/components/schemas/Address'
      +  age:
      +    type: integer
      +    format: int32
      +    minimum: 0
      +
      +
      Model with Map/Dictionary Properties
      +

      For a simple string to string mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  type: string
      +
      +

      For a string to model mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "$ref": "#/components/schemas/ComplexModel"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  $ref: '#/components/schemas/ComplexModel'
      +
      +
      Model with Example
      +
      
      +{
      +  "type": "object",
      +  "properties": {
      +    "id": {
      +      "type": "integer",
      +      "format": "int64"
      +    },
      +    "name": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "name"
      +  ],
      +  "example": {
      +    "name": "Puma",
      +    "id": 1
      +  }
      +}
      +
      +
      
      +type: object
      +properties:
      +  id:
      +    type: integer
      +    format: int64
      +  name:
      +    type: string
      +required:
      +- name
      +example:
      +  name: Puma
      +  id: 1
      +
      +
      Models with Composition
      +
      
      +{
      +  "components": {
      +    "schemas": {
      +      "ErrorModel": {
      +        "type": "object",
      +        "required": [
      +          "message",
      +          "code"
      +        ],
      +        "properties": {
      +          "message": {
      +            "type": "string"
      +          },
      +          "code": {
      +            "type": "integer",
      +            "minimum": 100,
      +            "maximum": 600
      +          }
      +        }
      +      },
      +      "ExtendedErrorModel": {
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/ErrorModel"
      +          },
      +          {
      +            "type": "object",
      +            "required": [
      +              "rootCause"
      +            ],
      +            "properties": {
      +              "rootCause": {
      +                "type": "string"
      +              }
      +            }
      +          }
      +        ]
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    ErrorModel:
      +      type: object
      +      required:
      +      - message
      +      - code
      +      properties:
      +        message:
      +          type: string
      +        code:
      +          type: integer
      +          minimum: 100
      +          maximum: 600
      +    ExtendedErrorModel:
      +      allOf:
      +      - $ref: '#/components/schemas/ErrorModel'
      +      - type: object
      +        required:
      +        - rootCause
      +        properties:
      +          rootCause:
      +            type: string
      +
      +
      Models with Polymorphism Support
      +
      
      +{
      +  "components": {
      +    "schemas": {
      +      "Pet": {
      +        "type": "object",
      +        "discriminator": {
      +          "propertyName": "petType"
      +        },
      +        "properties": {
      +          "name": {
      +            "type": "string"
      +          },
      +          "petType": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "petType"
      +        ]
      +      },
      +      "Cat": {
      +        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/Pet"
      +          },
      +          {
      +            "type": "object",
      +            "properties": {
      +              "huntingSkill": {
      +                "type": "string",
      +                "description": "The measured skill for hunting",
      +                "default": "lazy",
      +                "enum": [
      +                  "clueless",
      +                  "lazy",
      +                  "adventurous",
      +                  "aggressive"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "huntingSkill"
      +            ]
      +          }
      +        ]
      +      },
      +      "Dog": {
      +        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/Pet"
      +          },
      +          {
      +            "type": "object",
      +            "properties": {
      +              "packSize": {
      +                "type": "integer",
      +                "format": "int32",
      +                "description": "the size of the pack the dog is from",
      +                "default": 0,
      +                "minimum": 0
      +              }
      +            },
      +            "required": [
      +              "packSize"
      +            ]
      +          }
      +        ]
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    Pet:
      +      type: object
      +      discriminator:
      +        propertyName: petType
      +      properties:
      +        name:
      +          type: string
      +        petType:
      +          type: string
      +      required:
      +      - name
      +      - petType
      +    Cat:  ## "Cat" will be used as the discriminator value
      +      description: A representation of a cat
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          huntingSkill:
      +            type: string
      +            description: The measured skill for hunting
      +            enum:
      +            - clueless
      +            - lazy
      +            - adventurous
      +            - aggressive
      +        required:
      +        - huntingSkill
      +    Dog:  ## "Dog" will be used as the discriminator value
      +      description: A representation of a dog
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          packSize:
      +            type: integer
      +            format: int32
      +            description: the size of the pack the dog is from
      +            default: 0
      +            minimum: 0
      +        required:
      +        - packSize
      +
      +

      Discriminator Object

      +

      When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

      +

      When using the discriminator, inline schemas will not be considered.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
      mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
      +

      The discriminator object is legal only when using one of the composite keywords oneOf, anyOf, allOf.

      +

      In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +
      +

      which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +  discriminator:
      +    propertyName: petType
      +
      +

      The expectation now is that a property with name petType MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

      +
      
      +{
      +  "id": 12345,
      +  "petType": "Cat"
      +}
      +
      +

      Will indicate that the Cat schema be used in conjunction with this payload.

      +

      In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +  discriminator:
      +    propertyName: petType
      +    mapping:
      +      dog: '#/components/schemas/Dog'
      +      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +
      +

      Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

      +

      When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

      +

      In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

      +

      For example:

      +
      
      +components:
      +  schemas:
      +    Pet:
      +      type: object
      +      required:
      +      - petType
      +      properties:
      +        petType:
      +          type: string
      +      discriminator:
      +        propertyName: petType
      +        mapping:
      +          dog: Dog
      +    Cat:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Cat`
      +        properties:
      +          name:
      +            type: string
      +    Dog:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Dog`
      +        properties:
      +          bark:
      +            type: string
      +    Lizard:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Lizard`
      +        properties:
      +          lovesRocks:
      +            type: boolean
      +
      +

      a payload like this:

      +
      
      +{
      +  "petType": "Cat",
      +  "name": "misty"
      +}
      +
      +

      will indicate that the Cat schema be used. Likewise this schema:

      +
      
      +{
      +  "petType": "dog",
      +  "bark": "soft"
      +}
      +
      +

      will map to Dog because of the definition in the mappings element.

      +

      XML Object

      +

      A metadata object that allows for more fine-tuned XML model definitions.

      +

      When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. +See examples for expected behavior.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
      namespacestringThe URI of the namespace definition. Value MUST be in the form of an absolute URI.
      prefixstringThe prefix to be used for the name.
      attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
      wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
      +

      This object MAY be extended with Specification Extensions.

      +

      XML Object Examples

      +

      The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

      +
      No XML Element
      +

      Basic string property:

      +
      
      +{
      +    "animals": {
      +        "type": "string"
      +    }
      +}
      +
      +
      
      +animals:
      +  type: string
      +
      +
      
      +<animals>...</animals>
      +
      +

      Basic string array property (wrapped is false by default):

      +
      
      +{
      +    "animals": {
      +        "type": "array",
      +        "items": {
      +            "type": "string"
      +        }
      +    }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +
      +
      
      +<animals>...</animals>
      +<animals>...</animals>
      +<animals>...</animals>
      +
      +
      XML Name Replacement
      +
      
      +{
      +  "animals": {
      +    "type": "string",
      +    "xml": {
      +      "name": "animal"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: string
      +  xml:
      +    name: animal
      +
      +
      
      +<animal>...</animal>
      +
      +
      XML Attribute, Prefix and Namespace
      +

      In this example, a full model definition is shown.

      +
      
      +{
      +  "Person": {
      +    "type": "object",
      +    "properties": {
      +      "id": {
      +        "type": "integer",
      +        "format": "int32",
      +        "xml": {
      +          "attribute": true
      +        }
      +      },
      +      "name": {
      +        "type": "string",
      +        "xml": {
      +          "namespace": "http://example.com/schema/sample",
      +          "prefix": "sample"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +Person:
      +  type: object
      +  properties:
      +    id:
      +      type: integer
      +      format: int32
      +      xml:
      +        attribute: true
      +    name:
      +      type: string
      +      xml:
      +        namespace: http://example.com/schema/sample
      +        prefix: sample
      +
      +
      
      +<Person id="123">
      +    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
      +</Person>
      +
      +
      XML Arrays
      +

      Changing the element names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      The external name property has no effect on the XML:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animals>value</animals>
      +  <animals>value</animals>
      +</animals>
      +
      +

      To overcome the naming problem in the example above, the following definition can be used:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</animals>
      +
      +

      Affecting both internal and external names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</aliens>
      +
      +

      If we change the external element but not the internal ones:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <aliens>value</aliens>
      +  <aliens>value</aliens>
      +</aliens>
      +
      +

      Security Scheme Object

      +

      Defines a security scheme that can be used by the operations. +Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeApplies ToDescription
      typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "oauth2", "openIdConnect".
      descriptionstringAnyA short description for security scheme. CommonMark syntax MAY be used for rich text representation.
      namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
      instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
      schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]]. The values used SHOULD be registered in the IANA Authentication Scheme registry.
      bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
      flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
      openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      Security Scheme Object Example

      +
      Basic Authentication Sample
      +
      
      +{
      +  "type": "http",
      +  "scheme": "basic"
      +}
      +
      +
      
      +type: http
      +scheme: basic
      +
      +
      API Key Sample
      +
      
      +{
      +  "type": "apiKey",
      +  "name": "api_key",
      +  "in": "header"
      +}
      +
      +
      
      +type: apiKey
      +name: api_key
      +in: header
      +
      +
      JWT Bearer Sample
      +
      
      +{
      +  "type": "http",
      +  "scheme": "bearer",
      +  "bearerFormat": "JWT",
      +}
      +
      +
      
      +type: http
      +scheme: bearer
      +bearerFormat: JWT
      +
      +
      Implicit OAuth2 Sample
      +
      
      +{
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
      +
      +

      OAuth Flows Object

      +

      Allows configuration of the supported OAuth Flows.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
      passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
      clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
      authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
      +

      This object MAY be extended with Specification Extensions.

      +

      OAuth Flow Object

      +

      Configuration details for a supported OAuth Flow

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeApplies ToDescription
      authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL.
      tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL.
      refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL.
      scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.
      +

      This object MAY be extended with Specification Extensions.

      +

      OAuth Flow Object Examples

      +
      
      +{
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    },
      +    "authorizationCode": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "tokenUrl": "https://example.com/api/oauth/token",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
      +  authorizationCode:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    tokenUrl: https://example.com/api/oauth/token
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets 
      +
      +

      Security Requirement Object

      +

      Lists the required security schemes to execute this operation. +The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

      +

      Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. +This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

      +

      When a list of Security Requirement Objects is defined on the OpenAPI Object or Operation Object, only one of the Security Requirement Objects in the list needs to be satisfied to authorize the request.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution, and the list MAY be empty if authorization does not require a specified scope. For other security scheme types, the array MUST be empty.
      +

      Security Requirement Object Examples

      +
      Non-OAuth2 Security Requirement
      +
      
      +{
      +  "api_key": []
      +}
      +
      +
      
      +api_key: []
      +
      +
      OAuth2 Security Requirement
      +
      
      +{
      +  "petstore_auth": [
      +    "write:pets",
      +    "read:pets"
      +  ]
      +}
      +
      +
      
      +petstore_auth:
      +- write:pets
      +- read:pets
      +
      +
      Optional OAuth2 Security
      +

      Optional OAuth2 security as would be defined in an OpenAPI Object or an Operation Object:

      +
      
      +{
      +  "security": [
      +    {},
      +    {
      +      "petstore_auth": [
      +        "write:pets",
      +        "read:pets"
      +      ]
      +    }
      +  ]
      +}
      +
      +
      
      +security:
      +  - {}
      +  - petstore_auth:
      +    - write:pets
      +    - read:pets
      +
      +

      Specification Extensions

      +

      While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

      +

      The extensions properties are implemented as patterned fields that are always prefixed by "x-".

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. Can have any valid JSON format value.
      +

      The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

      +

      Security Filtering

      +

      Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

      +

      The reasoning is to allow an additional layer of access control over the documentation. +While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

      +

      Two examples of this:

      +
        +
      1. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
      2. +
      3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the Paths Object, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
      4. +
      +

      Appendix A: Revision History

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      VersionDateNotes
      3.0.32020-02-20Patch release of the OpenAPI Specification 3.0.3
      3.0.22018-10-08Patch release of the OpenAPI Specification 3.0.2
      3.0.12017-12-06Patch release of the OpenAPI Specification 3.0.1
      3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
      3.0.0-rc22017-06-16rc2 of the 3.0 specification
      3.0.0-rc12017-04-27rc1 of the 3.0 specification
      3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
      2.02015-12-31Donation of Swagger 2.0 to the OpenAPI Initiative
      2.02014-09-08Release of Swagger 2.0
      1.22014-03-14Initial release of the formal document.
      1.12012-08-22Release of Swagger 1.1
      1.02011-08-10First release of the Swagger Specification
      + From f0a6befb996ce5ed085ef8db85be996fb9fe556d Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Sat, 22 Feb 2020 16:02:49 +0000 Subject: [PATCH 010/152] gh-pages: don't mix https and http content (toc) (#2154) --- oas/v3.0.3.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/oas/v3.0.3.html b/oas/v3.0.3.html index 42a69bce68..4e4535256c 100644 --- a/oas/v3.0.3.html +++ b/oas/v3.0.3.html @@ -1,4 +1,4 @@ -OpenAPI Specification
      The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

      Status of This Document

      The source-of-truth for the specification is the GitHub markdown file referenced above.
      +OpenAPI Specification
      The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

      Status of This Document

      The source-of-truth for the specification is the GitHub markdown file referenced above.

      OpenAPI Specification

      Version 3.0.3

      The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

      From 62d0c0582ffa73fd71be77d459776f5d5e245905 Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Tue, 16 Feb 2021 20:04:30 +0000 Subject: [PATCH 011/152] gh-pages: add v3.1.0.html (#2464) Signed-off-by: Mike Ralphson --- index.md | 2 +- oas/v3.1.0.html | 4083 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 4084 insertions(+), 1 deletion(-) create mode 100644 oas/v3.1.0.html diff --git a/index.md b/index.md index 4a80db926e..fcc9bac2a2 100644 --- a/index.md +++ b/index.md @@ -13,4 +13,4 @@ This site contains the OpenAPI Initiative Registry and content for the HTML vers ## The Specification * [Markdown source-of-truth](https://github.com/OAI/OpenAPI-Specification) -* [HTML Specification version](oas/v3.0.3.html) +* [HTML Specification version](oas/v3.1.0.html) diff --git a/oas/v3.1.0.html b/oas/v3.1.0.html new file mode 100644 index 0000000000..e9ba775ffc --- /dev/null +++ b/oas/v3.1.0.html @@ -0,0 +1,4083 @@ +OpenAPI Specification + + +
      The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

      Status of This Document

      The source-of-truth for the specification is the GitHub markdown file referenced above.
      +

      OpenAPI Specification

      +

      Version 3.1.0

      +

      The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

      +

      This document is licensed under The Apache License, Version 2.0.

      +

      Introduction

      +

      The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to HTTP APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

      +

      An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

      + +

      Definitions

      +

      OpenAPI Document

      +

      A self-contained or composite resource which defines or describes an API or elements of an API. The OpenAPI document MUST contain at least one paths field, a components field or a webhooks field. An OpenAPI document uses and conforms to the OpenAPI Specification.

      +

      Path Templating

      +

      Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.

      +

      Each template expression in the path MUST correspond to a path parameter that is included in the Path Item itself and/or in each of the Path Item’s Operations. An exception is if the path item is empty, for example due to ACL constraints, matching path parameters are not required.

      +

      The value for these path parameters MUST NOT contain any unescaped “generic syntax” characters described by [[!RFC3986]]: forward slashes (/), question marks (?), or hashes (#).

      +

      Media Types

      +

      Media type definitions are spread across several resources. +The media type definitions SHOULD be in compliance with [[!RFC6838]].

      +

      Some examples of possible media type definitions:

      +
      
      +  text/plain; charset=utf-8
      +  application/json
      +  application/vnd.github+json
      +  application/vnd.github.v3+json
      +  application/vnd.github.v3.raw+json
      +  application/vnd.github.v3.text+json
      +  application/vnd.github.v3.html+json
      +  application/vnd.github.v3.full+json
      +  application/vnd.github.v3.diff
      +  application/vnd.github.v3.patch
      +
      +

      HTTP Status Codes

      +

      The HTTP Status Codes are used to indicate the status of the executed operation. +The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

      +

      Specification

      +

      Versions

      +

      The OpenAPI Specification is versioned using a major.minor.patch versioning scheme. The major.minor portion of the version string (for example 3.1) SHALL designate the OAS feature set. .patch versions address errors in, or provide clarifications to, this document, not the feature set. Tooling which supports OAS 3.1 SHOULD be compatible with all OAS 3.1.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.1.0 and 3.1.1 for example.

      +

      Occasionally, non-backwards compatible changes may be made in minor versions of the OAS where impact is believed to be low relative to the benefit provided.

      +

      An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the version of the OAS that it uses.

      +

      Format

      +

      An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

      +

      For example, if a field has an array value, the JSON array representation will be used:

      +
      
      +{
      +   "field": [ 1, 2, 3 ]
      +}
      +
      +

      All field names in the specification are case sensitive. +This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

      +

      The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

      +

      Patterned fields MUST have unique names within the containing object.

      +

      In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

      + +

      Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

      +

      Document Structure

      +

      An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. In the latter case, Reference Objects and Schema Object $ref keywords are used.

      +

      It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

      +

      Data Types

      +

      Data types in the OAS are based on the types supported by the JSON Schema Specification Draft 2020-12. +Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. +Models are defined using the Schema Object, which is a superset of JSON Schema Specification Draft 2020-12.

      +

      As defined by the JSON Schema Validation vocabulary, data types can have an optional modifier property: format. +OAS defines additional formats to provide fine detail for primitive data types.

      +

      The formats defined by the OAS are:

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      typeformatComments
      integerint32signed 32 bits
      integerint64signed 64 bits (a.k.a long)
      numberfloat
      numberdouble
      stringpasswordA hint to UIs to obscure input.
      +

      Rich Text Formatting

      +

      Throughout the specification description fields are noted as supporting CommonMark markdown formatting. +Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

      +

      Relative References in URIs

      +

      Unless specified otherwise, all properties that are URIs MAY be relative references as defined by [[!RFC3986]].

      +

      Relative references, including those in Reference Objects, PathItem Object $ref fields, Link Object operationRef fields and Example Object externalValue fields, are resolved using the referring document as the Base URI according to [[!RFC3986]].

      +

      If a URI contains a fragment identifier, then the fragment should be resolved per the fragment resolution mechanism of the referenced document. If the representation of the referenced document is JSON or YAML, then the fragment identifier SHOULD be interpreted as a JSON-Pointer as per [[!RFC6901]].

      +

      Relative references in Schema Objects, including any that appear as $id values, use the nearest parent $id as a Base URI, as described by JSON Schema Specification Draft 2020-12. If no parent schema contains an $id, then the Base URI MUST be determined according to [[!RFC3986]].

      +

      Relative References in URLs

      +

      Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. +Unless specified otherwise, relative references are resolved using the URLs defined in the Server Object as a Base URL. Note that these themselves MAY be relative to the referring document.

      +

      Schema

      +

      In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

      +

      OpenAPI Object

      +

      This is the root object of the OpenAPI document.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      openapistringREQUIRED. This string MUST be the version number of the OpenAPI Specification that the OpenAPI document uses. The openapi field SHOULD be used by tooling to interpret the OpenAPI document. This is not related to the API info.version string.
      infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
      jsonSchemaDialectstringThe default value for the $schema keyword within Schema Objects contained within this OAS document. This MUST be in the form of a URI.
      servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
      pathsPaths ObjectThe available paths and operations for the API.
      webhooksMap[string, Path Item Object ¦ Reference Object] ]The incoming webhooks that MAY be received as part of this API and that the API consumer MAY choose to implement. Closely related to the callbacks feature, this section describes requests initiated other than by an API call, for example by an out of band registration. The key name is a unique string to refer to each webhook, while the (optionally referenced) Path Item Object describes a request that may be initiated by the API provider and the expected responses. An example is available.
      componentsComponents ObjectAn element to hold various schemas for the document.
      security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition. To make security optional, an empty security requirement ({}) can be included in the array.
      tags[Tag Object]A list of tags used by the document with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
      externalDocsExternal Documentation ObjectAdditional external documentation.
      +

      This object MAY be extended with Specification Extensions.

      +

      Info Object

      +

      The object provides metadata about the API. +The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      titlestringREQUIRED. The title of the API.
      summarystringA short summary of the API.
      descriptionstringA description of the API. CommonMark syntax MAY be used for rich text representation.
      termsOfServicestringA URL to the Terms of Service for the API. This MUST be in the form of a URL.
      contactContact ObjectThe contact information for the exposed API.
      licenseLicense ObjectThe license information for the exposed API.
      versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
      +

      This object MAY be extended with Specification Extensions.

      +

      Info Object Example

      +
      
      +{
      +  "title": "Sample Pet Store App",
      +  "summary": "A pet store manager.",
      +  "description": "This is a sample server for a pet store.",
      +  "termsOfService": "https://example.com/terms/",
      +  "contact": {
      +    "name": "API Support",
      +    "url": "https://www.example.com/support",
      +    "email": "support@example.com"
      +  },
      +  "license": {
      +    "name": "Apache 2.0",
      +    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
      +  },
      +  "version": "1.0.1"
      +}
      +
      +
      
      +title: Sample Pet Store App
      +summary: A pet store manager.
      +description: This is a sample server for a pet store.
      +termsOfService: https://example.com/terms/
      +contact:
      +  name: API Support
      +  url: https://www.example.com/support
      +  email: support@example.com
      +license:
      +  name: Apache 2.0
      +  url: https://www.apache.org/licenses/LICENSE-2.0.html
      +version: 1.0.1
      +
      +

      Contact Object

      +

      Contact information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringThe identifying name of the contact person/organization.
      urlstringThe URL pointing to the contact information. This MUST be in the form of a URL.
      emailstringThe email address of the contact person/organization. This MUST be in the form of an email address.
      +

      This object MAY be extended with Specification Extensions.

      +

      Contact Object Example

      +
      
      +{
      +  "name": "API Support",
      +  "url": "https://www.example.com/support",
      +  "email": "support@example.com"
      +}
      +
      +
      
      +name: API Support
      +url: https://www.example.com/support
      +email: support@example.com
      +
      +

      License Object

      +

      License information for the exposed API.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The license name used for the API.
      identifierstringAn SPDX license expression for the API. The identifier field is mutually exclusive of the url field.
      urlstringA URL to the license used for the API. This MUST be in the form of a URL. The url field is mutually exclusive of the identifier field.
      +

      This object MAY be extended with Specification Extensions.

      +

      License Object Example

      +
      
      +{
      +  "name": "Apache 2.0",
      +  "identifier": "Apache-2.0"
      +}
      +
      +
      
      +name: Apache 2.0
      +identifier: Apache-2.0
      +
      +

      Server Object

      +

      An object representing a Server.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
      descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
      variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
      +

      This object MAY be extended with Specification Extensions.

      +

      Server Object Example

      +

      A single server would be described as:

      +
      
      +{
      +  "url": "https://development.gigantic-server.com/v1",
      +  "description": "Development server"
      +}
      +
      +
      
      +url: https://development.gigantic-server.com/v1
      +description: Development server
      +
      +

      The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

      +
      
      +{
      +  "servers": [
      +    {
      +      "url": "https://development.gigantic-server.com/v1",
      +      "description": "Development server"
      +    },
      +    {
      +      "url": "https://staging.gigantic-server.com/v1",
      +      "description": "Staging server"
      +    },
      +    {
      +      "url": "https://api.gigantic-server.com/v1",
      +      "description": "Production server"
      +    }
      +  ]
      +}
      +
      +
      
      +servers:
      +- url: https://development.gigantic-server.com/v1
      +  description: Development server
      +- url: https://staging.gigantic-server.com/v1
      +  description: Staging server
      +- url: https://api.gigantic-server.com/v1
      +  description: Production server
      +
      +

      The following shows how variables can be used for a server configuration:

      +
      
      +{
      +  "servers": [
      +    {
      +      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
      +      "description": "The production API server",
      +      "variables": {
      +        "username": {
      +          "default": "demo",
      +          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
      +        },
      +        "port": {
      +          "enum": [
      +            "8443",
      +            "443"
      +          ],
      +          "default": "8443"
      +        },
      +        "basePath": {
      +          "default": "v2"
      +        }
      +      }
      +    }
      +  ]
      +}
      +
      +
      
      +servers:
      +- url: https://{username}.gigantic-server.com:{port}/{basePath}
      +  description: The production API server
      +  variables:
      +    username:
      +      # note! no enum here means it is an open value
      +      default: demo
      +      description: this value is assigned by the service provider, in this example `gigantic-server.com`
      +    port:
      +      enum:
      +        - '8443'
      +        - '443'
      +      default: '8443'
      +    basePath:
      +      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
      +      default: v2
      +
      +

      Server Variable Object

      +

      An object representing a Server Variable for server URL template substitution.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      enum[string]An enumeration of string values to be used if the substitution options are from a limited set. The array MUST NOT be empty.
      defaultstringREQUIRED. The default value to use for substitution, which SHALL be sent if an alternate value is not supplied. Note this behavior is different than the Schema Object’s treatment of default values, because in those cases parameter values are optional. If the enum is defined, the value MUST exist in the enum’s values.
      descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
      +

      This object MAY be extended with Specification Extensions.

      +

      Components Object

      +

      Holds a set of reusable objects for different aspects of the OAS. +All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      schemasMap[string, Schema Object]An object to hold reusable Schema Objects.
      responsesMap[string, Response Object ¦ Reference Object]An object to hold reusable Response Objects.
      parametersMap[string, Parameter Object ¦ Reference Object]An object to hold reusable Parameter Objects.
      examplesMap[string, Example Object ¦ Reference Object]An object to hold reusable Example Objects.
      requestBodiesMap[string, Request Body Object ¦ Reference Object]An object to hold reusable Request Body Objects.
      headersMap[string, Header Object ¦ Reference Object]An object to hold reusable Header Objects.
      securitySchemesMap[string, Security Scheme Object ¦ Reference Object]An object to hold reusable Security Scheme Objects.
      linksMap[string, Link Object ¦ Reference Object]An object to hold reusable Link Objects.
      callbacksMap[string, Callback Object ¦ Reference Object]An object to hold reusable Callback Objects.
      pathItemsMap[string, Path Item Object ¦ Reference Object]An object to hold reusable Path Item Object.
      +

      This object MAY be extended with Specification Extensions.

      +

      All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

      +

      Field Name Examples:

      +
      
      +User
      +User_1
      +User_Name
      +user-name
      +my.org.User
      +
      +

      Components Object Example

      +
      
      +"components": {
      +  "schemas": {
      +    "GeneralError": {
      +      "type": "object",
      +      "properties": {
      +        "code": {
      +          "type": "integer",
      +          "format": "int32"
      +        },
      +        "message": {
      +          "type": "string"
      +        }
      +      }
      +    },
      +    "Category": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      }
      +    },
      +    "Tag": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      }
      +    }
      +  },
      +  "parameters": {
      +    "skipParam": {
      +      "name": "skip",
      +      "in": "query",
      +      "description": "number of items to skip",
      +      "required": true,
      +      "schema": {
      +        "type": "integer",
      +        "format": "int32"
      +      }
      +    },
      +    "limitParam": {
      +      "name": "limit",
      +      "in": "query",
      +      "description": "max records to return",
      +      "required": true,
      +      "schema" : {
      +        "type": "integer",
      +        "format": "int32"
      +      }
      +    }
      +  },
      +  "responses": {
      +    "NotFound": {
      +      "description": "Entity not found."
      +    },
      +    "IllegalInput": {
      +      "description": "Illegal input for operation."
      +    },
      +    "GeneralError": {
      +      "description": "General Error",
      +      "content": {
      +        "application/json": {
      +          "schema": {
      +            "$ref": "#/components/schemas/GeneralError"
      +          }
      +        }
      +      }
      +    }
      +  },
      +  "securitySchemes": {
      +    "api_key": {
      +      "type": "apiKey",
      +      "name": "api_key",
      +      "in": "header"
      +    },
      +    "petstore_auth": {
      +      "type": "oauth2",
      +      "flows": {
      +        "implicit": {
      +          "authorizationUrl": "https://example.org/api/oauth/dialog",
      +          "scopes": {
      +            "write:pets": "modify pets in your account",
      +            "read:pets": "read your pets"
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    GeneralError:
      +      type: object
      +      properties:
      +        code:
      +          type: integer
      +          format: int32
      +        message:
      +          type: string
      +    Category:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +    Tag:
      +      type: object
      +      properties:
      +        id:
      +          type: integer
      +          format: int64
      +        name:
      +          type: string
      +  parameters:
      +    skipParam:
      +      name: skip
      +      in: query
      +      description: number of items to skip
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +    limitParam:
      +      name: limit
      +      in: query
      +      description: max records to return
      +      required: true
      +      schema:
      +        type: integer
      +        format: int32
      +  responses:
      +    NotFound:
      +      description: Entity not found.
      +    IllegalInput:
      +      description: Illegal input for operation.
      +    GeneralError:
      +      description: General Error
      +      content:
      +        application/json:
      +          schema:
      +            $ref: '#/components/schemas/GeneralError'
      +  securitySchemes:
      +    api_key:
      +      type: apiKey
      +      name: api_key
      +      in: header
      +    petstore_auth:
      +      type: oauth2
      +      flows: 
      +        implicit:
      +          authorizationUrl: https://example.org/api/oauth/dialog
      +          scopes:
      +            write:pets: modify pets in your account
      +            read:pets: read your pets
      +
      +

      Paths Object

      +

      Holds the relative paths to the individual endpoints and their operations. +The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to Access Control List (ACL) constraints.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a forward slash (/). The path is appended (no relative URL resolution) to the expanded URL from the Server Object’s url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
      +

      This object MAY be extended with Specification Extensions.

      +

      Path Templating Matching

      +

      Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

      +
      
      +  /pets/{petId}
      +  /pets/mine
      +
      +

      The following paths are considered identical and invalid:

      +
      
      +  /pets/{petId}
      +  /pets/{name}
      +
      +

      The following may lead to ambiguous resolution:

      +
      
      +  /{entity}/me
      +  /books/{id}
      +
      +

      Paths Object Example

      +
      
      +{
      +  "/pets": {
      +    "get": {
      +      "description": "Returns all pets from the system that the user has access to",
      +      "responses": {
      +        "200": {          
      +          "description": "A list of pets.",
      +          "content": {
      +            "application/json": {
      +              "schema": {
      +                "type": "array",
      +                "items": {
      +                  "$ref": "#/components/schemas/pet"
      +                }
      +              }
      +            }
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +/pets:
      +  get:
      +    description: Returns all pets from the system that the user has access to
      +    responses:
      +      '200':
      +        description: A list of pets.
      +        content:
      +          application/json:
      +            schema:
      +              type: array
      +              items:
      +                $ref: '#/components/schemas/pet'
      +
      +

      Path Item Object

      +

      Describes the operations available on a single path. +A Path Item MAY be empty, due to ACL constraints. +The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringAllows for a referenced definition of this path item. The referenced structure MUST be in the form of a Path Item Object. In case a Path Item Object field appears both in the defined object and the referenced object, the behavior is undefined. See the rules for resolving Relative References.
      summarystringAn optional, string summary, intended to apply to all operations in this path.
      descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
      getOperation ObjectA definition of a GET operation on this path.
      putOperation ObjectA definition of a PUT operation on this path.
      postOperation ObjectA definition of a POST operation on this path.
      deleteOperation ObjectA definition of a DELETE operation on this path.
      optionsOperation ObjectA definition of a OPTIONS operation on this path.
      headOperation ObjectA definition of a HEAD operation on this path.
      patchOperation ObjectA definition of a PATCH operation on this path.
      traceOperation ObjectA definition of a TRACE operation on this path.
      servers[Server Object]An alternative server array to service all operations in this path.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      +

      This object MAY be extended with Specification Extensions.

      +

      Path Item Object Example

      +
      
      +{
      +  "get": {
      +    "description": "Returns pets based on ID",
      +    "summary": "Find pets by ID",
      +    "operationId": "getPetsById",
      +    "responses": {
      +      "200": {
      +        "description": "pet response",
      +        "content": {
      +          "*/*": {
      +            "schema": {
      +              "type": "array",
      +              "items": {
      +                "$ref": "#/components/schemas/Pet"
      +              }
      +            }
      +          }
      +        }
      +      },
      +      "default": {
      +        "description": "error payload",
      +        "content": {
      +          "text/html": {
      +            "schema": {
      +              "$ref": "#/components/schemas/ErrorModel"
      +            }
      +          }
      +        }
      +      }
      +    }
      +  },
      +  "parameters": [
      +    {
      +      "name": "id",
      +      "in": "path",
      +      "description": "ID of pet to use",
      +      "required": true,
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
      +        }
      +      },
      +      "style": "simple"
      +    }
      +  ]
      +}
      +
      +
      
      +get:
      +  description: Returns pets based on ID
      +  summary: Find pets by ID
      +  operationId: getPetsById
      +  responses:
      +    '200':
      +      description: pet response
      +      content:
      +        '*/*' :
      +          schema:
      +            type: array
      +            items:
      +              $ref: '#/components/schemas/Pet'
      +    default:
      +      description: error payload
      +      content:
      +        'text/html':
      +          schema:
      +            $ref: '#/components/schemas/ErrorModel'
      +parameters:
      +- name: id
      +  in: path
      +  description: ID of pet to use
      +  required: true
      +  schema:
      +    type: array
      +    items:
      +      type: string  
      +  style: simple
      +
      +

      Operation Object

      +

      Describes a single API operation on a path.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
      summarystringA short summary of what the operation does.
      descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
      operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. The operationId value is case-sensitive. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
      parameters[Parameter Object ¦ Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      requestBodyRequest Body Object ¦ Reference ObjectThe request body applicable for this operation. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as [GET]section-4.3.1), [HEAD]section-4.3.2) and [DELETE]section-4.3.5)), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.
      responsesResponses ObjectThe list of possible responses as they are returned from executing this operation.
      callbacksMap[string, Callback Object ¦ Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses.
      deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
      security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. To make security optional, an empty security requirement ({}) can be included in the array. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
      servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
      +

      This object MAY be extended with Specification Extensions.

      +

      Operation Object Example

      +
      
      +{
      +  "tags": [
      +    "pet"
      +  ],
      +  "summary": "Updates a pet in the store with form data",
      +  "operationId": "updatePetWithForm",
      +  "parameters": [
      +    {
      +      "name": "petId",
      +      "in": "path",
      +      "description": "ID of pet that needs to be updated",
      +      "required": true,
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  ],
      +  "requestBody": {
      +    "content": {
      +      "application/x-www-form-urlencoded": {
      +        "schema": {
      +          "type": "object",
      +          "properties": {
      +            "name": { 
      +              "description": "Updated name of the pet",
      +              "type": "string"
      +            },
      +            "status": {
      +              "description": "Updated status of the pet",
      +              "type": "string"
      +            }
      +          },
      +          "required": ["status"] 
      +        }
      +      }
      +    }
      +  },
      +  "responses": {
      +    "200": {
      +      "description": "Pet updated.",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
      +      }
      +    },
      +    "405": {
      +      "description": "Method Not Allowed",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
      +      }
      +    }
      +  },
      +  "security": [
      +    {
      +      "petstore_auth": [
      +        "write:pets",
      +        "read:pets"
      +      ]
      +    }
      +  ]
      +}
      +
      +
      
      +tags:
      +- pet
      +summary: Updates a pet in the store with form data
      +operationId: updatePetWithForm
      +parameters:
      +- name: petId
      +  in: path
      +  description: ID of pet that needs to be updated
      +  required: true
      +  schema:
      +    type: string
      +requestBody:
      +  content:
      +    'application/x-www-form-urlencoded':
      +      schema:
      +       type: object
      +       properties:
      +          name: 
      +            description: Updated name of the pet
      +            type: string
      +          status:
      +            description: Updated status of the pet
      +            type: string
      +       required:
      +         - status
      +responses:
      +  '200':
      +    description: Pet updated.
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +  '405':
      +    description: Method Not Allowed
      +    content: 
      +      'application/json': {}
      +      'application/xml': {}
      +security:
      +- petstore_auth:
      +  - write:pets
      +  - read:pets
      +
      +

      External Documentation Object

      +

      Allows referencing an external resource for extended documentation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA description of the target documentation. CommonMark syntax MAY be used for rich text representation.
      urlstringREQUIRED. The URL for the target documentation. This MUST be in the form of a URL.
      +

      This object MAY be extended with Specification Extensions.

      +

      External Documentation Object Example

      +
      
      +{
      +  "description": "Find more info here",
      +  "url": "https://example.com"
      +}
      +
      +
      
      +description: Find more info here
      +url: https://example.com
      +
      +

      Parameter Object

      +

      Describes a single operation parameter.

      +

      A unique parameter is defined by a combination of a name and location.

      +

      Parameter Locations

      +

      There are four possible parameter locations specified by the in field:

      +
        +
      • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
      • +
      • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
      • +
      • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
      • +
      • cookie - Used to pass a specific cookie value to the API.
      • +
      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
      • If in is "path", the name field MUST correspond to a template expression occurring within the path field in the Paths Object. See Path Templating for further information.
      • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
      • For all other cases, the name corresponds to the parameter name used by the in property.
      instringREQUIRED. The location of the parameter. Possible values are "query", "header", "path" or "cookie".
      descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
      requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is "path", this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
      deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage. Default value is false.
      allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored. Use of this property is NOT RECOMMENDED, as it is likely to be removed in a later revision.
      +

      The rules for serialization of the parameter are specified in one of two ways. +For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
      explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
      allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
      schemaSchema ObjectThe schema defining the type used for the parameter.
      exampleAnyExample of the parameter’s potential value. The example SHOULD match the specified schema and encoding properties if present. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema that contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
      examplesMap[ string, Example Object ¦ Reference Object]Examples of the parameter’s potential value. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema that contains an example, the examples value SHALL override the example provided by the schema.
      +

      For more complex scenarios, the content property can define the media type and schema of the parameter. +A parameter MUST contain either a schema property, or a content property, but not both. +When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
      +

      Style Values

      +

      In order to support common ways of serializing simple parameters, a set of style values are defined.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      styletypeinComments
      matrixprimitive, array, objectpathPath-style parameters defined by [[!RFC6570]]
      labelprimitive, array, objectpathLabel style parameters defined by [[!RFC6570]]
      formprimitive, array, objectquery, cookieForm style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
      simplearraypath, headerSimple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0.
      spaceDelimitedarray, objectquerySpace separated array or object values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
      pipeDelimitedarray, objectqueryPipe separated array or object values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
      deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
      +

      Style Examples

      +

      Assume a parameter named color has one of the following values:

      +
      
      +   string -> "blue"
      +   array -> ["blue","black","brown"]
      +   object -> { "R": 100, "G": 200, "B": 150 }
      +
      +

      The following table shows examples of rendering differences for each value.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      styleexplodeemptystringarrayobject
      matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
      matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
      labelfalse..blue.blue.black.brown.R.100.G.200.B.150
      labeltrue..blue.blue.black.brown.R=100.G=200.B=150
      formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
      formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
      simplefalsen/ablueblue,black,brownR,100,G,200,B,150
      simpletruen/ablueblue,black,brownR=100,G=200,B=150
      spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
      pipeDelimitedfalsen/an/ablue¦black¦brownR¦100¦G¦200¦B¦150
      deepObjecttruen/an/an/acolor\R=100&color\G=200&color\B=150
      +

      This object MAY be extended with Specification Extensions.

      +

      Parameter Object Examples

      +

      A header parameter with an array of 64 bit integer numbers:

      +
      
      +{
      +  "name": "token",
      +  "in": "header",
      +  "description": "token to be passed as a header",
      +  "required": true,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "integer",
      +      "format": "int64"
      +    }
      +  },
      +  "style": "simple"
      +}
      +
      +
      
      +name: token
      +in: header
      +description: token to be passed as a header
      +required: true
      +schema:
      +  type: array
      +  items:
      +    type: integer
      +    format: int64
      +style: simple
      +
      +

      A path parameter of a string value:

      +
      
      +{
      +  "name": "username",
      +  "in": "path",
      +  "description": "username to fetch",
      +  "required": true,
      +  "schema": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +name: username
      +in: path
      +description: username to fetch
      +required: true
      +schema:
      +  type: string
      +
      +

      An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

      +
      
      +{
      +  "name": "id",
      +  "in": "query",
      +  "description": "ID of the object to fetch",
      +  "required": false,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    }
      +  },
      +  "style": "form",
      +  "explode": true
      +}
      +
      +
      
      +name: id
      +in: query
      +description: ID of the object to fetch
      +required: false
      +schema:
      +  type: array
      +  items:
      +    type: string
      +style: form
      +explode: true
      +
      +

      A free-form query parameter, allowing undefined parameters of a specific type:

      +
      
      +{
      +  "in": "query",
      +  "name": "freeForm",
      +  "schema": {
      +    "type": "object",
      +    "additionalProperties": {
      +      "type": "integer"
      +    },
      +  },
      +  "style": "form"
      +}
      +
      +
      
      +in: query
      +name: freeForm
      +schema:
      +  type: object
      +  additionalProperties:
      +    type: integer
      +style: form
      +
      +

      A complex parameter using content to define serialization:

      +
      
      +{
      +  "in": "query",
      +  "name": "coordinates",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "object",
      +        "required": [
      +          "lat",
      +          "long"
      +        ],
      +        "properties": {
      +          "lat": {
      +            "type": "number"
      +          },
      +          "long": {
      +            "type": "number"
      +          }
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +in: query
      +name: coordinates
      +content:
      +  application/json:
      +    schema:
      +      type: object
      +      required:
      +        - lat
      +        - long
      +      properties:
      +        lat:
      +          type: number
      +        long:
      +          type: number
      +
      +

      Request Body Object

      +

      Describes a single request body.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
      contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
      requiredbooleanDetermines if the request body is required in the request. Defaults to false.
      +

      This object MAY be extended with Specification Extensions.

      +

      Request Body Examples

      +

      A request body with a referenced model definition.

      +
      
      +{
      +  "description": "user to add to the system",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
      +      },
      +      "examples": {
      +          "user" : {
      +            "summary": "User Example", 
      +            "externalValue": "https://foo.bar/examples/user-example.json"
      +          } 
      +        }
      +    },
      +    "application/xml": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
      +      },
      +      "examples": {
      +          "user" : {
      +            "summary": "User example in XML",
      +            "externalValue": "https://foo.bar/examples/user-example.xml"
      +          }
      +        }
      +    },
      +    "text/plain": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in Plain text",
      +            "externalValue": "https://foo.bar/examples/user-example.txt" 
      +        }
      +      } 
      +    },
      +    "*/*": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in other format",
      +            "externalValue": "https://foo.bar/examples/user-example.whatever"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: user to add to the system
      +content: 
      +  'application/json':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User Example
      +        externalValue: 'https://foo.bar/examples/user-example.json'
      +  'application/xml':
      +    schema:
      +      $ref: '#/components/schemas/User'
      +    examples:
      +      user:
      +        summary: User example in XML
      +        externalValue: 'https://foo.bar/examples/user-example.xml'
      +  'text/plain':
      +    examples:
      +      user:
      +        summary: User example in Plain text
      +        externalValue: 'https://foo.bar/examples/user-example.txt'
      +  '*/*':
      +    examples:
      +      user: 
      +        summary: User example in other format
      +        externalValue: 'https://foo.bar/examples/user-example.whatever'
      +
      +

      A body parameter that is an array of string values:

      +
      
      +{
      +  "description": "user to add to the system",
      +  "required": true,
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: user to add to the system
      +required: true
      +content:
      +  text/plain:
      +    schema:
      +      type: array
      +      items:
      +        type: string
      +
      +

      Media Type Object

      +

      Each Media Type Object provides schema and examples for the media type identified by its key.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      schemaSchema ObjectThe schema defining the content of the request, response, or parameter.
      exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
      examplesMap[ string, Example Object ¦ Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
      encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
      +

      This object MAY be extended with Specification Extensions.

      +

      Media Type Examples

      +
      
      +{
      +  "application/json": {
      +    "schema": {
      +         "$ref": "#/components/schemas/Pet"
      +    },
      +    "examples": {
      +      "cat" : {
      +        "summary": "An example of a cat",
      +        "value": 
      +          {
      +            "name": "Fluffy",
      +            "petType": "Cat",
      +            "color": "White",
      +            "gender": "male",
      +            "breed": "Persian"
      +          }
      +      },
      +      "dog": {
      +        "summary": "An example of a dog with a cat's name",
      +        "value" :  { 
      +          "name": "Puma",
      +          "petType": "Dog",
      +          "color": "Black",
      +          "gender": "Female",
      +          "breed": "Mixed"
      +        },
      +      "frog": {
      +          "$ref": "#/components/examples/frog-example"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +application/json: 
      +  schema:
      +    $ref: "#/components/schemas/Pet"
      +  examples:
      +    cat:
      +      summary: An example of a cat
      +      value:
      +        name: Fluffy
      +        petType: Cat
      +        color: White
      +        gender: male
      +        breed: Persian
      +    dog:
      +      summary: An example of a dog with a cat's name
      +      value:
      +        name: Puma
      +        petType: Dog
      +        color: Black
      +        gender: Female
      +        breed: Mixed
      +    frog:
      +      $ref: "#/components/examples/frog-example"
      +
      +

      Considerations for File Uploads

      +

      In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type.

      +

      In contrast with the 3.0 specification, the format keyword has no effect on the content-encoding of the schema. JSON Schema offers a contentEncoding keyword, which may be used to specify the Content-Encoding for the schema. The contentEncoding keyword supports all encodings defined in [[!RFC4648]], including “base64” and “base64url”, as well as “quoted-printable” from [[!RFC2045]]. The encoding specified by the contentEncoding keyword is independent of an encoding specified by the Content-Type header in the request or response or metadata of a multipart body – when both are present, the encoding specified in the contentEncoding is applied first and then the encoding specified in the Content-Type header.

      +

      JSON Schema also offers a contentMediaType keyword. However, when the media type is already specified by the Media Type Object’s key, or by the contentType field of an Encoding Object, the contentMediaType keyword SHALL be ignored if present.

      +

      Examples:

      +

      Content transferred in binary (octet-stream) MAY omit schema:

      +
      
      +# a PNG image as a binary file:
      +content:
      +    image/png: {}
      +
      +
      
      +# an arbitrary binary file:
      +content:
      +    application/octet-stream: {}
      +
      +

      Binary content transferred with base64 encoding:

      +
      
      +content:
      +    image/png:
      +        schema:
      +            type: string
      +            contentMediaType: image/png
      +            contentEncoding: base64
      +
      +

      Note that the Content-Type remains image/png, describing the semantics of the payload. The JSON Schema type and contentEncoding fields explain that the payload is transferred as text. The JSON Schema contentMediaType is technically redundant, but can be used by JSON Schema tools that may not be aware of the OpenAPI context.

      +

      These examples apply to either input payloads of file uploads or response payloads.

      +

      A requestBody for submitting a file in a POST operation may look like the following example:

      +
      
      +requestBody:
      +  content:
      +    application/octet-stream: {}
      +
      +

      In addition, specific media types MAY be specified:

      +
      
      +# multiple, specific media types may be specified:
      +requestBody:
      +  content:
      +    # a binary file of type png or jpeg
      +    image/jpeg: {}
      +    image/png: {}
      +
      +

      To upload multiple files, a multipart media type MUST be used:

      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        properties:
      +          # The property name 'file' will be used for all files.
      +          file:
      +            type: array
      +            items: {}
      +
      +

      As seen in the section on multipart/form-data below, the empty schema for items indicates a media type of application/octet-stream.

      +

      Support for x-www-form-urlencoded Request Bodies

      +

      To submit content using form url encoding via [[!RFC1866]], the following +definition may be used:

      +
      
      +requestBody:
      +  content:
      +    application/x-www-form-urlencoded:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # complex types are stringified to support RFC 1866
      +            type: object
      +            properties: {}
      +
      +

      In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

      +

      When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object’s style property as form.

      +

      Special Considerations for multipart Content

      +

      It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

      +

      In a multipart/form-data request body, each schema property, or each element of a schema array property, takes a section in the payload with an internal header as defined by [[!RFC7578]]. The serialization strategy for each property of a multipart/form-data request body can be specified in an associated Encoding Object.

      +

      When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred – thus, the following default Content-Types are defined for multipart:

      +
        +
      • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
      • +
      • If the property is complex, or an array of complex values, the default Content-Type is application/json
      • +
      • If the property is a type: string with a contentEncoding, the default Content-Type is application/octet-stream
      • +
      +

      Per the JSON Schema specification, contentMediaType without contentEncoding present is treated as if contentEncoding: identity were present. While useful for embedding text documents such as text/html into JSON strings, it is not useful for a multipart/form-data part, as it just causes the document to be treated as text/plain instead of its actual media type. Use the Encoding Object without contentMediaType if no contentEncoding is required.

      +

      Examples:

      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            type: string
      +            format: uuid
      +          address:
      +            # default Content-Type for objects is `application/json`
      +            type: object
      +            properties: {}
      +          profileImage:
      +            # Content-Type for application-level encoded resource is `text/plain`
      +            type: string
      +            contentMediaType: image/png
      +            contentEncoding: base64
      +          children:
      +            # default Content-Type for arrays is based on the _inner_ type (`text/plain` here)
      +            type: array
      +            items:
      +              type: string
      +          addresses:
      +            # default Content-Type for arrays is based on the _inner_ type (object shown, so `application/json` in this example)
      +            type: array
      +            items:
      +              type: object
      +              $ref: '#/components/schemas/Address'
      +
      +

      An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

      +

      Encoding Object

      +

      A single encoding definition applied to a single schema property.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for object - application/json; for array – the default is defined based on the inner type; for all other cases the default is application/octet-stream. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
      headersMap[string, Header Object ¦ Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
      stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
      explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
      allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
      +

      This object MAY be extended with Specification Extensions.

      +

      Encoding Object Example

      +
      
      +requestBody:
      +  content:
      +    multipart/form-data:
      +      schema:
      +        type: object
      +        properties:
      +          id:
      +            # default is text/plain
      +            type: string
      +            format: uuid
      +          address:
      +            # default is application/json
      +            type: object
      +            properties: {}
      +          historyMetadata:
      +            # need to declare XML format!
      +            description: metadata in XML format
      +            type: object
      +            properties: {}
      +          profileImage: {}
      +      encoding:
      +        historyMetadata:
      +          # require XML Content-Type in utf-8 encoding
      +          contentType: application/xml; charset=utf-8
      +        profileImage:
      +          # only accept png/jpeg
      +          contentType: image/png, image/jpeg
      +          headers:
      +            X-Rate-Limit-Limit:
      +              description: The number of allowed requests in the current period
      +              schema:
      +                type: integer
      +
      +

      Responses Object

      +

      A container for the expected responses of an operation. +The container maps a HTTP response code to the expected response.

      +

      The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. +However, documentation is expected to cover a successful operation response and any known errors.

      +

      The default MAY be used as a default response object for all HTTP codes +that are not covered individually by the Responses Object.

      +

      The Responses Object MUST contain at least one response code, and if only one +response code is provided it SHOULD be the response for a successful operation +call.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      defaultResponse Object ¦ Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses.
      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      HTTP Status CodeResponse Object ¦ Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. Only the following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
      +

      This object MAY be extended with Specification Extensions.

      +

      Responses Object Example

      +

      A 200 response for a successful operation and a default response for others (implying an error):

      +
      
      +{
      +  "200": {
      +    "description": "a pet to be returned",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/Pet"
      +        }
      +      }
      +    }
      +  },
      +  "default": {
      +    "description": "Unexpected error",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/ErrorModel"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +'200':
      +  description: a pet to be returned
      +  content: 
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/Pet'
      +default:
      +  description: Unexpected error
      +  content:
      +    application/json:
      +      schema:
      +        $ref: '#/components/schemas/ErrorModel'
      +
      +

      Response Object

      +

      Describes a single response from an API Operation, including design-time, static +links to operations based on the response.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      descriptionstringREQUIRED. A description of the response. CommonMark syntax MAY be used for rich text representation.
      headersMap[string, Header Object ¦ Reference Object]Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
      contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
      linksMap[string, Link Object ¦ Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
      +

      This object MAY be extended with Specification Extensions.

      +

      Response Object Examples

      +

      Response of an array of a complex type:

      +
      
      +{
      +  "description": "A complex object array response",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "$ref": "#/components/schemas/VeryComplexType"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: A complex object array response
      +content: 
      +  application/json:
      +    schema: 
      +      type: array
      +      items:
      +        $ref: '#/components/schemas/VeryComplexType'
      +
      +

      Response with a string type:

      +
      
      +{
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string"
      +      }
      +    }
      +  }
      +
      +}
      +
      +
      
      +description: A simple string response
      +content:
      +  text/plain:
      +    schema:
      +      type: string
      +
      +

      Plain text response with headers:

      +
      
      +{
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string",
      +        "example": "whoa!"
      +      }
      +    }
      +  },
      +  "headers": {
      +    "X-Rate-Limit-Limit": {
      +      "description": "The number of allowed requests in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    },
      +    "X-Rate-Limit-Remaining": {
      +      "description": "The number of remaining requests in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    },
      +    "X-Rate-Limit-Reset": {
      +      "description": "The number of seconds left in the current period",
      +      "schema": {
      +        "type": "integer"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +description: A simple string response
      +content:
      +  text/plain:
      +    schema:
      +      type: string
      +    example: 'whoa!'
      +headers:
      +  X-Rate-Limit-Limit:
      +    description: The number of allowed requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Remaining:
      +    description: The number of remaining requests in the current period
      +    schema:
      +      type: integer
      +  X-Rate-Limit-Reset:
      +    description: The number of seconds left in the current period
      +    schema:
      +      type: integer
      +
      +

      Response with no return value:

      +
      
      +{
      +  "description": "object created"
      +}
      +
      +
      
      +description: object created
      +
      +

      Callback Object

      +

      A map of possible out-of band callbacks related to the parent operation. +Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. +The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

      +

      To describe incoming requests from the API provider independent from another API call, use the webhooks field.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {expression}Path Item Object ¦ Reference ObjectA Path Item Object, or a reference to one, used to define a callback request and expected responses. A complete example is available.
      +

      This object MAY be extended with Specification Extensions.

      +

      Key Expression

      +

      The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. +A simple example might be $request.body#/url. +However, using a runtime expression the complete HTTP message can be accessed. +This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

      +

      For example, given the following HTTP request:

      +
      
      +POST /subscribe/myevent?queryUrl=https://clientdomain.com/stillrunning HTTP/1.1
      +Host: example.org
      +Content-Type: application/json
      +Content-Length: 187
      +
      +{
      +  "failedUrl" : "https://clientdomain.com/failed",
      +  "successUrls" : [
      +    "https://clientdomain.com/fast",
      +    "https://clientdomain.com/medium",
      +    "https://clientdomain.com/slow"
      +  ] 
      +}
      +
      +201 Created
      +Location: https://example.org/subscription/1
      +
      +

      The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      ExpressionValue
      $urlhttps://example.org/subscribe/myevent?queryUrl=https://clientdomain.com/stillrunning
      $methodPOST
      $request.path.eventTypemyevent
      $request.query.queryUrlhttps://clientdomain.com/stillrunning
      $request.header.content-Typeapplication/json
      $request.body#/failedUrlhttps://clientdomain.com/failed
      $request.body#/successUrls/2https://clientdomain.com/medium
      $response.header.Locationhttps://example.org/subscription/1
      +

      Callback Object Examples

      +

      The following example uses the user provided queryUrl query string parameter to define the callback URL. This is an example of how to use a callback object to describe a WebHook callback that goes with the subscription operation to enable registering for the WebHook.

      +
      
      +myCallback:
      +  '{$request.query.queryUrl}':
      +    post:
      +      requestBody:
      +        description: Callback payload
      +        content:
      +          'application/json':
      +            schema:
      +              $ref: '#/components/schemas/SomePayload'
      +      responses:
      +        '200':
      +          description: callback successfully processed
      +
      +

      The following example shows a callback where the server is hard-coded, but the query string parameters are populated from the id and email property in the request body.

      +
      
      +transactionCallback:
      +  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
      +    post:
      +      requestBody:
      +        description: Callback payload
      +        content:
      +          'application/json':
      +            schema:
      +              $ref: '#/components/schemas/SomePayload'
      +      responses:
      +        '200':
      +          description: callback successfully processed
      +
      +

      Example Object

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      summarystringShort description for the example.
      descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
      valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
      externalValuestringA URI that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive. See the rules for resolving Relative References.
      +

      This object MAY be extended with Specification Extensions.

      +

      In all cases, the example value is expected to be compatible with the type schema +of its associated value. Tooling implementations MAY choose to +validate compatibility automatically, and reject the example value(s) if incompatible.

      +

      Example Object Examples

      +

      In a request body:

      +
      
      +requestBody:
      +  content:
      +    'application/json':
      +      schema:
      +        $ref: '#/components/schemas/Address'
      +      examples: 
      +        foo:
      +          summary: A foo example
      +          value: {"foo": "bar"}
      +        bar:
      +          summary: A bar example
      +          value: {"bar": "baz"}
      +    'application/xml':
      +      examples: 
      +        xmlExample:
      +          summary: This is an example in XML
      +          externalValue: 'https://example.org/examples/address-example.xml'
      +    'text/plain':
      +      examples:
      +        textExample: 
      +          summary: This is a text example
      +          externalValue: 'https://foo.bar/examples/address-example.txt'
      +
      +

      In a parameter:

      +
      
      +parameters:
      +  - name: 'zipCode'
      +    in: 'query'
      +    schema:
      +      type: 'string'
      +      format: 'zip-code'
      +    examples:
      +      zip-example: 
      +        $ref: '#/components/examples/zip-example'
      +
      +

      In a response:

      +
      
      +responses:
      +  '200':
      +    description: your car appointment has been booked
      +    content: 
      +      application/json:
      +        schema:
      +          $ref: '#/components/schemas/SuccessResponse'
      +        examples:
      +          confirmation-success:
      +            $ref: '#/components/examples/confirmation-success'
      +
      +

      Link Object

      +

      The Link object represents a possible design-time link for a response. +The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

      +

      Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

      +

      For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      operationRefstringA relative or absolute URI reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition. See the rules for resolving Relative References.
      operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
      parametersMap[string, Any ¦ {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
      requestBodyAny ¦ {expression}A literal value or {expression} to use as a request body when calling the target operation.
      descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
      serverServer ObjectA server object to be used by the target operation.
      +

      This object MAY be extended with Specification Extensions.

      +

      A linked operation MUST be identified using either an operationRef or operationId. +In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. +Because of the potential for name clashes, the operationRef syntax is preferred +for OpenAPI documents with external references.

      +

      Examples

      +

      Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

      +
      
      +paths:
      +  /users/{id}:
      +    parameters:
      +    - name: id
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +    get:
      +      responses:
      +        '200':
      +          description: the user being returned
      +          content:
      +            application/json:
      +              schema:
      +                type: object
      +                properties:
      +                  uuid: # the unique user id
      +                    type: string
      +                    format: uuid
      +          links:
      +            address:
      +              # the target link operationId
      +              operationId: getUserAddress
      +              parameters:
      +                # get the `id` field from the request path parameter named `id`
      +                userId: $request.path.id
      +  # the path item of the linked operation
      +  /users/{userid}/address:
      +    parameters:
      +    - name: userid
      +      in: path
      +      required: true
      +      description: the user identifier, as userId 
      +      schema:
      +        type: string
      +    # linked operation
      +    get:
      +      operationId: getUserAddress
      +      responses:
      +        '200':
      +          description: the user's address
      +
      +

      When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

      +

      Values from the response body can be used to drive a linked operation.

      +
      
      +links:
      +  address:
      +    operationId: getUserAddressByUUID
      +    parameters:
      +      # get the `uuid` field from the `uuid` field in the response body
      +      userUuid: $response.body#/uuid
      +
      +

      Clients follow all links at their discretion. +Neither permissions, nor the capability to make a successful call to that link, is guaranteed +solely by the existence of a relationship.

      +

      OperationRef Examples

      +

      As references to operationId MAY NOT be possible (the operationId is an optional +field in an Operation Object), references MAY also be made through a relative operationRef:

      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
      +
      +

      or an absolute operationRef:

      +
      
      +links:
      +  UserRepositories:
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
      +    parameters:
      +      username: $response.body#/username
      +
      +

      Note that in the use of operationRef, the escaped forward-slash is necessary when +using JSON references.

      +

      Runtime Expressions

      +

      Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. +This mechanism is used by Link Objects and Callback Objects.

      +

      The runtime expression is defined by the following [ABNF] syntax

      +
      
      +      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
      +      source = ( header-reference / query-reference / path-reference / body-reference )
      +      header-reference = "header." token
      +      query-reference = "query." name  
      +      path-reference = "path." name
      +      body-reference = "body" ["#" json-pointer ]
      +      json-pointer    = *( "/" reference-token )
      +      reference-token = *( unescaped / escaped )
      +      unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
      +         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
      +      escaped         = "~" ( "0" / "1" )
      +        ; representing '~' and '/', respectively
      +      name = *( CHAR )
      +      token = 1*tchar
      +      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
      +        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
      +
      +

      Here, json-pointer is taken from [[!RFC6901]], char from [[!RFC7159]] and token from [[!RFC7230]].

      +

      The name identifier is case-sensitive, whereas token is not.

      +

      The table below provides examples of runtime expressions and examples of their use in a value:

      +

      Examples

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Source Locationexample expressionnotes
      HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
      Requested media type$request.header.accept
      Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
      Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
      Request URL$url
      Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
      Response header$response.header.ServerSingle header values only are available
      +

      Runtime expressions preserve the type of the referenced value. +Expressions can be embedded into string values by surrounding the expression with {} curly braces.

      +

      Header Object

      +

      The Header Object follows the structure of the Parameter Object with the following changes:

      +
        +
      1. name MUST NOT be specified, it is given in the corresponding headers map.
      2. +
      3. in MUST NOT be specified, it is implicitly in header.
      4. +
      5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
      6. +
      +

      Header Object Example

      +

      A simple header of type integer:

      +
      
      +{
      +  "description": "The number of allowed requests in the current period",
      +  "schema": {
      +    "type": "integer"
      +  }
      +}
      +
      +
      
      +description: The number of allowed requests in the current period
      +schema:
      +  type: integer
      +
      +

      Tag Object

      +

      Adds metadata to a single tag that is used by the Operation Object. +It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringREQUIRED. The name of the tag.
      descriptionstringA description for the tag. CommonMark syntax MAY be used for rich text representation.
      externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
      +

      This object MAY be extended with Specification Extensions.

      +

      Tag Object Example

      +
      
      +{
      +	"name": "pet",
      +	"description": "Pets operations"
      +}
      +
      +
      
      +name: pet
      +description: Pets operations
      +
      +

      Reference Object

      +

      A simple object to allow referencing other components in the OpenAPI document, internally and externally.

      +

      The $ref string value contains a URI [[!RFC3986]], which identifies the location of the value being referenced.

      +

      See the rules for resolving Relative References.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      $refstringREQUIRED. The reference identifier. This MUST be in the form of a URI.
      summarystringA short summary which by default SHOULD override that of the referenced component. If the referenced object-type does not allow a summary field, then this field has no effect.
      descriptionstringA description which by default SHOULD override that of the referenced component. CommonMark syntax MAY be used for rich text representation. If the referenced object-type does not allow a description field, then this field has no effect.
      +

      This object cannot be extended with additional properties and any properties added SHALL be ignored.

      +

      Note that this restriction on additional properties is a difference between Reference Objects and Schema Objects that contain a $ref keyword.

      +

      Reference Object Example

      +
      
      +{
      +	"$ref": "#/components/schemas/Pet"
      +}
      +
      +
      
      +$ref: '#/components/schemas/Pet'
      +
      +

      Relative Schema Document Example

      +
      
      +{
      +  "$ref": "Pet.json"
      +}
      +
      +
      
      +$ref: Pet.yaml
      +
      +

      Relative Documents With Embedded Schema Example

      +
      
      +{
      +  "$ref": "definitions.json#/Pet"
      +}
      +
      +
      
      +$ref: definitions.yaml#/Pet
      +
      +

      Schema Object

      +

      The Schema Object allows the definition of input and output data types. +These types can be objects, but also primitives and arrays. This object is a superset of the JSON Schema Specification Draft 2020-12.

      +

      For more information about the properties, see JSON Schema Core and JSON Schema Validation.

      +

      Unless stated otherwise, the property definitions follow those of JSON Schema and do not add any additional semantics. +Where JSON Schema indicates that behavior is defined by the application (e.g. for annotations), OAS also defers the definition of semantics to the application consuming the OpenAPI document.

      +

      Properties

      +

      The OpenAPI Schema Object dialect is defined as requiring the OAS base vocabulary, in addition to the vocabularies as specified in the JSON Schema draft 2020-12 general purpose meta-schema.

      +

      The OpenAPI Schema Object dialect for this version of the specification is identified by the URI https://spec.openapis.org/oas/3.1/dialect/base (the “OAS dialect schema id”).

      +

      The following properties are taken from the JSON Schema specification but their definitions have been extended by the OAS:

      +
        +
      • description - CommonMark syntax MAY be used for rich text representation.
      • +
      • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
      • +
      +

      In addition to the JSON Schema properties comprising the OAS dialect, the Schema Object supports keywords from any other vocabularies, or entirely arbitrary properties.

      +

      The OpenAPI Specification’s base vocabulary is comprised of the following keywords:

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
      xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
      externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
      exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.

      Deprecated: The example property has been deprecated in favor of the JSON Schema examples keyword. Use of example is discouraged, and later versions of this specification may remove it.
      +

      This object MAY be extended with Specification Extensions, though as noted, additional properties MAY omit the x- prefix within this object.

      +
      Composition and Inheritance (Polymorphism)
      +

      The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. +allOf takes an array of object definitions that are validated independently but together compose a single object.

      +

      While composition offers model extensibility, it does not imply a hierarchy between the models. +To support polymorphism, the OpenAPI Specification adds the discriminator field. +When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. +As such, the discriminator field MUST be a required field. +There are two ways to define the value of a discriminator for an inheriting instance.

      +
        +
      • Use the schema name.
      • +
      • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. +As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
      • +
      +
      XML Modeling
      +

      The xml property allows extra definitions when translating the JSON definition to XML. +The XML Object contains additional information about the available options.

      +
      Specifying Schema Dialects
      +

      It is important for tooling to be able to determine which dialect or meta-schema any given resource wishes to be processed with: JSON Schema Core, JSON Schema Validation, OpenAPI Schema dialect, or some custom meta-schema.

      +

      The $schema keyword MAY be present in any root Schema Object, and if present MUST be used to determine which dialect should be used when processing the schema. This allows use of Schema Objects which comply with other drafts of JSON Schema than the default Draft 2020-12 support. Tooling MUST support the OAS dialect schema id, and MAY support additional values of $schema.

      +

      To allow use of a different default $schema value for all Schema Objects contained within an OAS document, a jsonSchemaDialect value may be set within the OpenAPI Object. If this default is not set, then the OAS dialect schema id MUST be used for these Schema Objects. The value of $schema within a Schema Object always overrides any default.

      +

      When a Schema Object is referenced from an external resource which is not an OAS document (e.g. a bare JSON Schema resource), then the value of the $schema keyword for schemas within that resource MUST follow JSON Schema rules.

      +

      Schema Object Examples

      +
      Primitive Sample
      +
      
      +{
      +  "type": "string",
      +  "format": "email"
      +}
      +
      +
      
      +type: string
      +format: email
      +
      +
      Simple Model
      +
      
      +{
      +  "type": "object",
      +  "required": [
      +    "name"
      +  ],
      +  "properties": {
      +    "name": {
      +      "type": "string"
      +    },
      +    "address": {
      +      "$ref": "#/components/schemas/Address"
      +    },
      +    "age": {
      +      "type": "integer",
      +      "format": "int32",
      +      "minimum": 0
      +    }
      +  }
      +}
      +
      +
      
      +type: object
      +required:
      +- name
      +properties:
      +  name:
      +    type: string
      +  address:
      +    $ref: '#/components/schemas/Address'
      +  age:
      +    type: integer
      +    format: int32
      +    minimum: 0
      +
      +
      Model with Map/Dictionary Properties
      +

      For a simple string to string mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "type": "string"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  type: string
      +
      +

      For a string to model mapping:

      +
      
      +{
      +  "type": "object",
      +  "additionalProperties": {
      +    "$ref": "#/components/schemas/ComplexModel"
      +  }
      +}
      +
      +
      
      +type: object
      +additionalProperties:
      +  $ref: '#/components/schemas/ComplexModel'
      +
      +
      Model with Example
      +
      
      +{
      +  "type": "object",
      +  "properties": {
      +    "id": {
      +      "type": "integer",
      +      "format": "int64"
      +    },
      +    "name": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "name"
      +  ],
      +  "example": {
      +    "name": "Puma",
      +    "id": 1
      +  }
      +}
      +
      +
      
      +type: object
      +properties:
      +  id:
      +    type: integer
      +    format: int64
      +  name:
      +    type: string
      +required:
      +- name
      +example:
      +  name: Puma
      +  id: 1
      +
      +
      Models with Composition
      +
      
      +{
      +  "components": {
      +    "schemas": {
      +      "ErrorModel": {
      +        "type": "object",
      +        "required": [
      +          "message",
      +          "code"
      +        ],
      +        "properties": {
      +          "message": {
      +            "type": "string"
      +          },
      +          "code": {
      +            "type": "integer",
      +            "minimum": 100,
      +            "maximum": 600
      +          }
      +        }
      +      },
      +      "ExtendedErrorModel": {
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/ErrorModel"
      +          },
      +          {
      +            "type": "object",
      +            "required": [
      +              "rootCause"
      +            ],
      +            "properties": {
      +              "rootCause": {
      +                "type": "string"
      +              }
      +            }
      +          }
      +        ]
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    ErrorModel:
      +      type: object
      +      required:
      +      - message
      +      - code
      +      properties:
      +        message:
      +          type: string
      +        code:
      +          type: integer
      +          minimum: 100
      +          maximum: 600
      +    ExtendedErrorModel:
      +      allOf:
      +      - $ref: '#/components/schemas/ErrorModel'
      +      - type: object
      +        required:
      +        - rootCause
      +        properties:
      +          rootCause:
      +            type: string
      +
      +
      Models with Polymorphism Support
      +
      
      +{
      +  "components": {
      +    "schemas": {
      +      "Pet": {
      +        "type": "object",
      +        "discriminator": {
      +          "propertyName": "petType"
      +        },
      +        "properties": {
      +          "name": {
      +            "type": "string"
      +          },
      +          "petType": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "petType"
      +        ]
      +      },
      +      "Cat": {
      +        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/Pet"
      +          },
      +          {
      +            "type": "object",
      +            "properties": {
      +              "huntingSkill": {
      +                "type": "string",
      +                "description": "The measured skill for hunting",
      +                "default": "lazy",
      +                "enum": [
      +                  "clueless",
      +                  "lazy",
      +                  "adventurous",
      +                  "aggressive"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "huntingSkill"
      +            ]
      +          }
      +        ]
      +      },
      +      "Dog": {
      +        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
      +        "allOf": [
      +          {
      +            "$ref": "#/components/schemas/Pet"
      +          },
      +          {
      +            "type": "object",
      +            "properties": {
      +              "packSize": {
      +                "type": "integer",
      +                "format": "int32",
      +                "description": "the size of the pack the dog is from",
      +                "default": 0,
      +                "minimum": 0
      +              }
      +            },
      +            "required": [
      +              "packSize"
      +            ]
      +          }
      +        ]
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +components:
      +  schemas:
      +    Pet:
      +      type: object
      +      discriminator:
      +        propertyName: petType
      +      properties:
      +        name:
      +          type: string
      +        petType:
      +          type: string
      +      required:
      +      - name
      +      - petType
      +    Cat:  ## "Cat" will be used as the discriminator value
      +      description: A representation of a cat
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          huntingSkill:
      +            type: string
      +            description: The measured skill for hunting
      +            enum:
      +            - clueless
      +            - lazy
      +            - adventurous
      +            - aggressive
      +        required:
      +        - huntingSkill
      +    Dog:  ## "Dog" will be used as the discriminator value
      +      description: A representation of a dog
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        properties:
      +          packSize:
      +            type: integer
      +            format: int32
      +            description: the size of the pack the dog is from
      +            default: 0
      +            minimum: 0
      +        required:
      +        - packSize
      +
      +

      Discriminator Object

      +

      When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the document of an alternative schema based on the value associated with it.

      +

      When using the discriminator, inline schemas will not be considered.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
      mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
      +

      This object MAY be extended with Specification Extensions.

      +

      The discriminator object is legal only when using one of the composite keywords oneOf, anyOf, allOf.

      +

      In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +
      +

      which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +  discriminator:
      +    propertyName: petType
      +
      +

      The expectation now is that a property with name petType MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

      +
      
      +{
      +  "id": 12345,
      +  "petType": "Cat"
      +}
      +
      +

      Will indicate that the Cat schema be used in conjunction with this payload.

      +

      In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

      +
      
      +MyResponseType:
      +  oneOf:
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +  discriminator:
      +    propertyName: petType
      +    mapping:
      +      dog: '#/components/schemas/Dog'
      +      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +
      +

      Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

      +

      When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

      +

      In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

      +

      For example:

      +
      
      +components:
      +  schemas:
      +    Pet:
      +      type: object
      +      required:
      +      - petType
      +      properties:
      +        petType:
      +          type: string
      +      discriminator:
      +        propertyName: petType
      +        mapping:
      +          dog: Dog
      +    Cat:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Cat`
      +        properties:
      +          name:
      +            type: string
      +    Dog:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Dog`
      +        properties:
      +          bark:
      +            type: string
      +    Lizard:
      +      allOf:
      +      - $ref: '#/components/schemas/Pet'
      +      - type: object
      +        # all other properties specific to a `Lizard`
      +        properties:
      +          lovesRocks:
      +            type: boolean
      +
      +

      a payload like this:

      +
      
      +{
      +  "petType": "Cat",
      +  "name": "misty"
      +}
      +
      +

      will indicate that the Cat schema be used. Likewise this schema:

      +
      
      +{
      +  "petType": "dog",
      +  "bark": "soft"
      +}
      +
      +

      will map to Dog because of the definition in the mapping element.

      +

      XML Object

      +

      A metadata object that allows for more fine-tuned XML model definitions.

      +

      When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. +See examples for expected behavior.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
      namespacestringThe URI of the namespace definition. This MUST be in the form of an absolute URI.
      prefixstringThe prefix to be used for the name.
      attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
      wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
      +

      This object MAY be extended with Specification Extensions.

      +

      XML Object Examples

      +

      The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

      +
      No XML Element
      +

      Basic string property:

      +
      
      +{
      +    "animals": {
      +        "type": "string"
      +    }
      +}
      +
      +
      
      +animals:
      +  type: string
      +
      +
      
      +<animals>...</animals>
      +
      +

      Basic string array property (wrapped is false by default):

      +
      
      +{
      +    "animals": {
      +        "type": "array",
      +        "items": {
      +            "type": "string"
      +        }
      +    }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +
      +
      
      +<animals>...</animals>
      +<animals>...</animals>
      +<animals>...</animals>
      +
      +
      XML Name Replacement
      +
      
      +{
      +  "animals": {
      +    "type": "string",
      +    "xml": {
      +      "name": "animal"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: string
      +  xml:
      +    name: animal
      +
      +
      
      +<animal>...</animal>
      +
      +
      XML Attribute, Prefix and Namespace
      +

      In this example, a full model definition is shown.

      +
      
      +{
      +  "Person": {
      +    "type": "object",
      +    "properties": {
      +      "id": {
      +        "type": "integer",
      +        "format": "int32",
      +        "xml": {
      +          "attribute": true
      +        }
      +      },
      +      "name": {
      +        "type": "string",
      +        "xml": {
      +          "namespace": "https://example.com/schema/sample",
      +          "prefix": "sample"
      +        }
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +Person:
      +  type: object
      +  properties:
      +    id:
      +      type: integer
      +      format: int32
      +      xml:
      +        attribute: true
      +    name:
      +      type: string
      +      xml:
      +        namespace: https://example.com/schema/sample
      +        prefix: sample
      +
      +
      
      +<Person id="123">
      +    <sample:name xmlns:sample="https://example.com/schema/sample">example</sample:name>
      +</Person>
      +
      +
      XML Arrays
      +

      Changing the element names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      The external name property has no effect on the XML:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens"
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +
      +
      
      +<animal>value</animal>
      +<animal>value</animal>
      +
      +

      Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animals>value</animals>
      +  <animals>value</animals>
      +</animals>
      +
      +

      To overcome the naming problem in the example above, the following definition can be used:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    wrapped: true
      +
      +
      
      +<animals>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</animals>
      +
      +

      Affecting both internal and external names:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
      +      }
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +    xml:
      +      name: animal
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <animal>value</animal>
      +  <animal>value</animal>
      +</aliens>
      +
      +

      If we change the external element but not the internal ones:

      +
      
      +{
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
      +    },
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
      +    }
      +  }
      +}
      +
      +
      
      +animals:
      +  type: array
      +  items:
      +    type: string
      +  xml:
      +    name: aliens
      +    wrapped: true
      +
      +
      
      +<aliens>
      +  <aliens>value</aliens>
      +  <aliens>value</aliens>
      +</aliens>
      +
      +

      Security Scheme Object

      +

      Defines a security scheme that can be used by the operations.

      +

      Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), mutual TLS (use of a client certificate), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and OpenID Connect Discovery. +Please note that as of 2020, the implicit flow is about to be deprecated by OAuth 2.0 Security Best Current Practice. Recommended for most use case is Authorization Code Grant flow with PKCE.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeApplies ToDescription
      typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "mutualTLS", "oauth2", "openIdConnect".
      descriptionstringAnyA description for security scheme. CommonMark syntax MAY be used for rich text representation.
      namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
      instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
      schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]]. The values used SHOULD be registered in the IANA Authentication Scheme registry.
      bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
      flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
      openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL. The OpenID Connect standard requires the use of TLS.
      +

      This object MAY be extended with Specification Extensions.

      +

      Security Scheme Object Example

      +
      Basic Authentication Sample
      +
      
      +{
      +  "type": "http",
      +  "scheme": "basic"
      +}
      +
      +
      
      +type: http
      +scheme: basic
      +
      +
      API Key Sample
      +
      
      +{
      +  "type": "apiKey",
      +  "name": "api_key",
      +  "in": "header"
      +}
      +
      +
      
      +type: apiKey
      +name: api_key
      +in: header
      +
      +
      JWT Bearer Sample
      +
      
      +{
      +  "type": "http",
      +  "scheme": "bearer",
      +  "bearerFormat": "JWT",
      +}
      +
      +
      
      +type: http
      +scheme: bearer
      +bearerFormat: JWT
      +
      +
      Implicit OAuth2 Sample
      +
      
      +{
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
      +
      +

      OAuth Flows Object

      +

      Allows configuration of the supported OAuth Flows.

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeDescription
      implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
      passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
      clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
      authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
      +

      This object MAY be extended with Specification Extensions.

      +

      OAuth Flow Object

      +

      Configuration details for a supported OAuth Flow

      +

      Fixed Fields

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Field NameTypeApplies ToDescription
      authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
      tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
      refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
      scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.
      +

      This object MAY be extended with Specification Extensions.

      +

      OAuth Flow Object Examples

      +
      
      +{
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    },
      +    "authorizationCode": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "tokenUrl": "https://example.com/api/oauth/token",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
      +      }
      +    }
      +  }
      +}
      +
      +
      
      +type: oauth2
      +flows: 
      +  implicit:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets
      +  authorizationCode:
      +    authorizationUrl: https://example.com/api/oauth/dialog
      +    tokenUrl: https://example.com/api/oauth/token
      +    scopes:
      +      write:pets: modify pets in your account
      +      read:pets: read your pets 
      +
      +

      Security Requirement Object

      +

      Lists the required security schemes to execute this operation. +The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

      +

      Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. +This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

      +

      When a list of Security Requirement Objects is defined on the OpenAPI Object or Operation Object, only one of the Security Requirement Objects in the list needs to be satisfied to authorize the request.

      +

      Patterned Fields

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution, and the list MAY be empty if authorization does not require a specified scope. For other security scheme types, the array MAY contain a list of role names which are required for the execution, but are not otherwise defined or exchanged in-band.
      +

      Security Requirement Object Examples

      +
      Non-OAuth2 Security Requirement
      +
      
      +{
      +  "api_key": []
      +}
      +
      +
      
      +api_key: []
      +
      +
      OAuth2 Security Requirement
      +
      
      +{
      +  "petstore_auth": [
      +    "write:pets",
      +    "read:pets"
      +  ]
      +}
      +
      +
      
      +petstore_auth:
      +- write:pets
      +- read:pets
      +
      +
      Optional OAuth2 Security
      +

      Optional OAuth2 security as would be defined in an OpenAPI Object or an Operation Object:

      +
      
      +{
      +  "security": [
      +    {},
      +    {
      +      "petstore_auth": [
      +        "write:pets",
      +        "read:pets"
      +      ]
      +    }
      +  ]
      +}
      +
      +
      
      +security:
      +  - {}
      +  - petstore_auth:
      +    - write:pets
      +    - read:pets
      +
      +

      Specification Extensions

      +

      While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

      +

      The extensions properties are implemented as patterned fields that are always prefixed by "x-".

      + + + + + + + + + + + + + + + +
      Field PatternTypeDescription
      ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. Field names beginning x-oai- and x-oas- are reserved for uses defined by the OpenAPI Initiative. The value can be null, a primitive, an array or an object.
      +

      The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

      +

      Security Filtering

      +

      Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

      +

      The reasoning is to allow an additional layer of access control over the documentation. +While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

      +

      Two examples of this:

      +
        +
      1. The Paths Object MAY be present but empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They would still have access to at least the Info Object which may contain additional information regarding authentication.
      2. +
      3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the Paths Object, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
      4. +
      +

      Appendix A: Revision History

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      VersionDateNotes
      3.1.02021-02-15Release of the OpenAPI Specification 3.1.0
      3.1.0-rc12020-10-08rc1 of the 3.1 specification
      3.1.0-rc02020-06-18rc0 of the 3.1 specification
      3.0.32020-02-20Patch release of the OpenAPI Specification 3.0.3
      3.0.22018-10-08Patch release of the OpenAPI Specification 3.0.2
      3.0.12017-12-06Patch release of the OpenAPI Specification 3.0.1
      3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
      3.0.0-rc22017-06-16rc2 of the 3.0 specification
      3.0.0-rc12017-04-27rc1 of the 3.0 specification
      3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
      2.02015-12-31Donation of Swagger 2.0 to the OpenAPI Initiative
      2.02014-09-08Release of Swagger 2.0
      1.22014-03-14Initial release of the formal document.
      1.12012-08-22Release of Swagger 1.1
      1.02011-08-10First release of the Swagger Specification
      + From dd98272197e8b7c6c6493bc4ff8ab3f8dcf67972 Mon Sep 17 00:00:00 2001 From: Jason Desrosiers Date: Mon, 22 Mar 2021 13:28:04 -0700 Subject: [PATCH 012/152] Make 3.1 schemas retrievable from their $ids --- oas/3.1/dialect/base | 21 + oas/3.1/meta/base | 79 ++ oas/3.1/schema-base/2021-03-02 | 24 + oas/3.1/schema/2021-03-02 | 1340 ++++++++++++++++++++++++++++++++ 4 files changed, 1464 insertions(+) create mode 100644 oas/3.1/dialect/base create mode 100644 oas/3.1/meta/base create mode 100644 oas/3.1/schema-base/2021-03-02 create mode 100644 oas/3.1/schema/2021-03-02 diff --git a/oas/3.1/dialect/base b/oas/3.1/dialect/base new file mode 100644 index 0000000000..d54b0d4d7c --- /dev/null +++ b/oas/3.1/dialect/base @@ -0,0 +1,21 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/dialect/base", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$vocabulary": { + "https://json-schema.org/draft/2020-12/vocab/core": true, + "https://json-schema.org/draft/2020-12/vocab/applicator": true, + "https://json-schema.org/draft/2020-12/vocab/unevaluated": true, + "https://json-schema.org/draft/2020-12/vocab/validation": true, + "https://json-schema.org/draft/2020-12/vocab/meta-data": true, + "https://json-schema.org/draft/2020-12/vocab/format-annotation": true, + "https://json-schema.org/draft/2020-12/vocab/content": true, + "https://spec.openapis.org/oas/3.1/vocab/base": false + }, + "$dynamicAnchor": "meta", + + "title": "OpenAPI 3.1 Schema Object Dialect", + "allOf": [ + { "$ref": "https://json-schema.org/draft/2020-12/schema" }, + { "$ref": "https://spec.openapis.org/oas/3.1/meta/base" } + ] +} diff --git a/oas/3.1/meta/base b/oas/3.1/meta/base new file mode 100644 index 0000000000..f3ee03fb96 --- /dev/null +++ b/oas/3.1/meta/base @@ -0,0 +1,79 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/meta/base", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$vocabulary": { + "https://spec.openapis.org/oas/3.1/vocab/base": true + }, + "$dynamicAnchor": "meta", + "title": "OAS Base vocabulary", + + "type": ["object", "boolean"], + "properties": { + "example": true, + "discriminator": { "$ref": "#/$defs/discriminator" }, + "externalDocs": { "$ref": "#/$defs/external-docs" }, + "xml": { "$ref": "#/$defs/xml" } + }, + "$defs": { + "extensible": { + "patternProperties": { + "^x-": true + } + }, + "discriminator": { + "$ref": "#/$defs/extensible", + "type": "object", + "properties": { + "propertyName": { + "type": "string" + }, + "mapping": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } + }, + "required": ["propertyName"], + "unevaluatedProperties": false + }, + "external-docs": { + "$ref": "#/$defs/extensible", + "type": "object", + "properties": { + "url": { + "type": "string", + "format": "uri-reference" + }, + "description": { + "type": "string" + } + }, + "required": ["url"], + "unevaluatedProperties": false + }, + "xml": { + "$ref": "#/$defs/extensible", + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "namespace": { + "type": "string", + "format": "uri" + }, + "prefix": { + "type": "string" + }, + "attribute": { + "type": "boolean" + }, + "wrapped": { + "type": "boolean" + } + }, + "unevaluatedProperties": false + } + } +} diff --git a/oas/3.1/schema-base/2021-03-02 b/oas/3.1/schema-base/2021-03-02 new file mode 100644 index 0000000000..078af184fe --- /dev/null +++ b/oas/3.1/schema-base/2021-03-02 @@ -0,0 +1,24 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/schema-base/2021-03-02", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$ref": "https://spec.openapis.org/oas/3.1/schema/2021-03-02", + "properties": { + "jsonSchemaDialect": { + "$ref": "#/$defs/dialect" + } + }, + "$defs": { + "dialect": { + "const": "https://spec.openapis.org/oas/3.1/dialect/base" + }, + "schema": { + "$dynamicAnchor": "meta", + "$ref\"": "https://spec.openapis.org/oas/3.1/dialect/base", + "properties": { + "$schema": { + "$ref": "#/$defs/dialect" + } + } + } + } +} diff --git a/oas/3.1/schema/2021-03-02 b/oas/3.1/schema/2021-03-02 new file mode 100644 index 0000000000..fa987c12d6 --- /dev/null +++ b/oas/3.1/schema/2021-03-02 @@ -0,0 +1,1340 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/schema/2021-03-02", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "type": "object", + "properties": { + "openapi": { + "type": "string", + "pattern": "^3\\.1\\.\\d+(-.+)?$" + }, + "info": { + "$ref": "#/$defs/info" + }, + "jsonSchemaDialect": { + "$ref": "#/$defs/uri", + "default": "https://spec.openapis.org/oas/3.1/dialect/base" + }, + "servers": { + "$ref": "#/$defs/server" + }, + "paths": { + "$ref": "#/$defs/paths" + }, + "webhooks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + }, + "components": { + "$ref": "#/$defs/components" + }, + "security": { + "type": "array", + "items": { + "$ref": "#/$defs/security-requirement" + } + }, + "tags": { + "type": "array", + "items": { + "$ref": "#/$defs/tag" + } + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + } + }, + "required": [ + "openapi", + "info" + ], + "anyOf": [ + { + "required": [ + "paths" + ] + }, + { + "required": [ + "components" + ] + }, + { + "required": [ + "webhooks" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false, + "$defs": { + "info": { + "type": "object", + "properties": { + "title": { + "type": "string" + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "termsOfService": { + "type": "string" + }, + "contact": { + "$ref": "#/$defs/contact" + }, + "license": { + "$ref": "#/$defs/license" + }, + "version": { + "type": "string" + } + }, + "required": [ + "title", + "version" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "contact": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "url": { + "type": "string" + }, + "email": { + "type": "string" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "license": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "identifier": { + "type": "string" + }, + "url": { + "$ref": "#/$defs/uri" + } + }, + "required": [ + "name" + ], + "oneOf": [ + { + "required": [ + "identifier" + ] + }, + { + "required": [ + "url" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "server": { + "type": "object", + "properties": { + "url": { + "$ref": "#/$defs/uri" + }, + "description": { + "type": "string" + }, + "variables": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/server-variable" + } + } + }, + "required": [ + "url" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "server-variable": { + "type": "object", + "properties": { + "enum": { + "type": "array", + "items": { + "type": "string" + }, + "minItems": 1 + }, + "default": { + "type": "string" + }, + "descriptions": { + "type": "string" + } + }, + "required": [ + "default" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "components": { + "type": "object", + "properties": { + "schemas": { + "type": "object", + "additionalProperties": { + "$dynamicRef": "#meta" + } + }, + "responses": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/response-or-reference" + } + }, + "parameters": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/parameter-or-reference" + } + }, + "examples": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/example-or-reference" + } + }, + "requestBodies": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/request-body-or-reference" + } + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "securitySchemes": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/security-scheme-or-reference" + } + }, + "links": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/link-or-reference" + } + }, + "callbacks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/callbacks-or-reference" + } + }, + "pathItems": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + } + }, + "patternProperties": { + "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": { + "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected", + "propertyNames": { + "pattern": "^[a-zA-Z0-9._-]+$" + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "paths": { + "type": "object", + "patternProperties": { + "^/": { + "$ref": "#/$defs/path-item" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "path-item": { + "type": "object", + "properties": { + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + }, + "parameters": { + "type": "array", + "items": { + "$ref": "#/$defs/parameter-or-reference" + } + } + }, + "patternProperties": { + "^(get|post|delete|options|head|patch|trace)$": { + "$ref": "#/$defs/operation" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "path-item-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/path-item" + } + }, + "operation": { + "type": "object", + "properties": { + "tags": { + "type": "array", + "items": { + "type": "string" + } + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + }, + "operationId": { + "type": "string" + }, + "parameters": { + "type": "array", + "items": { + "$ref": "#/$defs/parameter-or-reference" + } + }, + "requestBody": { + "$ref": "#/$defs/request-body-or-reference" + }, + "responses": { + "$ref": "#/$defs/responses" + }, + "callbacks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/callbacks-or-reference" + } + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "security": { + "type": "array", + "items": { + "$ref": "#/$defs/security-requirement" + } + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "external-documentation": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "url": { + "$ref": "#/$defs/uri" + } + }, + "required": [ + "url" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "parameter": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "in": { + "enum": [ + "query", + "header", + "path", + "cookie" + ] + }, + "description": { + "type": "string" + }, + "required": { + "default": false, + "type": "boolean" + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "allowEmptyValue": { + "default": false, + "type": "boolean" + }, + "schema": { + "$dynamicRef": "#meta" + }, + "content": { + "$ref": "#/$defs/content" + } + }, + "required": [ + "in" + ], + "oneOf": [ + { + "required": [ + "schema" + ] + }, + { + "required": [ + "content" + ] + } + ], + "dependentSchemas": { + "schema": { + "properties": { + "style": { + "type": "string" + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + } + }, + "allOf": [ + { + "$ref": "#/$defs/examples" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form" + } + ], + "$defs": { + "styles-for-path": { + "if": { + "properties": { + "in": { + "const": "path" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "simple", + "enum": [ + "matrix", + "label", + "simple" + ] + }, + "required": { + "const": true + } + }, + "required": [ + "required" + ] + } + }, + "styles-for-header": { + "if": { + "properties": { + "in": { + "const": "header" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "simple", + "enum": [ + "simple" + ] + } + } + } + }, + "styles-for-query": { + "if": { + "properties": { + "in": { + "const": "query" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "form", + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ] + } + } + } + }, + "styles-for-cookie": { + "if": { + "properties": { + "in": { + "const": "cookie" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "form", + "enum": [ + "form" + ] + } + } + } + }, + "styles-for-form": { + "if": { + "properties": { + "style": { + "const": "form" + } + }, + "required": [ + "style" + ] + }, + "then": { + "properties": { + "explode": { + "default": true + } + } + }, + "else": { + "properties": { + "explode": { + "default": false + } + } + } + } + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "parameter-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/parameter" + } + }, + "request-body": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "content": { + "$ref": "#/$defs/content" + }, + "required": { + "default": false, + "type": "boolean" + } + }, + "required": [ + "content" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "request-body-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/request-body" + } + }, + "content": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/media-type" + }, + "propertyNames": { + "format": "media-range" + } + }, + "media-type": { + "type": "object", + "properties": { + "schema": { + "$dynamicRef": "#meta" + }, + "encoding": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/encoding" + } + } + }, + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/examples" + } + ], + "unevaluatedProperties": false + }, + "encoding": { + "type": "object", + "properties": { + "contentType": { + "type": "string", + "format": "media-range" + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "style": { + "default": "form", + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ] + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + } + }, + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/encoding/$defs/explode-default" + } + ], + "unevaluatedProperties": false, + "$defs": { + "explode-default": { + "if": { + "properties": { + "style": { + "const": "form" + } + }, + "required": [ + "style" + ] + }, + "then": { + "properties": { + "explode": { + "default": true + } + } + }, + "else": { + "properties": { + "explode": { + "default": false + } + } + } + } + } + }, + "responses": { + "type": "object", + "properties": { + "default": { + "$ref": "#/$defs/response-or-reference" + } + }, + "patternProperties": { + "^[1-5][0-9X]{2}$": { + "$ref": "#/$defs/response-or-reference" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "response": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "content": { + "$ref": "#/$defs/content" + }, + "links": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/link-or-reference" + } + } + }, + "required": [ + "description" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "response-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/response" + } + }, + "callbacks": { + "type": "object", + "$ref": "#/$defs/specification-extensions", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + }, + "callbacks-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/callbacks" + } + }, + "example": { + "type": "object", + "properties": { + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "value": true, + "externalValue": { + "$ref": "#/$defs/uri" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "example-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/example" + } + }, + "link": { + "type": "object", + "properties": { + "operationRef": { + "$ref": "#/$defs/uri" + }, + "operationId": true, + "parameters": { + "$ref": "#/$defs/map-of-strings" + }, + "requestBody": true, + "description": { + "type": "string" + }, + "body": { + "$ref": "#/$defs/server" + } + }, + "oneOf": [ + { + "required": [ + "operationRef" + ] + }, + { + "required": [ + "operationId" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "link-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/link" + } + }, + "header": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "required": { + "default": false, + "type": "boolean" + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "allowEmptyValue": { + "default": false, + "type": "boolean" + } + }, + "dependentSchemas": { + "schema": { + "properties": { + "style": { + "default": "simple", + "enum": [ + "simple" + ] + }, + "explode": { + "default": false, + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + }, + "schema": { + "$dynamicRef": "#meta" + } + }, + "$ref": "#/$defs/examples" + }, + "content": { + "properties": { + "content": { + "$ref": "#/$defs/content" + } + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "header-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/header" + } + }, + "tag": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + } + }, + "required": [ + "name" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "reference": { + "type": "object", + "properties": { + "$ref": { + "$ref": "#/$defs/uri" + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + } + }, + "unevaluatedProperties": false + }, + "schema": { + "$dynamicAnchor": "meta", + "type": [ + "object", + "boolean" + ] + }, + "security-scheme": { + "type": "object", + "properties": { + "type": { + "enum": [ + "apiKey", + "http", + "mutualTLS", + "oauth2", + "openIdConnect" + ] + }, + "description": { + "type": "string" + } + }, + "required": [ + "type" + ], + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-apikey" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-http" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-http-bearer" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-oauth2" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-oidc" + } + ], + "unevaluatedProperties": false, + "$defs": { + "type-apikey": { + "if": { + "properties": { + "type": { + "const": "apiKey" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "name": { + "type": "string" + }, + "in": { + "enum": [ + "query", + "header", + "cookie" + ] + } + }, + "required": [ + "name", + "in" + ] + } + }, + "type-http": { + "if": { + "properties": { + "type": { + "const": "http" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "scheme": { + "type": "string" + } + }, + "required": [ + "scheme" + ] + } + }, + "type-http-bearer": { + "if": { + "properties": { + "type": { + "const": "http" + }, + "scheme": { + "const": "bearer" + } + }, + "required": [ + "type", + "scheme" + ] + }, + "then": { + "properties": { + "bearerFormat": { + "type": "string" + } + }, + "required": [ + "scheme" + ] + } + }, + "type-oauth2": { + "if": { + "properties": { + "type": { + "const": "oauth2" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "flows": { + "$ref": "#/$defs/oauth-flows" + } + }, + "required": [ + "flows" + ] + } + }, + "type-oidc": { + "if": { + "properties": { + "type": { + "const": "openIdConnect" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "openIdConnectUrl": { + "$ref": "#/$defs/uri" + } + }, + "required": [ + "openIdConnectUrl" + ] + } + } + } + }, + "security-scheme-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/security-scheme" + } + }, + "oauth-flows": { + "type": "object", + "properties": { + "implicit": { + "$ref": "#/$defs/oauth-flows/$defs/implicit" + }, + "password": { + "$ref": "#/$defs/oauth-flows/$defs/password" + }, + "clientCredentials": { + "$ref": "#/$defs/oauth-flows/$defs/client-credentials" + }, + "authorizationCode": { + "$ref": "#/$defs/oauth-flows/$defs/authorization-code" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false, + "$defs": { + "implicit": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "authorizationUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "password": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "client-credentials": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "authorization-code": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string" + }, + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "authorizationUrl", + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + } + } + }, + "security-requirement": { + "type": "object", + "additionalProperties": { + "type": "array", + "items": { + "type": "string" + } + } + }, + "specification-extensions": { + "patternProperties": { + "^x-": true + } + }, + "examples": { + "properties": { + "example": true, + "examples": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/example-or-reference" + } + } + } + }, + "uri": { + "type": "string", + "format": "uri" + }, + "map-of-strings": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } +} From b92609b099eb86ec833983a3f6a39bb67622dd30 Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Thu, 13 May 2021 23:58:22 +0100 Subject: [PATCH 013/152] fix: regenerate respec versions, refs #2488 (#2573) Signed-off-by: Mike Ralphson --- oas/v2.0.html | 1460 +++++++++++++-------------- oas/v3.0.0.html | 2482 ++++++++++++++++++++++----------------------- oas/v3.0.1.html | 2402 ++++++++++++++++++++++---------------------- oas/v3.0.2.html | 2546 +++++++++++++++++++++++------------------------ oas/v3.0.3.html | 1420 +++++++++++++------------- oas/v3.1.0.html | 188 ++-- 6 files changed, 5253 insertions(+), 5245 deletions(-) diff --git a/oas/v2.0.html b/oas/v2.0.html index d8c5f210ad..d269a5da5c 100644 --- a/oas/v2.0.html +++ b/oas/v2.0.html @@ -1,4 +1,4 @@ -OpenAPI Specification +OpenAPI Specification +OpenAPI Specification +OpenAPI Specification +OpenAPI Specification
      The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

      Status of This Document

      The source-of-truth for the specification is the GitHub markdown file referenced above.
      +OpenAPI Specification + + +
      The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

      Status of This Document

      The source-of-truth for the specification is the GitHub markdown file referenced above.

      OpenAPI Specification

      Version 3.0.3

      The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

      @@ -44,7 +52,7 @@

      For example, if a field has an array value, the JSON array representation will be used:

      
       {
      -   "field": [ 1, 2, 3 ]
      +   "field": [ 1, 2, 3 ]
       }
       

      All field names in the specification are case sensitive. @@ -250,19 +258,19 @@

      Info Object Example

      
       {
      -  "title": "Sample Pet Store App",
      -  "description": "This is a sample server for a pet store.",
      -  "termsOfService": "http://example.com/terms/",
      -  "contact": {
      -    "name": "API Support",
      -    "url": "http://www.example.com/support",
      -    "email": "support@example.com"
      +  "title": "Sample Pet Store App",
      +  "description": "This is a sample server for a pet store.",
      +  "termsOfService": "http://example.com/terms/",
      +  "contact": {
      +    "name": "API Support",
      +    "url": "http://www.example.com/support",
      +    "email": "support@example.com"
         },
      -  "license": {
      -    "name": "Apache 2.0",
      -    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
      +  "license": {
      +    "name": "Apache 2.0",
      +    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
         },
      -  "version": "1.0.1"
      +  "version": "1.0.1"
       }
       
      
      @@ -311,9 +319,9 @@
       

      Contact Object Example

      
       {
      -  "name": "API Support",
      -  "url": "http://www.example.com/support",
      -  "email": "support@example.com"
      +  "name": "API Support",
      +  "url": "http://www.example.com/support",
      +  "email": "support@example.com"
       }
       
      
      @@ -349,8 +357,8 @@
       

      License Object Example

      
       {
      -  "name": "Apache 2.0",
      -  "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
      +  "name": "Apache 2.0",
      +  "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
       }
       
      
      @@ -391,8 +399,8 @@
       

      A single server would be described as:

      
       {
      -  "url": "https://development.gigantic-server.com/v1",
      -  "description": "Development server"
      +  "url": "https://development.gigantic-server.com/v1",
      +  "description": "Development server"
       }
       
      
      @@ -402,18 +410,18 @@
       

      The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

      
       {
      -  "servers": [
      +  "servers": [
           {
      -      "url": "https://development.gigantic-server.com/v1",
      -      "description": "Development server"
      +      "url": "https://development.gigantic-server.com/v1",
      +      "description": "Development server"
           },
           {
      -      "url": "https://staging.gigantic-server.com/v1",
      -      "description": "Staging server"
      +      "url": "https://staging.gigantic-server.com/v1",
      +      "description": "Staging server"
           },
           {
      -      "url": "https://api.gigantic-server.com/v1",
      -      "description": "Production server"
      +      "url": "https://api.gigantic-server.com/v1",
      +      "description": "Production server"
           }
         ]
       }
      @@ -430,24 +438,24 @@
       

      The following shows how variables can be used for a server configuration:

      
       {
      -  "servers": [
      +  "servers": [
           {
      -      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
      -      "description": "The production API server",
      -      "variables": {
      -        "username": {
      -          "default": "demo",
      -          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
      +      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
      +      "description": "The production API server",
      +      "variables": {
      +        "username": {
      +          "default": "demo",
      +          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
               },
      -        "port": {
      -          "enum": [
      -            "8443",
      -            "443"
      +        "port": {
      +          "enum": [
      +            "8443",
      +            "443"
                 ],
      -          "default": "8443"
      +          "default": "8443"
               },
      -        "basePath": {
      -          "default": "v2"
      +        "basePath": {
      +          "default": "v2"
               }
             }
           }
      @@ -465,9 +473,9 @@
             description: this value is assigned by the service provider, in this example `gigantic-server.com`
           port:
             enum:
      -        - '8443'
      -        - '443'
      -      default: '8443'
      +        - '8443'
      +        - '443'
      +      default: '8443'
           basePath:
             # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
             default: v2
      @@ -517,47 +525,47 @@
       
       
         schemas
      -Map[string, Schema Object ¦ Reference Object]
      +Map[string, Schema Object | Reference Object]
       An object to hold reusable Schema Objects.
       
       
         responses
      -Map[string, Response Object ¦ Reference Object]
      +Map[string, Response Object | Reference Object]
       An object to hold reusable Response Objects.
       
       
         parameters
      -Map[string, Parameter Object ¦ Reference Object]
      +Map[string, Parameter Object | Reference Object]
       An object to hold reusable Parameter Objects.
       
       
         examples
      -Map[string, Example Object ¦ Reference Object]
      +Map[string, Example Object | Reference Object]
       An object to hold reusable Example Objects.
       
       
         requestBodies
      -Map[string, Request Body Object ¦ Reference Object]
      +Map[string, Request Body Object | Reference Object]
       An object to hold reusable Request Body Objects.
       
       
         headers
      -Map[string, Header Object ¦ Reference Object]
      +Map[string, Header Object | Reference Object]
       An object to hold reusable Header Objects.
       
       
         securitySchemes
      -Map[string, Security Scheme Object ¦ Reference Object]
      +Map[string, Security Scheme Object | Reference Object]
       An object to hold reusable Security Scheme Objects.
       
       
         links
      -Map[string, Link Object ¦ Reference Object]
      +Map[string, Link Object | Reference Object]
       An object to hold reusable Link Objects.
       
       
         callbacks
      -Map[string, Callback Object ¦ Reference Object]
      +Map[string, Callback Object | Reference Object]
       An object to hold reusable Callback Objects.
       
       
      @@ -574,99 +582,99 @@
       

      Components Object Example

      
      -"components": {
      -  "schemas": {
      -    "GeneralError": {
      -      "type": "object",
      -      "properties": {
      -        "code": {
      -          "type": "integer",
      -          "format": "int32"
      +"components": {
      +  "schemas": {
      +    "GeneralError": {
      +      "type": "object",
      +      "properties": {
      +        "code": {
      +          "type": "integer",
      +          "format": "int32"
               },
      -        "message": {
      -          "type": "string"
      +        "message": {
      +          "type": "string"
               }
             }
           },
      -    "Category": {
      -      "type": "object",
      -      "properties": {
      -        "id": {
      -          "type": "integer",
      -          "format": "int64"
      +    "Category": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
               },
      -        "name": {
      -          "type": "string"
      +        "name": {
      +          "type": "string"
               }
             }
           },
      -    "Tag": {
      -      "type": "object",
      -      "properties": {
      -        "id": {
      -          "type": "integer",
      -          "format": "int64"
      +    "Tag": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
               },
      -        "name": {
      -          "type": "string"
      +        "name": {
      +          "type": "string"
               }
             }
           }
         },
      -  "parameters": {
      -    "skipParam": {
      -      "name": "skip",
      -      "in": "query",
      -      "description": "number of items to skip",
      -      "required": true,
      -      "schema": {
      -        "type": "integer",
      -        "format": "int32"
      +  "parameters": {
      +    "skipParam": {
      +      "name": "skip",
      +      "in": "query",
      +      "description": "number of items to skip",
      +      "required": true,
      +      "schema": {
      +        "type": "integer",
      +        "format": "int32"
             }
           },
      -    "limitParam": {
      -      "name": "limit",
      -      "in": "query",
      -      "description": "max records to return",
      -      "required": true,
      -      "schema" : {
      -        "type": "integer",
      -        "format": "int32"
      +    "limitParam": {
      +      "name": "limit",
      +      "in": "query",
      +      "description": "max records to return",
      +      "required": true,
      +      "schema" : {
      +        "type": "integer",
      +        "format": "int32"
             }
           }
         },
      -  "responses": {
      -    "NotFound": {
      -      "description": "Entity not found."
      +  "responses": {
      +    "NotFound": {
      +      "description": "Entity not found."
           },
      -    "IllegalInput": {
      -      "description": "Illegal input for operation."
      +    "IllegalInput": {
      +      "description": "Illegal input for operation."
           },
      -    "GeneralError": {
      -      "description": "General Error",
      -      "content": {
      -        "application/json": {
      -          "schema": {
      -            "$ref": "#/components/schemas/GeneralError"
      +    "GeneralError": {
      +      "description": "General Error",
      +      "content": {
      +        "application/json": {
      +          "schema": {
      +            "$ref": "#/components/schemas/GeneralError"
                 }
               }
             }
           }
         },
      -  "securitySchemes": {
      -    "api_key": {
      -      "type": "apiKey",
      -      "name": "api_key",
      -      "in": "header"
      +  "securitySchemes": {
      +    "api_key": {
      +      "type": "apiKey",
      +      "name": "api_key",
      +      "in": "header"
           },
      -    "petstore_auth": {
      -      "type": "oauth2",
      -      "flows": {
      -        "implicit": {
      -          "authorizationUrl": "http://example.org/api/oauth/dialog",
      -          "scopes": {
      -            "write:pets": "modify pets in your account",
      -            "read:pets": "read your pets"
      +    "petstore_auth": {
      +      "type": "oauth2",
      +      "flows": {
      +        "implicit": {
      +          "authorizationUrl": "http://example.org/api/oauth/dialog",
      +          "scopes": {
      +            "write:pets": "modify pets in your account",
      +            "read:pets": "read your pets"
                 }
               }
             }
      @@ -728,7 +736,7 @@
             content:
               application/json:
                 schema:
      -            $ref: '#/components/schemas/GeneralError'
      +            $ref: '#/components/schemas/GeneralError'
         securitySchemes:
           api_key:
             type: apiKey
      @@ -759,7 +767,7 @@
       
        /{path}
       Path Item Object
      -A relative path to an individual endpoint. The field name MUST begin with a forward slash (/). The path is appended (no relative URL resolution) to the expanded URL from the Server Object's url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
      +A relative path to an individual endpoint. The field name MUST begin with a forward slash (/). The path is appended (no relative URL resolution) to the expanded URL from the Server Object’s url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
       
       
       
      @@ -783,18 +791,18 @@
       

      Paths Object Example

      
       {
      -  "/pets": {
      -    "get": {
      -      "description": "Returns all pets from the system that the user has access to",
      -      "responses": {
      -        "200": {          
      -          "description": "A list of pets.",
      -          "content": {
      -            "application/json": {
      -              "schema": {
      -                "type": "array",
      -                "items": {
      -                  "$ref": "#/components/schemas/pet"
      +  "/pets": {
      +    "get": {
      +      "description": "Returns all pets from the system that the user has access to",
      +      "responses": {
      +        "200": {          
      +          "description": "A list of pets.",
      +          "content": {
      +            "application/json": {
      +              "schema": {
      +                "type": "array",
      +                "items": {
      +                  "$ref": "#/components/schemas/pet"
                       }
                     }
                   }
      @@ -810,14 +818,14 @@
         get:
           description: Returns all pets from the system that the user has access to
           responses:
      -      '200':
      +      '200':
               description: A list of pets.
               content:
                 application/json:
                   schema:
                     type: array
                     items:
      -                $ref: '#/components/schemas/pet'
      +                $ref: '#/components/schemas/pet'
       

      Path Item Object

      Describes the operations available on a single path. @@ -895,7 +903,7 @@ parameters -[Parameter Object ¦ Reference Object] +[Parameter Object | Reference Object] A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters. @@ -904,49 +912,49 @@

      Path Item Object Example

      
       {
      -  "get": {
      -    "description": "Returns pets based on ID",
      -    "summary": "Find pets by ID",
      -    "operationId": "getPetsById",
      -    "responses": {
      -      "200": {
      -        "description": "pet response",
      -        "content": {
      -          "*/*": {
      -            "schema": {
      -              "type": "array",
      -              "items": {
      -                "$ref": "#/components/schemas/Pet"
      +  "get": {
      +    "description": "Returns pets based on ID",
      +    "summary": "Find pets by ID",
      +    "operationId": "getPetsById",
      +    "responses": {
      +      "200": {
      +        "description": "pet response",
      +        "content": {
      +          "*/*": {
      +            "schema": {
      +              "type": "array",
      +              "items": {
      +                "$ref": "#/components/schemas/Pet"
                     }
                   }
                 }
               }
             },
      -      "default": {
      -        "description": "error payload",
      -        "content": {
      -          "text/html": {
      -            "schema": {
      -              "$ref": "#/components/schemas/ErrorModel"
      +      "default": {
      +        "description": "error payload",
      +        "content": {
      +          "text/html": {
      +            "schema": {
      +              "$ref": "#/components/schemas/ErrorModel"
                   }
                 }
               }
             }
           }
         },
      -  "parameters": [
      +  "parameters": [
           {
      -      "name": "id",
      -      "in": "path",
      -      "description": "ID of pet to use",
      -      "required": true,
      -      "schema": {
      -        "type": "array",
      -        "items": {
      -          "type": "string"
      +      "name": "id",
      +      "in": "path",
      +      "description": "ID of pet to use",
      +      "required": true,
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
               }
             },
      -      "style": "simple"
      +      "style": "simple"
           }
         ]
       }
      @@ -957,20 +965,20 @@
         summary: Find pets by ID
         operationId: getPetsById
         responses:
      -    '200':
      +    '200':
             description: pet response
             content:
      -        '*/*' :
      +        '*/*' :
                 schema:
                   type: array
                   items:
      -              $ref: '#/components/schemas/Pet'
      +              $ref: '#/components/schemas/Pet'
           default:
             description: error payload
             content:
      -        'text/html':
      +        'text/html':
                 schema:
      -            $ref: '#/components/schemas/ErrorModel'
      +            $ref: '#/components/schemas/ErrorModel'
       parameters:
       - name: id
         in: path
      @@ -1021,12 +1029,12 @@
       
       
        parameters
      -[Parameter Object ¦ Reference Object]
      +[Parameter Object | Reference Object]
       A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
       
       
        requestBody
      -Request Body Object ¦ Reference Object
      +Request Body Object | Reference Object
       The request body applicable for this operation.  The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies.  In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers.
       
       
      @@ -1036,7 +1044,7 @@
       
       
        callbacks
      -Map[string, Callback Object ¦ Reference Object]
      +Map[string, Callback Object | Reference Object]
       A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses.
       
       
      @@ -1060,63 +1068,63 @@
       

      Operation Object Example

      
       {
      -  "tags": [
      -    "pet"
      +  "tags": [
      +    "pet"
         ],
      -  "summary": "Updates a pet in the store with form data",
      -  "operationId": "updatePetWithForm",
      -  "parameters": [
      +  "summary": "Updates a pet in the store with form data",
      +  "operationId": "updatePetWithForm",
      +  "parameters": [
           {
      -      "name": "petId",
      -      "in": "path",
      -      "description": "ID of pet that needs to be updated",
      -      "required": true,
      -      "schema": {
      -        "type": "string"
      +      "name": "petId",
      +      "in": "path",
      +      "description": "ID of pet that needs to be updated",
      +      "required": true,
      +      "schema": {
      +        "type": "string"
             }
           }
         ],
      -  "requestBody": {
      -    "content": {
      -      "application/x-www-form-urlencoded": {
      -        "schema": {
      -          "type": "object",
      -          "properties": {
      -            "name": { 
      -              "description": "Updated name of the pet",
      -              "type": "string"
      +  "requestBody": {
      +    "content": {
      +      "application/x-www-form-urlencoded": {
      +        "schema": {
      +          "type": "object",
      +          "properties": {
      +            "name": { 
      +              "description": "Updated name of the pet",
      +              "type": "string"
                   },
      -            "status": {
      -              "description": "Updated status of the pet",
      -              "type": "string"
      +            "status": {
      +              "description": "Updated status of the pet",
      +              "type": "string"
                   }
                 },
      -          "required": ["status"] 
      +          "required": ["status"] 
               }
             }
           }
         },
      -  "responses": {
      -    "200": {
      -      "description": "Pet updated.",
      -      "content": {
      -        "application/json": {},
      -        "application/xml": {}
      +  "responses": {
      +    "200": {
      +      "description": "Pet updated.",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
             }
           },
      -    "405": {
      -      "description": "Method Not Allowed",
      -      "content": {
      -        "application/json": {},
      -        "application/xml": {}
      +    "405": {
      +      "description": "Method Not Allowed",
      +      "content": {
      +        "application/json": {},
      +        "application/xml": {}
             }
           }
         },
      -  "security": [
      +  "security": [
           {
      -      "petstore_auth": [
      -        "write:pets",
      -        "read:pets"
      +      "petstore_auth": [
      +        "write:pets",
      +        "read:pets"
             ]
           }
         ]
      @@ -1136,7 +1144,7 @@
           type: string
       requestBody:
         content:
      -    'application/x-www-form-urlencoded':
      +    'application/x-www-form-urlencoded':
             schema:
              properties:
                 name: 
      @@ -1148,16 +1156,16 @@
              required:
                - status
       responses:
      -  '200':
      +  '200':
           description: Pet updated.
           content: 
      -      'application/json': {}
      -      'application/xml': {}
      -  '405':
      +      'application/json': {}
      +      'application/xml': {}
      +  '405':
           description: Method Not Allowed
           content: 
      -      'application/json': {}
      -      'application/xml': {}
      +      'application/json': {}
      +      'application/xml': {}
       security:
       - petstore_auth:
         - write:pets
      @@ -1191,8 +1199,8 @@
       

      External Documentation Object Example

      
       {
      -  "description": "Find more info here",
      -  "url": "https://example.com"
      +  "description": "Find more info here",
      +  "url": "https://example.com"
       }
       
      
      @@ -1280,7 +1288,7 @@
       
       
        schema
      -Schema Object ¦ Reference Object
      +Schema Object | Reference Object
       The schema defining the type used for the parameter.
       
       
      @@ -1290,7 +1298,7 @@
       
       
        examples
      -Map[ string, Example Object ¦ Reference Object]
      +Map[ string, Example Object | Reference Object]
       Examples of the parameter’s potential value. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema that contains an example, the examples value SHALL override the example provided by the schema.
       
       
      @@ -1467,8 +1475,8 @@
       false
       n/a
       n/a
      -blue¦black¦brown
      -R¦100¦G¦200¦B¦150
      +blue|black|brown
      +R|100|G|200|B|150
       
       
       deepObject
      @@ -1476,7 +1484,7 @@
       n/a
       n/a
       n/a
      -color\R=100&color\G=200&color\B=150
      +color[R]=100&color[G]=200&color[B]=150
       
       
       
      @@ -1485,18 +1493,18 @@
       

      A header parameter with an array of 64 bit integer numbers:

      
       {
      -  "name": "token",
      -  "in": "header",
      -  "description": "token to be passed as a header",
      -  "required": true,
      -  "schema": {
      -    "type": "array",
      -    "items": {
      -      "type": "integer",
      -      "format": "int64"
      +  "name": "token",
      +  "in": "header",
      +  "description": "token to be passed as a header",
      +  "required": true,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "integer",
      +      "format": "int64"
           }
         },
      -  "style": "simple"
      +  "style": "simple"
       }
       
      
      @@ -1514,12 +1522,12 @@
       

      A path parameter of a string value:

      
       {
      -  "name": "username",
      -  "in": "path",
      -  "description": "username to fetch",
      -  "required": true,
      -  "schema": {
      -    "type": "string"
      +  "name": "username",
      +  "in": "path",
      +  "description": "username to fetch",
      +  "required": true,
      +  "schema": {
      +    "type": "string"
         }
       }
       
      @@ -1534,18 +1542,18 @@

      An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

      
       {
      -  "name": "id",
      -  "in": "query",
      -  "description": "ID of the object to fetch",
      -  "required": false,
      -  "schema": {
      -    "type": "array",
      -    "items": {
      -      "type": "string"
      +  "name": "id",
      +  "in": "query",
      +  "description": "ID of the object to fetch",
      +  "required": false,
      +  "schema": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
           }
         },
      -  "style": "form",
      -  "explode": true
      +  "style": "form",
      +  "explode": true
       }
       
      
      @@ -1563,15 +1571,15 @@
       

      A free-form query parameter, allowing undefined parameters of a specific type:

      
       {
      -  "in": "query",
      -  "name": "freeForm",
      -  "schema": {
      -    "type": "object",
      -    "additionalProperties": {
      -      "type": "integer"
      +  "in": "query",
      +  "name": "freeForm",
      +  "schema": {
      +    "type": "object",
      +    "additionalProperties": {
      +      "type": "integer"
           },
         },
      -  "style": "form"
      +  "style": "form"
       }
       
      
      @@ -1586,22 +1594,22 @@
       

      A complex parameter using content to define serialization:

      
       {
      -  "in": "query",
      -  "name": "coordinates",
      -  "content": {
      -    "application/json": {
      -      "schema": {
      -        "type": "object",
      -        "required": [
      -          "lat",
      -          "long"
      +  "in": "query",
      +  "name": "coordinates",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "object",
      +        "required": [
      +          "lat",
      +          "long"
               ],
      -        "properties": {
      -          "lat": {
      -            "type": "number"
      +        "properties": {
      +          "lat": {
      +            "type": "number"
                 },
      -          "long": {
      -            "type": "number"
      +          "long": {
      +            "type": "number"
                 }
               }
             }
      @@ -1659,43 +1667,43 @@
       

      A request body with a referenced model definition.

      
       {
      -  "description": "user to add to the system",
      -  "content": {
      -    "application/json": {
      -      "schema": {
      -        "$ref": "#/components/schemas/User"
      +  "description": "user to add to the system",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
             },
      -      "examples": {
      -          "user" : {
      -            "summary": "User Example", 
      -            "externalValue": "http://foo.bar/examples/user-example.json"
      +      "examples": {
      +          "user" : {
      +            "summary": "User Example", 
      +            "externalValue": "http://foo.bar/examples/user-example.json"
                 } 
               }
           },
      -    "application/xml": {
      -      "schema": {
      -        "$ref": "#/components/schemas/User"
      +    "application/xml": {
      +      "schema": {
      +        "$ref": "#/components/schemas/User"
             },
      -      "examples": {
      -          "user" : {
      -            "summary": "User example in XML",
      -            "externalValue": "http://foo.bar/examples/user-example.xml"
      +      "examples": {
      +          "user" : {
      +            "summary": "User example in XML",
      +            "externalValue": "http://foo.bar/examples/user-example.xml"
                 }
               }
           },
      -    "text/plain": {
      -      "examples": {
      -        "user" : {
      -            "summary": "User example in Plain text",
      -            "externalValue": "http://foo.bar/examples/user-example.txt" 
      +    "text/plain": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in Plain text",
      +            "externalValue": "http://foo.bar/examples/user-example.txt" 
               }
             } 
           },
      -    "*/*": {
      -      "examples": {
      -        "user" : {
      -            "summary": "User example in other format",
      -            "externalValue": "http://foo.bar/examples/user-example.whatever"
      +    "*/*": {
      +      "examples": {
      +        "user" : {
      +            "summary": "User example in other format",
      +            "externalValue": "http://foo.bar/examples/user-example.whatever"
               }
             }
           }
      @@ -1705,41 +1713,41 @@
       
      
       description: user to add to the system
       content: 
      -  'application/json':
      +  'application/json':
           schema:
      -      $ref: '#/components/schemas/User'
      +      $ref: '#/components/schemas/User'
           examples:
             user:
               summary: User Example
      -        externalValue: 'http://foo.bar/examples/user-example.json'
      -  'application/xml':
      +        externalValue: 'http://foo.bar/examples/user-example.json'
      +  'application/xml':
           schema:
      -      $ref: '#/components/schemas/User'
      +      $ref: '#/components/schemas/User'
           examples:
             user:
               summary: User Example in XML
      -        externalValue: 'http://foo.bar/examples/user-example.xml'
      -  'text/plain':
      +        externalValue: 'http://foo.bar/examples/user-example.xml'
      +  'text/plain':
           examples:
             user:
               summary: User example in text plain format
      -        externalValue: 'http://foo.bar/examples/user-example.txt'
      -  '*/*':
      +        externalValue: 'http://foo.bar/examples/user-example.txt'
      +  '*/*':
           examples:
             user: 
               summary: User example in other format
      -        externalValue: 'http://foo.bar/examples/user-example.whatever'
      +        externalValue: 'http://foo.bar/examples/user-example.whatever'
       

      A body parameter that is an array of string values:

      
       {
      -  "description": "user to add to the system",
      -  "content": {
      -    "text/plain": {
      -      "schema": {
      -        "type": "array",
      -        "items": {
      -          "type": "string"
      +  "description": "user to add to the system",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "type": "string"
               }
             }
           }
      @@ -1770,7 +1778,7 @@
       
       
        schema
      -Schema Object ¦ Reference Object
      +Schema Object | Reference Object
       The schema defining the content of the request, response, or parameter.
       
       
      @@ -1780,7 +1788,7 @@
       
       
        examples
      -Map[ string, Example Object ¦ Reference Object]
      +Map[ string, Example Object | Reference Object]
       Examples of the media type.  Each example object SHOULD  match the media type and specified schema if present.  The examples field is mutually exclusive of the example field.  Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
       
       
      @@ -1794,33 +1802,33 @@
       

      Media Type Examples

      
       {
      -  "application/json": {
      -    "schema": {
      -         "$ref": "#/components/schemas/Pet"
      +  "application/json": {
      +    "schema": {
      +         "$ref": "#/components/schemas/Pet"
           },
      -    "examples": {
      -      "cat" : {
      -        "summary": "An example of a cat",
      -        "value": 
      +    "examples": {
      +      "cat" : {
      +        "summary": "An example of a cat",
      +        "value": 
                 {
      -            "name": "Fluffy",
      -            "petType": "Cat",
      -            "color": "White",
      -            "gender": "male",
      -            "breed": "Persian"
      +            "name": "Fluffy",
      +            "petType": "Cat",
      +            "color": "White",
      +            "gender": "male",
      +            "breed": "Persian"
                 }
             },
      -      "dog": {
      -        "summary": "An example of a dog with a cat's name",
      -        "value" :  { 
      -          "name": "Puma",
      -          "petType": "Dog",
      -          "color": "Black",
      -          "gender": "Female",
      -          "breed": "Mixed"
      +      "dog": {
      +        "summary": "An example of a dog with a cat's name",
      +        "value" :  { 
      +          "name": "Puma",
      +          "petType": "Dog",
      +          "color": "Black",
      +          "gender": "Female",
      +          "breed": "Mixed"
               },
      -      "frog": {
      -          "$ref": "#/components/examples/frog-example"
      +      "frog": {
      +          "$ref": "#/components/examples/frog-example"
               }
             }
           }
      @@ -1830,7 +1838,7 @@
       
      
       application/json: 
         schema:
      -    $ref: "#/components/schemas/Pet"
      +    $ref: "#/components/schemas/Pet"
         examples:
           cat:
             summary: An example of a cat
      @@ -1841,7 +1849,7 @@
               gender: male
               breed: Persian
           dog:
      -      summary: An example of a dog with a cat's name
      +      summary: An example of a dog with a cat's name
             value:
               name: Puma
               petType: Dog
      @@ -1849,7 +1857,7 @@
               gender: Female
               breed: Mixed
           frog:
      -      $ref: "#/components/examples/frog-example"
      +      $ref: "#/components/examples/frog-example"
       

      Considerations for File Uploads

      In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type. Specifically:

      @@ -1882,11 +1890,11 @@ requestBody: content: # a binary file of type png or jpeg - 'image/jpeg': + 'image/jpeg': schema: type: string format: binary - 'image/png': + 'image/png': schema: type: string format: binary @@ -1898,7 +1906,7 @@ multipart/form-data: schema: properties: - # The property name 'file' will be used for all files. + # The property name 'file' will be used for all files. file: type: array items: @@ -1922,10 +1930,10 @@ address: # complex types are stringified to support RFC 1866 type: object - properties: {} + properties: {}

      In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

      -

      When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object's style property as form.

      +

      When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object’s style property as form.

      Special Considerations for multipart Content

      It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

      When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred — thus, the following default Content-Types are defined for multipart:

      @@ -1948,7 +1956,7 @@ address: # default Content-Type for objects is `application/json` type: object - properties: {} + properties: {} profileImage: # default Content-Type for string/binary is `application/octet-stream` type: string @@ -1962,7 +1970,7 @@ # default Content-Type for arrays is based on the `inner` type (object shown, so `application/json` in this example) type: array items: - type: '#/components/schemas/Address' + type: '#/components/schemas/Address'

      An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

      Encoding Object

      @@ -1984,7 +1992,7 @@ headers -Map[string, Header Object ¦ Reference Object] +Map[string, Header Object | Reference Object] A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart. @@ -2020,12 +2028,12 @@ address: # default is application/json type: object - properties: {} + properties: {} historyMetadata: # need to declare XML format! description: metadata in XML format type: object - properties: {} + properties: {} profileImage: # default is application/octet-stream, need to declare an image type only! type: string @@ -2064,7 +2072,7 @@ default -Response Object ¦ Reference Object +Response Object | Reference Object The documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses. A Reference Object can link to a response that the OpenAPI Object’s components/responses section defines. @@ -2081,7 +2089,7 @@ HTTP Status Code -Response Object ¦ Reference Object +Response Object | Reference Object Any HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. A Reference Object can link to a response that is defined in the OpenAPI Object’s components/responses section. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. Only the following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code. @@ -2091,22 +2099,22 @@

      A 200 response for a successful operation and a default response for others (implying an error):

      
       {
      -  "200": {
      -    "description": "a pet to be returned",
      -    "content": {
      -      "application/json": {
      -        "schema": {
      -          "$ref": "#/components/schemas/Pet"
      +  "200": {
      +    "description": "a pet to be returned",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/Pet"
               }
             }
           }
         },
      -  "default": {
      -    "description": "Unexpected error",
      -    "content": {
      -      "application/json": {
      -        "schema": {
      -          "$ref": "#/components/schemas/ErrorModel"
      +  "default": {
      +    "description": "Unexpected error",
      +    "content": {
      +      "application/json": {
      +        "schema": {
      +          "$ref": "#/components/schemas/ErrorModel"
               }
             }
           }
      @@ -2114,18 +2122,18 @@
       }
       
      
      -'200':
      +'200':
         description: a pet to be returned
         content: 
           application/json:
             schema:
      -        $ref: '#/components/schemas/Pet'
      +        $ref: '#/components/schemas/Pet'
       default:
         description: Unexpected error
         content:
           application/json:
             schema:
      -        $ref: '#/components/schemas/ErrorModel'
      +        $ref: '#/components/schemas/ErrorModel'
       

      Response Object

      Describes a single response from an API Operation, including design-time, static @@ -2147,7 +2155,7 @@ headers -Map[string, Header Object ¦ Reference Object] +Map[string, Header Object | Reference Object] Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored. @@ -2157,7 +2165,7 @@ links -Map[string, Link Object ¦ Reference Object] +Map[string, Link Object | Reference Object] A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects. @@ -2167,13 +2175,13 @@

      Response of an array of a complex type:

      
       {
      -  "description": "A complex object array response",
      -  "content": {
      -    "application/json": {
      -      "schema": {
      -        "type": "array",
      -        "items": {
      -          "$ref": "#/components/schemas/VeryComplexType"
      +  "description": "A complex object array response",
      +  "content": {
      +    "application/json": {
      +      "schema": {
      +        "type": "array",
      +        "items": {
      +          "$ref": "#/components/schemas/VeryComplexType"
               }
             }
           }
      @@ -2187,16 +2195,16 @@
           schema: 
             type: array
             items:
      -        $ref: '#/components/schemas/VeryComplexType'
      +        $ref: '#/components/schemas/VeryComplexType'
       

      Response with a string type:

      
       {
      -  "description": "A simple string response",
      -  "content": {
      -    "text/plain": {
      -      "schema": {
      -        "type": "string"
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string"
             }
           }
         }
      @@ -2213,32 +2221,32 @@
       

      Plain text response with headers:

      
       {
      -  "description": "A simple string response",
      -  "content": {
      -    "text/plain": {
      -      "schema": {
      -        "type": "string",
      -        "example": "whoa!"
      +  "description": "A simple string response",
      +  "content": {
      +    "text/plain": {
      +      "schema": {
      +        "type": "string",
      +        "example": "whoa!"
             }
           }
         },
      -  "headers": {
      -    "X-Rate-Limit-Limit": {
      -      "description": "The number of allowed requests in the current period",
      -      "schema": {
      -        "type": "integer"
      +  "headers": {
      +    "X-Rate-Limit-Limit": {
      +      "description": "The number of allowed requests in the current period",
      +      "schema": {
      +        "type": "integer"
             }
           },
      -    "X-Rate-Limit-Remaining": {
      -      "description": "The number of remaining requests in the current period",
      -      "schema": {
      -        "type": "integer"
      +    "X-Rate-Limit-Remaining": {
      +      "description": "The number of remaining requests in the current period",
      +      "schema": {
      +        "type": "integer"
             }
           },
      -    "X-Rate-Limit-Reset": {
      -      "description": "The number of seconds left in the current period",
      -      "schema": {
      -        "type": "integer"
      +    "X-Rate-Limit-Reset": {
      +      "description": "The number of seconds left in the current period",
      +      "schema": {
      +        "type": "integer"
             }
           }
         }
      @@ -2250,7 +2258,7 @@
         text/plain:
           schema:
             type: string
      -    example: 'whoa!'
      +    example: 'whoa!'
       headers:
         X-Rate-Limit-Limit:
           description: The number of allowed requests in the current period
      @@ -2268,7 +2276,7 @@
       

      Response with no return value:

      
       {
      -  "description": "object created"
      +  "description": "object created"
       }
       
      
      @@ -2303,22 +2311,22 @@
       This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

      For example, given the following HTTP request:

      
      -POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
      -Host: example.org
      -Content-Type: application/json
      -Content-Length: 187
      +POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
      +Host: example.org
      +Content-Type: application/json
      +Content-Length: 187
       
      -{
      -  "failedUrl" : "http://clientdomain.com/failed",
      -  "successUrls" : [
      -    "http://clientdomain.com/fast",
      -    "http://clientdomain.com/medium",
      -    "http://clientdomain.com/slow"
      +{
      +  "failedUrl" : "http://clientdomain.com/failed",
      +  "successUrls" : [
      +    "http://clientdomain.com/fast",
      +    "http://clientdomain.com/medium",
      +    "http://clientdomain.com/slow"
         ] 
       }
       
       201 Created
      -Location: http://example.org/subscription/1
      +Location: http://example.org/subscription/1
       

      The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

      @@ -2367,31 +2375,31 @@

      The following example uses the user provided queryUrl query string parameter to define the callback URL. This is an example of how to use a callback object to describe a WebHook callback that goes with the subscription operation to enable registering for the WebHook.

      
       myCallback:
      -  '{$request.query.queryUrl}':
      +  '{$request.query.queryUrl}':
           post:
             requestBody:
               description: Callback payload
               content: 
      -          'application/json':
      +          'application/json':
                   schema:
      -              $ref: '#/components/schemas/SomePayload'
      +              $ref: '#/components/schemas/SomePayload'
             responses:
      -        '200':
      +        '200':
                 description: callback successfully processed
       

      The following example shows a callback where the server is hard-coded, but the query string parameters are populated from the id and email property in the request body.

      
       transactionCallback:
      -  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
      +  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
           post:
             requestBody:
               description: Callback payload
               content: 
      -          'application/json':
      +          'application/json':
                   schema:
      -              $ref: '#/components/schemas/SomePayload'
      +              $ref: '#/components/schemas/SomePayload'
             responses:
      -        '200':
      +        '200':
                 description: callback successfully processed
       

      Example Object

      @@ -2436,51 +2444,51 @@
      
       requestBody:
         content:
      -    'application/json':
      +    'application/json':
             schema:
      -        $ref: '#/components/schemas/Address'
      +        $ref: '#/components/schemas/Address'
             examples: 
               foo:
                 summary: A foo example
      -          value: {"foo": "bar"}
      +          value: {"foo": "bar"}
               bar:
                 summary: A bar example
      -          value: {"bar": "baz"}
      -    'application/xml':
      +          value: {"bar": "baz"}
      +    'application/xml':
             examples: 
               xmlExample:
                 summary: This is an example in XML
      -          externalValue: 'http://example.org/examples/address-example.xml'
      -    'text/plain':
      +          externalValue: 'http://example.org/examples/address-example.xml'
      +    'text/plain':
             examples:
               textExample: 
                 summary: This is a text example
      -          externalValue: 'http://foo.bar/examples/address-example.txt'
      +          externalValue: 'http://foo.bar/examples/address-example.txt'
       

      In a parameter:

      
       parameters:
      -  - name: 'zipCode'
      -    in: 'query'
      +  - name: 'zipCode'
      +    in: 'query'
           schema:
      -      type: 'string'
      -      format: 'zip-code'
      +      type: 'string'
      +      format: 'zip-code'
           examples:
             zip-example: 
      -        $ref: '#/components/examples/zip-example'
      +        $ref: '#/components/examples/zip-example'
       

      In a response:

      
       responses:
      -  '200':
      +  '200':
           description: your car appointment has been booked
           content: 
             application/json:
               schema:
      -          $ref: '#/components/schemas/SuccessResponse'
      +          $ref: '#/components/schemas/SuccessResponse'
               examples:
                 confirmation-success:
      -            $ref: '#/components/examples/confirmation-success'
      +            $ref: '#/components/examples/confirmation-success'
       

      Link Object

      The Link object represents a possible design-time link for a response. @@ -2509,12 +2517,12 @@

      - + - + @@ -2548,7 +2556,7 @@ type:stringget:responses: - '200': + '200':description:theuserbeingreturnedcontent:application/json: @@ -2578,8 +2586,8 @@ get:operationId:getUserAddressresponses: - '200': - description:theuser'saddress + '200': + description:theuser'saddress

      When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

      Values from the response body can be used to drive a linked operation.

      @@ -2600,8 +2608,8 @@
      
       links:
         UserRepositories:
      -    # returns array of '#/components/schemas/repository'
      -    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
           parameters:
             username: $response.body#/username
       
      @@ -2609,8 +2617,8 @@
      
       links:
         UserRepositories:
      -    # returns array of '#/components/schemas/repository'
      -    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
      +    # returns array of '#/components/schemas/repository'
      +    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
           parameters:
             username: $response.body#/username
       
      @@ -2621,22 +2629,22 @@ This mechanism is used by Link Objects and Callback Objects.

      The runtime expression is defined by the following [ABNF] syntax

      
      -      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
      +      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
             source = ( header-reference / query-reference / path-reference / body-reference )
      -      header-reference = "header." token
      -      query-reference = "query." name  
      -      path-reference = "path." name
      -      body-reference = "body" ["#" json-pointer ]
      -      json-pointer    = *( "/" reference-token )
      +      header-reference = "header." token
      +      query-reference = "query." name  
      +      path-reference = "path." name
      +      body-reference = "body" ["#" json-pointer ]
      +      json-pointer    = *( "/" reference-token )
             reference-token = *( unescaped / escaped )
             unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
      -         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
      -      escaped         = "~" ( "0" / "1" )
      -        ; representing '~' and '/', respectively
      +         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
      +      escaped         = "~" ( "0" / "1" )
      +        ; representing '~' and '/', respectively
             name = *( CHAR )
             token = 1*tchar
      -      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
      -        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
      +      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
      +        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
       

      Here, json-pointer is taken from [[!RFC6901]], char from [[!RFC7159]] and token from [[!RFC7230]].

      The name identifier is case-sensitive, whereas token is not.

      @@ -2701,9 +2709,9 @@

      A simple header of type integer:

      
       {
      -  "description": "The number of allowed requests in the current period",
      -  "schema": {
      -    "type": "integer"
      +  "description": "The number of allowed requests in the current period",
      +  "schema": {
      +    "type": "integer"
         }
       }
       
      @@ -2746,8 +2754,8 @@

      Tag Object Example

      
       {
      -	"name": "pet",
      -	"description": "Pets operations"
      +	"name": "pet",
      +	"description": "Pets operations"
       }
       
      
      @@ -2779,16 +2787,16 @@
       

      Reference Object Example

      
       {
      -	"$ref": "#/components/schemas/Pet"
      +	"$ref": "#/components/schemas/Pet"
       }
       
      
      -$ref: '#/components/schemas/Pet'
      +$ref: '#/components/schemas/Pet'
       

      Relative Schema Document Example

      
       {
      -  "$ref": "Pet.json"
      +  "$ref": "Pet.json"
       }
       
      
      @@ -2797,7 +2805,7 @@
       

      Relative Documents With Embedded Schema Example

      
       {
      -  "$ref": "definitions.json#/Pet"
      +  "$ref": "definitions.json#/Pet"
       }
       
      
      @@ -2919,8 +2927,8 @@
       
      Primitive Sample
      
       {
      -  "type": "string",
      -  "format": "email"
      +  "type": "string",
      +  "format": "email"
       }
       
      
      @@ -2930,21 +2938,21 @@
       
      Simple Model
      
       {
      -  "type": "object",
      -  "required": [
      -    "name"
      +  "type": "object",
      +  "required": [
      +    "name"
         ],
      -  "properties": {
      -    "name": {
      -      "type": "string"
      +  "properties": {
      +    "name": {
      +      "type": "string"
           },
      -    "address": {
      -      "$ref": "#/components/schemas/Address"
      +    "address": {
      +      "$ref": "#/components/schemas/Address"
           },
      -    "age": {
      -      "type": "integer",
      -      "format": "int32",
      -      "minimum": 0
      +    "age": {
      +      "type": "integer",
      +      "format": "int32",
      +      "minimum": 0
           }
         }
       }
      @@ -2957,7 +2965,7 @@
         name:
           type: string
         address:
      -    $ref: '#/components/schemas/Address'
      +    $ref: '#/components/schemas/Address'
         age:
           type: integer
           format: int32
      @@ -2967,9 +2975,9 @@
       

      For a simple string to string mapping:

      
       {
      -  "type": "object",
      -  "additionalProperties": {
      -    "type": "string"
      +  "type": "object",
      +  "additionalProperties": {
      +    "type": "string"
         }
       }
       
      @@ -2981,36 +2989,36 @@

      For a string to model mapping:

      
       {
      -  "type": "object",
      -  "additionalProperties": {
      -    "$ref": "#/components/schemas/ComplexModel"
      +  "type": "object",
      +  "additionalProperties": {
      +    "$ref": "#/components/schemas/ComplexModel"
         }
       }
       
      
       type: object
       additionalProperties:
      -  $ref: '#/components/schemas/ComplexModel'
      +  $ref: '#/components/schemas/ComplexModel'
       
      Model with Example
      
       {
      -  "type": "object",
      -  "properties": {
      -    "id": {
      -      "type": "integer",
      -      "format": "int64"
      +  "type": "object",
      +  "properties": {
      +    "id": {
      +      "type": "integer",
      +      "format": "int64"
           },
      -    "name": {
      -      "type": "string"
      +    "name": {
      +      "type": "string"
           }
         },
      -  "required": [
      -    "name"
      +  "required": [
      +    "name"
         ],
      -  "example": {
      -    "name": "Puma",
      -    "id": 1
      +  "example": {
      +    "name": "Puma",
      +    "id": 1
         }
       }
       
      @@ -3031,38 +3039,38 @@
      Models with Composition
      
       {
      -  "components": {
      -    "schemas": {
      -      "ErrorModel": {
      -        "type": "object",
      -        "required": [
      -          "message",
      -          "code"
      +  "components": {
      +    "schemas": {
      +      "ErrorModel": {
      +        "type": "object",
      +        "required": [
      +          "message",
      +          "code"
               ],
      -        "properties": {
      -          "message": {
      -            "type": "string"
      +        "properties": {
      +          "message": {
      +            "type": "string"
                 },
      -          "code": {
      -            "type": "integer",
      -            "minimum": 100,
      -            "maximum": 600
      +          "code": {
      +            "type": "integer",
      +            "minimum": 100,
      +            "maximum": 600
                 }
               }
             },
      -      "ExtendedErrorModel": {
      -        "allOf": [
      +      "ExtendedErrorModel": {
      +        "allOf": [
                 {
      -            "$ref": "#/components/schemas/ErrorModel"
      +            "$ref": "#/components/schemas/ErrorModel"
                 },
                 {
      -            "type": "object",
      -            "required": [
      -              "rootCause"
      +            "type": "object",
      +            "required": [
      +              "rootCause"
                   ],
      -            "properties": {
      -              "rootCause": {
      -                "type": "string"
      +            "properties": {
      +              "rootCause": {
      +                "type": "string"
                     }
                   }
                 }
      @@ -3089,7 +3097,7 @@
                 maximum: 600
           ExtendedErrorModel:
             allOf:
      -      - $ref: '#/components/schemas/ErrorModel'
      +      - $ref: '#/components/schemas/ErrorModel'
             - type: object
               required:
               - rootCause
      @@ -3100,72 +3108,72 @@
       
      Models with Polymorphism Support
      
       {
      -  "components": {
      -    "schemas": {
      -      "Pet": {
      -        "type": "object",
      -        "discriminator": {
      -          "propertyName": "petType"
      +  "components": {
      +    "schemas": {
      +      "Pet": {
      +        "type": "object",
      +        "discriminator": {
      +          "propertyName": "petType"
               },
      -        "properties": {
      -          "name": {
      -            "type": "string"
      +        "properties": {
      +          "name": {
      +            "type": "string"
                 },
      -          "petType": {
      -            "type": "string"
      +          "petType": {
      +            "type": "string"
                 }
               },
      -        "required": [
      -          "name",
      -          "petType"
      +        "required": [
      +          "name",
      +          "petType"
               ]
             },
      -      "Cat": {
      -        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
      -        "allOf": [
      +      "Cat": {
      +        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
      +        "allOf": [
                 {
      -            "$ref": "#/components/schemas/Pet"
      +            "$ref": "#/components/schemas/Pet"
                 },
                 {
      -            "type": "object",
      -            "properties": {
      -              "huntingSkill": {
      -                "type": "string",
      -                "description": "The measured skill for hunting",
      -                "default": "lazy",
      -                "enum": [
      -                  "clueless",
      -                  "lazy",
      -                  "adventurous",
      -                  "aggressive"
      +            "type": "object",
      +            "properties": {
      +              "huntingSkill": {
      +                "type": "string",
      +                "description": "The measured skill for hunting",
      +                "default": "lazy",
      +                "enum": [
      +                  "clueless",
      +                  "lazy",
      +                  "adventurous",
      +                  "aggressive"
                       ]
                     }
                   },
      -            "required": [
      -              "huntingSkill"
      +            "required": [
      +              "huntingSkill"
                   ]
                 }
               ]
             },
      -      "Dog": {
      -        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
      -        "allOf": [
      +      "Dog": {
      +        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
      +        "allOf": [
                 {
      -            "$ref": "#/components/schemas/Pet"
      +            "$ref": "#/components/schemas/Pet"
                 },
                 {
      -            "type": "object",
      -            "properties": {
      -              "packSize": {
      -                "type": "integer",
      -                "format": "int32",
      -                "description": "the size of the pack the dog is from",
      -                "default": 0,
      -                "minimum": 0
      +            "type": "object",
      +            "properties": {
      +              "packSize": {
      +                "type": "integer",
      +                "format": "int32",
      +                "description": "the size of the pack the dog is from",
      +                "default": 0,
      +                "minimum": 0
                     }
                   },
      -            "required": [
      -              "packSize"
      +            "required": [
      +              "packSize"
                   ]
                 }
               ]
      @@ -3189,10 +3197,10 @@
             required:
             - name
             - petType
      -    Cat:  ## "Cat" will be used as the discriminator value
      +    Cat:  ## "Cat" will be used as the discriminator value
             description: A representation of a cat
             allOf:
      -      - $ref: '#/components/schemas/Pet'
      +      - $ref: '#/components/schemas/Pet'
             - type: object
               properties:
                 huntingSkill:
      @@ -3205,10 +3213,10 @@
                   - aggressive
               required:
               - huntingSkill
      -    Dog:  ## "Dog" will be used as the discriminator value
      +    Dog:  ## "Dog" will be used as the discriminator value
             description: A representation of a dog
             allOf:
      -      - $ref: '#/components/schemas/Pet'
      +      - $ref: '#/components/schemas/Pet'
             - type: object
               properties:
                 packSize:
      @@ -3250,25 +3258,25 @@
       
      
       MyResponseType:
         oneOf:
      -  - $ref: '#/components/schemas/Cat'
      -  - $ref: '#/components/schemas/Dog'
      -  - $ref: '#/components/schemas/Lizard'
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
       

      which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

      
       MyResponseType:
         oneOf:
      -  - $ref: '#/components/schemas/Cat'
      -  - $ref: '#/components/schemas/Dog'
      -  - $ref: '#/components/schemas/Lizard'
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
         discriminator:
           propertyName: petType
       

      The expectation now is that a property with name petType MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

      
       {
      -  "id": 12345,
      -  "petType": "Cat"
      +  "id": 12345,
      +  "petType": "Cat"
       }
       

      Will indicate that the Cat schema be used in conjunction with this payload.

      @@ -3276,15 +3284,15 @@
      
       MyResponseType:
         oneOf:
      -  - $ref: '#/components/schemas/Cat'
      -  - $ref: '#/components/schemas/Dog'
      -  - $ref: '#/components/schemas/Lizard'
      -  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +  - $ref: '#/components/schemas/Cat'
      +  - $ref: '#/components/schemas/Dog'
      +  - $ref: '#/components/schemas/Lizard'
      +  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
         discriminator:
           propertyName: petType
           mapping:
      -      dog: '#/components/schemas/Dog'
      -      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
      +      dog: '#/components/schemas/Dog'
      +      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
       

      Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

      When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

      @@ -3306,7 +3314,7 @@ dog: Dog Cat: allOf: - - $ref: '#/components/schemas/Pet' + - $ref: '#/components/schemas/Pet' - type: object # all other properties specific to a `Cat` properties: @@ -3314,7 +3322,7 @@ type: string Dog: allOf: - - $ref: '#/components/schemas/Pet' + - $ref: '#/components/schemas/Pet' - type: object # all other properties specific to a `Dog` properties: @@ -3322,7 +3330,7 @@ type: string Lizard: allOf: - - $ref: '#/components/schemas/Pet' + - $ref: '#/components/schemas/Pet' - type: object # all other properties specific to a `Lizard` properties: @@ -3332,15 +3340,15 @@

      a payload like this:

      
       {
      -  "petType": "Cat",
      -  "name": "misty"
      +  "petType": "Cat",
      +  "name": "misty"
       }
       

      will indicate that the Cat schema be used. Likewise this schema:

      
       {
      -  "petType": "dog",
      -  "bark": "soft"
      +  "petType": "dog",
      +  "bark": "soft"
       }
       

      will map to Dog because of the definition in the mappings element.

      @@ -3392,8 +3400,8 @@

      Basic string property:

      
       {
      -    "animals": {
      -        "type": "string"
      +    "animals": {
      +        "type": "string"
           }
       }
       
      @@ -3407,10 +3415,10 @@

      Basic string array property (wrapped is false by default):

      
       {
      -    "animals": {
      -        "type": "array",
      -        "items": {
      -            "type": "string"
      +    "animals": {
      +        "type": "array",
      +        "items": {
      +            "type": "string"
               }
           }
       }
      @@ -3429,10 +3437,10 @@
       
      XML Name Replacement
      
       {
      -  "animals": {
      -    "type": "string",
      -    "xml": {
      -      "name": "animal"
      +  "animals": {
      +    "type": "string",
      +    "xml": {
      +      "name": "animal"
           }
         }
       }
      @@ -3450,21 +3458,21 @@
       

      In this example, a full model definition is shown.

      
       {
      -  "Person": {
      -    "type": "object",
      -    "properties": {
      -      "id": {
      -        "type": "integer",
      -        "format": "int32",
      -        "xml": {
      -          "attribute": true
      +  "Person": {
      +    "type": "object",
      +    "properties": {
      +      "id": {
      +        "type": "integer",
      +        "format": "int32",
      +        "xml": {
      +          "attribute": true
               }
             },
      -      "name": {
      -        "type": "string",
      -        "xml": {
      -          "namespace": "http://example.com/schema/sample",
      -          "prefix": "sample"
      +      "name": {
      +        "type": "string",
      +        "xml": {
      +          "namespace": "http://example.com/schema/sample",
      +          "prefix": "sample"
               }
             }
           }
      @@ -3487,20 +3495,20 @@
               prefix: sample
       
      
      -<Person id="123">
      -    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
      +<Person id="123">
      +    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
       </Person>
       
      XML Arrays

      Changing the element names:

      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string",
      -      "xml": {
      -        "name": "animal"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
             }
           }
         }
      @@ -3521,16 +3529,16 @@
       

      The external name property has no effect on the XML:

      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string",
      -      "xml": {
      -        "name": "animal"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
             }
           },
      -    "xml": {
      -      "name": "aliens"
      +    "xml": {
      +      "name": "aliens"
           }
         }
       }
      @@ -3552,13 +3560,13 @@
       

      Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
           },
      -    "xml": {
      -      "wrapped": true
      +    "xml": {
      +      "wrapped": true
           }
         }
       }
      @@ -3580,16 +3588,16 @@
       

      To overcome the naming problem in the example above, the following definition can be used:

      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string",
      -      "xml": {
      -        "name": "animal"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
             }
           },
      -    "xml": {
      -      "wrapped": true
      +    "xml": {
      +      "wrapped": true
           }
         }
       }
      @@ -3613,17 +3621,17 @@
       

      Affecting both internal and external names:

      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string",
      -      "xml": {
      -        "name": "animal"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string",
      +      "xml": {
      +        "name": "animal"
             }
           },
      -    "xml": {
      -      "name": "aliens",
      -      "wrapped": true
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
           }
         }
       }
      @@ -3648,14 +3656,14 @@
       

      If we change the external element but not the internal ones:

      
       {
      -  "animals": {
      -    "type": "array",
      -    "items": {
      -      "type": "string"
      +  "animals": {
      +    "type": "array",
      +    "items": {
      +      "type": "string"
           },
      -    "xml": {
      -      "name": "aliens",
      -      "wrapped": true
      +    "xml": {
      +      "name": "aliens",
      +      "wrapped": true
           }
         }
       }
      @@ -3744,8 +3752,8 @@
       
      Basic Authentication Sample
      
       {
      -  "type": "http",
      -  "scheme": "basic"
      +  "type": "http",
      +  "scheme": "basic"
       }
       
      
      @@ -3755,9 +3763,9 @@
       
      API Key Sample
      
       {
      -  "type": "apiKey",
      -  "name": "api_key",
      -  "in": "header"
      +  "type": "apiKey",
      +  "name": "api_key",
      +  "in": "header"
       }
       
      
      @@ -3768,9 +3776,9 @@
       
      JWT Bearer Sample
      
       {
      -  "type": "http",
      -  "scheme": "bearer",
      -  "bearerFormat": "JWT",
      +  "type": "http",
      +  "scheme": "bearer",
      +  "bearerFormat": "JWT",
       }
       
      
      @@ -3781,13 +3789,13 @@
       
      Implicit OAuth2 Sample
      
       {
      -  "type": "oauth2",
      -  "flows": {
      -    "implicit": {
      -      "authorizationUrl": "https://example.com/api/oauth/dialog",
      -      "scopes": {
      -        "write:pets": "modify pets in your account",
      -        "read:pets": "read your pets"
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
             }
           }
         }
      @@ -3880,21 +3888,21 @@
       

      OAuth Flow Object Examples

      
       {
      -  "type": "oauth2",
      -  "flows": {
      -    "implicit": {
      -      "authorizationUrl": "https://example.com/api/oauth/dialog",
      -      "scopes": {
      -        "write:pets": "modify pets in your account",
      -        "read:pets": "read your pets"
      +  "type": "oauth2",
      +  "flows": {
      +    "implicit": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
             }
           },
      -    "authorizationCode": {
      -      "authorizationUrl": "https://example.com/api/oauth/dialog",
      -      "tokenUrl": "https://example.com/api/oauth/token",
      -      "scopes": {
      -        "write:pets": "modify pets in your account",
      -        "read:pets": "read your pets"
      +    "authorizationCode": {
      +      "authorizationUrl": "https://example.com/api/oauth/dialog",
      +      "tokenUrl": "https://example.com/api/oauth/token",
      +      "scopes": {
      +        "write:pets": "modify pets in your account",
      +        "read:pets": "read your pets"
             }
           }
         }
      @@ -3942,18 +3950,18 @@
       
      Non-OAuth2 Security Requirement
      
       {
      -  "api_key": []
      +  "api_key": []
       }
       
      
      -api_key: []
      +api_key: []
       
      OAuth2 Security Requirement
      
       {
      -  "petstore_auth": [
      -    "write:pets",
      -    "read:pets"
      +  "petstore_auth": [
      +    "write:pets",
      +    "read:pets"
         ]
       }
       
      @@ -3966,12 +3974,12 @@

      Optional OAuth2 security as would be defined in an OpenAPI Object or an Operation Object:

      
       {
      -  "security": [
      +  "security": [
           {},
           {
      -      "petstore_auth": [
      -        "write:pets",
      -        "read:pets"
      +      "petstore_auth": [
      +        "write:pets",
      +        "read:pets"
             ]
           }
         ]
      @@ -3979,7 +3987,7 @@
       
      
       security:
      -  - {}
      +  - {}
         - petstore_auth:
           - write:pets
           - read:pets
      diff --git a/oas/v3.1.0.html b/oas/v3.1.0.html
      index e9ba775ffc..751f55370c 100644
      --- a/oas/v3.1.0.html
      +++ b/oas/v3.1.0.html
      @@ -162,7 +162,7 @@
       
      - + @@ -521,47 +521,47 @@ - + - + - + - + - + - + - + - + - + @@ -578,99 +578,99 @@

      Components Object Example

      
      -"components": {
      -  "schemas": {
      -    "GeneralError": {
      -      "type": "object",
      -      "properties": {
      -        "code": {
      -          "type": "integer",
      -          "format": "int32"
      +"components": {
      +  "schemas": {
      +    "GeneralError": {
      +      "type": "object",
      +      "properties": {
      +        "code": {
      +          "type": "integer",
      +          "format": "int32"
               },
      -        "message": {
      -          "type": "string"
      +        "message": {
      +          "type": "string"
               }
             }
           },
      -    "Category": {
      -      "type": "object",
      -      "properties": {
      -        "id": {
      -          "type": "integer",
      -          "format": "int64"
      +    "Category": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
               },
      -        "name": {
      -          "type": "string"
      +        "name": {
      +          "type": "string"
               }
             }
           },
      -    "Tag": {
      -      "type": "object",
      -      "properties": {
      -        "id": {
      -          "type": "integer",
      -          "format": "int64"
      +    "Tag": {
      +      "type": "object",
      +      "properties": {
      +        "id": {
      +          "type": "integer",
      +          "format": "int64"
               },
      -        "name": {
      -          "type": "string"
      +        "name": {
      +          "type": "string"
               }
             }
           }
         },
      -  "parameters": {
      -    "skipParam": {
      -      "name": "skip",
      -      "in": "query",
      -      "description": "number of items to skip",
      -      "required": true,
      -      "schema": {
      -        "type": "integer",
      -        "format": "int32"
      +  "parameters": {
      +    "skipParam": {
      +      "name": "skip",
      +      "in": "query",
      +      "description": "number of items to skip",
      +      "required": true,
      +      "schema": {
      +        "type": "integer",
      +        "format": "int32"
             }
           },
      -    "limitParam": {
      -      "name": "limit",
      -      "in": "query",
      -      "description": "max records to return",
      -      "required": true,
      -      "schema" : {
      -        "type": "integer",
      -        "format": "int32"
      +    "limitParam": {
      +      "name": "limit",
      +      "in": "query",
      +      "description": "max records to return",
      +      "required": true,
      +      "schema" : {
      +        "type": "integer",
      +        "format": "int32"
             }
           }
         },
      -  "responses": {
      -    "NotFound": {
      -      "description": "Entity not found."
      +  "responses": {
      +    "NotFound": {
      +      "description": "Entity not found."
           },
      -    "IllegalInput": {
      -      "description": "Illegal input for operation."
      +    "IllegalInput": {
      +      "description": "Illegal input for operation."
           },
      -    "GeneralError": {
      -      "description": "General Error",
      -      "content": {
      -        "application/json": {
      -          "schema": {
      -            "$ref": "#/components/schemas/GeneralError"
      +    "GeneralError": {
      +      "description": "General Error",
      +      "content": {
      +        "application/json": {
      +          "schema": {
      +            "$ref": "#/components/schemas/GeneralError"
                 }
               }
             }
           }
         },
      -  "securitySchemes": {
      -    "api_key": {
      -      "type": "apiKey",
      -      "name": "api_key",
      -      "in": "header"
      +  "securitySchemes": {
      +    "api_key": {
      +      "type": "apiKey",
      +      "name": "api_key",
      +      "in": "header"
           },
      -    "petstore_auth": {
      -      "type": "oauth2",
      -      "flows": {
      -        "implicit": {
      -          "authorizationUrl": "https://example.org/api/oauth/dialog",
      -          "scopes": {
      -            "write:pets": "modify pets in your account",
      -            "read:pets": "read your pets"
      +    "petstore_auth": {
      +      "type": "oauth2",
      +      "flows": {
      +        "implicit": {
      +          "authorizationUrl": "https://example.org/api/oauth/dialog",
      +          "scopes": {
      +            "write:pets": "modify pets in your account",
      +            "read:pets": "read your pets"
                 }
               }
             }
      @@ -899,7 +899,7 @@
       
       
      - + @@ -1025,12 +1025,12 @@ - + - + @@ -1040,7 +1040,7 @@ - + @@ -1295,7 +1295,7 @@ - + @@ -1472,8 +1472,8 @@ - - + + @@ -1481,7 +1481,7 @@ - +
      parametersMap[string, Any ¦ {expression}]Map[string, Any | {expression}] A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
      requestBodyAny ¦ {expression}Any | {expression} A literal value or {expression} to use as a request body when calling the target operation.
      webhooksMap[string, Path Item Object ¦ Reference Object] ]Map[string, Path Item Object | Reference Object] ] The incoming webhooks that MAY be received as part of this API and that the API consumer MAY choose to implement. Closely related to the callbacks feature, this section describes requests initiated other than by an API call, for example by an out of band registration. The key name is a unique string to refer to each webhook, while the (optionally referenced) Path Item Object describes a request that may be initiated by the API provider and the expected responses. An example is available.
      responsesMap[string, Response Object ¦ Reference Object]Map[string, Response Object | Reference Object] An object to hold reusable Response Objects.
      parametersMap[string, Parameter Object ¦ Reference Object]Map[string, Parameter Object | Reference Object] An object to hold reusable Parameter Objects.
      examplesMap[string, Example Object ¦ Reference Object]Map[string, Example Object | Reference Object] An object to hold reusable Example Objects.
      requestBodiesMap[string, Request Body Object ¦ Reference Object]Map[string, Request Body Object | Reference Object] An object to hold reusable Request Body Objects.
      headersMap[string, Header Object ¦ Reference Object]Map[string, Header Object | Reference Object] An object to hold reusable Header Objects.
      securitySchemesMap[string, Security Scheme Object ¦ Reference Object]Map[string, Security Scheme Object | Reference Object] An object to hold reusable Security Scheme Objects.
      linksMap[string, Link Object ¦ Reference Object]Map[string, Link Object | Reference Object] An object to hold reusable Link Objects.
      callbacksMap[string, Callback Object ¦ Reference Object]Map[string, Callback Object | Reference Object] An object to hold reusable Callback Objects.
      pathItemsMap[string, Path Item Object ¦ Reference Object]Map[string, Path Item Object | Reference Object] An object to hold reusable Path Item Object.
      parameters[Parameter Object ¦ Reference Object][Parameter Object | Reference Object] A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      parameters[Parameter Object ¦ Reference Object][Parameter Object | Reference Object] A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
      requestBodyRequest Body Object ¦ Reference ObjectRequest Body Object | Reference Object The request body applicable for this operation. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as [GET]section-4.3.1), [HEAD]section-4.3.2) and [DELETE]section-4.3.5)), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.
      callbacksMap[string, Callback Object ¦ Reference Object]Map[string, Callback Object | Reference Object] A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses.
      examplesMap[ string, Example Object ¦ Reference Object]Map[ string, Example Object | Reference Object] Examples of the parameter’s potential value. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema that contains an example, the examples value SHALL override the example provided by the schema.
      false n/a n/ablue¦black¦brownR¦100¦G¦200¦B¦150blue|black|brownR|100|G|200|B|150
      deepObjectn/a n/a n/acolor\R=100&color\G=200&color\B=150color[R]=100&color[G]=200&color[B]=150
      @@ -1786,7 +1786,7 @@ examples -Map[ string, Example Object ¦ Reference Object] +Map[ string, Example Object | Reference Object] Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema. @@ -1994,7 +1994,7 @@ headers -Map[string, Header Object ¦ Reference Object] +Map[string, Header Object | Reference Object] A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart. @@ -2072,7 +2072,7 @@ default -Response Object ¦ Reference Object +Response Object | Reference Object The documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses. @@ -2089,7 +2089,7 @@ HTTP Status Code -Response Object ¦ Reference Object +Response Object | Reference Object Any HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. Only the following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code. @@ -2155,7 +2155,7 @@ headers -Map[string, Header Object ¦ Reference Object] +Map[string, Header Object | Reference Object] Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored. @@ -2165,7 +2165,7 @@ links -Map[string, Link Object ¦ Reference Object] +Map[string, Link Object | Reference Object] A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects. @@ -2299,7 +2299,7 @@ {expression} -Path Item Object ¦ Reference Object +Path Item Object | Reference Object A Path Item Object, or a reference to one, used to define a callback request and expected responses. A complete example is available. @@ -2518,12 +2518,12 @@ parameters -Map[string, Any ¦ {expression}] +Map[string, Any | {expression}] A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id). requestBody -Any ¦ {expression} +Any | {expression} A literal value or {expression} to use as a request body when calling the target operation. From bf82a1d8e6182c679575b2b157a5b4053f25d75c Mon Sep 17 00:00:00 2001 From: Jason Desrosiers Date: Thu, 20 May 2021 10:55:22 -0700 Subject: [PATCH 014/152] iAdd v3.1 2021-05-20 schemas to website --- oas/3.1/schema-base/2021-05-20 | 24 + oas/3.1/schema/2021-05-20 | 1347 ++++++++++++++++++++++++++++++++ 2 files changed, 1371 insertions(+) create mode 100644 oas/3.1/schema-base/2021-05-20 create mode 100644 oas/3.1/schema/2021-05-20 diff --git a/oas/3.1/schema-base/2021-05-20 b/oas/3.1/schema-base/2021-05-20 new file mode 100644 index 0000000000..9796fa3851 --- /dev/null +++ b/oas/3.1/schema-base/2021-05-20 @@ -0,0 +1,24 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/schema-base/2021-05-20", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$ref": "https://spec.openapis.org/oas/3.1/schema/2021-05-20", + "properties": { + "jsonSchemaDialect": { + "$ref": "#/$defs/dialect" + } + }, + "$defs": { + "dialect": { + "const": "https://spec.openapis.org/oas/3.1/dialect/base" + }, + "schema": { + "$dynamicAnchor": "meta", + "$ref": "https://spec.openapis.org/oas/3.1/dialect/base", + "properties": { + "$schema": { + "$ref": "#/$defs/dialect" + } + } + } + } +} diff --git a/oas/3.1/schema/2021-05-20 b/oas/3.1/schema/2021-05-20 new file mode 100644 index 0000000000..44fdbb92b8 --- /dev/null +++ b/oas/3.1/schema/2021-05-20 @@ -0,0 +1,1347 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/schema/2021-05-20", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "type": "object", + "properties": { + "openapi": { + "type": "string", + "pattern": "^3\\.1\\.\\d+(-.+)?$" + }, + "info": { + "$ref": "#/$defs/info" + }, + "jsonSchemaDialect": { + "type": "string", + "format": "uri", + "default": "https://spec.openapis.org/oas/3.1/dialect/base" + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + }, + "paths": { + "$ref": "#/$defs/paths" + }, + "webhooks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + }, + "components": { + "$ref": "#/$defs/components" + }, + "security": { + "type": "array", + "items": { + "$ref": "#/$defs/security-requirement" + } + }, + "tags": { + "type": "array", + "items": { + "$ref": "#/$defs/tag" + } + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + } + }, + "required": [ + "openapi", + "info" + ], + "anyOf": [ + { + "required": [ + "paths" + ] + }, + { + "required": [ + "components" + ] + }, + { + "required": [ + "webhooks" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false, + "$defs": { + "info": { + "type": "object", + "properties": { + "title": { + "type": "string" + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "termsOfService": { + "type": "string" + }, + "contact": { + "$ref": "#/$defs/contact" + }, + "license": { + "$ref": "#/$defs/license" + }, + "version": { + "type": "string" + } + }, + "required": [ + "title", + "version" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "contact": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "url": { + "type": "string" + }, + "email": { + "type": "string" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "license": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "identifier": { + "type": "string" + }, + "url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "name" + ], + "oneOf": [ + { + "required": [ + "identifier" + ] + }, + { + "required": [ + "url" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "server": { + "type": "object", + "properties": { + "url": { + "type": "string", + "format": "uri-reference" + }, + "description": { + "type": "string" + }, + "variables": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/server-variable" + } + } + }, + "required": [ + "url" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "server-variable": { + "type": "object", + "properties": { + "enum": { + "type": "array", + "items": { + "type": "string" + }, + "minItems": 1 + }, + "default": { + "type": "string" + }, + "descriptions": { + "type": "string" + } + }, + "required": [ + "default" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "components": { + "type": "object", + "properties": { + "schemas": { + "type": "object", + "additionalProperties": { + "$dynamicRef": "#meta" + } + }, + "responses": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/response-or-reference" + } + }, + "parameters": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/parameter-or-reference" + } + }, + "examples": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/example-or-reference" + } + }, + "requestBodies": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/request-body-or-reference" + } + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "securitySchemes": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/security-scheme-or-reference" + } + }, + "links": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/link-or-reference" + } + }, + "callbacks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/callbacks-or-reference" + } + }, + "pathItems": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + } + }, + "patternProperties": { + "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": { + "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected", + "propertyNames": { + "pattern": "^[a-zA-Z0-9._-]+$" + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "paths": { + "type": "object", + "patternProperties": { + "^/": { + "$ref": "#/$defs/path-item" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "path-item": { + "type": "object", + "properties": { + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + }, + "parameters": { + "type": "array", + "items": { + "$ref": "#/$defs/parameter-or-reference" + } + } + }, + "patternProperties": { + "^(get|put|post|delete|options|head|patch|trace)$": { + "$ref": "#/$defs/operation" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "path-item-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/path-item" + } + }, + "operation": { + "type": "object", + "properties": { + "tags": { + "type": "array", + "items": { + "type": "string" + } + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + }, + "operationId": { + "type": "string" + }, + "parameters": { + "type": "array", + "items": { + "$ref": "#/$defs/parameter-or-reference" + } + }, + "requestBody": { + "$ref": "#/$defs/request-body-or-reference" + }, + "responses": { + "$ref": "#/$defs/responses" + }, + "callbacks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/callbacks-or-reference" + } + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "security": { + "type": "array", + "items": { + "$ref": "#/$defs/security-requirement" + } + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "external-documentation": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "url" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "parameter": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "in": { + "enum": [ + "query", + "header", + "path", + "cookie" + ] + }, + "description": { + "type": "string" + }, + "required": { + "default": false, + "type": "boolean" + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "allowEmptyValue": { + "default": false, + "type": "boolean" + }, + "schema": { + "$dynamicRef": "#meta" + }, + "content": { + "$ref": "#/$defs/content" + } + }, + "required": [ + "in" + ], + "oneOf": [ + { + "required": [ + "schema" + ] + }, + { + "required": [ + "content" + ] + } + ], + "dependentSchemas": { + "schema": { + "properties": { + "style": { + "type": "string" + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + } + }, + "allOf": [ + { + "$ref": "#/$defs/examples" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form" + } + ], + "$defs": { + "styles-for-path": { + "if": { + "properties": { + "in": { + "const": "path" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "simple", + "enum": [ + "matrix", + "label", + "simple" + ] + }, + "required": { + "const": true + } + }, + "required": [ + "required" + ] + } + }, + "styles-for-header": { + "if": { + "properties": { + "in": { + "const": "header" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "simple", + "enum": [ + "simple" + ] + } + } + } + }, + "styles-for-query": { + "if": { + "properties": { + "in": { + "const": "query" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "form", + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ] + } + } + } + }, + "styles-for-cookie": { + "if": { + "properties": { + "in": { + "const": "cookie" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "form", + "enum": [ + "form" + ] + } + } + } + }, + "styles-for-form": { + "if": { + "properties": { + "style": { + "const": "form" + } + }, + "required": [ + "style" + ] + }, + "then": { + "properties": { + "explode": { + "default": true + } + } + }, + "else": { + "properties": { + "explode": { + "default": false + } + } + } + } + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "parameter-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/parameter" + } + }, + "request-body": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "content": { + "$ref": "#/$defs/content" + }, + "required": { + "default": false, + "type": "boolean" + } + }, + "required": [ + "content" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "request-body-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/request-body" + } + }, + "content": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/media-type" + }, + "propertyNames": { + "format": "media-range" + } + }, + "media-type": { + "type": "object", + "properties": { + "schema": { + "$dynamicRef": "#meta" + }, + "encoding": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/encoding" + } + } + }, + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/examples" + } + ], + "unevaluatedProperties": false + }, + "encoding": { + "type": "object", + "properties": { + "contentType": { + "type": "string", + "format": "media-range" + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "style": { + "default": "form", + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ] + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + } + }, + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/encoding/$defs/explode-default" + } + ], + "unevaluatedProperties": false, + "$defs": { + "explode-default": { + "if": { + "properties": { + "style": { + "const": "form" + } + }, + "required": [ + "style" + ] + }, + "then": { + "properties": { + "explode": { + "default": true + } + } + }, + "else": { + "properties": { + "explode": { + "default": false + } + } + } + } + } + }, + "responses": { + "type": "object", + "properties": { + "default": { + "$ref": "#/$defs/response-or-reference" + } + }, + "patternProperties": { + "^[1-5][0-9X]{2}$": { + "$ref": "#/$defs/response-or-reference" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "response": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "content": { + "$ref": "#/$defs/content" + }, + "links": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/link-or-reference" + } + } + }, + "required": [ + "description" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "response-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/response" + } + }, + "callbacks": { + "type": "object", + "$ref": "#/$defs/specification-extensions", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + }, + "callbacks-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/callbacks" + } + }, + "example": { + "type": "object", + "properties": { + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "value": true, + "externalValue": { + "type": "string", + "format": "uri" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "example-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/example" + } + }, + "link": { + "type": "object", + "properties": { + "operationRef": { + "type": "string", + "format": "uri-reference" + }, + "operationId": true, + "parameters": { + "$ref": "#/$defs/map-of-strings" + }, + "requestBody": true, + "description": { + "type": "string" + }, + "body": { + "$ref": "#/$defs/server" + } + }, + "oneOf": [ + { + "required": [ + "operationRef" + ] + }, + { + "required": [ + "operationId" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "link-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/link" + } + }, + "header": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "required": { + "default": false, + "type": "boolean" + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "allowEmptyValue": { + "default": false, + "type": "boolean" + } + }, + "dependentSchemas": { + "schema": { + "properties": { + "style": { + "default": "simple", + "enum": [ + "simple" + ] + }, + "explode": { + "default": false, + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + }, + "schema": { + "$dynamicRef": "#meta" + } + }, + "$ref": "#/$defs/examples" + }, + "content": { + "properties": { + "content": { + "$ref": "#/$defs/content" + } + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "header-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/header" + } + }, + "tag": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + } + }, + "required": [ + "name" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "reference": { + "type": "object", + "properties": { + "$ref": { + "type": "string", + "format": "uri-reference" + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + } + }, + "unevaluatedProperties": false + }, + "schema": { + "$dynamicAnchor": "meta", + "type": [ + "object", + "boolean" + ] + }, + "security-scheme": { + "type": "object", + "properties": { + "type": { + "enum": [ + "apiKey", + "http", + "mutualTLS", + "oauth2", + "openIdConnect" + ] + }, + "description": { + "type": "string" + } + }, + "required": [ + "type" + ], + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-apikey" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-http" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-http-bearer" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-oauth2" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-oidc" + } + ], + "unevaluatedProperties": false, + "$defs": { + "type-apikey": { + "if": { + "properties": { + "type": { + "const": "apiKey" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "name": { + "type": "string" + }, + "in": { + "enum": [ + "query", + "header", + "cookie" + ] + } + }, + "required": [ + "name", + "in" + ] + } + }, + "type-http": { + "if": { + "properties": { + "type": { + "const": "http" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "scheme": { + "type": "string" + } + }, + "required": [ + "scheme" + ] + } + }, + "type-http-bearer": { + "if": { + "properties": { + "type": { + "const": "http" + }, + "scheme": { + "const": "bearer" + } + }, + "required": [ + "type", + "scheme" + ] + }, + "then": { + "properties": { + "bearerFormat": { + "type": "string" + } + }, + "required": [ + "scheme" + ] + } + }, + "type-oauth2": { + "if": { + "properties": { + "type": { + "const": "oauth2" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "flows": { + "$ref": "#/$defs/oauth-flows" + } + }, + "required": [ + "flows" + ] + } + }, + "type-oidc": { + "if": { + "properties": { + "type": { + "const": "openIdConnect" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "openIdConnectUrl": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "openIdConnectUrl" + ] + } + } + } + }, + "security-scheme-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/security-scheme" + } + }, + "oauth-flows": { + "type": "object", + "properties": { + "implicit": { + "$ref": "#/$defs/oauth-flows/$defs/implicit" + }, + "password": { + "$ref": "#/$defs/oauth-flows/$defs/password" + }, + "clientCredentials": { + "$ref": "#/$defs/oauth-flows/$defs/client-credentials" + }, + "authorizationCode": { + "$ref": "#/$defs/oauth-flows/$defs/authorization-code" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false, + "$defs": { + "implicit": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "authorizationUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "password": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "client-credentials": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "authorization-code": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string" + }, + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "authorizationUrl", + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + } + } + }, + "security-requirement": { + "type": "object", + "additionalProperties": { + "type": "array", + "items": { + "type": "string" + } + } + }, + "specification-extensions": { + "patternProperties": { + "^x-": true + } + }, + "examples": { + "properties": { + "example": true, + "examples": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/example-or-reference" + } + } + } + }, + "map-of-strings": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } +} From 5948c36a3bfc1814c44d5e7333194a02d95610e2 Mon Sep 17 00:00:00 2001 From: Jason Desrosiers Date: Thu, 27 May 2021 09:45:40 -0700 Subject: [PATCH 015/152] Add v3.1 2021-04-15 schemas to website (#2545) --- oas/3.1/schema-base/2021-03-02 | 2 +- oas/3.1/schema-base/2021-04-15 | 24 + oas/3.1/schema/2021-04-15 | 1343 ++++++++++++++++++++++++++++++++ 3 files changed, 1368 insertions(+), 1 deletion(-) create mode 100644 oas/3.1/schema-base/2021-04-15 create mode 100644 oas/3.1/schema/2021-04-15 diff --git a/oas/3.1/schema-base/2021-03-02 b/oas/3.1/schema-base/2021-03-02 index 078af184fe..03a580818f 100644 --- a/oas/3.1/schema-base/2021-03-02 +++ b/oas/3.1/schema-base/2021-03-02 @@ -13,7 +13,7 @@ }, "schema": { "$dynamicAnchor": "meta", - "$ref\"": "https://spec.openapis.org/oas/3.1/dialect/base", + "$ref": "https://spec.openapis.org/oas/3.1/dialect/base", "properties": { "$schema": { "$ref": "#/$defs/dialect" diff --git a/oas/3.1/schema-base/2021-04-15 b/oas/3.1/schema-base/2021-04-15 new file mode 100644 index 0000000000..cb973912a7 --- /dev/null +++ b/oas/3.1/schema-base/2021-04-15 @@ -0,0 +1,24 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/schema-base/2021-04-15", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$ref": "https://spec.openapis.org/oas/3.1/schema/2021-04-15", + "properties": { + "jsonSchemaDialect": { + "$ref": "#/$defs/dialect" + } + }, + "$defs": { + "dialect": { + "const": "https://spec.openapis.org/oas/3.1/dialect/base" + }, + "schema": { + "$dynamicAnchor": "meta", + "$ref": "https://spec.openapis.org/oas/3.1/dialect/base", + "properties": { + "$schema": { + "$ref": "#/$defs/dialect" + } + } + } + } +} diff --git a/oas/3.1/schema/2021-04-15 b/oas/3.1/schema/2021-04-15 new file mode 100644 index 0000000000..a798834247 --- /dev/null +++ b/oas/3.1/schema/2021-04-15 @@ -0,0 +1,1343 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/schema/2021-04-15", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "type": "object", + "properties": { + "openapi": { + "type": "string", + "pattern": "^3\\.1\\.\\d+(-.+)?$" + }, + "info": { + "$ref": "#/$defs/info" + }, + "jsonSchemaDialect": { + "$ref": "#/$defs/uri", + "default": "https://spec.openapis.org/oas/3.1/dialect/base" + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + }, + "paths": { + "$ref": "#/$defs/paths" + }, + "webhooks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + }, + "components": { + "$ref": "#/$defs/components" + }, + "security": { + "type": "array", + "items": { + "$ref": "#/$defs/security-requirement" + } + }, + "tags": { + "type": "array", + "items": { + "$ref": "#/$defs/tag" + } + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + } + }, + "required": [ + "openapi", + "info" + ], + "anyOf": [ + { + "required": [ + "paths" + ] + }, + { + "required": [ + "components" + ] + }, + { + "required": [ + "webhooks" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false, + "$defs": { + "info": { + "type": "object", + "properties": { + "title": { + "type": "string" + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "termsOfService": { + "type": "string" + }, + "contact": { + "$ref": "#/$defs/contact" + }, + "license": { + "$ref": "#/$defs/license" + }, + "version": { + "type": "string" + } + }, + "required": [ + "title", + "version" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "contact": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "url": { + "type": "string" + }, + "email": { + "type": "string" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "license": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "identifier": { + "type": "string" + }, + "url": { + "$ref": "#/$defs/uri" + } + }, + "required": [ + "name" + ], + "oneOf": [ + { + "required": [ + "identifier" + ] + }, + { + "required": [ + "url" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "server": { + "type": "object", + "properties": { + "url": { + "$ref": "#/$defs/uri" + }, + "description": { + "type": "string" + }, + "variables": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/server-variable" + } + } + }, + "required": [ + "url" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "server-variable": { + "type": "object", + "properties": { + "enum": { + "type": "array", + "items": { + "type": "string" + }, + "minItems": 1 + }, + "default": { + "type": "string" + }, + "descriptions": { + "type": "string" + } + }, + "required": [ + "default" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "components": { + "type": "object", + "properties": { + "schemas": { + "type": "object", + "additionalProperties": { + "$dynamicRef": "#meta" + } + }, + "responses": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/response-or-reference" + } + }, + "parameters": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/parameter-or-reference" + } + }, + "examples": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/example-or-reference" + } + }, + "requestBodies": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/request-body-or-reference" + } + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "securitySchemes": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/security-scheme-or-reference" + } + }, + "links": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/link-or-reference" + } + }, + "callbacks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/callbacks-or-reference" + } + }, + "pathItems": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + } + }, + "patternProperties": { + "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": { + "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected", + "propertyNames": { + "pattern": "^[a-zA-Z0-9._-]+$" + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "paths": { + "type": "object", + "patternProperties": { + "^/": { + "$ref": "#/$defs/path-item" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "path-item": { + "type": "object", + "properties": { + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + }, + "parameters": { + "type": "array", + "items": { + "$ref": "#/$defs/parameter-or-reference" + } + } + }, + "patternProperties": { + "^(get|put|post|delete|options|head|patch|trace)$": { + "$ref": "#/$defs/operation" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "path-item-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/path-item" + } + }, + "operation": { + "type": "object", + "properties": { + "tags": { + "type": "array", + "items": { + "type": "string" + } + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + }, + "operationId": { + "type": "string" + }, + "parameters": { + "type": "array", + "items": { + "$ref": "#/$defs/parameter-or-reference" + } + }, + "requestBody": { + "$ref": "#/$defs/request-body-or-reference" + }, + "responses": { + "$ref": "#/$defs/responses" + }, + "callbacks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/callbacks-or-reference" + } + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "security": { + "type": "array", + "items": { + "$ref": "#/$defs/security-requirement" + } + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "external-documentation": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "url": { + "$ref": "#/$defs/uri" + } + }, + "required": [ + "url" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "parameter": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "in": { + "enum": [ + "query", + "header", + "path", + "cookie" + ] + }, + "description": { + "type": "string" + }, + "required": { + "default": false, + "type": "boolean" + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "allowEmptyValue": { + "default": false, + "type": "boolean" + }, + "schema": { + "$dynamicRef": "#meta" + }, + "content": { + "$ref": "#/$defs/content" + } + }, + "required": [ + "in" + ], + "oneOf": [ + { + "required": [ + "schema" + ] + }, + { + "required": [ + "content" + ] + } + ], + "dependentSchemas": { + "schema": { + "properties": { + "style": { + "type": "string" + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + } + }, + "allOf": [ + { + "$ref": "#/$defs/examples" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form" + } + ], + "$defs": { + "styles-for-path": { + "if": { + "properties": { + "in": { + "const": "path" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "simple", + "enum": [ + "matrix", + "label", + "simple" + ] + }, + "required": { + "const": true + } + }, + "required": [ + "required" + ] + } + }, + "styles-for-header": { + "if": { + "properties": { + "in": { + "const": "header" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "simple", + "enum": [ + "simple" + ] + } + } + } + }, + "styles-for-query": { + "if": { + "properties": { + "in": { + "const": "query" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "form", + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ] + } + } + } + }, + "styles-for-cookie": { + "if": { + "properties": { + "in": { + "const": "cookie" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "form", + "enum": [ + "form" + ] + } + } + } + }, + "styles-for-form": { + "if": { + "properties": { + "style": { + "const": "form" + } + }, + "required": [ + "style" + ] + }, + "then": { + "properties": { + "explode": { + "default": true + } + } + }, + "else": { + "properties": { + "explode": { + "default": false + } + } + } + } + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "parameter-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/parameter" + } + }, + "request-body": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "content": { + "$ref": "#/$defs/content" + }, + "required": { + "default": false, + "type": "boolean" + } + }, + "required": [ + "content" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "request-body-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/request-body" + } + }, + "content": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/media-type" + }, + "propertyNames": { + "format": "media-range" + } + }, + "media-type": { + "type": "object", + "properties": { + "schema": { + "$dynamicRef": "#meta" + }, + "encoding": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/encoding" + } + } + }, + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/examples" + } + ], + "unevaluatedProperties": false + }, + "encoding": { + "type": "object", + "properties": { + "contentType": { + "type": "string", + "format": "media-range" + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "style": { + "default": "form", + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ] + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + } + }, + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/encoding/$defs/explode-default" + } + ], + "unevaluatedProperties": false, + "$defs": { + "explode-default": { + "if": { + "properties": { + "style": { + "const": "form" + } + }, + "required": [ + "style" + ] + }, + "then": { + "properties": { + "explode": { + "default": true + } + } + }, + "else": { + "properties": { + "explode": { + "default": false + } + } + } + } + } + }, + "responses": { + "type": "object", + "properties": { + "default": { + "$ref": "#/$defs/response-or-reference" + } + }, + "patternProperties": { + "^[1-5][0-9X]{2}$": { + "$ref": "#/$defs/response-or-reference" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "response": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "content": { + "$ref": "#/$defs/content" + }, + "links": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/link-or-reference" + } + } + }, + "required": [ + "description" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "response-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/response" + } + }, + "callbacks": { + "type": "object", + "$ref": "#/$defs/specification-extensions", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + }, + "callbacks-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/callbacks" + } + }, + "example": { + "type": "object", + "properties": { + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "value": true, + "externalValue": { + "$ref": "#/$defs/uri" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "example-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/example" + } + }, + "link": { + "type": "object", + "properties": { + "operationRef": { + "$ref": "#/$defs/uri" + }, + "operationId": true, + "parameters": { + "$ref": "#/$defs/map-of-strings" + }, + "requestBody": true, + "description": { + "type": "string" + }, + "body": { + "$ref": "#/$defs/server" + } + }, + "oneOf": [ + { + "required": [ + "operationRef" + ] + }, + { + "required": [ + "operationId" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "link-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/link" + } + }, + "header": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "required": { + "default": false, + "type": "boolean" + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "allowEmptyValue": { + "default": false, + "type": "boolean" + } + }, + "dependentSchemas": { + "schema": { + "properties": { + "style": { + "default": "simple", + "enum": [ + "simple" + ] + }, + "explode": { + "default": false, + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + }, + "schema": { + "$dynamicRef": "#meta" + } + }, + "$ref": "#/$defs/examples" + }, + "content": { + "properties": { + "content": { + "$ref": "#/$defs/content" + } + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "header-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/header" + } + }, + "tag": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + } + }, + "required": [ + "name" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "reference": { + "type": "object", + "properties": { + "$ref": { + "$ref": "#/$defs/uri" + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + } + }, + "unevaluatedProperties": false + }, + "schema": { + "$dynamicAnchor": "meta", + "type": [ + "object", + "boolean" + ] + }, + "security-scheme": { + "type": "object", + "properties": { + "type": { + "enum": [ + "apiKey", + "http", + "mutualTLS", + "oauth2", + "openIdConnect" + ] + }, + "description": { + "type": "string" + } + }, + "required": [ + "type" + ], + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-apikey" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-http" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-http-bearer" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-oauth2" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-oidc" + } + ], + "unevaluatedProperties": false, + "$defs": { + "type-apikey": { + "if": { + "properties": { + "type": { + "const": "apiKey" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "name": { + "type": "string" + }, + "in": { + "enum": [ + "query", + "header", + "cookie" + ] + } + }, + "required": [ + "name", + "in" + ] + } + }, + "type-http": { + "if": { + "properties": { + "type": { + "const": "http" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "scheme": { + "type": "string" + } + }, + "required": [ + "scheme" + ] + } + }, + "type-http-bearer": { + "if": { + "properties": { + "type": { + "const": "http" + }, + "scheme": { + "const": "bearer" + } + }, + "required": [ + "type", + "scheme" + ] + }, + "then": { + "properties": { + "bearerFormat": { + "type": "string" + } + }, + "required": [ + "scheme" + ] + } + }, + "type-oauth2": { + "if": { + "properties": { + "type": { + "const": "oauth2" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "flows": { + "$ref": "#/$defs/oauth-flows" + } + }, + "required": [ + "flows" + ] + } + }, + "type-oidc": { + "if": { + "properties": { + "type": { + "const": "openIdConnect" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "openIdConnectUrl": { + "$ref": "#/$defs/uri" + } + }, + "required": [ + "openIdConnectUrl" + ] + } + } + } + }, + "security-scheme-or-reference": { + "if": { + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/security-scheme" + } + }, + "oauth-flows": { + "type": "object", + "properties": { + "implicit": { + "$ref": "#/$defs/oauth-flows/$defs/implicit" + }, + "password": { + "$ref": "#/$defs/oauth-flows/$defs/password" + }, + "clientCredentials": { + "$ref": "#/$defs/oauth-flows/$defs/client-credentials" + }, + "authorizationCode": { + "$ref": "#/$defs/oauth-flows/$defs/authorization-code" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false, + "$defs": { + "implicit": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "authorizationUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "password": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "client-credentials": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "authorization-code": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string" + }, + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "authorizationUrl", + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + } + } + }, + "security-requirement": { + "type": "object", + "additionalProperties": { + "type": "array", + "items": { + "type": "string" + } + } + }, + "specification-extensions": { + "patternProperties": { + "^x-": true + } + }, + "examples": { + "properties": { + "example": true, + "examples": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/example-or-reference" + } + } + } + }, + "uri": { + "type": "string", + "format": "uri" + }, + "map-of-strings": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } +} From c0e7db7bc78d1b7f68a9a625fba39737796e0291 Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Thu, 10 Jun 2021 17:30:03 +0100 Subject: [PATCH 016/152] gh-pages: change text of Abstract heading (#2606) Signed-off-by: Mike Ralphson --- js/respec-oai.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/js/respec-oai.js b/js/respec-oai.js index b88250472f..008663cec0 100644 --- a/js/respec-oai.js +++ b/js/respec-oai.js @@ -1,4 +1,4 @@ -"use strict";var requirejs,require,define;window.respecVersion="21.0.1",function(global,setTimeout){var req,s,head,baseElement,dataMain,src,interactiveScript,currentlyAddingScript,mainScript,subPath,version="2.3.5",commentRegExp=/\/\*[\s\S]*?\*\/|([^:"'=]|^)\/\/.*$/gm,cjsRequireRegExp=/[^.]\s*require\s*\(\s*["']([^'"\s]+)["']\s*\)/g,jsSuffixRegExp=/\.js$/,currDirRegExp=/^\.\//,op=Object.prototype,ostring=op.toString,hasOwn=op.hasOwnProperty,isBrowser=!("undefined"==typeof window||"undefined"==typeof navigator||!window.document),isWebWorker=!isBrowser&&"undefined"!=typeof importScripts,readyRegExp=isBrowser&&"PLAYSTATION 3"===navigator.platform?/^complete$/:/^(complete|loaded)$/,defContextName="_",isOpera="undefined"!=typeof opera&&"[object Opera]"===opera.toString(),contexts={},cfg={},globalDefQueue=[],useInteractive=!1;function commentReplace(e,t){return t||""}function isFunction(e){return"[object Function]"===ostring.call(e)}function isArray(e){return"[object Array]"===ostring.call(e)}function each(e,t){var n;if(e)for(n=0;n-1&&(!e[n]||!t(e[n],n,e));n-=1);}function hasProp(e,t){return hasOwn.call(e,t)}function getOwn(e,t){return hasProp(e,t)&&e[t]}function eachProp(e,t){var n;for(n in e)if(hasProp(e,n)&&t(e[n],n))break}function mixin(e,t,n,r){return t&&eachProp(t,function(t,i){!n&&hasProp(e,i)||(!r||"object"!=typeof t||!t||isArray(t)||isFunction(t)||t instanceof RegExp?e[i]=t:(e[i]||(e[i]={}),mixin(e[i],t,n,r)))}),e}function bind(e,t){return function(){return t.apply(e,arguments)}}function scripts(){return document.getElementsByTagName("script")}function defaultOnError(e){throw e}function getGlobal(e){if(!e)return e;var t=global;return each(e.split("."),function(e){t=t[e]}),t}function makeError(e,t,n,r){var i=new Error(t+"\nhttp://requirejs.org/docs/errors.html#"+e);return i.requireType=e,i.requireModules=r,n&&(i.originalError=n),i}if(void 0===define){if(void 0!==requirejs){if(isFunction(requirejs))return;cfg=requirejs,requirejs=void 0}void 0===require||isFunction(require)||(cfg=require,require=void 0),req=requirejs=function(e,t,n,r){var i,o,a=defContextName;return isArray(e)||"string"==typeof e||(o=e,isArray(t)?(e=t,t=n,n=r):e=[]),o&&o.context&&(a=o.context),(i=getOwn(contexts,a))||(i=contexts[a]=req.s.newContext(a)),o&&i.configure(o),i.require(e,t,n)},req.config=function(e){return req(e)},req.nextTick=void 0!==setTimeout?function(e){setTimeout(e,4)}:function(e){e()},require||(require=req),req.version=version,req.jsExtRegExp=/^\/|:|\?|\.js$/,req.isBrowser=isBrowser,s=req.s={contexts:contexts,newContext:newContext},req({}),each(["toUrl","undef","defined","specified"],function(e){req[e]=function(){var t=contexts[defContextName];return t.require[e].apply(t,arguments)}}),isBrowser&&(head=s.head=document.getElementsByTagName("head")[0],baseElement=document.getElementsByTagName("base")[0],baseElement&&(head=s.head=baseElement.parentNode)),req.onError=defaultOnError,req.createNode=function(e,t,n){var r=e.xhtml?document.createElementNS("http://www.w3.org/1999/xhtml","html:script"):document.createElement("script");return r.type=e.scriptType||"text/javascript",r.charset="utf-8",r.async=!0,r},req.load=function(e,t,n){var r,i=e&&e.config||{};if(isBrowser)return(r=req.createNode(i,t,n)).setAttribute("data-requirecontext",e.contextName),r.setAttribute("data-requiremodule",t),!r.attachEvent||r.attachEvent.toString&&r.attachEvent.toString().indexOf("[native code")<0||isOpera?(r.addEventListener("load",e.onScriptLoad,!1),r.addEventListener("error",e.onScriptError,!1)):(useInteractive=!0,r.attachEvent("onreadystatechange",e.onScriptLoad)),r.src=n,i.onNodeCreated&&i.onNodeCreated(r,i,t,n),currentlyAddingScript=r,baseElement?head.insertBefore(r,baseElement):head.appendChild(r),currentlyAddingScript=null,r;if(isWebWorker)try{setTimeout(function(){},0),importScripts(n),e.completeLoad(t)}catch(r){e.onError(makeError("importscripts","importScripts failed for "+t+" at "+n,r,[t]))}},isBrowser&&!cfg.skipDataMain&&eachReverse(scripts(),function(e){if(head||(head=e.parentNode),dataMain=e.getAttribute("data-main"))return mainScript=dataMain,cfg.baseUrl||-1!==mainScript.indexOf("!")||(src=mainScript.split("/"),mainScript=src.pop(),subPath=src.length?src.join("/")+"/":"./",cfg.baseUrl=subPath),mainScript=mainScript.replace(jsSuffixRegExp,""),req.jsExtRegExp.test(mainScript)&&(mainScript=dataMain),cfg.deps=cfg.deps?cfg.deps.concat(mainScript):[mainScript],!0}),define=function(e,t,n){var r,i;"string"!=typeof e&&(n=t,t=e,e=null),isArray(t)||(n=t,t=null),!t&&isFunction(n)&&(t=[],n.length&&(n.toString().replace(commentRegExp,commentReplace).replace(cjsRequireRegExp,function(e,n){t.push(n)}),t=(1===n.length?["require"]:["require","exports","module"]).concat(t))),useInteractive&&(r=currentlyAddingScript||getInteractiveScript())&&(e||(e=r.getAttribute("data-requiremodule")),i=contexts[r.getAttribute("data-requirecontext")]),i?(i.defQueue.push([e,t,n]),i.defQueueMap[e]=!0):globalDefQueue.push([e,t,n])},define.amd={jQuery:!0},req.exec=function(text){return eval(text)},req(cfg)}function newContext(e){var t,n,r,i,o,a={waitSeconds:7,baseUrl:"./",paths:{},bundles:{},pkgs:{},shim:{},config:{}},s={},l={},c={},u=[],d={},p={},f={},h=1,m=1;function g(e,t,n){var r,i,o,s,l,c,u,d,p,f,h=t&&t.split("/"),m=a.map,g=m&&m["*"];if(e&&(c=(e=e.split("/")).length-1,a.nodeIdCompat&&jsSuffixRegExp.test(e[c])&&(e[c]=e[c].replace(jsSuffixRegExp,"")),"."===e[0].charAt(0)&&h&&(e=h.slice(0,h.length-1).concat(e)),function(e){var t,n;for(t=0;t0&&(e.splice(t-1,2),t-=2)}}(e),e=e.join("/")),n&&m&&(h||g)){i=e.split("/");e:for(o=i.length;o>0;o-=1){if(l=i.slice(0,o).join("/"),h)for(s=h.length;s>0;s-=1)if((r=getOwn(m,h.slice(0,s).join("/")))&&(r=getOwn(r,l))){u=r,d=o;break e}!p&&g&&getOwn(g,l)&&(p=getOwn(g,l),f=o)}!u&&p&&(u=p,d=f),u&&(i.splice(0,d,u),e=i.join("/"))}return getOwn(a.pkgs,e)||e}function b(e){isBrowser&&each(scripts(),function(t){if(t.getAttribute("data-requiremodule")===e&&t.getAttribute("data-requirecontext")===r.contextName)return t.parentNode.removeChild(t),!0})}function y(e){var t=getOwn(a.paths,e);if(t&&isArray(t)&&t.length>1)return t.shift(),r.require.undef(e),r.makeRequire(null,{skipMap:!0})([e]),!0}function v(e){var t,n=e?e.indexOf("!"):-1;return n>-1&&(t=e.substring(0,n),e=e.substring(n+1,e.length)),[t,e]}function w(e,t,n,i){var o,a,s,l,c=null,u=t?t.name:null,p=e,f=!0,b="";return e||(f=!1,e="_@r"+(h+=1)),c=(l=v(e))[0],e=l[1],c&&(c=g(c,u,i),a=getOwn(d,c)),e&&(c?b=n?e:a&&a.normalize?a.normalize(e,function(e){return g(e,u,i)}):-1===e.indexOf("!")?g(e,u,i):e:(c=(l=v(b=g(e,u,i)))[0],b=l[1],n=!0,o=r.nameToUrl(b))),{prefix:c,name:b,parentMap:t,unnormalized:!!(s=!c||a||n?"":"_unnormalized"+(m+=1)),url:o,originalName:p,isDefine:f,id:(c?c+"!"+b:b)+s}}function x(e){var t=e.id,n=getOwn(s,t);return n||(n=s[t]=new r.Module(e)),n}function k(e,t,n){var r=e.id,i=getOwn(s,r);!hasProp(d,r)||i&&!i.defineEmitComplete?(i=x(e)).error&&"error"===t?n(i.error):i.on(t,n):"defined"===t&&n(d[r])}function C(e,t){var n=e.requireModules,r=!1;t?t(e):(each(n,function(t){var n=getOwn(s,t);n&&(n.error=e,n.events.error&&(r=!0,n.emit("error",e)))}),r||req.onError(e))}function E(){globalDefQueue.length&&(each(globalDefQueue,function(e){var t=e[0];"string"==typeof t&&(r.defQueueMap[t]=!0),u.push(e)}),globalDefQueue=[])}function $(e){delete s[e],delete l[e]}function T(){var e,n,i=1e3*a.waitSeconds,c=i&&r.startTime+i<(new Date).getTime(),u=[],p=[],f=!1,h=!0;if(!t){if(t=!0,eachProp(l,function(e){var t=e.map,r=t.id;if(e.enabled&&(t.isDefine||p.push(e),!e.error))if(!e.inited&&c)y(r)?(n=!0,f=!0):(u.push(r),b(r));else if(!e.inited&&e.fetched&&t.isDefine&&(f=!0,!t.prefix))return h=!1}),c&&u.length)return(e=makeError("timeout","Load timeout for modules: "+u,null,u)).contextName=r.contextName,C(e);h&&each(p,function(e){!function e(t,n,r){var i=t.map.id;t.error?t.emit("error",t.error):(n[i]=!0,each(t.depMaps,function(i,o){var a=i.id,l=getOwn(s,a);!l||t.depMatched[o]||r[a]||(getOwn(n,a)?(t.defineDep(o,d[a]),t.check()):e(l,n,r))}),r[i]=!0)}(e,{},{})}),c&&!n||!f||!isBrowser&&!isWebWorker||o||(o=setTimeout(function(){o=0,T()},50)),t=!1}}function S(e){hasProp(d,e[0])||x(w(e[0],null,!0)).init(e[1],e[2])}function A(e,t,n,r){e.detachEvent&&!isOpera?r&&e.detachEvent(r,t):e.removeEventListener(n,t,!1)}function L(e){var t=e.currentTarget||e.srcElement;return A(t,r.onScriptLoad,"load","onreadystatechange"),A(t,r.onScriptError,"error"),{node:t,id:t&&t.getAttribute("data-requiremodule")}}function j(){var e;for(E();u.length;){if(null===(e=u.shift())[0])return C(makeError("mismatch","Mismatched anonymous define() module: "+e[e.length-1]));S(e)}r.defQueueMap={}}return i={require:function(e){return e.require?e.require:e.require=r.makeRequire(e.map)},exports:function(e){if(e.usingExports=!0,e.map.isDefine)return e.exports?d[e.map.id]=e.exports:e.exports=d[e.map.id]={}},module:function(e){return e.module?e.module:e.module={id:e.map.id,uri:e.map.url,config:function(){return getOwn(a.config,e.map.id)||{}},exports:e.exports||(e.exports={})}}},(n=function(e){this.events=getOwn(c,e.id)||{},this.map=e,this.shim=getOwn(a.shim,e.id),this.depExports=[],this.depMaps=[],this.depMatched=[],this.pluginMaps={},this.depCount=0}).prototype={init:function(e,t,n,r){r=r||{},this.inited||(this.factory=t,n?this.on("error",n):this.events.error&&(n=bind(this,function(e){this.emit("error",e)})),this.depMaps=e&&e.slice(0),this.errback=n,this.inited=!0,this.ignore=r.ignore,r.enabled||this.enabled?this.enable():this.check())},defineDep:function(e,t){this.depMatched[e]||(this.depMatched[e]=!0,this.depCount-=1,this.depExports[e]=t)},fetch:function(){if(!this.fetched){this.fetched=!0,r.startTime=(new Date).getTime();var e=this.map;if(!this.shim)return e.prefix?this.callPlugin():this.load();r.makeRequire(this.map,{enableBuildCallback:!0})(this.shim.deps||[],bind(this,function(){return e.prefix?this.callPlugin():this.load()}))}},load:function(){var e=this.map.url;p[e]||(p[e]=!0,r.load(this.map.id,e))},check:function(){if(this.enabled&&!this.enabling){var e,t,n=this.map.id,i=this.depExports,o=this.exports,a=this.factory;if(this.inited){if(this.error)this.emit("error",this.error);else if(!this.defining){if(this.defining=!0,this.depCount<1&&!this.defined){if(isFunction(a)){if(this.events.error&&this.map.isDefine||req.onError!==defaultOnError)try{o=r.execCb(n,a,i,o)}catch(t){e=t}else o=r.execCb(n,a,i,o);if(this.map.isDefine&&void 0===o&&((t=this.module)?o=t.exports:this.usingExports&&(o=this.exports)),e)return e.requireMap=this.map,e.requireModules=this.map.isDefine?[this.map.id]:null,e.requireType=this.map.isDefine?"define":"require",C(this.error=e)}else o=a;if(this.exports=o,this.map.isDefine&&!this.ignore&&(d[n]=o,req.onResourceLoad)){var s=[];each(this.depMaps,function(e){s.push(e.normalizedMap||e)}),req.onResourceLoad(r,this.map,s)}$(n),this.defined=!0}this.defining=!1,this.defined&&!this.defineEmitted&&(this.defineEmitted=!0,this.emit("defined",this.exports),this.defineEmitComplete=!0)}}else hasProp(r.defQueueMap,n)||this.fetch()}},callPlugin:function(){var e=this.map,t=e.id,n=w(e.prefix);this.depMaps.push(n),k(n,"defined",bind(this,function(n){var i,o,l,c=getOwn(f,this.map.id),u=this.map.name,d=this.map.parentMap?this.map.parentMap.name:null,p=r.makeRequire(e.parentMap,{enableBuildCallback:!0});return this.map.unnormalized?(n.normalize&&(u=n.normalize(u,function(e){return g(e,d,!0)})||""),k(o=w(e.prefix+"!"+u,this.map.parentMap,!0),"defined",bind(this,function(e){this.map.normalizedMap=o,this.init([],function(){return e},null,{enabled:!0,ignore:!0})})),void((l=getOwn(s,o.id))&&(this.depMaps.push(o),this.events.error&&l.on("error",bind(this,function(e){this.emit("error",e)})),l.enable()))):c?(this.map.url=r.nameToUrl(c),void this.load()):((i=bind(this,function(e){this.init([],function(){return e},null,{enabled:!0})})).error=bind(this,function(e){this.inited=!0,this.error=e,e.requireModules=[t],eachProp(s,function(e){0===e.map.id.indexOf(t+"_unnormalized")&&$(e.map.id)}),C(e)}),i.fromText=bind(this,function(n,o){var s=e.name,l=w(s),c=useInteractive;o&&(n=o),c&&(useInteractive=!1),x(l),hasProp(a.config,t)&&(a.config[s]=a.config[t]);try{req.exec(n)}catch(e){return C(makeError("fromtexteval","fromText eval for "+t+" failed: "+e,e,[t]))}c&&(useInteractive=!0),this.depMaps.push(l),r.completeLoad(s),p([s],i)}),void n.load(e.name,p,i,a))})),r.enable(n,this),this.pluginMaps[n.id]=n},enable:function(){l[this.map.id]=this,this.enabled=!0,this.enabling=!0,each(this.depMaps,bind(this,function(e,t){var n,o,a;if("string"==typeof e){if(e=w(e,this.map.isDefine?this.map:this.map.parentMap,!1,!this.skipMap),this.depMaps[t]=e,a=getOwn(i,e.id))return void(this.depExports[t]=a(this));this.depCount+=1,k(e,"defined",bind(this,function(e){this.undefed||(this.defineDep(t,e),this.check())})),this.errback?k(e,"error",bind(this,this.errback)):this.events.error&&k(e,"error",bind(this,function(e){this.emit("error",e)}))}n=e.id,o=s[n],hasProp(i,n)||!o||o.enabled||r.enable(e,this)})),eachProp(this.pluginMaps,bind(this,function(e){var t=getOwn(s,e.id);t&&!t.enabled&&r.enable(e,this)})),this.enabling=!1,this.check()},on:function(e,t){var n=this.events[e];n||(n=this.events[e]=[]),n.push(t)},emit:function(e,t){each(this.events[e],function(e){e(t)}),"error"===e&&delete this.events[e]}},(r={config:a,contextName:e,registry:s,defined:d,urlFetched:p,defQueue:u,defQueueMap:{},Module:n,makeModuleMap:w,nextTick:req.nextTick,onError:C,configure:function(e){if(e.baseUrl&&"/"!==e.baseUrl.charAt(e.baseUrl.length-1)&&(e.baseUrl+="/"),"string"==typeof e.urlArgs){var t=e.urlArgs;e.urlArgs=function(e,n){return(-1===n.indexOf("?")?"?":"&")+t}}var n=a.shim,i={paths:!0,bundles:!0,config:!0,map:!0};eachProp(e,function(e,t){i[t]?(a[t]||(a[t]={}),mixin(a[t],e,!0,!0)):a[t]=e}),e.bundles&&eachProp(e.bundles,function(e,t){each(e,function(e){e!==t&&(f[e]=t)})}),e.shim&&(eachProp(e.shim,function(e,t){isArray(e)&&(e={deps:e}),!e.exports&&!e.init||e.exportsFn||(e.exportsFn=r.makeShimExports(e)),n[t]=e}),a.shim=n),e.packages&&each(e.packages,function(e){var t;t=(e="string"==typeof e?{name:e}:e).name,e.location&&(a.paths[t]=e.location),a.pkgs[t]=e.name+"/"+(e.main||"main").replace(currDirRegExp,"").replace(jsSuffixRegExp,"")}),eachProp(s,function(e,t){e.inited||e.map.unnormalized||(e.map=w(t,null,!0))}),(e.deps||e.callback)&&r.require(e.deps||[],e.callback)},makeShimExports:function(e){return function(){var t;return e.init&&(t=e.init.apply(global,arguments)),t||e.exports&&getGlobal(e.exports)}},makeRequire:function(t,n){function o(a,l,c){var u,p;return n.enableBuildCallback&&l&&isFunction(l)&&(l.__requireJsBuild=!0),"string"==typeof a?isFunction(l)?C(makeError("requireargs","Invalid require call"),c):t&&hasProp(i,a)?i[a](s[t.id]):req.get?req.get(r,a,t,o):(u=w(a,t,!1,!0).id,hasProp(d,u)?d[u]:C(makeError("notloaded",'Module name "'+u+'" has not been loaded yet for context: '+e+(t?"":". Use require([])")))):(j(),r.nextTick(function(){j(),(p=x(w(null,t))).skipMap=n.skipMap,p.init(a,l,c,{enabled:!0}),T()}),o)}return n=n||{},mixin(o,{isBrowser:isBrowser,toUrl:function(e){var n,i=e.lastIndexOf("."),o=e.split("/")[0];return-1!==i&&(!("."===o||".."===o)||i>1)&&(n=e.substring(i,e.length),e=e.substring(0,i)),r.nameToUrl(g(e,t&&t.id,!0),n,!0)},defined:function(e){return hasProp(d,w(e,t,!1,!0).id)},specified:function(e){return e=w(e,t,!1,!0).id,hasProp(d,e)||hasProp(s,e)}}),t||(o.undef=function(e){E();var n=w(e,t,!0),i=getOwn(s,e);i.undefed=!0,b(e),delete d[e],delete p[n.url],delete c[e],eachReverse(u,function(t,n){t[0]===e&&u.splice(n,1)}),delete r.defQueueMap[e],i&&(i.events.defined&&(c[e]=i.events),$(e))}),o},enable:function(e){getOwn(s,e.id)&&x(e).enable()},completeLoad:function(e){var t,n,i,o=getOwn(a.shim,e)||{},l=o.exports;for(E();u.length;){if(null===(n=u.shift())[0]){if(n[0]=e,t)break;t=!0}else n[0]===e&&(t=!0);S(n)}if(r.defQueueMap={},i=getOwn(s,e),!t&&!hasProp(d,e)&&i&&!i.inited){if(!(!a.enforceDefine||l&&getGlobal(l)))return y(e)?void 0:C(makeError("nodefine","No define call for "+e,null,[e]));S([e,o.deps||[],o.exportsFn])}T()},nameToUrl:function(e,t,n){var i,o,s,l,c,u,d=getOwn(a.pkgs,e);if(d&&(e=d),u=getOwn(f,e))return r.nameToUrl(u,t,n);if(req.jsExtRegExp.test(e))l=e+(t||"");else{for(i=a.paths,s=(o=e.split("/")).length;s>0;s-=1)if(c=getOwn(i,o.slice(0,s).join("/"))){isArray(c)&&(c=c[0]),o.splice(0,s,c);break}l=o.join("/"),l=("/"===(l+=t||(/^data\:|^blob\:|\?/.test(l)||n?"":".js")).charAt(0)||l.match(/^[\w\+\.\-]+:/)?"":a.baseUrl)+l}return a.urlArgs&&!/^blob\:/.test(l)?l+a.urlArgs(e,l):l},load:function(e,t){req.load(r,e,t)},execCb:function(e,t,n,r){return t.apply(r,n)},onScriptLoad:function(e){if("load"===e.type||readyRegExp.test((e.currentTarget||e.srcElement).readyState)){interactiveScript=null;var t=L(e);r.completeLoad(t.id)}},onScriptError:function(e){var t=L(e);if(!y(t.id)){var n=[];return eachProp(s,function(e,r){0!==r.indexOf("_@r")&&each(e.depMaps,function(e){if(e.id===t.id)return n.push(r),!0})}),C(makeError("scripterror",'Script error for "'+t.id+(n.length?'", needed by: '+n.join(", "):'"'),e,[t.id]))}}}).require=r.makeRequire(),r}function getInteractiveScript(){return interactiveScript&&"interactive"===interactiveScript.readyState?interactiveScript:(eachReverse(scripts(),function(e){if("interactive"===e.readyState)return interactiveScript=e}),interactiveScript)}}(this,"undefined"==typeof setTimeout?void 0:setTimeout),define("deps/require",function(){});var hyperHTML=function(e){var t=document.defaultView,n=1,r=/^area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|source|track|wbr$/i,i="ownerSVGElement",o="http://www.w3.org/2000/svg",a="connected",s="dis"+a,l=/^style|textarea$/i,c="_hyper: "+(Math.random()*new Date|0)+";",u="\x3c!--"+c+"--\x3e",d=t.Event;try{new d("Event")}catch(e){d=function(e){var t=document.createEvent("Event");return t.initEvent(e,!1,!1),t}}var p,f=t.Map||function(){var e=[],t=[];return{get:function(n){return t[e.indexOf(n)]},set:function(n,r){t[e.push(n)-1]=r}}},h=0,m=t.WeakMap||function(){var e=c+h++;return{get:function(t){return t[e]},set:function(t,n){Object.defineProperty(t,e,{configurable:!0,value:n})}}},g=t.WeakSet||function(){var e=new m;return{add:function(t){e.set(t,!0)},has:function(t){return!0===e.get(t)}}},b=Array.isArray||(p={}.toString,function(e){return"[object Array]"===p.call(e)}),y=c.trim||function(){return this.replace(/^\s+|\s+$/g,"")};function v(){return this}var w=function(e,t){var n="_"+e+"$";return{get:function(){return this[n]||(this[e]=t.call(this,e))},set:function(e){Object.defineProperty(this,n,{configurable:!0,value:e})}}},x={},k=[],C=x.hasOwnProperty,E=0,$=function(e,t){e in x||(E=k.push(e)),x[e]=t},T=function(e,t){for(var n=0;n\"'=]+",N="[ "+D+"]+"+_,R="<([A-Za-z]+[A-Za-z0-9:_-]*)((?:",P="(?:=(?:'[^']*?'|\"[^\"]*?\"|<[^>]*?>|"+_+"))?)",M=new RegExp(R+N+P+"+)([ "+D+"]*/?>)","g"),O=new RegExp(R+N+P+"*)([ "+D+"]*/>)","g"),I=L(document),q="append"in I,U="content"in S(document,"template");I.appendChild(j(I,"g")),I.appendChild(j(I,""));var W=1===I.cloneNode(!0).childNodes.length,H="importNode"in document,B=q?function(e,t){e.append.apply(e,t)}:function(e,t){for(var n=t.length,r=0;r"+t+"",B(r,Y.call(n.querySelectorAll(i)))}else n.innerHTML=t,B(r,Y.call(n.childNodes));return r},ee=U?function(e,t){var n=L(e),r=A(e).createElementNS(o,"svg");return r.innerHTML=t,B(n,Y.call(r.childNodes)),n}:function(e,t){var n=L(e),r=S(e,"div");return r.innerHTML=''+t+"",B(n,Y.call(r.firstChild.childNodes)),n};function te(e){this.childNodes=e,this.length=e.length,this.first=e[0],this.last=e[this.length-1]}te.prototype.insert=function(){var e=L(this.first);return B(e,this.childNodes),e},te.prototype.remove=function(){var e=this.first,t=this.last;if(2===this.length)t.parentNode.removeChild(t);else{var n=A(e).createRange();n.setStartBefore(this.childNodes[1]),n.setEndAfter(t),n.deleteContents()}return e};var ne=function(e,t,n){e.unshift(e.indexOf.call(t.childNodes,n))},re=function(e,t,r){return{type:e,name:r,node:t,path:function(e){var t=[],r=void 0;switch(e.nodeType){case n:case 11:r=e;break;case 8:r=e.parentNode,ne(t,r,e);break;default:r=e.ownerElement}for(e=r;r=r.parentNode;e=r)ne(t,r,e);return t}(t)}},ie=function(e,t){for(var n=t.length,r=0;rc){var v=n[p+1],w=null==v?a:o(v,0);if(l===p)e.insertBefore(o(n[l],1),w);else{for(var x=e.ownerDocument.createDocumentFragment();l<=p;)x.appendChild(o(n[l++],1));e.insertBefore(x,w)}}else null==t[s]&&s++,s===c?e.removeChild(o(t[s],-1)):de(e,o(t[s],-1),o(t[c],-1));return n},fe=new g;function he(){}he.prototype=Object.create(null);var me=function(e){return{html:e}},ge=function e(t,n){return"ELEMENT_NODE"in t?t:t.constructor===te?1/n<0?n?t.remove():t.last:n?t.insert():t.first:e(t.render(),n)},be=function(e,t,n){for(var r=new he,i=e.attributes,o=Y.call(i),a=[],s=o.length,l=0;l"},Pe=new m,Me=function(e){var t=void 0,n=void 0,r=void 0,i=void 0,a=void 0;return function(s){s=Q(s);var l=i!==s;return l&&(i=s,r=L(document),n="svg"===e?document.createElementNS(o,"svg"):r,a=Se.bind(n)),a.apply(null,arguments),l&&("svg"===e&&B(r,Y.call(n.childNodes)),t=Ie(r)),t}},Oe=function(e,t){var n=t.indexOf(":"),r=Pe.get(e),i=t;return-1e.apply(void 0,n)),window.parent===window.self)return;var r=n.map(e=>String(JSON.stringify(e.stack||e)));window.parent.postMessage({topic:e,args:r},window.parent.location.origin)},e.sub=n,e.unsub=r;e.name="core/pubsubhub";const t=new Map;function n(e,i,o={once:!1}){return o.once?n(e,function t(...n){r({topic:e,cb:t}),i(...n)}):(t.has(e)?t.get(e).add(i):t.set(e,new Set([i])),{topic:e,cb:i})}function r({topic:e,cb:n}){const r=t.get(e);return r&&r.has(n)?r.delete(n):(console.warn("Already unsubscribed:",e,n),!1)}n("error",e=>{console.error(e,e.stack)}),n("warn",e=>{console.warn(e)})}),function(e){var t={newline:/^\n+/,code:/^( {4}[^\n]+\n*)+/,fences:h,hr:/^ {0,3}((?:- *){3,}|(?:_ *){3,}|(?:\* *){3,})(?:\n+|$)/,heading:/^ *(#{1,6}) *([^\n]+?) *(?:#+ *)?(?:\n+|$)/,nptable:h,blockquote:/^( {0,3}> ?(paragraph|[^\n]*)(?:\n|$))+/,list:/^( *)(bull) [\s\S]+?(?:hr|def|\n{2,}(?! )(?!\1bull )\n*|\s*$)/,html:"^ {0,3}(?:<(script|pre|style)[\\s>][\\s\\S]*?(?:[^\\n]*\\n+|$)|comment[^\\n]*(\\n+|$)|<\\?[\\s\\S]*?\\?>\\n*|\\n*|\\n*|)[\\s\\S]*?(?:\\n{2,}|$)|<(?!script|pre|style)([a-z][\\w-]*)(?:attribute)*? */?>(?=\\h*\\n)[\\s\\S]*?(?:\\n{2,}|$)|(?=\\h*\\n)[\\s\\S]*?(?:\\n{2,}|$))",def:/^ {0,3}\[(label)\]: *\n? *]+)>?(?:(?: +\n? *| *\n *)(title))? *(?:\n+|$)/,table:h,lheading:/^([^\n]+)\n *(=|-){2,} *(?:\n+|$)/,paragraph:/^([^\n]+(?:\n(?!hr|heading|lheading| {0,3}>|<\/?(?:tag)(?: +|\n|\/?>)|<(?:script|pre|style|!--))[^\n]+)*)/,text:/^[^\n]+/};function n(e){this.tokens=[],this.tokens.links={},this.options=e||b.defaults,this.rules=t.normal,this.options.pedantic?this.rules=t.pedantic:this.options.gfm&&(this.options.tables?this.rules=t.tables:this.rules=t.gfm)}t._label=/(?!\s*\])(?:\\[\[\]]|[^\[\]])+/,t._title=/(?:"(?:\\"?|[^"\\])*"|'[^'\n]*(?:\n[^'\n]+)*\n?'|\([^()]*\))/,t.def=u(t.def).replace("label",t._label).replace("title",t._title).getRegex(),t.bullet=/(?:[*+-]|\d+\.)/,t.item=/^( *)(bull) [^\n]*(?:\n(?!\1bull )[^\n]*)*/,t.item=u(t.item,"gm").replace(/bull/g,t.bullet).getRegex(),t.list=u(t.list).replace(/bull/g,t.bullet).replace("hr","\\n+(?=\\1?(?:(?:- *){3,}|(?:_ *){3,}|(?:\\* *){3,})(?:\\n+|$))").replace("def","\\n+(?="+t.def.source+")").getRegex(),t._tag="address|article|aside|base|basefont|blockquote|body|caption|center|col|colgroup|dd|details|dialog|dir|div|dl|dt|fieldset|figcaption|figure|footer|form|frame|frameset|h[1-6]|head|header|hr|html|iframe|legend|li|link|main|menu|menuitem|meta|nav|noframes|ol|optgroup|option|p|param|section|source|summary|table|tbody|td|tfoot|th|thead|title|tr|track|ul",t._comment=//,t.html=u(t.html,"i").replace("comment",t._comment).replace("tag",t._tag).replace("attribute",/ +[a-zA-Z:_][\w.:-]*(?: *= *"[^"\n]*"| *= *'[^'\n]*'| *= *[^\s"'=<>`]+)?/).getRegex(),t.paragraph=u(t.paragraph).replace("hr",t.hr).replace("heading",t.heading).replace("lheading",t.lheading).replace("tag",t._tag).getRegex(),t.blockquote=u(t.blockquote).replace("paragraph",t.paragraph).getRegex(),t.normal=m({},t),t.gfm=m({},t.normal,{fences:/^ *(`{3,}|~{3,})[ \.]*(\S+)? *\n([\s\S]*?)\n? *\1 *(?:\n+|$)/,paragraph:/^/,heading:/^ *(#{1,6}) +([^\n]+?) *#* *(?:\n+|$)/}),t.gfm.paragraph=u(t.paragraph).replace("(?!","(?!"+t.gfm.fences.source.replace("\\1","\\2")+"|"+t.list.source.replace("\\1","\\3")+"|").getRegex(),t.tables=m({},t.gfm,{nptable:/^ *([^|\n ].*\|.*)\n *([-:]+ *\|[-| :]*)(?:\n((?:.*[^>\n ].*(?:\n|$))*)\n*|$)/,table:/^ *\|(.+)\n *\|?( *[-:]+[-| :]*)(?:\n((?: *[^>\n ].*(?:\n|$))*)\n*|$)/}),t.pedantic=m({},t.normal,{html:u("^ *(?:comment *(?:\\n|\\s*$)|<(tag)[\\s\\S]+? *(?:\\n{2,}|\\s*$)|\\s]*)*?/?> *(?:\\n{2,}|\\s*$))").replace("comment",t._comment).replace(/tag/g,"(?!(?:a|em|strong|small|s|cite|q|dfn|abbr|data|time|code|var|samp|kbd|sub|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo|span|br|wbr|ins|del|img)\\b)\\w+(?!:|[^\\w\\s@]*@)\\b").getRegex(),def:/^ *\[([^\]]+)\]: *]+)>?(?: +(["(][^\n]+[")]))? *(?:\n+|$)/}),n.rules=t,n.lex=function(e,t){return new n(t).lex(e)},n.prototype.lex=function(e){return e=e.replace(/\r\n|\r/g,"\n").replace(/\t/g," ").replace(/\u00a0/g," ").replace(/\u2424/g,"\n"),this.token(e,!0)},n.prototype.token=function(e,n){var r,i,o,a,s,l,c,u,d,p,f,h,m;for(e=e.replace(/^ +$/gm,"");e;)if((o=this.rules.newline.exec(e))&&(e=e.substring(o[0].length),o[0].length>1&&this.tokens.push({type:"space"})),o=this.rules.code.exec(e))e=e.substring(o[0].length),o=o[0].replace(/^ {4}/gm,""),this.tokens.push({type:"code",text:this.options.pedantic?o:o.replace(/\n+$/,"")});else if(o=this.rules.fences.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"code",lang:o[2],text:o[3]||""});else if(o=this.rules.heading.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"heading",depth:o[1].length,text:o[2]});else if(n&&(o=this.rules.nptable.exec(e))&&(l={type:"table",header:g(o[1].replace(/^ *| *\| *$/g,"")),align:o[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:o[3]?o[3].replace(/\n$/,"").split("\n"):[]}).header.length===l.align.length){for(e=e.substring(o[0].length),u=0;u ?/gm,""),this.token(o,n),this.tokens.push({type:"blockquote_end"});else if(o=this.rules.list.exec(e)){for(e=e.substring(o[0].length),f=(a=o[2]).length>1,this.tokens.push({type:"list_start",ordered:f,start:f?+a:""}),r=!1,p=(o=o[0].match(this.rules.item)).length,u=0;u1&&s.length>1||(e=o.slice(u+1).join("\n")+e,u=p-1)),i=r||/\n\n(?!\s*$)/.test(l),u!==p-1&&(r="\n"===l.charAt(l.length-1),i||(i=r)),m=void 0,(h=/^\[[ xX]\] /.test(l))&&(m=" "!==l[1],l=l.replace(/^\[[ xX]\] +/,"")),this.tokens.push({type:i?"loose_item_start":"list_item_start",task:h,checked:m}),this.token(l,!1),this.tokens.push({type:"list_item_end"});this.tokens.push({type:"list_end"})}else if(o=this.rules.html.exec(e))e=e.substring(o[0].length),this.tokens.push({type:this.options.sanitize?"paragraph":"html",pre:!this.options.sanitizer&&("pre"===o[1]||"script"===o[1]||"style"===o[1]),text:o[0]});else if(n&&(o=this.rules.def.exec(e)))e=e.substring(o[0].length),o[3]&&(o[3]=o[3].substring(1,o[3].length-1)),d=o[1].toLowerCase().replace(/\s+/g," "),this.tokens.links[d]||(this.tokens.links[d]={href:o[2],title:o[3]});else if(n&&(o=this.rules.table.exec(e))&&(l={type:"table",header:g(o[1].replace(/^ *| *\| *$/g,"")),align:o[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:o[3]?o[3].replace(/(?: *\| *)?\n$/,"").split("\n"):[]}).header.length===l.align.length){for(e=e.substring(o[0].length),u=0;u?@\[\]\\^_`{|}~])/,autolink:/^<(scheme:[^\s\x00-\x1f<>]*|email)>/,url:h,tag:"^comment|^|^<[a-zA-Z][\\w-]*(?:attribute)*?\\s*/?>|^<\\?[\\s\\S]*?\\?>|^|^",link:/^!?\[(label)\]\(href(?:\s+(title))?\s*\)/,reflink:/^!?\[(label)\]\[(?!\s*\])((?:\\[\[\]]?|[^\[\]\\])+)\]/,nolink:/^!?\[(?!\s*\])((?:\[[^\[\]]*\]|\\[\[\]]|[^\[\]])*)\](?:\[\])?/,strong:/^__([^\s][\s\S]*?[^\s])__(?!_)|^\*\*([^\s][\s\S]*?[^\s])\*\*(?!\*)|^__([^\s])__(?!_)|^\*\*([^\s])\*\*(?!\*)/,em:/^_([^\s][\s\S]*?[^\s_])_(?!_)|^_([^\s_][\s\S]*?[^\s])_(?!_)|^\*([^\s][\s\S]*?[^\s*])\*(?!\*)|^\*([^\s*][\s\S]*?[^\s])\*(?!\*)|^_([^\s_])_(?!_)|^\*([^\s*])\*(?!\*)/,code:/^(`+)\s*([\s\S]*?[^`]?)\s*\1(?!`)/,br:/^ {2,}\n(?!\s*$)/,del:h,text:/^[\s\S]+?(?=[\\/g,">").replace(/"/g,""").replace(/'/g,"'")}function c(e){return e.replace(/&(#(?:\d+)|(?:#x[0-9A-Fa-f]+)|(?:\w+));?/gi,function(e,t){return"colon"===(t=t.toLowerCase())?":":"#"===t.charAt(0)?"x"===t.charAt(1)?String.fromCharCode(parseInt(t.substring(2),16)):String.fromCharCode(+t.substring(1)):""})}function u(e,t){return e=e.source||e,t=t||"",{replace:function(t,n){return n=(n=n.source||n).replace(/(^|[^\[])\^/g,"$1"),e=e.replace(t,n),this},getRegex:function(){return new RegExp(e,t)}}}function d(e,t){return p[" "+e]||(/^[^:]+:\/*[^/]*$/.test(e)?p[" "+e]=e+"/":p[" "+e]=e.replace(/[^/]*$/,"")),e=p[" "+e],"//"===t.slice(0,2)?e.replace(/:[\s\S]*/,":")+t:"/"===t.charAt(0)?e.replace(/(:\/*[^/]*)[\s\S]*/,"$1")+t:e+t}r._escapes=/\\([!"#$%&'()*+,\-./:;<=>?@\[\]\\^_`{|}~])/g,r._scheme=/[a-zA-Z][a-zA-Z0-9+.-]{1,31}/,r._email=/[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+(@)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+(?![-_])/,r.autolink=u(r.autolink).replace("scheme",r._scheme).replace("email",r._email).getRegex(),r._attribute=/\s+[a-zA-Z:_][\w.:-]*(?:\s*=\s*"[^"]*"|\s*=\s*'[^']*'|\s*=\s*[^\s"'=<>`]+)?/,r.tag=u(r.tag).replace("comment",t._comment).replace("attribute",r._attribute).getRegex(),r._label=/(?:\[[^\[\]]*\]|\\[\[\]]?|`[^`]*`|[^\[\]\\])*?/,r._href=/\s*(<(?:\\[<>]?|[^\s<>\\])*>|(?:\\[()]?|\([^\s\x00-\x1f()\\]*\)|[^\s\x00-\x1f()\\])*?)/,r._title=/"(?:\\"?|[^"\\])*"|'(?:\\'?|[^'\\])*'|\((?:\\\)?|[^)\\])*\)/,r.link=u(r.link).replace("label",r._label).replace("href",r._href).replace("title",r._title).getRegex(),r.reflink=u(r.reflink).replace("label",r._label).getRegex(),r.normal=m({},r),r.pedantic=m({},r.normal,{strong:/^__(?=\S)([\s\S]*?\S)__(?!_)|^\*\*(?=\S)([\s\S]*?\S)\*\*(?!\*)/,em:/^_(?=\S)([\s\S]*?\S)_(?!_)|^\*(?=\S)([\s\S]*?\S)\*(?!\*)/,link:u(/^!?\[(label)\]\((.*?)\)/).replace("label",r._label).getRegex(),reflink:u(/^!?\[(label)\]\s*\[([^\]]*)\]/).replace("label",r._label).getRegex()}),r.gfm=m({},r.normal,{escape:u(r.escape).replace("])","~|])").getRegex(),url:u(/^((?:ftp|https?):\/\/|www\.)(?:[a-zA-Z0-9\-]+\.?)+[^\s<]*|^email/).replace("email",r._email).getRegex(),_backpedal:/(?:[^?!.,:;*_~()&]+|\([^)]*\)|&(?![a-zA-Z0-9]+;$)|[?!.,:;*_~)]+(?!$))+/,del:/^~~(?=\S)([\s\S]*?\S)~~/,text:u(r.text).replace("]|","~]|").replace("|","|https?://|ftp://|www\\.|[a-zA-Z0-9.!#$%&'*+/=?^_`{\\|}~-]+@|").getRegex()}),r.breaks=m({},r.gfm,{br:u(r.br).replace("{2,}","*").getRegex(),text:u(r.gfm.text).replace("{2,}","*").getRegex()}),i.rules=r,i.output=function(e,t,n){return new i(t,n).output(e)},i.prototype.output=function(e){for(var t,n,r,o,a,s="";e;)if(a=this.rules.escape.exec(e))e=e.substring(a[0].length),s+=a[1];else if(a=this.rules.autolink.exec(e))e=e.substring(a[0].length),r="@"===a[2]?"mailto:"+(n=l(this.mangle(a[1]))):n=l(a[1]),s+=this.renderer.link(r,null,n);else if(this.inLink||!(a=this.rules.url.exec(e))){if(a=this.rules.tag.exec(e))!this.inLink&&/^/i.test(a[0])&&(this.inLink=!1),e=e.substring(a[0].length),s+=this.options.sanitize?this.options.sanitizer?this.options.sanitizer(a[0]):l(a[0]):a[0];else if(a=this.rules.link.exec(e))e=e.substring(a[0].length),this.inLink=!0,r=a[2],this.options.pedantic?(t=/^([^'"]*[^\s])\s+(['"])(.*)\2/.exec(r))?(r=t[1],o=t[3]):o="":o=a[3]?a[3].slice(1,-1):"",r=r.trim().replace(/^<([\s\S]*)>$/,"$1"),s+=this.outputLink(a,{href:i.escapes(r),title:i.escapes(o)}),this.inLink=!1;else if((a=this.rules.reflink.exec(e))||(a=this.rules.nolink.exec(e))){if(e=e.substring(a[0].length),t=(a[2]||a[1]).replace(/\s+/g," "),!(t=this.links[t.toLowerCase()])||!t.href){s+=a[0].charAt(0),e=a[0].substring(1)+e;continue}this.inLink=!0,s+=this.outputLink(a,t),this.inLink=!1}else if(a=this.rules.strong.exec(e))e=e.substring(a[0].length),s+=this.renderer.strong(this.output(a[4]||a[3]||a[2]||a[1]));else if(a=this.rules.em.exec(e))e=e.substring(a[0].length),s+=this.renderer.em(this.output(a[6]||a[5]||a[4]||a[3]||a[2]||a[1]));else if(a=this.rules.code.exec(e))e=e.substring(a[0].length),s+=this.renderer.codespan(l(a[2].trim(),!0));else if(a=this.rules.br.exec(e))e=e.substring(a[0].length),s+=this.renderer.br();else if(a=this.rules.del.exec(e))e=e.substring(a[0].length),s+=this.renderer.del(this.output(a[1]));else if(a=this.rules.text.exec(e))e=e.substring(a[0].length),s+=this.renderer.text(l(this.smartypants(a[0])));else if(e)throw new Error("Infinite loop on byte: "+e.charCodeAt(0))}else a[0]=this.rules._backpedal.exec(a[0])[0],e=e.substring(a[0].length),"@"===a[2]?r="mailto:"+(n=l(a[0])):(n=l(a[0]),r="www."===a[1]?"http://"+n:n),s+=this.renderer.link(r,null,n);return s},i.escapes=function(e){return e?e.replace(i.rules._escapes,"$1"):e},i.prototype.outputLink=function(e,t){var n=t.href,r=t.title?l(t.title):null;return"!"!==e[0].charAt(0)?this.renderer.link(n,r,this.output(e[1])):this.renderer.image(n,r,l(e[1]))},i.prototype.smartypants=function(e){return this.options.smartypants?e.replace(/---/g,"—").replace(/--/g,"–").replace(/(^|[-\u2014/(\[{"\s])'/g,"$1‘").replace(/'/g,"’").replace(/(^|[-\u2014/(\[{\u2018\s])"/g,"$1“").replace(/"/g,"”").replace(/\.{3}/g,"…"):e},i.prototype.mangle=function(e){if(!this.options.mangle)return e;for(var t,n="",r=e.length,i=0;i.5&&(t="x"+t.toString(16)),n+="&#"+t+";";return n},o.prototype.code=function(e,t,n){if(this.options.highlight){var r=this.options.highlight(e,t);null!=r&&r!==e&&(n=!0,e=r)}return t?'
      '+(n?e:l(e,!0))+"
      \n":"
      "+(n?e:l(e,!0))+"
      "},o.prototype.blockquote=function(e){return"
      \n"+e+"
      \n"},o.prototype.html=function(e){return e},o.prototype.heading=function(e,t,n){return this.options.headerIds?"'+e+"\n":""+e+"\n"},o.prototype.hr=function(){return this.options.xhtml?"
      \n":"
      \n"},o.prototype.list=function(e,t,n){var r=t?"ol":"ul";return"<"+r+(t&&1!==n?' start="'+n+'"':"")+">\n"+e+"\n"},o.prototype.listitem=function(e){return"
    7. "+e+"
    8. \n"},o.prototype.checkbox=function(e){return" "},o.prototype.paragraph=function(e){return"

      "+e+"

      \n"},o.prototype.table=function(e,t){return t&&(t=""+t+""),"\n\n"+e+"\n"+t+"
      \n"},o.prototype.tablerow=function(e){return"\n"+e+"\n"},o.prototype.tablecell=function(e,t){var n=t.header?"th":"td";return(t.align?"<"+n+' align="'+t.align+'">':"<"+n+">")+e+"\n"},o.prototype.strong=function(e){return""+e+""},o.prototype.em=function(e){return""+e+""},o.prototype.codespan=function(e){return""+e+""},o.prototype.br=function(){return this.options.xhtml?"
      ":"
      "},o.prototype.del=function(e){return""+e+""},o.prototype.link=function(e,t,n){if(this.options.sanitize){try{var r=decodeURIComponent(c(e)).replace(/[^\w:]/g,"").toLowerCase()}catch(e){return n}if(0===r.indexOf("javascript:")||0===r.indexOf("vbscript:")||0===r.indexOf("data:"))return n}this.options.baseUrl&&!f.test(e)&&(e=d(this.options.baseUrl,e));try{e=encodeURI(e).replace(/%25/g,"%")}catch(e){return n}var i='
      "},o.prototype.image=function(e,t,n){this.options.baseUrl&&!f.test(e)&&(e=d(this.options.baseUrl,e));var r=''+n+'":">"},o.prototype.text=function(e){return e},a.prototype.strong=a.prototype.em=a.prototype.codespan=a.prototype.del=a.prototype.text=function(e){return e},a.prototype.link=a.prototype.image=function(e,t,n){return""+n},a.prototype.br=function(){return""},s.parse=function(e,t){return new s(t).parse(e)},s.prototype.parse=function(e){this.inline=new i(e.links,this.options),this.inlineText=new i(e.links,m({},this.options,{renderer:new a})),this.tokens=e.reverse();for(var t="";this.next();)t+=this.tok();return t},s.prototype.next=function(){return this.token=this.tokens.pop()},s.prototype.peek=function(){return this.tokens[this.tokens.length-1]||0},s.prototype.parseText=function(){for(var e=this.token.text;"text"===this.peek().type;)e+="\n"+this.next().text;return this.inline.output(e)},s.prototype.tok=function(){switch(this.token.type){case"space":return"";case"hr":return this.renderer.hr();case"heading":return this.renderer.heading(this.inline.output(this.token.text),this.token.depth,c(this.inlineText.output(this.token.text)));case"code":return this.renderer.code(this.token.text,this.token.lang,this.token.escaped);case"table":var e,t,n,r,i="",o="";for(n="",e=0;et)n.splice(t);else for(;n.lengthAn error occurred:

      "+l(e.message+"",!0)+"
      ";throw e}}h.exec=h,b.options=b.setOptions=function(e){return m(b.defaults,e),b},b.getDefaults=function(){return{baseUrl:null,breaks:!1,gfm:!0,headerIds:!0,headerPrefix:"",highlight:null,langPrefix:"language-",mangle:!0,pedantic:!1,renderer:new o,sanitize:!1,sanitizer:null,silent:!1,smartLists:!1,smartypants:!1,tables:!0,xhtml:!1}},b.defaults=b.getDefaults(),b.Parser=s,b.parser=s.parse,b.Renderer=o,b.TextRenderer=a,b.Lexer=n,b.lexer=n.lex,b.InlineLexer=i,b.inlineLexer=i.output,b.parse=b,"undefined"!=typeof module&&"object"==typeof exports?module.exports=b:"function"==typeof define&&define.amd?define("deps/marked",[],function(){return b}):e.marked=b}(this||("undefined"!=typeof window?window:global)),define("core/utils",["exports","core/pubsubhub","deps/marked"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.ISODate=e.name=void 0,e.markdownToHtml=function(e){const t=h(e).replace(l,">").replace(c,"&");return(0,i.default)(t)},e.makeOwnerSwapper=function(e){if(!e)throw new TypeError("Expected instance of Node.");return t=>{if(t.ownerDocument.adoptNode(e),t.firstElementChild)return t.insertBefore(e,t.firstElementChild);t.appendChild(e)}},e.calculateLeftPad=function(e){if("string"!=typeof e)throw new TypeError("Invalid input");var t=e.split("\n").filter(e=>e).reduce((e,t)=>{if(0===e)return e;const n=t.match(o)[0]||"";return Math.min(n.length,e)},1/0);return t===1/0?0:t},e.createResourceHint=function(e){if(!e||"object"!=typeof e)throw new TypeError("Missing options");if(!p.has(e.hint))throw new TypeError("Invalid resources hint");const t=new URL(e.href,document.location),n=document.createElement("link");let r=t.href;switch(n.rel=e.hint,n.rel){case"dns-prefetch":case"preconnect":r=t.origin,(e.corsMode||t.origin!==document.location.origin)&&(n.crossOrigin=e.corsMode||"anonymous");break;case"preload":"as"in e&&"string"==typeof e.as&&(f.has(e.as)||console.warn(`Unknown request destination: ${e.as}`),n.setAttribute("as",e.as))}n.href=r,e.dontRemove||n.classList.add("removeOnSave");return n},e.normalizePadding=h,e.removeReSpec=function(e){Array.from(e.querySelectorAll(".remove, script[data-requiremodule]")).forEach(e=>{e.remove()})},e.joinAnd=function(e=[],t=(e=>e)){const n=e.map(t);switch(n.length){case 0:case 1:return n.toString();case 2:return n.join(" and ");default:const e=n.join(", "),t=e.lastIndexOf(",");return`${e.substr(0,t+1)} and ${e.slice(t+2)}`}},e.xmlEscape=function(e){return e.replace(/&/g,"&").replace(/>/g,">").replace(/"/g,""").replace(/i)return 1;if(i>t)return-1;if(!isNaN(t)&&isNaN(i))return 1;if(isNaN(t)&&!isNaN(i))return-1}return 0},e.concatDate=function(e,t=""){return u.format(e).replace(s,t)},e.toShortIsoDate=function(e){return u.format(e)},e.lead0=function(e){return 1===String(e).length?"0"+e:e},e.parseSimpleDate=function(e){return new Date(e)},e.parseLastModified=function(e){return e?new Date(Date.parse(e)):new Date},e.humanDate=function(e=new Date,t=document.documentElement.lang||"en"){e instanceof Date||(e=new Date(e));const n=[t,"en"],r=e.toLocaleString(n,{day:"2-digit",timeZone:"UTC"}),i=e.toLocaleString(n,{month:"long",timeZone:"UTC"}),o=e.toLocaleString(n,{year:"numeric",timeZone:"UTC"});return`${r} ${i} ${o}`},e.isoDate=function(e){return(e instanceof Date?e:new Date(e)).toISOString()},e.toKeyValuePairs=function(e,t=", ",n="="){return Array.from(Object.entries(e)).map(([e,t])=>`${e}${n}${JSON.stringify(t)}`).join(t)},e.linkCSS=function(e,t){const n=[].concat(t).map(t=>{var n=e.createElement("link");return n.rel="stylesheet",n.href=t,n}).reduce(function(e,t){return e.appendChild(t),e},e.createDocumentFragment());e.head.appendChild(n)},e.runTransforms=function(e,n){var r=[this,e],i=Array.from(arguments);if(i.shift(),i.shift(),r=r.concat(i),n)for(var o=n.split(/\s+/),a=0;anew Date)return i}catch(e){console.error("Failed to use Cache API.",e)}const o=await fetch(e);if(!o.ok&&i)return console.warn(`Returning a stale cached response for ${n}`),i;if(r){const n=o.clone(),i=new Headers(o.headers),a=new Date(Date.now()+t);i.set("Expires",a);const s=new Response(await n.blob(),{headers:i});return await r.put(e,s).catch(console.error),await r.match(e)}return o},e.flatten=function e(t,n){const r="object"==typeof n;const i=Object(n)[Symbol.iterator]&&"function"==typeof n.values;const o=r?i?[...n.values()].reduce(e,[]):Object.values(n):[n];return[...t,...o]};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/utils";i.default.setOptions({sanitize:!1,gfm:!0});const o=/^[\ |\t]*/,a=/\s+$/gm,s=/\-/g,l=/>/gm,c=/&/gm;const u=e.ISODate=new Intl.DateTimeFormat(["en-ca-iso8601"],{timeZone:"UTC",year:"numeric",month:"2-digit",day:"2-digit"}),d=new Set(["a","abbr","acronym","b","bdo","big","br","button","cite","code","dfn","em","i","img","input","kbd","label","map","object","q","samp","script","select","small","span","strong","sub","sup","textarea","time","tt","var"]),p=new Set(["dns-prefetch","preconnect","preload","prerender"]),f=new Set(["document","embed","font","image","manifest","media","object","report","script","serviceworker","sharedworker","style","worker","xslt",""]);function h(e=""){if(!e)return"";if("string"!=typeof e)throw TypeError("Invalid input");if("\n"===e)return"\n";function t(e){return null!==e&&e.nodeType===Node.TEXT_NODE}var n=""+e,r=(new DOMParser).parseFromString(n,"text/html");Array.from(r.body.children).filter(e=>!d.has(e.localName)).filter(e=>"pre"!==e.localName).filter(e=>"table"!==e.localName).forEach(e=>{e.innerHTML=h(e.innerHTML)}),Array.from(r.body.childNodes).filter(e=>t(e)&&""===e.textContent.trim()).forEach(e=>e.parentElement.replaceChild(r.createTextNode("\n"),e)),t(r.body.firstChild)||Array.from(r.body.firstChild.children).filter(e=>"table"!==e.localName).forEach(e=>{e.innerHTML=h(e.innerHTML)}),r.normalize();const i=r.body.innerText.replace(/^\ *\n/,"").split("\n").filter(e=>e&&e.startsWith(" "))[0];var o=i?i.match(/\ +/)[0].length:0;if(o){Array.from(r.body.childNodes).filter(e=>"pre"!==e.localName).filter(t).filter(e=>{const t=e.previousElementSibling,n=t?t.localName:e.parentElement.localName;return!d.has(n)||e.textContent.trim().includes("\n")}).reduce((e,t)=>{let n="";const r=t.previousElementSibling,i=r?r.localName:t.parentElement.localName;return/^[\t\ ]/.test(t.textContent)&&d.has(i)&&(n=t.textContent.match(/^\s+/)[0]),t.textContent=n+t.textContent.replace(e,""),e},new RegExp("^ {1,"+o+"}","gm"));const e=new RegExp(`\\ {${o}}$`,"gm");Array.from(r.body.querySelectorAll("pre")).map(e=>e.previousSibling).filter(t).reduce((t,n)=>(e.test(n.textContent)&&(n.textContent=n.textContent.substr(0,n.textContent.length-t)),t),o)}return a.test(r.body.innerHTML)?r.body.innerHTML.trimRight()+"\n":r.body.innerHTML}}),define("core/post-process",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0;e.name="core/post-process";let n;e.done=new Promise(e=>{n=e});(0,t.sub)("plugins-done",async e=>{const t=[];if(Array.isArray(e.postProcess)){const n=await Promise.all(e.postProcess.filter(e=>"function"==typeof e).map(t=>Promise.resolve(t(e,document))));t.push(...n)}"function"==typeof e.afterEnd&&t.push(await Promise.resolve(e.afterEnd(e,document))),n(t)},{once:!0})}),define("core/pre-process",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0;e.name="core/pre-process";let n;e.done=new Promise(e=>{n=e});(0,t.sub)("start-all",async e=>{const t=[];if(Array.isArray(e.preProcess)){const n=await Promise.all(e.preProcess.filter(e=>"function"==typeof e).map(t=>Promise.resolve(t(e,document))));t.push(...n)}n(t)},{once:!0})}),define("core/include-config",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/include-config";const n={},r=e=>Object.assign(n,e);(0,t.sub)("start-all",r),(0,t.sub)("amend-user-config",r),(0,t.sub)("end-all",()=>{const e=document.createElement("script");e.id="initialUserConfig",e.type="application/json",e.innerHTML=JSON.stringify(n,null,2),document.head.appendChild(e)})}),define("core/override-configuration",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/override-configuration";(0,t.sub)("start-all",function(e){const n=document.location.search.replace(/;/g,"&"),r=new URLSearchParams(n),i=Array.from(r.entries()).filter(([e,t])=>!!e&&!!t).map(([e,t])=>{const n=decodeURIComponent(e),r=decodeURIComponent(t.replace(/%3D/g,"="));let i;try{i=JSON.parse(r)}catch(e){i=r}return{key:n,value:i}}).reduce((e,{key:t,value:n})=>(e[t]=n,e),{});Object.assign(e,i),(0,t.pub)("amend-user-config",i)},{once:!0})}),define("core/respec-ready",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/respec-ready";const n=new Promise(e=>{(0,t.sub)("end-all",e,{once:!0})});Object.defineProperty(document,"respecIsReady",{get:()=>n})}),define("core/base-runner",["exports","core/utils","core/post-process","core/pre-process","core/pubsubhub","core/include-config","core/override-configuration","core/respec-ready"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.runAll=async function(e){(0,i.pub)("start-all",respecConfig),a&&performance.mark(o+"-start");await r.done;const l=e.filter(e=>e&&e.run).map(s);for(const e of l)try{await e(respecConfig)}catch(e){console.error(e)}(0,i.pub)("plugins-done",respecConfig),await n.done,(0,i.pub)("end-all",respecConfig),(0,t.removeReSpec)(document),a&&(performance.mark(o+"-end"),performance.measure(o,o+"-start",o+"-end"))};const o=e.name="core/base-runner",a=performance.mark&&performance.measure;function s(e){const t=e.name||"";return t||console.warn("Plugin lacks name:",e),n=>new Promise(async(r,i)=>{const o=setTimeout(()=>{const n=`Plugin ${t} took too long.`;console.error(n,e),i(new Error(n))},15e3);a&&performance.mark(t+"-start");try{e.run.length<=1?(await e.run(n),r()):e.run(n,document,r)}catch(e){i(e)}finally{clearTimeout(o)}a&&(performance.mark(t+"-end"),performance.measure(t,t+"-start",t+"-end"))})}});var shortcut={all_shortcuts:{},add:function(e,t,n){var r={type:"keydown",propagate:!1,disable_in_input:!1,target:document,keycode:!1};if(n)for(var i in r)void 0===n[i]&&(n[i]=r[i]);else n=r;var o=n.target;"string"==typeof n.target&&(o=document.getElementById(n.target));e=e.toLowerCase();var a=function(r){var i,o;if((r=r||window.event,n.disable_in_input)&&(r.target?o=r.target:r.srcElement&&(o=r.srcElement),3==o.nodeType&&(o=o.parentNode),"INPUT"==o.tagName||"TEXTAREA"==o.tagName))return;r.keyCode?i=r.keyCode:r.which&&(i=r.which);var a=String.fromCharCode(i).toLowerCase();188==i&&(a=","),190==i&&(a=".");var s=e.split("+"),l=0,c={"`":"~",1:"!",2:"@",3:"#",4:"$",5:"%",6:"^",7:"&",8:"*",9:"(",0:")","-":"_","=":"+",";":":","'":'"',",":"<",".":">","/":"?","\\":"|"},u={esc:27,escape:27,tab:9,space:32,return:13,enter:13,backspace:8,scrolllock:145,scroll_lock:145,scroll:145,capslock:20,caps_lock:20,caps:20,numlock:144,num_lock:144,num:144,pause:19,break:19,insert:45,home:36,delete:46,end:35,pageup:33,page_up:33,pu:33,pagedown:34,page_down:34,pd:34,left:37,up:38,right:39,down:40,f1:112,f2:113,f3:114,f4:115,f5:116,f6:117,f7:118,f8:119,f9:120,f10:121,f11:122,f12:123},d={shift:{wanted:!1,pressed:!1},ctrl:{wanted:!1,pressed:!1},alt:{wanted:!1,pressed:!1},meta:{wanted:!1,pressed:!1}};r.ctrlKey&&(d.ctrl.pressed=!0),r.shiftKey&&(d.shift.pressed=!0),r.altKey&&(d.alt.pressed=!0),r.metaKey&&(d.meta.pressed=!0);for(var p,f=0;p=s[f],f1?u[p]==i&&l++:n.keycode?n.keycode==i&&l++:a==p?l++:c[a]&&r.shiftKey&&(a=c[a])==p&&l++;if(l==s.length&&d.ctrl.pressed==d.ctrl.wanted&&d.shift.pressed==d.shift.wanted&&d.alt.pressed==d.alt.wanted&&d.meta.pressed==d.meta.wanted&&(t(r),!n.propagate))return r.cancelBubble=!0,r.returnValue=!1,r.stopPropagation&&(r.stopPropagation(),r.preventDefault()),!1};this.all_shortcuts[e]={callback:a,target:o,event:n.type},o.addEventListener?o.addEventListener(n.type,a,!1):o.attachEvent?o.attachEvent("on"+n.type,a):o["on"+n.type]=a}},Zx,t0,u0,Dha,Eha,mta,nta,eXa,fXa;define("shortcut",(Zx=this,function(){return Zx.shortcut})),define("deps/text",["module"],function(e){var t,n,r,i,o,a=["Msxml2.XMLHTTP","Microsoft.XMLHTTP","Msxml2.XMLHTTP.4.0"],s=/^\s*<\?xml(\s)+version=[\'\"](\d)*.(\d)*[\'\"](\s)*\?>/im,l=/]*>\s*([\s\S]+)\s*<\/body>/im,c="undefined"!=typeof location&&location.href,u=c&&location.protocol&&location.protocol.replace(/\:/,""),d=c&&location.hostname,p=c&&(location.port||void 0),f={},h=e.config&&e.config()||{};function m(e,t){return void 0===e||""===e?t:e}return t={version:"2.0.15",strip:function(e){if(e){var t=(e=e.replace(s,"")).match(l);t&&(e=t[1])}else e="";return e},jsEscape:function(e){return e.replace(/(['\\])/g,"\\$1").replace(/[\f]/g,"\\f").replace(/[\b]/g,"\\b").replace(/[\n]/g,"\\n").replace(/[\t]/g,"\\t").replace(/[\r]/g,"\\r").replace(/[\u2028]/g,"\\u2028").replace(/[\u2029]/g,"\\u2029")},createXhr:h.createXhr||function(){var e,t,n;if("undefined"!=typeof XMLHttpRequest)return new XMLHttpRequest;if("undefined"!=typeof ActiveXObject)for(t=0;t<3;t+=1){n=a[t];try{e=new ActiveXObject(n)}catch(e){}if(e){a=[n];break}}return e},parseName:function(e){var t,n,r,i=!1,o=e.lastIndexOf("."),a=0===e.indexOf("./")||0===e.indexOf("../");return-1!==o&&(!a||o>1)?(t=e.substring(0,o),n=e.substring(o+1)):t=e,-1!==(o=(r=n||t).indexOf("!"))&&(i="strip"===r.substring(o+1),r=r.substring(0,o),n?n=r:t=r),{moduleName:t,ext:n,strip:i}},xdRegExp:/^((\w+)\:)?\/\/([^\/\\]+)/,useXhr:function(e,n,r,i){var o,a,s,l=t.xdRegExp.exec(e);return!l||(o=l[2],s=(a=(a=l[3]).split(":"))[1],a=a[0],(!o||o===n)&&(!a||a.toLowerCase()===r.toLowerCase())&&(!s&&!a||function(e,t,n,r){if(t===r)return!0;if(e===n){if("http"===e)return m(t,"80")===m(r,"80");if("https"===e)return m(t,"443")===m(r,"443")}return!1}(o,s,n,i)))},finishLoad:function(e,n,r,i){r=n?t.strip(r):r,h.isBuild&&(f[e]=r),i(r)},load:function(e,n,r,i){if(i&&i.isBuild&&!i.inlineText)r();else{h.isBuild=i&&i.isBuild;var o=t.parseName(e),a=o.moduleName+(o.ext?"."+o.ext:""),s=n.toUrl(a),l=h.useXhr||t.useXhr;0!==s.indexOf("empty:")?!c||l(s,u,d,p)?t.get(s,function(n){t.finishLoad(e,o.strip,n,r)},function(e){r.error&&r.error(e)}):n([a],function(e){t.finishLoad(o.moduleName+"."+o.ext,o.strip,e,r)}):r()}},write:function(e,n,r,i){if(f.hasOwnProperty(n)){var o=t.jsEscape(f[n]);r.asModule(e+"!"+n,"define(function () { return '"+o+"';});\n")}},writeFile:function(e,n,r,i,o){var a=t.parseName(n),s=a.ext?"."+a.ext:"",l=a.moduleName+s,c=r.toUrl(a.moduleName+s)+".js";t.load(l,r,function(n){var r=function(e){return i(c,e)};r.asModule=function(e,t){return i.asModule(e,c,t)},t.write(e,l,r,o)},o)}},"node"===h.env||!h.env&&"undefined"!=typeof process&&process.versions&&process.versions.node&&!process.versions["node-webkit"]&&!process.versions["atom-shell"]?(n=require.nodeRequire("fs"),t.get=function(e,t,r){try{var i=n.readFileSync(e,"utf8");"\ufeff"===i[0]&&(i=i.substring(1)),t(i)}catch(e){r&&r(e)}}):"xhr"===h.env||!h.env&&t.createXhr()?t.get=function(e,n,r,i){var o,a=t.createXhr();if(a.open("GET",e,!0),i)for(o in i)i.hasOwnProperty(o)&&a.setRequestHeader(o.toLowerCase(),i[o]);h.onXhr&&h.onXhr(a,e),a.onreadystatechange=function(t){var i,o;4===a.readyState&&((i=a.status||0)>399&&i<600?((o=new Error(e+" HTTP status: "+i)).xhr=a,r&&r(o)):n(a.responseText),h.onXhrComplete&&h.onXhrComplete(a,e))},a.send(null)}:"rhino"===h.env||!h.env&&"undefined"!=typeof Packages&&"undefined"!=typeof java?t.get=function(e,t){var n,r,i=new java.io.File(e),o=java.lang.System.getProperty("line.separator"),a=new java.io.BufferedReader(new java.io.InputStreamReader(new java.io.FileInputStream(i),"utf-8")),s="";try{for(n=new java.lang.StringBuffer,(r=a.readLine())&&r.length()&&65279===r.charAt(0)&&(r=r.substring(1)),null!==r&&n.append(r);null!==(r=a.readLine());)n.append(o),n.append(r);s=String(n.toString())}finally{a.close()}t(s)}:("xpconnect"===h.env||!h.env&&"undefined"!=typeof Components&&Components.classes&&Components.interfaces)&&(r=Components.classes,i=Components.interfaces,Components.utils.import("resource://gre/modules/FileUtils.jsm"),o="@mozilla.org/windows-registry-key;1"in r,t.get=function(e,t){var n,a,s,l={};o&&(e=e.replace(/\//g,"\\")),s=new FileUtils.File(e);try{(n=r["@mozilla.org/network/file-input-stream;1"].createInstance(i.nsIFileInputStream)).init(s,1,0,!1),(a=r["@mozilla.org/intl/converter-input-stream;1"].createInstance(i.nsIConverterInputStream)).init(n,"utf-8",n.available(),i.nsIConverterInputStream.DEFAULT_REPLACEMENT_CHARACTER),a.readString(n.available(),l),a.close(),n.close(),t(l.value)}catch(e){throw new Error((s&&s.path||"")+": "+e)}}),t}),define("deps/text!ui/ui.css",[],function(){return'#respec-ui {\n position: fixed;\n display: flex;\n flex-direction: row-reverse;\n top: 20px;\n right: 20px;\n width: 202px;\n text-align: right;\n z-index: 9000;\n}\n\n#respec-pill,\n.respec-info-button {\n background: #fff;\n height: 2.5em;\n color: rgb(120, 120, 120);\n border: 1px solid #ccc;\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\n}\n\n.respec-info-button {\n border: none;\n opacity: 0.75;\n border-radius: 2em;\n margin-right: 1em;\n min-width: 3.5em;\n}\n\n.respec-info-button:focus,\n.respec-info-button:hover {\n opacity: 1;\n transition: opacity 0.2s;\n}\n\n#respec-pill:disabled {\n font-size: 2.8px;\n text-indent: -9999em;\n border-top: 1.1em solid rgba(40, 40, 40, 0.2);\n border-right: 1.1em solid rgba(40, 40, 40, 0.2);\n border-bottom: 1.1em solid rgba(40, 40, 40, 0.2);\n border-left: 1.1em solid #ffffff;\n transform: translateZ(0);\n animation: respec-spin 0.5s infinite linear;\n box-shadow: none;\n}\n\n#respec-pill:disabled,\n#respec-pill:disabled:after {\n border-radius: 50%;\n width: 10em;\n height: 10em;\n}\n\n@keyframes respec-spin {\n 0% {\n transform: rotate(0deg);\n }\n 100% {\n transform: rotate(360deg);\n }\n}\n\n.respec-hidden {\n visibility: hidden;\n opacity: 0;\n transition: visibility 0s 0.2s, opacity 0.2s linear;\n}\n\n.respec-visible {\n visibility: visible;\n opacity: 1;\n transition: opacity 0.2s linear;\n}\n\n#respec-pill:hover,\n#respec-pill:focus {\n color: rgb(0, 0, 0);\n background-color: rgb(245, 245, 245);\n transition: color 0.2s;\n}\n\n#respec-menu {\n position: absolute;\n margin: 0;\n padding: 0;\n font-family: sans-serif;\n background: #fff;\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\n width: 200px;\n display: none;\n text-align: left;\n margin-top: 32px;\n font-size: 0.8em;\n}\n\n#respec-menu:not([hidden]) {\n display: block;\n}\n\n#respec-menu li {\n list-style-type: none;\n margin: 0;\n padding: 0;\n}\n\n.respec-save-buttons {\n display: grid;\n grid-template-columns: repeat(auto-fill, minmax(47%, 2fr));\n grid-gap: 0.5cm;\n padding: 0.5cm;\n}\n\n.respec-save-button:link {\n padding-top: 16px;\n color: rgb(240, 240, 240);\n background: rgb(42, 90, 168);\n justify-self: stretch;\n height: 1cm;\n text-decoration: none;\n text-align: center;\n font-size: inherit;\n border: none;\n border-radius: 0.2cm;\n}\n\n.respec-save-button:link:hover {\n color: white;\n background: rgb(42, 90, 168);\n padding: 0;\n margin: 0;\n border: 0;\n padding-top: 16px;\n}\n\n#respec-ui button:focus,\n#respec-pill:focus,\n.respec-option:focus {\n outline: 0;\n outline-style: none;\n}\n\n#respec-pill-error {\n background-color: red;\n color: white;\n}\n\n#respec-pill-warning {\n background-color: orange;\n color: white;\n}\n\n.respec-warning-list,\n.respec-error-list {\n margin: 0;\n padding: 0;\n list-style: none;\n font-family: sans-serif;\n background-color: rgb(255, 251, 230);\n font-size: 0.85em;\n}\n\n.respec-warning-list > li,\n.respec-error-list > li {\n padding: 0.4em 0.7em;\n}\n\n.respec-warning-list > li::before {\n content: "⚠️";\n padding-right: 0.5em;\n}\n.respec-warning-list p,\n.respec-error-list p {\n padding: 0;\n margin: 0;\n}\n\n.respec-warning-list li {\n color: rgb(92, 59, 0);\n border-bottom: thin solid rgb(255, 245, 194);\n}\n\n.respec-error-list,\n.respec-error-list li {\n background-color: rgb(255, 240, 240);\n}\n\n.respec-error-list li::before {\n content: "💥";\n padding-right: 0.5em;\n}\n\n.respec-error-list li {\n padding: 0.4em 0.7em;\n color: rgb(92, 59, 0);\n border-bottom: thin solid rgb(255, 215, 215);\n}\n\n.respec-error-list li > p {\n margin: 0;\n padding: 0;\n display: inline-block;\n}\n\n#respec-overlay {\n display: block;\n position: fixed;\n z-index: 10000;\n top: 0px;\n left: 0px;\n height: 100%;\n width: 100%;\n background: #000;\n}\n\n.respec-show-overlay {\n transition: opacity 0.2s linear;\n opacity: 0.5;\n}\n\n.respec-hide-overlay {\n transition: opacity 0.2s linear;\n opacity: 0;\n}\n\n.respec-modal {\n display: block;\n position: fixed;\n z-index: 11000;\n margin: auto;\n top: 10%;\n background: #fff;\n border: 5px solid #666;\n min-width: 20%;\n width: 79%;\n padding: 0;\n max-height: 80%;\n overflow-y: auto;\n margin: 0 -0.5cm;\n}\n\n@media screen and (min-width: 78em) {\n .respec-modal {\n width: 62%;\n }\n}\n\n.respec-modal h3 {\n margin: 0;\n padding: 0.2em;\n text-align: center;\n color: black;\n background: linear-gradient(\n to bottom,\n rgba(238, 238, 238, 1) 0%,\n rgba(238, 238, 238, 1) 50%,\n rgba(204, 204, 204, 1) 100%\n );\n font-size: 1em;\n}\n\n.respec-modal .inside div p {\n padding-left: 1cm;\n}\n\n#respec-menu button.respec-option {\n background: white;\n padding: 0 0.2cm;\n border: none;\n width: 100%;\n text-align: left;\n font-size: inherit;\n padding: 1.2em 1.2em;\n}\n\n#respec-menu button.respec-option:hover,\n#respec-menu button:focus {\n background-color: #eeeeee;\n}\n\n.respec-cmd-icon {\n padding-right: 0.5em;\n}\n\n#respec-ui button.respec-option:last-child {\n border: none;\n border-radius: inherit;\n}\n\n.respec-offending-element {\n display: inline-block;\n position: relative;\n background: url(data:image/gif;base64,R0lGODdhBAADAPEAANv///8AAP///wAAACwAAAAABAADAEACBZQjmIAFADs=)\n bottom repeat-x;\n}\n\n@supports (text-decoration-style: wavy) {\n .respec-offending-element {\n background: none;\n text-decoration-line: underline;\n text-decoration-style: wavy;\n text-decoration-color: red;\n }\n}\n\n.respec-button-copy-paste {\n position: absolute;\n display: block;\n padding: 0px 8px;\n height: 28px;\n width: 40px;\n color: #333;\n white-space: nowrap;\n vertical-align: middle;\n cursor: pointer;\n background-color: #eee;\n background-image: linear-gradient(#fcfcfc, #eee);\n border: 1px solid rgb(144, 184, 222);\n border-radius: 0px 0px 3px 0;\n -webkit-user-select: none;\n -moz-user-select: none;\n -ms-user-select: none;\n user-select: none;\n -webkit-appearance: none;\n margin: 0px 127px;\n border-left: 0;\n}\n\np + .respec-button-copy-paste {\n margin: 1px 127px;\n}\n\n#specref-ui {\n margin: 0 2%;\n margin-bottom: 0.5cm;\n}\n\n#specref-ui header {\n font-size: 0.7em;\n background-color: #eee;\n text-align: center;\n padding: 0.2cm;\n margin-bottom: 0.5cm;\n border-radius: 0 0 0.2cm 0.2cm;\n}\n\n#specref-ui header h1 {\n padding: 0;\n margin: 0;\n color: black;\n}\n\n#specref-ui p {\n padding: 0;\n margin: 0;\n font-size: 0.8em;\n text-align: center;\n}\n\n#specref-ui p.state {\n margin: 1cm;\n}\n\n#specref-ui .searchcomponent {\n font-size: 16px;\n display: grid;\n grid-template-columns: auto 2cm;\n}\n#specref-ui .searchcomponent:focus {\n}\n\n#specref-ui input,\n#specref-ui button {\n border: 0;\n padding: 6px 12px;\n}\n\n#specref-ui label {\n font-size: 0.6em;\n grid-column-end: 3;\n text-align: right;\n grid-column-start: 1;\n}\n\n#specref-ui input[type="search"] {\n -webkit-appearance: none;\n font-size: 16px;\n border-radius: 0.1cm 0 0 0.1cm;\n border: 1px solid rgb(204, 204, 204);\n}\n\n#specref-ui button[type="submit"] {\n color: white;\n border-radius: 0 0.1cm 0.1cm 0;\n background-color: rgb(51, 122, 183);\n}\n\n#specref-ui button[type="submit"]:hover {\n background-color: #286090;\n border-color: #204d74;\n}\n\n#specref-ui .result-stats {\n margin: 0;\n padding: 0;\n color: rgb(128, 128, 128);\n font-size: 0.7em;\n font-weight: bold;\n}\n\n#specref-ui .specref-results {\n font-size: 0.8em;\n}\n\n#specref-ui .specref-results dd + dt {\n margin-top: 0.51cm;\n}\n\n#specref-ui .specref-results a {\n text-transform: capitalize;\n}\n#specref-ui .specref-results .authors {\n display: block;\n color: #006621;\n}\n\n@media print {\n #respec-ui {\n display: none;\n }\n}\n'}),t0="undefined"!=typeof window?window:this,u0=function(e,t){var n=[],r=e.document,i=Object.getPrototypeOf,o=n.slice,a=n.concat,s=n.push,l=n.indexOf,c={},u=c.toString,d=c.hasOwnProperty,p=d.toString,f=p.call(Object),h={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType},g=function(e){return null!=e&&e===e.window},b={type:!0,src:!0,noModule:!0};function y(e,t,n){var i,o=(t=t||r).createElement("script");if(o.text=e,n)for(i in b)n[i]&&(o[i]=n[i]);t.head.appendChild(o).parentNode.removeChild(o)}function v(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?c[u.call(e)]||"object":typeof e}var w="3.3.1 -ajax,-ajax/jsonp,-ajax/load,-ajax/parseXML,-ajax/script,-ajax/var/location,-ajax/var/nonce,-ajax/var/rquery,-ajax/xhr,-manipulation/_evalUrl,-event/ajax,-effects,-effects/Tween,-effects/animatedSelector",x=function(e,t){return new x.fn.init(e,t)},k=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;function C(e){var t=!!e&&"length"in e&&e.length,n=v(e);return!m(e)&&!g(e)&&("array"===n||0===t||"number"==typeof t&&t>0&&t-1 in e)}x.fn=x.prototype={jquery:w,constructor:x,length:0,toArray:function(){return o.call(this)},get:function(e){return null==e?o.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=x.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return x.each(this,e)},map:function(e){return this.pushStack(x.map(this,function(t,n){return e.call(t,n,t)}))},slice:function(){return this.pushStack(o.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(n>=0&&n+~]|"+M+")"+M+"*"),F=new RegExp("="+M+"*([^\\]'\"]*?)"+M+"*\\]","g"),z=new RegExp(q),G=new RegExp("^"+O+"$"),V={ID:new RegExp("^#("+O+")"),CLASS:new RegExp("^\\.("+O+")"),TAG:new RegExp("^("+O+"|[*])"),ATTR:new RegExp("^"+I),PSEUDO:new RegExp("^"+q),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+P+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},X=/^(?:input|select|textarea|button)$/i,Z=/^h\d$/i,Y=/^[^{]+\{\s*\[native \w/,Q=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,J=/[+~]/,K=new RegExp("\\\\([\\da-f]{1,6}"+M+"?|("+M+")|.)","ig"),ee=function(e,t,n){var r="0x"+t-65536;return r!=r||n?t:r<0?String.fromCharCode(r+65536):String.fromCharCode(r>>10|55296,1023&r|56320)},te=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ne=function(e,t){return t?"\0"===e?"�":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},re=function(){p()},ie=ye(function(e){return!0===e.disabled&&("form"in e||"label"in e)},{dir:"parentNode",next:"legend"});try{_.apply(L=N.call(x.childNodes),x.childNodes),L[x.childNodes.length].nodeType}catch(e){_={apply:L.length?function(e,t){D.apply(e,N.call(t))}:function(e,t){for(var n=e.length,r=0;e[n++]=t[r++];);e.length=n-1}}}function oe(e,t,r,i){var o,s,c,u,d,h,b,y=t&&t.ownerDocument,k=t?t.nodeType:9;if(r=r||[],"string"!=typeof e||!e||1!==k&&9!==k&&11!==k)return r;if(!i&&((t?t.ownerDocument||t:x)!==f&&p(t),t=t||f,m)){if(11!==k&&(d=Q.exec(e)))if(o=d[1]){if(9===k){if(!(c=t.getElementById(o)))return r;if(c.id===o)return r.push(c),r}else if(y&&(c=y.getElementById(o))&&v(t,c)&&c.id===o)return r.push(c),r}else{if(d[2])return _.apply(r,t.getElementsByTagName(e)),r;if((o=d[3])&&n.getElementsByClassName&&t.getElementsByClassName)return _.apply(r,t.getElementsByClassName(o)),r}if(n.qsa&&!T[e+" "]&&(!g||!g.test(e))){if(1!==k)y=t,b=e;else if("object"!==t.nodeName.toLowerCase()){for((u=t.getAttribute("id"))?u=u.replace(te,ne):t.setAttribute("id",u=w),s=(h=a(e)).length;s--;)h[s]="#"+u+" "+be(h[s]);b=h.join(","),y=J.test(e)&&me(t.parentNode)||t}if(b)try{return _.apply(r,y.querySelectorAll(b)),r}catch(e){}finally{u===w&&t.removeAttribute("id")}}}return l(e.replace(W,"$1"),t,r,i)}function ae(){var e=[];return function t(n,i){return e.push(n+" ")>r.cacheLength&&delete t[e.shift()],t[n+" "]=i}}function se(e){return e[w]=!0,e}function le(e){var t=f.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function ce(e,t){for(var n=e.split("|"),i=n.length;i--;)r.attrHandle[n[i]]=t}function ue(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)for(;n=n.nextSibling;)if(n===t)return-1;return e?1:-1}function de(e){return function(t){return"input"===t.nodeName.toLowerCase()&&t.type===e}}function pe(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function fe(e){return function(t){return"form"in t?t.parentNode&&!1===t.disabled?"label"in t?"label"in t.parentNode?t.parentNode.disabled===e:t.disabled===e:t.isDisabled===e||t.isDisabled!==!e&&ie(t)===e:t.disabled===e:"label"in t&&t.disabled===e}}function he(e){return se(function(t){return t=+t,se(function(n,r){for(var i,o=e([],n.length,t),a=o.length;a--;)n[i=o[a]]&&(n[i]=!(r[i]=n[i]))})})}function me(e){return e&&void 0!==e.getElementsByTagName&&e}n=oe.support={},o=oe.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return!!t&&"HTML"!==t.nodeName},p=oe.setDocument=function(e){var t,i,a=e?e.ownerDocument||e:x;return a!==f&&9===a.nodeType&&a.documentElement?(h=(f=a).documentElement,m=!o(f),x!==f&&(i=f.defaultView)&&i.top!==i&&(i.addEventListener?i.addEventListener("unload",re,!1):i.attachEvent&&i.attachEvent("onunload",re)),n.attributes=le(function(e){return e.className="i",!e.getAttribute("className")}),n.getElementsByTagName=le(function(e){return e.appendChild(f.createComment("")),!e.getElementsByTagName("*").length}),n.getElementsByClassName=Y.test(f.getElementsByClassName),n.getById=le(function(e){return h.appendChild(e).id=w,!f.getElementsByName||!f.getElementsByName(w).length}),n.getById?(r.filter.ID=function(e){var t=e.replace(K,ee);return function(e){return e.getAttribute("id")===t}},r.find.ID=function(e,t){if(void 0!==t.getElementById&&m){var n=t.getElementById(e);return n?[n]:[]}}):(r.filter.ID=function(e){var t=e.replace(K,ee);return function(e){var n=void 0!==e.getAttributeNode&&e.getAttributeNode("id");return n&&n.value===t}},r.find.ID=function(e,t){if(void 0!==t.getElementById&&m){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];for(i=t.getElementsByName(e),r=0;o=i[r++];)if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),r.find.TAG=n.getElementsByTagName?function(e,t){return void 0!==t.getElementsByTagName?t.getElementsByTagName(e):n.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){for(;n=o[i++];)1===n.nodeType&&r.push(n);return r}return o},r.find.CLASS=n.getElementsByClassName&&function(e,t){if(void 0!==t.getElementsByClassName&&m)return t.getElementsByClassName(e)},b=[],g=[],(n.qsa=Y.test(f.querySelectorAll))&&(le(function(e){h.appendChild(e).innerHTML="
      ",e.querySelectorAll("[msallowcapture^='']").length&&g.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||g.push("\\["+M+"*(?:value|"+P+")"),e.querySelectorAll("[id~="+w+"-]").length||g.push("~="),e.querySelectorAll(":checked").length||g.push(":checked"),e.querySelectorAll("a#"+w+"+*").length||g.push(".#.+[+~]")}),le(function(e){e.innerHTML="";var t=f.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&g.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&g.push(":enabled",":disabled"),h.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&g.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),g.push(",.*:")})),(n.matchesSelector=Y.test(y=h.matches||h.webkitMatchesSelector||h.mozMatchesSelector||h.oMatchesSelector||h.msMatchesSelector))&&le(function(e){n.disconnectedMatch=y.call(e,"*"),y.call(e,"[s!='']:x"),b.push("!=",q)}),g=g.length&&new RegExp(g.join("|")),b=b.length&&new RegExp(b.join("|")),t=Y.test(h.compareDocumentPosition),v=t||Y.test(h.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)for(;t=t.parentNode;)if(t===e)return!0;return!1},S=t?function(e,t){if(e===t)return d=!0,0;var r=!e.compareDocumentPosition-!t.compareDocumentPosition;return r||(1&(r=(e.ownerDocument||e)===(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!n.sortDetached&&t.compareDocumentPosition(e)===r?e===f||e.ownerDocument===x&&v(x,e)?-1:t===f||t.ownerDocument===x&&v(x,t)?1:u?R(u,e)-R(u,t):0:4&r?-1:1)}:function(e,t){if(e===t)return d=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e===f?-1:t===f?1:i?-1:o?1:u?R(u,e)-R(u,t):0;if(i===o)return ue(e,t);for(n=e;n=n.parentNode;)a.unshift(n);for(n=t;n=n.parentNode;)s.unshift(n);for(;a[r]===s[r];)r++;return r?ue(a[r],s[r]):a[r]===x?-1:s[r]===x?1:0},f):f},oe.matches=function(e,t){return oe(e,null,null,t)},oe.matchesSelector=function(e,t){if((e.ownerDocument||e)!==f&&p(e),t=t.replace(F,"='$1']"),n.matchesSelector&&m&&!T[t+" "]&&(!b||!b.test(t))&&(!g||!g.test(t)))try{var r=y.call(e,t);if(r||n.disconnectedMatch||e.document&&11!==e.document.nodeType)return r}catch(e){}return oe(t,f,null,[e]).length>0},oe.contains=function(e,t){return(e.ownerDocument||e)!==f&&p(e),v(e,t)},oe.attr=function(e,t){(e.ownerDocument||e)!==f&&p(e);var i=r.attrHandle[t.toLowerCase()],o=i&&A.call(r.attrHandle,t.toLowerCase())?i(e,t,!m):void 0;return void 0!==o?o:n.attributes||!m?e.getAttribute(t):(o=e.getAttributeNode(t))&&o.specified?o.value:null},oe.escape=function(e){return(e+"").replace(te,ne)},oe.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},oe.uniqueSort=function(e){var t,r=[],i=0,o=0;if(d=!n.detectDuplicates,u=!n.sortStable&&e.slice(0),e.sort(S),d){for(;t=e[o++];)t===e[o]&&(i=r.push(o));for(;i--;)e.splice(r[i],1)}return u=null,e},i=oe.getText=function(e){var t,n="",r=0,o=e.nodeType;if(o){if(1===o||9===o||11===o){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=i(e)}else if(3===o||4===o)return e.nodeValue}else for(;t=e[r++];)n+=i(t);return n},(r=oe.selectors={cacheLength:50,createPseudo:se,match:V,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(K,ee),e[3]=(e[3]||e[4]||e[5]||"").replace(K,ee),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||oe.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&oe.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return V.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&z.test(n)&&(t=a(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(K,ee).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=E[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&E(e,function(e){return t.test("string"==typeof e.className&&e.className||void 0!==e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r){var i=oe.attr(r,e);return null==i?"!="===t:!t||(i+="","="===t?i===n:"!="===t?i!==n:"^="===t?n&&0===i.indexOf(n):"*="===t?n&&i.indexOf(n)>-1:"$="===t?n&&i.slice(-n.length)===n:"~="===t?(" "+i.replace(U," ")+" ").indexOf(n)>-1:"|="===t&&(i===n||i.slice(0,n.length+1)===n+"-"))}},CHILD:function(e,t,n,r,i){var o="nth"!==e.slice(0,3),a="last"!==e.slice(-4),s="of-type"===t;return 1===r&&0===i?function(e){return!!e.parentNode}:function(t,n,l){var c,u,d,p,f,h,m=o!==a?"nextSibling":"previousSibling",g=t.parentNode,b=s&&t.nodeName.toLowerCase(),y=!l&&!s,v=!1;if(g){if(o){for(;m;){for(p=t;p=p[m];)if(s?p.nodeName.toLowerCase()===b:1===p.nodeType)return!1;h=m="only"===e&&!h&&"nextSibling"}return!0}if(h=[a?g.firstChild:g.lastChild],a&&y){for(v=(f=(c=(u=(d=(p=g)[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]||[])[0]===k&&c[1])&&c[2],p=f&&g.childNodes[f];p=++f&&p&&p[m]||(v=f=0)||h.pop();)if(1===p.nodeType&&++v&&p===t){u[e]=[k,f,v];break}}else if(y&&(v=f=(c=(u=(d=(p=t)[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]||[])[0]===k&&c[1]),!1===v)for(;(p=++f&&p&&p[m]||(v=f=0)||h.pop())&&((s?p.nodeName.toLowerCase()!==b:1!==p.nodeType)||!++v||(y&&((u=(d=p[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]=[k,v]),p!==t)););return(v-=i)===r||v%r==0&&v/r>=0}}},PSEUDO:function(e,t){var n,i=r.pseudos[e]||r.setFilters[e.toLowerCase()]||oe.error("unsupported pseudo: "+e);return i[w]?i(t):i.length>1?(n=[e,e,"",t],r.setFilters.hasOwnProperty(e.toLowerCase())?se(function(e,n){for(var r,o=i(e,t),a=o.length;a--;)e[r=R(e,o[a])]=!(n[r]=o[a])}):function(e){return i(e,0,n)}):i}},pseudos:{not:se(function(e){var t=[],n=[],r=s(e.replace(W,"$1"));return r[w]?se(function(e,t,n,i){for(var o,a=r(e,null,i,[]),s=e.length;s--;)(o=a[s])&&(e[s]=!(t[s]=o))}):function(e,i,o){return t[0]=e,r(t,null,o,n),t[0]=null,!n.pop()}}),has:se(function(e){return function(t){return oe(e,t).length>0}}),contains:se(function(e){return e=e.replace(K,ee),function(t){return(t.textContent||t.innerText||i(t)).indexOf(e)>-1}}),lang:se(function(e){return G.test(e||"")||oe.error("unsupported lang: "+e),e=e.replace(K,ee).toLowerCase(),function(t){var n;do{if(n=m?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return(n=n.toLowerCase())===e||0===n.indexOf(e+"-")}while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===h},focus:function(e){return e===f.activeElement&&(!f.hasFocus||f.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:fe(!1),disabled:fe(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!r.pseudos.empty(e)},header:function(e){return Z.test(e.nodeName)},input:function(e){return X.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:he(function(){return[0]}),last:he(function(e,t){return[t-1]}),eq:he(function(e,t,n){return[n<0?n+t:n]}),even:he(function(e,t){for(var n=0;n=0;)e.push(r);return e}),gt:he(function(e,t,n){for(var r=n<0?n+t:n;++r1?function(t,n,r){for(var i=e.length;i--;)if(!e[i](t,n,r))return!1;return!0}:e[0]}function we(e,t,n,r,i){for(var o,a=[],s=0,l=e.length,c=null!=t;s-1&&(o[c]=!(a[c]=d))}}else b=we(b===a?b.splice(h,b.length):b),i?i(null,a,b,l):_.apply(a,b)})}function ke(e){for(var t,n,i,o=e.length,a=r.relative[e[0].type],s=a||r.relative[" "],l=a?1:0,u=ye(function(e){return e===t},s,!0),d=ye(function(e){return R(t,e)>-1},s,!0),p=[function(e,n,r){var i=!a&&(r||n!==c)||((t=n).nodeType?u(e,n,r):d(e,n,r));return t=null,i}];l1&&ve(p),l>1&&be(e.slice(0,l-1).concat({value:" "===e[l-2].type?"*":""})).replace(W,"$1"),n,l0,l=i.length>0,u=function(e,t,n,a,u){var d,h,g,b=0,y="0",v=e&&[],w=[],x=c,C=e||l&&r.find.TAG("*",u),E=k+=null==x?1:Math.random()||.1,$=C.length;for(u&&(c=t===f||t||u);y!==$&&null!=(d=C[y]);y++){if(l&&d){for(h=0,t||d.ownerDocument===f||(p(d),n=!m);g=i[h++];)if(g(d,t||f,n)){a.push(d);break}u&&(k=E)}s&&((d=!g&&d)&&b--,e&&v.push(d))}if(b+=y,s&&y!==b){for(h=0;g=o[h++];)g(v,w,t,n);if(e){if(b>0)for(;y--;)v[y]||w[y]||(w[y]=j.call(a));w=we(w)}_.apply(a,w),u&&!e&&w.length>0&&b+o.length>1&&oe.uniqueSort(a)}return u&&(k=E,c=x),v},s?se(u):u))).selector=e}return g},l=oe.select=function(e,t,n,i){var o,l,c,u,d,p="function"==typeof e&&e,f=!i&&a(e=p.selector||e);if(n=n||[],1===f.length){if((l=f[0]=f[0].slice(0)).length>2&&"ID"===(c=l[0]).type&&9===t.nodeType&&m&&r.relative[l[1].type]){if(!(t=(r.find.ID(c.matches[0].replace(K,ee),t)||[])[0]))return n;p&&(t=t.parentNode),e=e.slice(l.shift().value.length)}for(o=V.needsContext.test(e)?0:l.length;o--&&(c=l[o],!r.relative[u=c.type]);)if((d=r.find[u])&&(i=d(c.matches[0].replace(K,ee),J.test(l[0].type)&&me(t.parentNode)||t))){if(l.splice(o,1),!(e=i.length&&be(l)))return _.apply(n,i),n;break}}return(p||s(e,f))(i,t,!m,n,!t||J.test(e)&&me(t.parentNode)||t),n},n.sortStable=w.split("").sort(S).join("")===w,n.detectDuplicates=!!d,p(),n.sortDetached=le(function(e){return 1&e.compareDocumentPosition(f.createElement("fieldset"))}),le(function(e){return e.innerHTML="","#"===e.firstChild.getAttribute("href")})||ce("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),n.attributes&&le(function(e){return e.innerHTML="",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||ce("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),le(function(e){return null==e.getAttribute("disabled")})||ce(P,function(e,t,n){var r;if(!n)return!0===e[t]?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),oe}(e);x.find=E,x.expr=E.selectors,x.expr[":"]=x.expr.pseudos,x.uniqueSort=x.unique=E.uniqueSort,x.text=E.getText,x.isXMLDoc=E.isXML,x.contains=E.contains,x.escapeSelector=E.escape;var $=function(e,t,n){for(var r=[],i=void 0!==n;(e=e[t])&&9!==e.nodeType;)if(1===e.nodeType){if(i&&x(e).is(n))break;r.push(e)}return r},T=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},S=x.expr.match.needsContext;function A(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var L=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,t,n){return m(t)?x.grep(e,function(e,r){return!!t.call(e,r,e)!==n}):t.nodeType?x.grep(e,function(e){return e===t!==n}):"string"!=typeof t?x.grep(e,function(e){return l.call(t,e)>-1!==n}):x.filter(t,e,n)}x.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?x.find.matchesSelector(r,e)?[r]:[]:x.find.matches(e,x.grep(t,function(e){return 1===e.nodeType}))},x.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(x(e).filter(function(){for(t=0;t1?x.uniqueSort(n):n},filter:function(e){return this.pushStack(j(this,e||[],!1))},not:function(e){return this.pushStack(j(this,e||[],!0))},is:function(e){return!!j(this,"string"==typeof e&&S.test(e)?x(e):e||[],!1).length}});var D,_=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/;(x.fn.init=function(e,t,n){var i,o;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(i="<"===e[0]&&">"===e[e.length-1]&&e.length>=3?[null,e,null]:_.exec(e))||!i[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(i[1]){if(t=t instanceof x?t[0]:t,x.merge(this,x.parseHTML(i[1],t&&t.nodeType?t.ownerDocument||t:r,!0)),L.test(i[1])&&x.isPlainObject(t))for(i in t)m(this[i])?this[i](t[i]):this.attr(i,t[i]);return this}return(o=r.getElementById(i[2]))&&(this[0]=o,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(x):x.makeArray(e,this)}).prototype=x.fn,D=x(r);var N=/^(?:parents|prev(?:Until|All))/,R={children:!0,contents:!0,next:!0,prev:!0};function P(e,t){for(;(e=e[t])&&1!==e.nodeType;);return e}x.fn.extend({has:function(e){var t=x(e,this),n=t.length;return this.filter(function(){for(var e=0;e-1:1===n.nodeType&&x.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(o.length>1?x.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?l.call(x(e),this[0]):l.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(x.uniqueSort(x.merge(this.get(),x(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),x.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return $(e,"parentNode")},parentsUntil:function(e,t,n){return $(e,"parentNode",n)},next:function(e){return P(e,"nextSibling")},prev:function(e){return P(e,"previousSibling")},nextAll:function(e){return $(e,"nextSibling")},prevAll:function(e){return $(e,"previousSibling")},nextUntil:function(e,t,n){return $(e,"nextSibling",n)},prevUntil:function(e,t,n){return $(e,"previousSibling",n)},siblings:function(e){return T((e.parentNode||{}).firstChild,e)},children:function(e){return T(e.firstChild)},contents:function(e){return A(e,"iframe")?e.contentDocument:(A(e,"template")&&(e=e.content||e),x.merge([],e.childNodes))}},function(e,t){x.fn[e]=function(n,r){var i=x.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(i=x.filter(r,i)),this.length>1&&(R[e]||x.uniqueSort(i),N.test(e)&&i.reverse()),this.pushStack(i)}});var M=/[^\x20\t\r\n\f]+/g;function O(e){return e}function I(e){throw e}function q(e,t,n,r){var i;try{e&&m(i=e.promise)?i.call(e).done(t).fail(n):e&&m(i=e.then)?i.call(e,t,n):t.apply(void 0,[e].slice(r))}catch(e){n.apply(void 0,[e])}}x.Callbacks=function(e){var t,n;e="string"==typeof e?(t=e,n={},x.each(t.match(M)||[],function(e,t){n[t]=!0}),n):x.extend({},e);var r,i,o,a,s=[],l=[],c=-1,u=function(){for(a=a||e.once,o=r=!0;l.length;c=-1)for(i=l.shift();++c-1;)s.splice(n,1),n<=c&&c--}),this},has:function(e){return e?x.inArray(e,s)>-1:s.length>0},empty:function(){return s&&(s=[]),this},disable:function(){return a=l=[],s=i="",this},disabled:function(){return!s},lock:function(){return a=l=[],i||r||(s=i=""),this},locked:function(){return!!a},fireWith:function(e,t){return a||(t=[e,(t=t||[]).slice?t.slice():t],l.push(t),r||u()),this},fire:function(){return d.fireWith(this,arguments),this},fired:function(){return!!o}};return d},x.extend({Deferred:function(t){var n=[["notify","progress",x.Callbacks("memory"),x.Callbacks("memory"),2],["resolve","done",x.Callbacks("once memory"),x.Callbacks("once memory"),0,"resolved"],["reject","fail",x.Callbacks("once memory"),x.Callbacks("once memory"),1,"rejected"]],r="pending",i={state:function(){return r},always:function(){return o.done(arguments).fail(arguments),this},catch:function(e){return i.then(null,e)},pipe:function(){var e=arguments;return x.Deferred(function(t){x.each(n,function(n,r){var i=m(e[r[4]])&&e[r[4]];o[r[1]](function(){var e=i&&i.apply(this,arguments);e&&m(e.promise)?e.promise().progress(t.notify).done(t.resolve).fail(t.reject):t[r[0]+"With"](this,i?[e]:arguments)})}),e=null}).promise()},then:function(t,r,i){var o=0;function a(t,n,r,i){return function(){var s=this,l=arguments,c=function(){var e,c;if(!(t=o&&(r!==I&&(s=void 0,l=[e]),n.rejectWith(s,l))}};t?u():(x.Deferred.getStackHook&&(u.stackTrace=x.Deferred.getStackHook()),e.setTimeout(u))}}return x.Deferred(function(e){n[0][3].add(a(0,e,m(i)?i:O,e.notifyWith)),n[1][3].add(a(0,e,m(t)?t:O)),n[2][3].add(a(0,e,m(r)?r:I))}).promise()},promise:function(e){return null!=e?x.extend(e,i):i}},o={};return x.each(n,function(e,t){var a=t[2],s=t[5];i[t[1]]=a.add,s&&a.add(function(){r=s},n[3-e][2].disable,n[3-e][3].disable,n[0][2].lock,n[0][3].lock),a.add(t[3].fire),o[t[0]]=function(){return o[t[0]+"With"](this===o?void 0:this,arguments),this},o[t[0]+"With"]=a.fireWith}),i.promise(o),t&&t.call(o,o),o},when:function(e){var t=arguments.length,n=t,r=Array(n),i=o.call(arguments),a=x.Deferred(),s=function(e){return function(n){r[e]=this,i[e]=arguments.length>1?o.call(arguments):n,--t||a.resolveWith(r,i)}};if(t<=1&&(q(e,a.done(s(n)).resolve,a.reject,!t),"pending"===a.state()||m(i[n]&&i[n].then)))return a.then();for(;n--;)q(i[n],s(n),a.reject);return a.promise()}});var U=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;x.Deferred.exceptionHook=function(t,n){e.console&&e.console.warn&&t&&U.test(t.name)&&e.console.warn("jQuery.Deferred exception: "+t.message,t.stack,n)},x.readyException=function(t){e.setTimeout(function(){throw t})};var W=x.Deferred();function H(){r.removeEventListener("DOMContentLoaded",H),e.removeEventListener("load",H),x.ready()}x.fn.ready=function(e){return W.then(e).catch(function(e){x.readyException(e)}),this},x.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--x.readyWait:x.isReady)||(x.isReady=!0,!0!==e&&--x.readyWait>0||W.resolveWith(r,[x]))}}),x.ready.then=W.then,"complete"===r.readyState||"loading"!==r.readyState&&!r.documentElement.doScroll?e.setTimeout(x.ready):(r.addEventListener("DOMContentLoaded",H),e.addEventListener("load",H));var B=function(e,t,n,r,i,o,a){var s=0,l=e.length,c=null==n;if("object"===v(n)){i=!0;for(s in n)B(e,t,s,n[s],!0,o,a)}else if(void 0!==r&&(i=!0,m(r)||(a=!0),c&&(a?(t.call(e,r),t=null):(c=t,t=function(e,t,n){return c.call(x(e),n)})),t))for(;s1,null,!0)},removeData:function(e){return this.each(function(){Q.remove(this,e)})}}),x.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Y.get(e,t),n&&(!r||Array.isArray(n)?r=Y.access(e,t,x.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=x.queue(e,t),r=n.length,i=n.shift(),o=x._queueHooks(e,t);"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,function(){x.dequeue(e,t)},o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Y.get(e,n)||Y.access(e,n,{empty:x.Callbacks("once memory").add(function(){Y.remove(e,[t+"queue",n])})})}}),x.fn.extend({queue:function(e,t){var n=2;return"string"!=typeof e&&(t=e,e="fx",n--),arguments.length\x20\t\r\n\f]+)/i,ue=/^$|^module$|\/(?:java|ecma)script/i,de={option:[1,""],thead:[1,"","
      "],col:[2,"","
      "],tr:[2,"","
      "],td:[3,"","
      "],_default:[0,"",""]};function pe(e,t){var n;return n=void 0!==e.getElementsByTagName?e.getElementsByTagName(t||"*"):void 0!==e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&A(e,t)?x.merge([e],n):n}function fe(e,t){for(var n=0,r=e.length;n-1)i&&i.push(o);else if(c=x.contains(o.ownerDocument,o),a=pe(d.appendChild(o),"script"),c&&fe(a),n)for(u=0;o=a[u++];)ue.test(o.type||"")&&n.push(o);return d}he=r.createDocumentFragment().appendChild(r.createElement("div")),(me=r.createElement("input")).setAttribute("type","radio"),me.setAttribute("checked","checked"),me.setAttribute("name","t"),he.appendChild(me),h.checkClone=he.cloneNode(!0).cloneNode(!0).lastChild.checked,he.innerHTML="",h.noCloneChecked=!!he.cloneNode(!0).lastChild.defaultValue;var ye=r.documentElement,ve=/^key/,we=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,xe=/^([^.]*)(?:\.(.+)|)/;function ke(){return!0}function Ce(){return!1}function Ee(){try{return r.activeElement}catch(e){}}function $e(e,t,n,r,i,o){var a,s;if("object"==typeof t){"string"!=typeof n&&(r=r||n,n=void 0);for(s in t)$e(e,s,n,r,t[s],o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=Ce;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return x().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=x.guid++)),e.each(function(){x.event.add(this,t,i,r,n)})}x.event={global:{},add:function(e,t,n,r,i){var o,a,s,l,c,u,d,p,f,h,m,g=Y.get(e);if(g)for(n.handler&&(n=(o=n).handler,i=o.selector),i&&x.find.matchesSelector(ye,i),n.guid||(n.guid=x.guid++),(l=g.events)||(l=g.events={}),(a=g.handle)||(a=g.handle=function(t){return void 0!==x&&x.event.triggered!==t.type?x.event.dispatch.apply(e,arguments):void 0}),c=(t=(t||"").match(M)||[""]).length;c--;)f=m=(s=xe.exec(t[c])||[])[1],h=(s[2]||"").split(".").sort(),f&&(d=x.event.special[f]||{},f=(i?d.delegateType:d.bindType)||f,d=x.event.special[f]||{},u=x.extend({type:f,origType:m,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&x.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=l[f])||((p=l[f]=[]).delegateCount=0,d.setup&&!1!==d.setup.call(e,r,h,a)||e.addEventListener&&e.addEventListener(f,a)),d.add&&(d.add.call(e,u),u.handler.guid||(u.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,u):p.push(u),x.event.global[f]=!0)},remove:function(e,t,n,r,i){var o,a,s,l,c,u,d,p,f,h,m,g=Y.hasData(e)&&Y.get(e);if(g&&(l=g.events)){for(c=(t=(t||"").match(M)||[""]).length;c--;)if(f=m=(s=xe.exec(t[c])||[])[1],h=(s[2]||"").split(".").sort(),f){for(d=x.event.special[f]||{},p=l[f=(r?d.delegateType:d.bindType)||f]||[],s=s[2]&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;o--;)u=p[o],!i&&m!==u.origType||n&&n.guid!==u.guid||s&&!s.test(u.namespace)||r&&r!==u.selector&&("**"!==r||!u.selector)||(p.splice(o,1),u.selector&&p.delegateCount--,d.remove&&d.remove.call(e,u));a&&!p.length&&(d.teardown&&!1!==d.teardown.call(e,h,g.handle)||x.removeEvent(e,f,g.handle),delete l[f])}else for(f in l)x.event.remove(e,f+t[c],n,r,!0);x.isEmptyObject(l)&&Y.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=x.event.fix(e),l=new Array(arguments.length),c=(Y.get(this,"events")||{})[s.type]||[],u=x.event.special[s.type]||{};for(l[0]=s,t=1;t=1))for(;c!==this;c=c.parentNode||this)if(1===c.nodeType&&("click"!==e.type||!0!==c.disabled)){for(o=[],a={},n=0;n-1:x.find(i,this,null,[c]).length),a[i]&&o.push(r);o.length&&s.push({elem:c,handlers:o})}return c=this,l\x20\t\r\n\f]*)[^>]*)\/>/gi,Se=/\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&x(e).children("tbody")[0]||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function _e(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Ne(e,t){var n,r,i,o,a,s,l,c;if(1===t.nodeType){if(Y.hasData(e)&&(o=Y.access(e),a=Y.set(t,o),c=o.events)){delete a.handle,a.events={};for(i in c)for(n=0,r=c[i].length;n1&&"string"==typeof g&&!h.checkClone&&Ae.test(g))return e.each(function(i){var o=e.eq(i);b&&(t[0]=g.call(this,i,o.html())),Re(o,t,n,r)});if(p&&(o=(i=be(t,e[0].ownerDocument,!1,e,r)).firstChild,1===i.childNodes.length&&(i=o),o||r)){for(l=(s=x.map(pe(i,"script"),De)).length;d")},clone:function(e,t,n){var r,i,o,a,s,l,c,u=e.cloneNode(!0),d=x.contains(e.ownerDocument,e);if(!(h.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||x.isXMLDoc(e)))for(a=pe(u),r=0,i=(o=pe(e)).length;r0&&fe(a,!d&&pe(e,"script")),u},cleanData:function(e){for(var t,n,r,i=x.event.special,o=0;void 0!==(n=e[o]);o++)if(X(n)){if(t=n[Y.expando]){if(t.events)for(r in t.events)i[r]?x.event.remove(n,r):x.removeEvent(n,r,t.handle);n[Y.expando]=void 0}n[Q.expando]&&(n[Q.expando]=void 0)}}}),x.fn.extend({detach:function(e){return Pe(this,e,!0)},remove:function(e){return Pe(this,e)},text:function(e){return B(this,function(e){return void 0===e?x.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return Re(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||je(this,e).appendChild(e)})},prepend:function(){return Re(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=je(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(x.cleanData(pe(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return x.clone(this,e,t)})},html:function(e){return B(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!Se.test(e)&&!de[(ce.exec(e)||["",""])[1].toLowerCase()]){e=x.htmlPrefilter(e);try{for(;n=0&&(l+=Math.max(0,Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-o-l-s-.5))),l}function Je(e,t,n){var r=Oe(e),i=qe(e,t,r),o="border-box"===x.css(e,"boxSizing",!1,r),a=o;if(Me.test(i)){if(!n)return i;i="auto"}return a=a&&(h.boxSizingReliable()||i===e.style[t]),("auto"===i||!parseFloat(i)&&"inline"===x.css(e,"display",!1,r))&&(i=e["offset"+t[0].toUpperCase()+t.slice(1)],a=!0),(i=parseFloat(i)||0)+Qe(e,t,n||(o?"border":"content"),a,r,i)+"px"}x.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=qe(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=V(t),l=Fe.test(t),c=e.style;if(l||(t=Ze(s)),a=x.cssHooks[t]||x.cssHooks[s],void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:c[t];"string"===(o=typeof n)&&(i=ne.exec(n))&&i[1]&&(n=function(e,t,n,r){var i,o,a=20,s=r?function(){return r.cur()}:function(){return x.css(e,t,"")},l=s(),c=n&&n[3]||(x.cssNumber[t]?"":"px"),u=(x.cssNumber[t]||"px"!==c&&+l)&&ne.exec(x.css(e,t));if(u&&u[3]!==c){for(l/=2,c=c||u[3],u=+l||1;a--;)x.style(e,t,u+c),(1-o)*(1-(o=s()/l||.5))<=0&&(a=0),u/=o;u*=2,x.style(e,t,u+c),n=n||[]}return n&&(u=+u||+l||0,i=n[1]?u+(n[1]+1)*n[2]:+n[2],r&&(r.unit=c,r.start=u,r.end=i)),i}(e,t,i),o="number"),null!=n&&n==n&&("number"===o&&(n+=i&&i[3]||(x.cssNumber[s]?"":"px")),h.clearCloneStyle||""!==n||0!==t.indexOf("background")||(c[t]="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(l?c.setProperty(t,n):c[t]=n))}},css:function(e,t,n,r){var i,o,a,s=V(t);return Fe.test(t)||(t=Ze(s)),(a=x.cssHooks[t]||x.cssHooks[s])&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=qe(e,t,r)),"normal"===i&&t in Ge&&(i=Ge[t]),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),x.each(["height","width"],function(e,t){x.cssHooks[t]={get:function(e,n,r){if(n)return!Be.test(x.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?Je(e,t,r):oe(e,ze,function(){return Je(e,t,r)})},set:function(e,n,r){var i,o=Oe(e),a="border-box"===x.css(e,"boxSizing",!1,o),s=r&&Qe(e,t,r,a,o);return a&&h.scrollboxSize()===o.position&&(s-=Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-parseFloat(o[t])-Qe(e,t,"border",!1,o)-.5)),s&&(i=ne.exec(n))&&"px"!==(i[3]||"px")&&(e.style[t]=n,n=x.css(e,t)),Ye(0,n,s)}}}),x.cssHooks.marginLeft=Ue(h.reliableMarginLeft,function(e,t){if(t)return(parseFloat(qe(e,"marginLeft"))||e.getBoundingClientRect().left-oe(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),x.each({margin:"",padding:"",border:"Width"},function(e,t){x.cssHooks[e+t]={expand:function(n){for(var r=0,i={},o="string"==typeof n?n.split(" "):[n];r<4;r++)i[e+re[r]+t]=o[r]||o[r-2]||o[0];return i}},"margin"!==e&&(x.cssHooks[e+t].set=Ye)}),x.fn.extend({css:function(e,t){return B(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=Oe(e),i=t.length;a1)}}),x.fn.delay=function(t,n){return t=x.fx&&x.fx.speeds[t]||t,n=n||"fx",this.queue(n,function(n,r){var i=e.setTimeout(n,t);r.stop=function(){e.clearTimeout(i)}})},We=r.createElement("input"),He=r.createElement("select").appendChild(r.createElement("option")),We.type="checkbox",h.checkOn=""!==We.value,h.optSelected=He.selected,(We=r.createElement("input")).value="t",We.type="radio",h.radioValue="t"===We.value;var Ke,et=x.expr.attrHandle;x.fn.extend({attr:function(e,t){return B(this,x.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){x.removeAttr(this,e)})}}),x.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return void 0===e.getAttribute?x.prop(e,t,n):(1===o&&x.isXMLDoc(e)||(i=x.attrHooks[t.toLowerCase()]||(x.expr.match.bool.test(t)?Ke:void 0)),void 0!==n?null===n?void x.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=x.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!h.radioValue&&"radio"===t&&A(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(M);if(i&&1===e.nodeType)for(;n=i[r++];)e.removeAttribute(n)}}),Ke={set:function(e,t,n){return!1===t?x.removeAttr(e,n):e.setAttribute(n,n),n}},x.each(x.expr.match.bool.source.match(/\w+/g),function(e,t){var n=et[t]||x.find.attr;et[t]=function(e,t,r){var i,o,a=t.toLowerCase();return r||(o=et[a],et[a]=i,i=null!=n(e,t,r)?a:null,et[a]=o),i}});var tt=/^(?:input|select|textarea|button)$/i,nt=/^(?:a|area)$/i;function rt(e){return(e.match(M)||[]).join(" ")}function it(e){return e.getAttribute&&e.getAttribute("class")||""}function ot(e){return Array.isArray(e)?e:"string"==typeof e&&e.match(M)||[]}x.fn.extend({prop:function(e,t){return B(this,x.prop,e,t,arguments.length>1)},removeProp:function(e){return this.each(function(){delete this[x.propFix[e]||e]})}}),x.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&x.isXMLDoc(e)||(t=x.propFix[t]||t,i=x.propHooks[t]),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=x.find.attr(e,"tabindex");return t?parseInt(t,10):tt.test(e.nodeName)||nt.test(e.nodeName)&&e.href?0:-1}}},propFix:{for:"htmlFor",class:"className"}}),h.optSelected||(x.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),x.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){x.propFix[this.toLowerCase()]=this}),x.fn.extend({addClass:function(e){var t,n,r,i,o,a,s,l=0;if(m(e))return this.each(function(t){x(this).addClass(e.call(this,t,it(this)))});if((t=ot(e)).length)for(;n=this[l++];)if(i=it(n),r=1===n.nodeType&&" "+rt(i)+" "){for(a=0;o=t[a++];)r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=rt(r))&&n.setAttribute("class",s)}return this},removeClass:function(e){var t,n,r,i,o,a,s,l=0;if(m(e))return this.each(function(t){x(this).removeClass(e.call(this,t,it(this)))});if(!arguments.length)return this.attr("class","");if((t=ot(e)).length)for(;n=this[l++];)if(i=it(n),r=1===n.nodeType&&" "+rt(i)+" "){for(a=0;o=t[a++];)for(;r.indexOf(" "+o+" ")>-1;)r=r.replace(" "+o+" "," ");i!==(s=rt(r))&&n.setAttribute("class",s)}return this},toggleClass:function(e,t){var n=typeof e,r="string"===n||Array.isArray(e);return"boolean"==typeof t&&r?t?this.addClass(e):this.removeClass(e):m(e)?this.each(function(n){x(this).toggleClass(e.call(this,n,it(this),t),t)}):this.each(function(){var t,i,o,a;if(r)for(i=0,o=x(this),a=ot(e);t=a[i++];)o.hasClass(t)?o.removeClass(t):o.addClass(t);else void 0!==e&&"boolean"!==n||((t=it(this))&&Y.set(this,"__className__",t),this.setAttribute&&this.setAttribute("class",t||!1===e?"":Y.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;for(t=" "+e+" ";n=this[r++];)if(1===n.nodeType&&(" "+rt(it(n))+" ").indexOf(t)>-1)return!0;return!1}});var at=/\r/g;x.fn.extend({val:function(e){var t,n,r,i=this[0];return arguments.length?(r=m(e),this.each(function(n){var i;1===this.nodeType&&(null==(i=r?e.call(this,n,x(this).val()):e)?i="":"number"==typeof i?i+="":Array.isArray(i)&&(i=x.map(i,function(e){return null==e?"":e+""})),(t=x.valHooks[this.type]||x.valHooks[this.nodeName.toLowerCase()])&&"set"in t&&void 0!==t.set(this,i,"value")||(this.value=i))})):i?(t=x.valHooks[i.type]||x.valHooks[i.nodeName.toLowerCase()])&&"get"in t&&void 0!==(n=t.get(i,"value"))?n:"string"==typeof(n=i.value)?n.replace(at,""):null==n?"":n:void 0}}),x.extend({valHooks:{option:{get:function(e){var t=x.find.attr(e,"value");return null!=t?t:rt(x.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:[],l=a?o+1:i.length;for(r=o<0?l:a?o:0;r-1)&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),x.each(["radio","checkbox"],function(){x.valHooks[this]={set:function(e,t){if(Array.isArray(t))return e.checked=x.inArray(x(e).val(),t)>-1}},h.checkOn||(x.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})}),h.focusin="onfocusin"in e;var st=/^(?:focusinfocus|focusoutblur)$/,lt=function(e){e.stopPropagation()};x.extend(x.event,{trigger:function(t,n,i,o){var a,s,l,c,u,p,f,h,b=[i||r],y=d.call(t,"type")?t.type:t,v=d.call(t,"namespace")?t.namespace.split("."):[];if(s=h=l=i=i||r,3!==i.nodeType&&8!==i.nodeType&&!st.test(y+x.event.triggered)&&(y.indexOf(".")>-1&&(y=(v=y.split(".")).shift(),v.sort()),u=y.indexOf(":")<0&&"on"+y,(t=t[x.expando]?t:new x.Event(y,"object"==typeof t&&t)).isTrigger=o?2:3,t.namespace=v.join("."),t.rnamespace=t.namespace?new RegExp("(^|\\.)"+v.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,t.result=void 0,t.target||(t.target=i),n=null==n?[t]:x.makeArray(n,[t]),f=x.event.special[y]||{},o||!f.trigger||!1!==f.trigger.apply(i,n))){if(!o&&!f.noBubble&&!g(i)){for(c=f.delegateType||y,st.test(c+y)||(s=s.parentNode);s;s=s.parentNode)b.push(s),l=s;l===(i.ownerDocument||r)&&b.push(l.defaultView||l.parentWindow||e)}for(a=0;(s=b[a++])&&!t.isPropagationStopped();)h=s,t.type=a>1?c:f.bindType||y,(p=(Y.get(s,"events")||{})[t.type]&&Y.get(s,"handle"))&&p.apply(s,n),(p=u&&s[u])&&p.apply&&X(s)&&(t.result=p.apply(s,n),!1===t.result&&t.preventDefault());return t.type=y,o||t.isDefaultPrevented()||f._default&&!1!==f._default.apply(b.pop(),n)||!X(i)||u&&m(i[y])&&!g(i)&&((l=i[u])&&(i[u]=null),x.event.triggered=y,t.isPropagationStopped()&&h.addEventListener(y,lt),i[y](),t.isPropagationStopped()&&h.removeEventListener(y,lt),x.event.triggered=void 0,l&&(i[u]=l)),t.result}},simulate:function(e,t,n){var r=x.extend(new x.Event,n,{type:e,isSimulated:!0});x.event.trigger(r,null,t)}}),x.fn.extend({trigger:function(e,t){return this.each(function(){x.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return x.event.trigger(e,t,n,!0)}}),h.focusin||x.each({focus:"focusin",blur:"focusout"},function(e,t){var n=function(e){x.event.simulate(t,e.target,x.event.fix(e))};x.event.special[t]={setup:function(){var r=this.ownerDocument||this,i=Y.access(r,t);i||r.addEventListener(e,n,!0),Y.access(r,t,(i||0)+1)},teardown:function(){var r=this.ownerDocument||this,i=Y.access(r,t)-1;i?Y.access(r,t,i):(r.removeEventListener(e,n,!0),Y.remove(r,t))}}});var ct,ut=/\[\]$/,dt=/\r?\n/g,pt=/^(?:submit|button|image|reset|file)$/i,ft=/^(?:input|select|textarea|keygen)/i;function ht(e,t,n,r){var i;if(Array.isArray(t))x.each(t,function(t,i){n||ut.test(e)?r(e,i):ht(e+"["+("object"==typeof i&&null!=i?t:"")+"]",i,n,r)});else if(n||"object"!==v(t))r(e,t);else for(i in t)ht(e+"["+i+"]",t[i],n,r)}x.param=function(e,t){var n,r=[],i=function(e,t){var n=m(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(Array.isArray(e)||e.jquery&&!x.isPlainObject(e))x.each(e,function(){i(this.name,this.value)});else for(n in e)ht(n,e[n],t,i);return r.join("&")},x.fn.extend({serialize:function(){return x.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=x.prop(this,"elements");return e?x.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!x(this).is(":disabled")&&ft.test(this.nodeName)&&!pt.test(e)&&(this.checked||!le.test(e))}).map(function(e,t){var n=x(this).val();return null==n?null:Array.isArray(n)?x.map(n,function(e){return{name:t.name,value:e.replace(dt,"\r\n")}}):{name:t.name,value:n.replace(dt,"\r\n")}}).get()}}),x.fn.extend({wrapAll:function(e){var t;return this[0]&&(m(e)&&(e=e.call(this[0])),t=x(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){for(var e=this;e.firstElementChild;)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(e){return m(e)?this.each(function(t){x(this).wrapInner(e.call(this,t))}):this.each(function(){var t=x(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=m(e);return this.each(function(n){x(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(e){return this.parent(e).not("body").each(function(){x(this).replaceWith(this.childNodes)}),this}}),x.expr.pseudos.hidden=function(e){return!x.expr.pseudos.visible(e)},x.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},h.createHTMLDocument=((ct=r.implementation.createHTMLDocument("").body).innerHTML="
      ",2===ct.childNodes.length),x.parseHTML=function(e,t,n){return"string"!=typeof e?[]:("boolean"==typeof t&&(n=t,t=!1),t||(h.createHTMLDocument?((i=(t=r.implementation.createHTMLDocument("")).createElement("base")).href=r.location.href,t.head.appendChild(i)):t=r),o=L.exec(e),a=!n&&[],o?[t.createElement(o[1])]:(o=be([e],t,a),a&&a.length&&x(a).remove(),x.merge([],o.childNodes)));var i,o,a},x.offset={setOffset:function(e,t,n){var r,i,o,a,s,l,c=x.css(e,"position"),u=x(e),d={};"static"===c&&(e.style.position="relative"),s=u.offset(),o=x.css(e,"top"),l=x.css(e,"left"),("absolute"===c||"fixed"===c)&&(o+l).indexOf("auto")>-1?(a=(r=u.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(l)||0),m(t)&&(t=t.call(e,n,x.extend({},s))),null!=t.top&&(d.top=t.top-s.top+a),null!=t.left&&(d.left=t.left-s.left+i),"using"in t?t.using.call(e,d):u.css(d)}},x.fn.extend({offset:function(e){if(arguments.length)return void 0===e?this:this.each(function(t){x.offset.setOffset(this,e,t)});var t,n,r=this[0];return r?r.getClientRects().length?(t=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:t.top+n.pageYOffset,left:t.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this[0]){var e,t,n,r=this[0],i={top:0,left:0};if("fixed"===x.css(r,"position"))t=r.getBoundingClientRect();else{for(t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;e&&(e===n.body||e===n.documentElement)&&"static"===x.css(e,"position");)e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=x(e).offset()).top+=x.css(e,"borderTopWidth",!0),i.left+=x.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-x.css(r,"marginTop",!0),left:t.left-i.left-x.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){for(var e=this.offsetParent;e&&"static"===x.css(e,"position");)e=e.offsetParent;return e||ye})}}),x.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,t){var n="pageYOffset"===t;x.fn[e]=function(r){return B(this,function(e,r,i){var o;if(g(e)?o=e:9===e.nodeType&&(o=e.defaultView),void 0===i)return o?o[t]:e[r];o?o.scrollTo(n?o.pageXOffset:i,n?i:o.pageYOffset):e[r]=i},e,r,arguments.length)}}),x.each(["top","left"],function(e,t){x.cssHooks[t]=Ue(h.pixelPosition,function(e,n){if(n)return n=qe(e,t),Me.test(n)?x(e).position()[t]+"px":n})}),x.each({Height:"height",Width:"width"},function(e,t){x.each({padding:"inner"+e,content:t,"":"outer"+e},function(n,r){x.fn[r]=function(i,o){var a=arguments.length&&(n||"boolean"!=typeof i),s=n||(!0===i||!0===o?"margin":"border");return B(this,function(t,n,i){var o;return g(t)?0===r.indexOf("outer")?t["inner"+e]:t.document.documentElement["client"+e]:9===t.nodeType?(o=t.documentElement,Math.max(t.body["scroll"+e],o["scroll"+e],t.body["offset"+e],o["offset"+e],o["client"+e])):void 0===i?x.css(t,n,s):x.style(t,n,i,s)},t,a?i:void 0,a)}})}),x.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,t){x.fn[t]=function(e,n){return arguments.length>0?this.on(t,null,e,n):this.trigger(t)}}),x.fn.extend({hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),x.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)}}),x.proxy=function(e,t){var n,r,i;if("string"==typeof t&&(n=e[t],t=e,e=n),m(e))return r=o.call(arguments,2),(i=function(){return e.apply(t||this,r.concat(o.call(arguments)))}).guid=e.guid=e.guid||x.guid++,i},x.holdReady=function(e){e?x.readyWait++:x.ready(!0)},x.isArray=Array.isArray,x.parseJSON=JSON.parse,x.nodeName=A,x.isFunction=m,x.isWindow=g,x.camelCase=V,x.type=v,x.now=Date.now,x.isNumeric=function(e){var t=x.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},"function"==typeof define&&define.amd&&define("jquery",[],function(){return x});var mt=e.jQuery,gt=e.$;return x.noConflict=function(t){return e.$===x&&(e.$=gt),t&&e.jQuery===x&&(e.jQuery=mt),x},t||(e.jQuery=e.$=x),x},"object"==typeof module&&"object"==typeof module.exports?module.exports=t0.document?u0(t0,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return u0(e)}:u0(t0),define("deps/jquery",function(){}),define("core/jquery-enhanced",["exports","core/pubsubhub","core/utils","deps/jquery"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/jquery-enhanced";window.$=$,window.$.fn.renameElement=function(e){var n=[];return this.each(function(){for(var r=$(this.ownerDocument.createElement(e)),i=0,o=this.attributes.length;i""!==e).reduce((e,t)=>e.add(t),new Set)]},window.$.fn.linkTargets=function(){var e=this[0].closest("[data-link-for]"),t=e?e.dataset.linkFor.toLowerCase():"",n=this.getDfnTitles(),r=[];for(const e of n){r.push({for:t,title:e});const n=e.split(".");2===n.length&&r.push({for:n[0],title:n[1]}),r.push({for:"",title:e})}return r},window.$.fn.makeID=function(e="",t="",n=!1){const r=this[0];if(r.id)return r.id;t||(t=(r.title?r.title:r.textContent).trim());var i=n?t:t.toLowerCase();if((i=i.replace(/[\W]+/gim,"-").replace(/^-+/,"").replace(/-+$/,""))?!/\.$/.test(i)&&/^[a-z]/i.test(i)||(i="x"+i):i="generatedID",e&&(i=`${e}-${i}`),r.ownerDocument.getElementById(i)){let e=0,t=i+"-"+e;for(;r.ownerDocument.getElementById(t);)t=i+"-"+e++;i=t}return r.id=i,i},window.$.fn.allTextNodes=function(e){for(var t=[],n={},r=0,i=e.length;r(e.setAttribute("aria-"+t,n),e),e)}l.id="respec-ui-styles",l.textContent=a.default,l.classList.add("removeOnSave"),document.head.appendChild(l);const u=$(""),d=$("");var p,f;const h=[],m=[],g={};(0,n.sub)("start-all",()=>{document.body.insertAdjacentElement("afterbegin",u[0])},{once:!0}),(0,n.sub)("end-all",()=>{document.body.insertAdjacentElement("afterbegin",u[0])},{once:!0});const b=$("");b.click(function(e){e.stopPropagation(),d[0].hidden?(d[0].classList.remove("respec-hidden"),d[0].classList.add("respec-visible")):(d[0].classList.add("respec-hidden"),d[0].classList.remove("respec-visible")),this.setAttribute("aria-expanded",String(d[0].hidden)),d[0].hidden=!d[0].hidden}).appendTo(u),document.documentElement.addEventListener("click",function(){d[0].hidden||(d[0].classList.remove("respec-visible"),d[0].classList.add("respec-hidden"),d[0].hidden=!0)}),d.appendTo(u);const y=new Map([["controls","respec-menu"],["expanded","false"],["haspopup","true"],["label","ReSpec Menu"]]);function v(e,t,n,r){if(t.push(e),g.hasOwnProperty(n))return void g[n].text(t.length);g[n]=$("").appendTo(u).click(function(){this.setAttribute("aria-expanded","true");for(var e=$("
        "),o=0,a=t.length;o
        ").appendTo(e).find("span").text("["+s.name+"] "+s.message).end().find("a").css({fontSize:"1.1em",color:"#999",cursor:"pointer"}).click(function(){var e=$(this),t=e.text(),n=e.parent().find("pre");"⊞"===t?(e.text("⊟"),n.show()):(e.text("⊞"),n.hide())}).end().find("pre").text(s.stack).css({marginLeft:"0",maxWidth:"100%",overflowY:"hidden",overflowX:"scroll"}).hide().end();else{const t=document.createElement("tmp");t.innerHTML=(0,i.markdownToHtml)(s);const n=document.createElement("li");if(t.firstElementChild===t.lastElementChild)for(;t.firstElementChild&&t.firstElementChild.hasChildNodes();)n.appendChild(t.firstElementChild.firstChild);else n.innerHTML=t.innerHTML;e[0].appendChild(n)}}w.freshModal(r,e,this)});const o=new Map([["expanded","false"],["haspopup","true"],["controls","respec-pill-"+n+"-modal"],["label","Document "+r.toLowerCase()]]);c(g[n][0],o)}c(b[0],y);const w=e.ui={show:function(){try{u[0].hidden=!1}catch(e){console.error(e)}},hide:function(){u[0].hidden=!0},enable:function(){b[0].removeAttribute("disabled")},addCommand:function(e,t,n,r){r=r||"";var i=function(){require([t],function(e){e.show()})},a="respec-button-"+e.toLowerCase().replace(/\s+/,"-"),s=$('
      1. ").click(i).appendTo(d);return n&&o.default.add(n,i),s[0].querySelector("button")},error:function(e){v(e,h,"error","Errors")},warning:function(e){v(e,m,"warning","Warnings")},closeModal:function(e){f&&(f[0].classList.remove("respec-show-overlay"),f[0].classList.add("respec-hide-overlay"),f[0].addEventListener("transitionend",()=>{f.remove(),f=null})),e&&e.setAttribute("aria-expanded","false"),p&&(p.remove(),p=null)},freshModal:function(e,t,n){p&&p.remove(),f&&f.remove(),f=$("
        ");const r=n.id+"-modal",i=r+"-heading";(p=$("")).find("h3").text(e),p.find("h3")[0].id=i;const o=new Map([["labelledby",i]]);c(p[0],o),p.find(".inside").append(t),$(document.body).append(f).append(p),f.click(()=>{this.closeModal(n)}),f[0].classList.toggle("respec-show-overlay"),p[0].hidden=!1}};o.default.add("Esc",function(){w.closeModal()}),o.default.add("Ctrl+Alt+Shift+E",function(){g.error&&g.error.click()}),o.default.add("Ctrl+Alt+Shift+W",function(){g.warning&&g.warning.click()}),window.respecUI=w,(0,n.sub)("error",function(e){w.error(e)}),(0,n.sub)("warn",function(e){w.warning(e)})}),define("core/l10n",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e){e.l10n=i[o]||i.en};var t=Object.assign||function(e){for(var t=1;te.add(t),this.rules)}async lint(e,i=window.document){const a=[...r.get(this).rules].map(r=>(async function(e){(await e).map(async e=>{const t=await e,r=n({},o,t),{description:i,help:a,howToFix:s,name:l,occurrences:c,offendingElements:u}=r,d=`${i} ${s} ${a} ("${l}" x ${c})`;return u.forEach(e=>{e.classList.add("respec-offending-element")}),console.warn(`Linter (${l}):`,i,...u),d}).forEach(async e=>{(0,t.pub)("warn",await e)})})(r.lint(e,i)));await a}};e.default=i;const o={name:"unknown",description:"",occurrences:0,howToFix:"",offendingElements:[],help:""}}),define("core/LinterRule",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0});const t=new WeakMap;e.default=class{constructor(e,n){t.set(this,{name:e,lintingFunction:n})}get name(){return t.get(this).name}lint(e={lint:{[this.name]:!1}},n=document){return r=e,i=this.name,!1!==r.hasOwnProperty("lint")&&!1!==r.lint&&r.lint[i]?[].concat(t.get(this).lintingFunction(e,n)):[];var r,i}}}),define("core/linter-rules/no-headingless-sections",["exports","core/LinterRule","../l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=t)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t`.",help:"See developer console."},nl:{description:"Alle secties moeten beginnen met een `h2-6` element.",howToFix:"Voeg een `h2-6` toe aan de conflicterende sectie of gebruik een `
        `.",help:"Zie de developer console."}},l=n.lang in s?n.lang:"en",c=({firstElementChild:e})=>null===e||!1===/^h[1-6]$/.test(e.localName);e.rule=new i.default(a,function(e,t){const n=Array.from(t.querySelectorAll("section")).filter(c);return n.length?o({name:a,offendingElements:n,occurrences:n.length},s[l]):[]})}),define("core/linter-rules/no-http-props",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;te.endsWith("URI")||"prevED"===e).filter(n=>new URL(e[n],t.location.href).href.startsWith("http://")).reduce((e,t)=>e.concat(t),[]);if(!n.length)return[];const r=o({name:a,occurrences:n.length},s[l]);return r.howToFix+=n.map(e=>"`"+e+"`").join(", ")+".",r})}),define("w3c/l10n",["exports","core/l10n"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="w3c/l10n";const n={en:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."},ko:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."},zh:{status_at_publication:"本章节描述了本文档的发布状态。其它更新版本可能会覆盖本文档。W3C的文档列 表和最新版本可通过W3C技术报告索引访问。"},ja:{status_at_publication:"この節には、公開時点でのこの文書の位置づけが記されている。他の文書によって置き換えられる可能性がある。現時点でのW3Cの発行文書とこのテクニカルレポートの最新版は、下記から参照できる。 W3C technical reports index (https://www.w3.org/TR/)"},nl:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."}};Object.keys(n).reduce((e,t)=>(Object.assign(e[t],n[t]),e),t.l10n)}),define("w3c/linter-rules/privsec-section",["exports","core/LinterRule","../l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=t)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t{const t=/(privacy|security)/im.test(e),n=/(considerations)/im.test(e);return t&&n||t}))&&n.push(o({name:a,occurrences:1},s[l])),n})}),define("core/linter-rules/check-punctuation",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t`"${e}"`).join(", ")}.`}},c=t.lang in l?t.lang:"en";e.rule=new i.default(a,function(e,t){const n=new RegExp(`[${s.join("")}\\]]$|^ *$`,"m"),r=[...t.querySelectorAll("p:not(#back-to-top)")].filter(e=>!n.test(e.textContent.trim()));return r.length?o({name:a,offendingElements:r,occurrences:r.length},l[c]):[]})}),define("core/linter-rules/local-refs-exist",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t p:first-child {\n margin-top: 0;\n}\n\n.section dd > p:last-child {\n margin-bottom: 0;\n}\n\n.section dd {\n margin-bottom: 1em;\n}\n\n.section dl.attrs dd,\n.section dl.eldef dd {\n margin-bottom: 0;\n}\n\n#issue-summary > ul,\n.respec-dfn-list {\n column-count: 2;\n}\n\n#issue-summary li,\n.respec-dfn-list li {\n list-style: none;\n}\n\ndetails.respec-tests-details {\n margin-left: 1em;\n display: inline-block;\n vertical-align: top;\n}\n\ndetails.respec-tests-details > * {\n padding-right: 2em;\n}\n\ndetails.respec-tests-details[open] {\n z-index: 999999;\n position: absolute;\n border: thin solid #cad3e2;\n border-radius: .3em;\n background-color: white;\n padding-bottom: .5em;\n}\n\ndetails.respec-tests-details[open] > summary {\n border-bottom: thin solid #cad3e2;\n padding-left: 1em;\n margin-bottom: 1em;\n line-height: 2em;\n}\n\ndetails.respec-tests-details > ul {\n width: 100%;\n margin-top: -0.3em;\n}\n\ndetails.respec-tests-details > li {\n padding-left: 1em;\n}\n\n@media print {\n .removeOnSave {\n display: none;\n }\n}\n'}),define("core/style",["exports","deps/text!core/css/respec2.css"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){e.noReSpecCSS&&i.remove();n()};var n,r=(n=t)&&n.__esModule?n:{default:n};e.name="core/style";const i=document.createElement("style");i.id="respec-mainstyle",i.textContent=r.default,document.head.appendChild(i)}),define("w3c/style",["exports","core/utils","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,i){if(!e.specStatus){const t="`respecConfig.specStatus` missing. Defaulting to 'base'.";e.specStatus="base",(0,n.pub)("warn",t)}let o="W3C-";switch(e.specStatus.toUpperCase()){case"CG-DRAFT":case"CG-FINAL":case"BG-DRAFT":case"BG-FINAL":o=e.specStatus.toLowerCase();break;case"FPWD":case"LC":case"WD-NOTE":case"LC-NOTE":o+="WD";break;case"WG-NOTE":case"FPWD-NOTE":o+="WG-NOTE.css";break;case"UNOFFICIAL":o+="UD";break;case"FINDING":case"FINDING-DRAFT":case"BASE":o="base.css";break;default:o+=e.specStatus}const a=function(e){let t="";switch(e){case null:case!0:t="2016";break;default:e&&!isNaN(e)&&(t=e.toString().trim())}return t}(e.useExperimentalStyles||"2016");a&&!e.noToc&&(0,n.sub)("end-all",function(){!function(e,t){const n=e.createElement("script");n.addEventListener("load",function(){window.location.hash&&(window.location=window.location)},{once:!0}),n.src=`https://www.w3.org/scripts/TR/${t}/fixup.js`,e.body.appendChild(n)}(r,a)},{once:!0});const s=`https://www.w3.org/StyleSheets/TR/${a?a+"/":""}${o}`;(0,t.linkCSS)(r,s),i()};e.name="w3c/style";const r=[{hint:"preconnect",href:"https://www.w3.org"},{hint:"preload",href:"https://www.w3.org/scripts/TR/2016/fixup.js",as:"script"},{hint:"preload",href:"https://www.w3.org/StyleSheets/TR/2016/base.css",as:"style"},{hint:"preload",href:"https://www.w3.org/StyleSheets/TR/2016/logos/W3C",as:"image"}].map(t.createResourceHint).reduce(function(e,t){return e.appendChild(t),e},document.createDocumentFragment());r.appendChild(function(){const e=document.createElement("link");return e.rel="stylesheet",e.href="https://www.w3.org/StyleSheets/TR/2016/base.css",e.classList.add("removeOnSave"),e}()),document.head.querySelector("meta[name=viewport]")||r.insertBefore(function(){const e=document.createElement("meta");return e.name="viewport",e.content=(0,t.toKeyValuePairs)({width:"device-width","initial-scale":"1","shrink-to-fit":"no"}).replace(/\"/g,""),e}(),r.firstChild),document.head.insertBefore(r,document.head.firstChild)}),define("core/github",["exports","core/l10n","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.fetchAll=o,e.fetchIndex=function(e,t){return o(e.replace(/\{[^}]+\}/,""),t)},e.run=async function(e){if(!e.hasOwnProperty("github")||!e.github)return;if("object"==typeof e.github&&!e.github.hasOwnProperty("repoURL")){const e="Config option `[github](https://github.com/w3c/respec/wiki/github)` is missing property `repoURL`.";return void(0,n.pub)("error",e)}let t;try{t=new URL(e.github.repoURL||e.github,"https://github.com")}catch(e){return void(0,n.pub)("error",`\`respecConf.github\` is not a valid URL? (${t})`)}if("https://github.com"!==t.origin){const e=`\`respecConf.github\` must be HTTPS and pointing to GitHub. (${t})`;return void(0,n.pub)("error",e)}const[r,o]=t.pathname.split("/").filter(e=>e);if(!r||!o){const e="`respecConf.github` URL needs a path with, for example, w3c/my-spec";return void(0,n.pub)("error",e)}const a=e.github.branch||"gh-pages",s={edDraftURI:`https://${r.toLowerCase()}.github.io/${o}/`,githubToken:void 0,githubUser:void 0,githubAPI:`https://api.github.com/repos/${r}/${o}`,issueBase:new URL("./issues/",t).href,otherLinks:[],pullBase:new URL("./pulls/",t).href,shortName:o},l={key:e.l10n.participate,data:[{value:`GitHub ${r}/${o}`,href:t},{value:e.l10n.file_a_bug,href:s.issueBase},{value:e.l10n.commit_history,href:new URL(`./commits/${a}`,t.href).href},{value:e.l10n.pull_requests,href:s.pullBase}]},c={branch:a,repoURL:t.href},u=i({},s,e,{github:c});Object.assign(e,u),e.otherLinks.unshift(l)};var r;(r=t)&&r.__esModule;var i=Object.assign||function(e){for(var t=1;t]+)>\s*;\s*rel="next"/))&&u[1]||null);var c,u;return l?o(l,t,n):n}}),define("core/data-include",["exports","core/pubsubhub","core/utils"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,i){const o=Array.from(r.querySelectorAll("[data-include]")).map(async e=>{const r=e.dataset.include;if(!r)return;const i="include-"+String(Math.random()).substr(2);e.dataset.includeId=i;try{const o=await fetch(r),a=await o.text();!function(e,t,r){const i=document.querySelector(`[data-include-id=${t}]`),o=i.ownerDocument,a=(0,n.runTransforms)(e,i.dataset.oninclude,r),s="string"==typeof i.dataset.includeReplace;let l;switch(i.dataset.includeFormat){case"text":s?(l=o.createTextNode(a),i.parentNode.replaceChild(l,i)):i.textContent=a;break;default:if(i.innerHTML=a,s){for(l=o.createDocumentFragment();i.hasChildNodes();)l.append(i.removeChild(i.firstChild));i.parentNode.replaceChild(l,i)}}o.contains(i)&&(c=i,["data-include","data-include-format","data-include-replace","data-include-id","oninclude"].forEach(e=>c.removeAttribute(e)));var c}(a,i,r)}catch(n){const i=`\`data-include\` failed: \`${r}\` (${n.message}). See console for details.`;console.error("data-include failed for element: ",e,n),(0,t.pub)("error",i)}});Promise.all(o).then(i)};e.name="core/data-include"}),define("core/markdown",["exports","core/utils"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){const r=!!t.querySelector("[data-format=markdown]:not(body)"),s="markdown"===e.format;if(!s&&!r)return n();if(!s)return o(t.body).map(e=>{const t=i(e,e.ownerDocument);return{structuredInternals:t,elem:e}}).forEach(({elem:e,structuredInternals:t})=>{if(e.setAttribute("aria-busy","true"),"section"===t.firstElementChild.localName&&"section"===e.localName){const n=t.firstElementChild;for(n.remove();n.hasChildNodes();)e.appendChild(n.firstChild)}else e.innerHTML="";e.appendChild(t),e.setAttribute("aria-busy","false")}),n();const l=t.getElementById("respec-ui");l.remove();const c=t.createElement("html"),u=t.createElement("body");u.innerHTML=t.body.innerHTML,c.appendChild(u),a(c);const d=u.innerHTML.replace(/

        \s*<\/p>/gm,"");u.innerHTML=d,p=u.querySelectorAll(".nolinks a[href]"),Array.from(p).forEach(e=>{const t=e.ownerDocument.createTextNode(e.textContent);e.parentElement.replaceChild(t,e)});var p;var f=i(u,t);u.appendChild(f),u.insertAdjacentElement("afterbegin",l),t.body.parentNode.replaceChild(u,t.body),n()};e.name="core/markdown";function n(e){return n=>{const r=Array.from(n.querySelectorAll(e));return r.reverse().forEach(e=>{e.innerHTML=(0,t.markdownToHtml)(e.innerHTML)}),r}}class r{constructor(e){this.doc=e,this.root=e.createDocumentFragment(),this.stack=[this.root],this.current=this.root}findPosition(e){return parseInt(e.tagName.charAt(1),10)}findParent(e){let t;for(;e>0;)if(e--,t=this.stack[e])return t}findHeader({firstChild:e}){for(;e;){if(/H[1-6]/.test(e.tagName))return e;e=e.nextSibling}return null}addHeader(e){const t=this.doc.createElement("section"),n=this.findPosition(e);t.appendChild(e),this.findParent(n).appendChild(t),this.stack[n]=t,this.stack.length=n+1,this.current=t}addSection(e,t){const n=this.findHeader(e),r=n?this.findPosition(n):1,i=this.findParent(r);n&&e.removeChild(n),e.appendChild(t(e)),n&&e.insertBefore(n,e.firstChild),i.appendChild(e),this.current=i}addElement(e){this.current.appendChild(e)}}function i(e,t){return function e(n){const i=new r(t);for(;n.firstChild;){const t=n.firstChild;if(t.nodeType===Node.ELEMENT_NODE)switch(t.localName){case"h1":case"h2":case"h3":case"h4":case"h5":case"h6":i.addHeader(t);break;case"section":i.addSection(t,e);break;default:i.addElement(t)}else n.removeChild(t)}return i.root}(e)}const o=n("[data-format='markdown']:not(body)"),a=n("[data-format=markdown]:not(body), section, div, address, article, aside, figure, header, main, body")}),Dha=this,Eha=function(){return function(e){var t={};function n(r){if(t[r])return t[r].exports;var i=t[r]={exports:{},id:r,loaded:!1};return e[r].call(i.exports,i,i.exports,n),i.loaded=!0,i.exports}return n.m=e,n.c=t,n.p="",n(0)}([function(e,t,n){var r=n(1).default,i=n(2).default;t.__esModule=!0;var o=r(n(3)),a=i(n(20)),s=i(n(5)),l=r(n(4)),c=r(n(21)),u=i(n(33));function d(){var e=new o.HandlebarsEnvironment;return l.extend(e,o),e.SafeString=a.default,e.Exception=s.default,e.Utils=l,e.escapeExpression=l.escapeExpression,e.VM=c,e.template=function(t){return c.template(t,e)},e}var p=d();p.create=d,u.default(p),p.default=p,t.default=p,e.exports=t.default},function(e,t){t.default=function(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&(t[n]=e[n]);return t.default=e,t},t.__esModule=!0},function(e,t){t.default=function(e){return e&&e.__esModule?e:{default:e}},t.__esModule=!0},function(e,t,n){var r=n(2).default;t.__esModule=!0,t.HandlebarsEnvironment=u;var i=n(4),o=r(n(5)),a=n(9),s=n(17),l=r(n(19));t.VERSION="4.0.11";t.COMPILER_REVISION=7;t.REVISION_CHANGES={1:"<= 1.0.rc.2",2:"== 1.0.0-rc.3",3:"== 1.0.0-rc.4",4:"== 1.x.x",5:"== 2.0.0-alpha.x",6:">= 2.0.0-beta.1",7:">= 4.0.0"};var c="[object Object]";function u(e,t,n){this.helpers=e||{},this.partials=t||{},this.decorators=n||{},a.registerDefaultHelpers(this),s.registerDefaultDecorators(this)}u.prototype={constructor:u,logger:l.default,log:l.default.log,registerHelper:function(e,t){if(i.toString.call(e)===c){if(t)throw new o.default("Arg not supported with multiple helpers");i.extend(this.helpers,e)}else this.helpers[e]=t},unregisterHelper:function(e){delete this.helpers[e]},registerPartial:function(e,t){if(i.toString.call(e)===c)i.extend(this.partials,e);else{if(void 0===t)throw new o.default('Attempting to register a partial called "'+e+'" as undefined');this.partials[e]=t}},unregisterPartial:function(e){delete this.partials[e]},registerDecorator:function(e,t){if(i.toString.call(e)===c){if(t)throw new o.default("Arg not supported with multiple decorators");i.extend(this.decorators,e)}else this.decorators[e]=t},unregisterDecorator:function(e){delete this.decorators[e]}};var d=l.default.log;t.log=d,t.createFrame=i.createFrame,t.logger=l.default},function(e,t){t.__esModule=!0,t.extend=a,t.indexOf=function(e,t){for(var n=0,r=e.length;n":">",'"':""","'":"'","`":"`","=":"="},r=/[&<>"'`=]/g,i=/[&<>"'`=]/;function o(e){return n[e]}function a(e){for(var t=1;t0?(n.ids&&(n.ids=[n.name]),e.helpers.each(t,n)):i(this);if(n.data&&n.ids){var a=r.createFrame(n.data);a.contextPath=r.appendContextPath(n.data.contextPath,n.name),n={data:a}}return o(t,n)})},e.exports=t.default},function(e,t,n){var r=n(2).default;t.__esModule=!0;var i=n(4),o=r(n(5));t.default=function(e){e.registerHelper("each",function(e,t){if(!t)throw new o.default("Must pass iterator to #each");var n=t.fn,r=t.inverse,a=0,s="",l=void 0,c=void 0;function u(t,r,o){l&&(l.key=t,l.index=r,l.first=0===r,l.last=!!o,c&&(l.contextPath=c+t)),s+=n(e[t],{data:l,blockParams:i.blockParams([e[t],t],[c+t,null])})}if(t.data&&t.ids&&(c=i.appendContextPath(t.data.contextPath,t.ids[0])+"."),i.isFunction(e)&&(e=e.call(this)),t.data&&(l=i.createFrame(t.data)),e&&"object"==typeof e)if(i.isArray(e))for(var d=e.length;a=0?t:parseInt(e,10)}return e},log:function(e){if(e=i.lookupLevel(e),"undefined"!=typeof console&&i.lookupLevel(i.level)<=e){var t=i.methodMap[e];console[t]||(t="log");for(var n=arguments.length,r=Array(n>1?n-1:0),o=1;o *:hover > span.permalink { visibility: visible; }\n"},3:function(e,t,n,r,i){return" float: right;\n"},5:function(e,t,n,r,i){return" visibility: hidden;\n"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{};return"/* --- PERMALINKS --- */\n"+(null!=(o=n.if.call(a,null!=t?t.permalinkHide:t,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"\n.permalink {\n width: 1px;\n height: 1px;\n overflow: visible;\n font-size: 10pt;\n font-style: normal;\n vertical-align: middle;\n margin-left: 4px;\n"+(null!=(o=n.if.call(a,null!=t?t.permalinkEdge:t,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+(null!=(o=n.if.call(a,null!=t?t.permalinkHide:t,{name:"if",hash:{},fn:e.program(5,i,0),inverse:e.noop,data:i}))?o:"")+"}\n\n.permalink a, .permalink a:link, .permalink a:visited, .permalink a:hover, .permalink a:focus, .permalink a:active {\n background:transparent !important;\n text-decoration:none;\n font-weight: bold;\n color:#666 !important;\n}\n\n.permalink abbr {\n border:0;\n}\n"},useData:!0}),n["attribute.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression((n.escapeAttributeName||t&&t.escapeAttributeName||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.name:o,{name:"escapeAttributeName",hash:{},data:i}))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:u)?a.call(c,{name:"qualifiers",hash:{},data:i}):a)+"attribute "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["callback.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"callback "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" = "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" ("+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+");"},useData:!0}),n["const.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"const "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+""+l("function"==typeof(a=null!=(a=n.nullable||(null!=t?t.nullable:t))?a:u)?a.call(c,{name:"nullable",hash:{},data:i}):a)+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" = "+l((n.stringifyIdlConst||t&&t.stringifyIdlConst||u).call(c,null!=(o=null!=t?t.obj:t)?o.value:o,{name:"stringifyIdlConst",hash:{},data:i}))+";\n"},useData:!0}),n["dict-member.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" = "+e.escapeExpression((n.stringifyIdlConst||t&&t.stringifyIdlConst||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.default:o,{name:"stringifyIdlConst",hash:{},data:i}))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:u)?a.call(c,{name:"qualifiers",hash:{},data:i}):a)+""+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.typePad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.default:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["dictionary.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" : "+e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.inheritance:o,t))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.partial||(null!=t?t.partial:t))?a:u)?a.call(c,{name:"partial",hash:{},data:i}):a)+"dictionary "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.inheritance:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+"};"},useData:!0}),n["enum-item.html"]=t({1:function(e,t,n,r,i){return","},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression,u="function";return c((n.idn||t&&t.idn||l).call(s,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+'"'+c(typeof(a=null!=(a=n.name||(null!=t?t.name:t))?a:l)===u?a.call(s,{name:"name",hash:{},data:i}):a)+'"'+(null!=(o=n.if.call(s,null!=t?t.needsComma:t,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"\n"},useData:!0}),n["enum.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"enum "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"};"},useData:!0}),n["extended-attribute.html"]=t({1:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return"'+c("function"==typeof(a=null!=(a=n.name||(null!=t?t.name:t))?a:l)?a.call(s,{name:"name",hash:{},data:i}):a)+""+(null!=(o=n.if.call(s,null!=t?t.rhs:t,{name:"if",hash:{},fn:e.program(2,i,0),inverse:e.noop,data:i}))?o:"")+(null!=(o=(n.jsIf||t&&t.jsIf||l).call(s,null!=t?t.arguments:t,{name:"jsIf",hash:{},fn:e.program(5,i,0),inverse:e.noop,data:i}))?o:"")+""},2:function(e,t,n,r,i){var o;return'='+(null!=(o=(n.extAttrRhs||t&&t.extAttrRhs||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=t?t.rhs:t,{name:"extAttrRhs",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+""},3:function(e,t,n,r,i){return e.escapeExpression(e.lambda(t,t))},5:function(e,t,n,r,i){var o;return"("+(null!=(o=(n.joinNonWhitespace||t&&t.joinNonWhitespace||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=t?t.arguments:t,", ",{name:"joinNonWhitespace",hash:{},fn:e.program(6,i,0),inverse:e.noop,data:i}))?o:"")+")"},6:function(e,t,n,r,i){return e.escapeExpression((n.param||t&&t.param||n.helperMissing).call(null!=t?t:e.nullContext||{},t,{name:"param",hash:{},data:i}))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return c((n.idn||t&&t.idn||l).call(s,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"["+(null!=(o=(n.join||t&&t.join||l).call(s,null!=t?t.extAttrs:t,null!=t?t.sep:t,{name:"join",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"]"+c("function"==typeof(a=null!=(a=n.end||(null!=t?t.end:t))?a:l)?a.call(s,{name:"end",hash:{},data:i}):a)},useData:!0}),n["field.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=e.lambda,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+s((n.pads||t&&t.pads||c).call(l,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["implements.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression,c=e.lambda;return""+l((n.extAttr||t&&t.extAttr||s).call(a,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+l(c(null!=(o=null!=t?t.obj:t)?o.target:o,t))+" implements "+l(c(null!=(o=null!=t?t.obj:t)?o.implements:o,t))+";"},useData:!0}),n["includes.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression,c=e.lambda;return""+l((n.extAttr||t&&t.extAttr||s).call(a,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+l(c(null!=(o=null!=t?t.obj:t)?o.target:o,t))+" includes "+l(c(null!=(o=null!=t?t.obj:t)?o.includes:o,t))+";"},useData:!0}),n["interface.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" : "+e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.inheritance:o,t))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing,d="function";return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l(typeof(a=null!=(a=n.partial||(null!=t?t.partial:t))?a:u)===d?a.call(c,{name:"partial",hash:{},data:i}):a)+l(typeof(a=null!=(a=n.callback||(null!=t?t.callback:t))?a:u)===d?a.call(c,{name:"callback",hash:{},data:i}):a)+"interface "+l(typeof(a=null!=(a=n.mixin||(null!=t?t.mixin:t))?a:u)===d?a.call(c,{name:"mixin",hash:{},data:i}):a)+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.inheritance:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o=typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)===d?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"};"},useData:!0}),n["iterable.html"]=t({1:function(e,t,n,r,i){return"iterable"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+s("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:c)?a.call(l,{name:"qualifiers",hash:{},data:i}):a)+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"<"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+">;\n"},useData:!0}),n["line-comment.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression;return""+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"//"+l("function"==typeof(o=null!=(o=n.comment||(null!=t?t.comment:t))?o:s)?o.call(a,{name:"comment",hash:{},data:i}):o)+"\n"},useData:!0}),n["maplike.html"]=t({1:function(e,t,n,r,i){return"maplike"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+s("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:c)?a.call(l,{name:"qualifiers",hash:{},data:i}):a)+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"<"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+">;\n"},useData:!0}),n["method.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l((n.extAttrInline||t&&t.extAttrInline||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttrInline",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.special||(null!=t?t.special:t))?a:u)?a.call(c,{name:"special",hash:{},data:i}):a)+""+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"("+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+");\n"},useData:!0}),n["multiline-comment.html"]=t({1:function(e,t,n,r,i,o,a){var s=e.escapeExpression;return s((n.idn||t&&t.idn||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=a[1]?a[1].indent:a[1],{name:"idn",hash:{},data:i}))+s(e.lambda(t,t))+"\n"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i,o,a){var s,l,c=null!=t?t:e.nullContext||{},u=n.helperMissing,d=e.escapeExpression;return""+d((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"/*"+d("function"==typeof(l=null!=(l=n.firstLine||(null!=t?t.firstLine:t))?l:u)?l.call(c,{name:"firstLine",hash:{},data:i}):l)+"\n"+(null!=(s=n.each.call(c,null!=t?t.innerLine:t,{name:"each",hash:{},fn:e.program(1,i,0,o,a),inverse:e.noop,data:i}))?s:"")+d((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+d("function"==typeof(l=null!=(l=n.lastLine||(null!=t?t.lastLine:t))?l:u)?l.call(c,{name:"lastLine",hash:{},data:i}):l)+"*/\n"},useData:!0,useDepths:!0}),n["param.html"]=t({1:function(e,t,n,r,i){var o;return" = "+e.escapeExpression((n.stringifyIdlConst||t&&t.stringifyIdlConst||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.default:o,{name:"stringifyIdlConst",hash:{},data:i}))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return""+c((n.extAttrInline||t&&t.extAttrInline||l).call(s,null!=t?t.obj:t,{name:"extAttrInline",hash:{},data:i}))+c("function"==typeof(a=null!=(a=n.optional||(null!=t?t.optional:t))?a:l)?a.call(s,{name:"optional",hash:{},data:i}):a)+""+c((n.idlType||t&&t.idlType||l).call(s,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+c("function"==typeof(a=null!=(a=n.variadic||(null!=t?t.variadic:t))?a:l)?a.call(s,{name:"variadic",hash:{},data:i}):a)+" "+c(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))+""+(null!=(o=n.if.call(s,null!=(o=null!=t?t.obj:t)?o.default:o,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""},useData:!0}),n["typedef.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=e.lambda,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return"typedef "+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";"},useData:!0}),n}),define("w3c/templates/cgbg-sotd",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const t=hyperHTML;return t`

        ${e.l10n.sotd}

        +"use strict";var requirejs,require,define;window.respecVersion="21.0.1",function(global,setTimeout){var req,s,head,baseElement,dataMain,src,interactiveScript,currentlyAddingScript,mainScript,subPath,version="2.3.5",commentRegExp=/\/\*[\s\S]*?\*\/|([^:"'=]|^)\/\/.*$/gm,cjsRequireRegExp=/[^.]\s*require\s*\(\s*["']([^'"\s]+)["']\s*\)/g,jsSuffixRegExp=/\.js$/,currDirRegExp=/^\.\//,op=Object.prototype,ostring=op.toString,hasOwn=op.hasOwnProperty,isBrowser=!("undefined"==typeof window||"undefined"==typeof navigator||!window.document),isWebWorker=!isBrowser&&"undefined"!=typeof importScripts,readyRegExp=isBrowser&&"PLAYSTATION 3"===navigator.platform?/^complete$/:/^(complete|loaded)$/,defContextName="_",isOpera="undefined"!=typeof opera&&"[object Opera]"===opera.toString(),contexts={},cfg={},globalDefQueue=[],useInteractive=!1;function commentReplace(e,t){return t||""}function isFunction(e){return"[object Function]"===ostring.call(e)}function isArray(e){return"[object Array]"===ostring.call(e)}function each(e,t){var n;if(e)for(n=0;n-1&&(!e[n]||!t(e[n],n,e));n-=1);}function hasProp(e,t){return hasOwn.call(e,t)}function getOwn(e,t){return hasProp(e,t)&&e[t]}function eachProp(e,t){var n;for(n in e)if(hasProp(e,n)&&t(e[n],n))break}function mixin(e,t,n,r){return t&&eachProp(t,function(t,i){!n&&hasProp(e,i)||(!r||"object"!=typeof t||!t||isArray(t)||isFunction(t)||t instanceof RegExp?e[i]=t:(e[i]||(e[i]={}),mixin(e[i],t,n,r)))}),e}function bind(e,t){return function(){return t.apply(e,arguments)}}function scripts(){return document.getElementsByTagName("script")}function defaultOnError(e){throw e}function getGlobal(e){if(!e)return e;var t=global;return each(e.split("."),function(e){t=t[e]}),t}function makeError(e,t,n,r){var i=new Error(t+"\nhttp://requirejs.org/docs/errors.html#"+e);return i.requireType=e,i.requireModules=r,n&&(i.originalError=n),i}if(void 0===define){if(void 0!==requirejs){if(isFunction(requirejs))return;cfg=requirejs,requirejs=void 0}void 0===require||isFunction(require)||(cfg=require,require=void 0),req=requirejs=function(e,t,n,r){var i,o,a=defContextName;return isArray(e)||"string"==typeof e||(o=e,isArray(t)?(e=t,t=n,n=r):e=[]),o&&o.context&&(a=o.context),(i=getOwn(contexts,a))||(i=contexts[a]=req.s.newContext(a)),o&&i.configure(o),i.require(e,t,n)},req.config=function(e){return req(e)},req.nextTick=void 0!==setTimeout?function(e){setTimeout(e,4)}:function(e){e()},require||(require=req),req.version=version,req.jsExtRegExp=/^\/|:|\?|\.js$/,req.isBrowser=isBrowser,s=req.s={contexts:contexts,newContext:newContext},req({}),each(["toUrl","undef","defined","specified"],function(e){req[e]=function(){var t=contexts[defContextName];return t.require[e].apply(t,arguments)}}),isBrowser&&(head=s.head=document.getElementsByTagName("head")[0],baseElement=document.getElementsByTagName("base")[0],baseElement&&(head=s.head=baseElement.parentNode)),req.onError=defaultOnError,req.createNode=function(e,t,n){var r=e.xhtml?document.createElementNS("http://www.w3.org/1999/xhtml","html:script"):document.createElement("script");return r.type=e.scriptType||"text/javascript",r.charset="utf-8",r.async=!0,r},req.load=function(e,t,n){var r,i=e&&e.config||{};if(isBrowser)return(r=req.createNode(i,t,n)).setAttribute("data-requirecontext",e.contextName),r.setAttribute("data-requiremodule",t),!r.attachEvent||r.attachEvent.toString&&r.attachEvent.toString().indexOf("[native code")<0||isOpera?(r.addEventListener("load",e.onScriptLoad,!1),r.addEventListener("error",e.onScriptError,!1)):(useInteractive=!0,r.attachEvent("onreadystatechange",e.onScriptLoad)),r.src=n,i.onNodeCreated&&i.onNodeCreated(r,i,t,n),currentlyAddingScript=r,baseElement?head.insertBefore(r,baseElement):head.appendChild(r),currentlyAddingScript=null,r;if(isWebWorker)try{setTimeout(function(){},0),importScripts(n),e.completeLoad(t)}catch(r){e.onError(makeError("importscripts","importScripts failed for "+t+" at "+n,r,[t]))}},isBrowser&&!cfg.skipDataMain&&eachReverse(scripts(),function(e){if(head||(head=e.parentNode),dataMain=e.getAttribute("data-main"))return mainScript=dataMain,cfg.baseUrl||-1!==mainScript.indexOf("!")||(src=mainScript.split("/"),mainScript=src.pop(),subPath=src.length?src.join("/")+"/":"./",cfg.baseUrl=subPath),mainScript=mainScript.replace(jsSuffixRegExp,""),req.jsExtRegExp.test(mainScript)&&(mainScript=dataMain),cfg.deps=cfg.deps?cfg.deps.concat(mainScript):[mainScript],!0}),define=function(e,t,n){var r,i;"string"!=typeof e&&(n=t,t=e,e=null),isArray(t)||(n=t,t=null),!t&&isFunction(n)&&(t=[],n.length&&(n.toString().replace(commentRegExp,commentReplace).replace(cjsRequireRegExp,function(e,n){t.push(n)}),t=(1===n.length?["require"]:["require","exports","module"]).concat(t))),useInteractive&&(r=currentlyAddingScript||getInteractiveScript())&&(e||(e=r.getAttribute("data-requiremodule")),i=contexts[r.getAttribute("data-requirecontext")]),i?(i.defQueue.push([e,t,n]),i.defQueueMap[e]=!0):globalDefQueue.push([e,t,n])},define.amd={jQuery:!0},req.exec=function(text){return eval(text)},req(cfg)}function newContext(e){var t,n,r,i,o,a={waitSeconds:7,baseUrl:"./",paths:{},bundles:{},pkgs:{},shim:{},config:{}},s={},l={},c={},u=[],d={},p={},f={},h=1,m=1;function g(e,t,n){var r,i,o,s,l,c,u,d,p,f,h=t&&t.split("/"),m=a.map,g=m&&m["*"];if(e&&(c=(e=e.split("/")).length-1,a.nodeIdCompat&&jsSuffixRegExp.test(e[c])&&(e[c]=e[c].replace(jsSuffixRegExp,"")),"."===e[0].charAt(0)&&h&&(e=h.slice(0,h.length-1).concat(e)),function(e){var t,n;for(t=0;t0&&(e.splice(t-1,2),t-=2)}}(e),e=e.join("/")),n&&m&&(h||g)){i=e.split("/");e:for(o=i.length;o>0;o-=1){if(l=i.slice(0,o).join("/"),h)for(s=h.length;s>0;s-=1)if((r=getOwn(m,h.slice(0,s).join("/")))&&(r=getOwn(r,l))){u=r,d=o;break e}!p&&g&&getOwn(g,l)&&(p=getOwn(g,l),f=o)}!u&&p&&(u=p,d=f),u&&(i.splice(0,d,u),e=i.join("/"))}return getOwn(a.pkgs,e)||e}function b(e){isBrowser&&each(scripts(),function(t){if(t.getAttribute("data-requiremodule")===e&&t.getAttribute("data-requirecontext")===r.contextName)return t.parentNode.removeChild(t),!0})}function y(e){var t=getOwn(a.paths,e);if(t&&isArray(t)&&t.length>1)return t.shift(),r.require.undef(e),r.makeRequire(null,{skipMap:!0})([e]),!0}function v(e){var t,n=e?e.indexOf("!"):-1;return n>-1&&(t=e.substring(0,n),e=e.substring(n+1,e.length)),[t,e]}function w(e,t,n,i){var o,a,s,l,c=null,u=t?t.name:null,p=e,f=!0,b="";return e||(f=!1,e="_@r"+(h+=1)),c=(l=v(e))[0],e=l[1],c&&(c=g(c,u,i),a=getOwn(d,c)),e&&(c?b=n?e:a&&a.normalize?a.normalize(e,function(e){return g(e,u,i)}):-1===e.indexOf("!")?g(e,u,i):e:(c=(l=v(b=g(e,u,i)))[0],b=l[1],n=!0,o=r.nameToUrl(b))),{prefix:c,name:b,parentMap:t,unnormalized:!!(s=!c||a||n?"":"_unnormalized"+(m+=1)),url:o,originalName:p,isDefine:f,id:(c?c+"!"+b:b)+s}}function x(e){var t=e.id,n=getOwn(s,t);return n||(n=s[t]=new r.Module(e)),n}function k(e,t,n){var r=e.id,i=getOwn(s,r);!hasProp(d,r)||i&&!i.defineEmitComplete?(i=x(e)).error&&"error"===t?n(i.error):i.on(t,n):"defined"===t&&n(d[r])}function C(e,t){var n=e.requireModules,r=!1;t?t(e):(each(n,function(t){var n=getOwn(s,t);n&&(n.error=e,n.events.error&&(r=!0,n.emit("error",e)))}),r||req.onError(e))}function E(){globalDefQueue.length&&(each(globalDefQueue,function(e){var t=e[0];"string"==typeof t&&(r.defQueueMap[t]=!0),u.push(e)}),globalDefQueue=[])}function $(e){delete s[e],delete l[e]}function T(){var e,n,i=1e3*a.waitSeconds,c=i&&r.startTime+i<(new Date).getTime(),u=[],p=[],f=!1,h=!0;if(!t){if(t=!0,eachProp(l,function(e){var t=e.map,r=t.id;if(e.enabled&&(t.isDefine||p.push(e),!e.error))if(!e.inited&&c)y(r)?(n=!0,f=!0):(u.push(r),b(r));else if(!e.inited&&e.fetched&&t.isDefine&&(f=!0,!t.prefix))return h=!1}),c&&u.length)return(e=makeError("timeout","Load timeout for modules: "+u,null,u)).contextName=r.contextName,C(e);h&&each(p,function(e){!function e(t,n,r){var i=t.map.id;t.error?t.emit("error",t.error):(n[i]=!0,each(t.depMaps,function(i,o){var a=i.id,l=getOwn(s,a);!l||t.depMatched[o]||r[a]||(getOwn(n,a)?(t.defineDep(o,d[a]),t.check()):e(l,n,r))}),r[i]=!0)}(e,{},{})}),c&&!n||!f||!isBrowser&&!isWebWorker||o||(o=setTimeout(function(){o=0,T()},50)),t=!1}}function S(e){hasProp(d,e[0])||x(w(e[0],null,!0)).init(e[1],e[2])}function A(e,t,n,r){e.detachEvent&&!isOpera?r&&e.detachEvent(r,t):e.removeEventListener(n,t,!1)}function L(e){var t=e.currentTarget||e.srcElement;return A(t,r.onScriptLoad,"load","onreadystatechange"),A(t,r.onScriptError,"error"),{node:t,id:t&&t.getAttribute("data-requiremodule")}}function j(){var e;for(E();u.length;){if(null===(e=u.shift())[0])return C(makeError("mismatch","Mismatched anonymous define() module: "+e[e.length-1]));S(e)}r.defQueueMap={}}return i={require:function(e){return e.require?e.require:e.require=r.makeRequire(e.map)},exports:function(e){if(e.usingExports=!0,e.map.isDefine)return e.exports?d[e.map.id]=e.exports:e.exports=d[e.map.id]={}},module:function(e){return e.module?e.module:e.module={id:e.map.id,uri:e.map.url,config:function(){return getOwn(a.config,e.map.id)||{}},exports:e.exports||(e.exports={})}}},(n=function(e){this.events=getOwn(c,e.id)||{},this.map=e,this.shim=getOwn(a.shim,e.id),this.depExports=[],this.depMaps=[],this.depMatched=[],this.pluginMaps={},this.depCount=0}).prototype={init:function(e,t,n,r){r=r||{},this.inited||(this.factory=t,n?this.on("error",n):this.events.error&&(n=bind(this,function(e){this.emit("error",e)})),this.depMaps=e&&e.slice(0),this.errback=n,this.inited=!0,this.ignore=r.ignore,r.enabled||this.enabled?this.enable():this.check())},defineDep:function(e,t){this.depMatched[e]||(this.depMatched[e]=!0,this.depCount-=1,this.depExports[e]=t)},fetch:function(){if(!this.fetched){this.fetched=!0,r.startTime=(new Date).getTime();var e=this.map;if(!this.shim)return e.prefix?this.callPlugin():this.load();r.makeRequire(this.map,{enableBuildCallback:!0})(this.shim.deps||[],bind(this,function(){return e.prefix?this.callPlugin():this.load()}))}},load:function(){var e=this.map.url;p[e]||(p[e]=!0,r.load(this.map.id,e))},check:function(){if(this.enabled&&!this.enabling){var e,t,n=this.map.id,i=this.depExports,o=this.exports,a=this.factory;if(this.inited){if(this.error)this.emit("error",this.error);else if(!this.defining){if(this.defining=!0,this.depCount<1&&!this.defined){if(isFunction(a)){if(this.events.error&&this.map.isDefine||req.onError!==defaultOnError)try{o=r.execCb(n,a,i,o)}catch(t){e=t}else o=r.execCb(n,a,i,o);if(this.map.isDefine&&void 0===o&&((t=this.module)?o=t.exports:this.usingExports&&(o=this.exports)),e)return e.requireMap=this.map,e.requireModules=this.map.isDefine?[this.map.id]:null,e.requireType=this.map.isDefine?"define":"require",C(this.error=e)}else o=a;if(this.exports=o,this.map.isDefine&&!this.ignore&&(d[n]=o,req.onResourceLoad)){var s=[];each(this.depMaps,function(e){s.push(e.normalizedMap||e)}),req.onResourceLoad(r,this.map,s)}$(n),this.defined=!0}this.defining=!1,this.defined&&!this.defineEmitted&&(this.defineEmitted=!0,this.emit("defined",this.exports),this.defineEmitComplete=!0)}}else hasProp(r.defQueueMap,n)||this.fetch()}},callPlugin:function(){var e=this.map,t=e.id,n=w(e.prefix);this.depMaps.push(n),k(n,"defined",bind(this,function(n){var i,o,l,c=getOwn(f,this.map.id),u=this.map.name,d=this.map.parentMap?this.map.parentMap.name:null,p=r.makeRequire(e.parentMap,{enableBuildCallback:!0});return this.map.unnormalized?(n.normalize&&(u=n.normalize(u,function(e){return g(e,d,!0)})||""),k(o=w(e.prefix+"!"+u,this.map.parentMap,!0),"defined",bind(this,function(e){this.map.normalizedMap=o,this.init([],function(){return e},null,{enabled:!0,ignore:!0})})),void((l=getOwn(s,o.id))&&(this.depMaps.push(o),this.events.error&&l.on("error",bind(this,function(e){this.emit("error",e)})),l.enable()))):c?(this.map.url=r.nameToUrl(c),void this.load()):((i=bind(this,function(e){this.init([],function(){return e},null,{enabled:!0})})).error=bind(this,function(e){this.inited=!0,this.error=e,e.requireModules=[t],eachProp(s,function(e){0===e.map.id.indexOf(t+"_unnormalized")&&$(e.map.id)}),C(e)}),i.fromText=bind(this,function(n,o){var s=e.name,l=w(s),c=useInteractive;o&&(n=o),c&&(useInteractive=!1),x(l),hasProp(a.config,t)&&(a.config[s]=a.config[t]);try{req.exec(n)}catch(e){return C(makeError("fromtexteval","fromText eval for "+t+" failed: "+e,e,[t]))}c&&(useInteractive=!0),this.depMaps.push(l),r.completeLoad(s),p([s],i)}),void n.load(e.name,p,i,a))})),r.enable(n,this),this.pluginMaps[n.id]=n},enable:function(){l[this.map.id]=this,this.enabled=!0,this.enabling=!0,each(this.depMaps,bind(this,function(e,t){var n,o,a;if("string"==typeof e){if(e=w(e,this.map.isDefine?this.map:this.map.parentMap,!1,!this.skipMap),this.depMaps[t]=e,a=getOwn(i,e.id))return void(this.depExports[t]=a(this));this.depCount+=1,k(e,"defined",bind(this,function(e){this.undefed||(this.defineDep(t,e),this.check())})),this.errback?k(e,"error",bind(this,this.errback)):this.events.error&&k(e,"error",bind(this,function(e){this.emit("error",e)}))}n=e.id,o=s[n],hasProp(i,n)||!o||o.enabled||r.enable(e,this)})),eachProp(this.pluginMaps,bind(this,function(e){var t=getOwn(s,e.id);t&&!t.enabled&&r.enable(e,this)})),this.enabling=!1,this.check()},on:function(e,t){var n=this.events[e];n||(n=this.events[e]=[]),n.push(t)},emit:function(e,t){each(this.events[e],function(e){e(t)}),"error"===e&&delete this.events[e]}},(r={config:a,contextName:e,registry:s,defined:d,urlFetched:p,defQueue:u,defQueueMap:{},Module:n,makeModuleMap:w,nextTick:req.nextTick,onError:C,configure:function(e){if(e.baseUrl&&"/"!==e.baseUrl.charAt(e.baseUrl.length-1)&&(e.baseUrl+="/"),"string"==typeof e.urlArgs){var t=e.urlArgs;e.urlArgs=function(e,n){return(-1===n.indexOf("?")?"?":"&")+t}}var n=a.shim,i={paths:!0,bundles:!0,config:!0,map:!0};eachProp(e,function(e,t){i[t]?(a[t]||(a[t]={}),mixin(a[t],e,!0,!0)):a[t]=e}),e.bundles&&eachProp(e.bundles,function(e,t){each(e,function(e){e!==t&&(f[e]=t)})}),e.shim&&(eachProp(e.shim,function(e,t){isArray(e)&&(e={deps:e}),!e.exports&&!e.init||e.exportsFn||(e.exportsFn=r.makeShimExports(e)),n[t]=e}),a.shim=n),e.packages&&each(e.packages,function(e){var t;t=(e="string"==typeof e?{name:e}:e).name,e.location&&(a.paths[t]=e.location),a.pkgs[t]=e.name+"/"+(e.main||"main").replace(currDirRegExp,"").replace(jsSuffixRegExp,"")}),eachProp(s,function(e,t){e.inited||e.map.unnormalized||(e.map=w(t,null,!0))}),(e.deps||e.callback)&&r.require(e.deps||[],e.callback)},makeShimExports:function(e){return function(){var t;return e.init&&(t=e.init.apply(global,arguments)),t||e.exports&&getGlobal(e.exports)}},makeRequire:function(t,n){function o(a,l,c){var u,p;return n.enableBuildCallback&&l&&isFunction(l)&&(l.__requireJsBuild=!0),"string"==typeof a?isFunction(l)?C(makeError("requireargs","Invalid require call"),c):t&&hasProp(i,a)?i[a](s[t.id]):req.get?req.get(r,a,t,o):(u=w(a,t,!1,!0).id,hasProp(d,u)?d[u]:C(makeError("notloaded",'Module name "'+u+'" has not been loaded yet for context: '+e+(t?"":". Use require([])")))):(j(),r.nextTick(function(){j(),(p=x(w(null,t))).skipMap=n.skipMap,p.init(a,l,c,{enabled:!0}),T()}),o)}return n=n||{},mixin(o,{isBrowser:isBrowser,toUrl:function(e){var n,i=e.lastIndexOf("."),o=e.split("/")[0];return-1!==i&&(!("."===o||".."===o)||i>1)&&(n=e.substring(i,e.length),e=e.substring(0,i)),r.nameToUrl(g(e,t&&t.id,!0),n,!0)},defined:function(e){return hasProp(d,w(e,t,!1,!0).id)},specified:function(e){return e=w(e,t,!1,!0).id,hasProp(d,e)||hasProp(s,e)}}),t||(o.undef=function(e){E();var n=w(e,t,!0),i=getOwn(s,e);i.undefed=!0,b(e),delete d[e],delete p[n.url],delete c[e],eachReverse(u,function(t,n){t[0]===e&&u.splice(n,1)}),delete r.defQueueMap[e],i&&(i.events.defined&&(c[e]=i.events),$(e))}),o},enable:function(e){getOwn(s,e.id)&&x(e).enable()},completeLoad:function(e){var t,n,i,o=getOwn(a.shim,e)||{},l=o.exports;for(E();u.length;){if(null===(n=u.shift())[0]){if(n[0]=e,t)break;t=!0}else n[0]===e&&(t=!0);S(n)}if(r.defQueueMap={},i=getOwn(s,e),!t&&!hasProp(d,e)&&i&&!i.inited){if(!(!a.enforceDefine||l&&getGlobal(l)))return y(e)?void 0:C(makeError("nodefine","No define call for "+e,null,[e]));S([e,o.deps||[],o.exportsFn])}T()},nameToUrl:function(e,t,n){var i,o,s,l,c,u,d=getOwn(a.pkgs,e);if(d&&(e=d),u=getOwn(f,e))return r.nameToUrl(u,t,n);if(req.jsExtRegExp.test(e))l=e+(t||"");else{for(i=a.paths,s=(o=e.split("/")).length;s>0;s-=1)if(c=getOwn(i,o.slice(0,s).join("/"))){isArray(c)&&(c=c[0]),o.splice(0,s,c);break}l=o.join("/"),l=("/"===(l+=t||(/^data\:|^blob\:|\?/.test(l)||n?"":".js")).charAt(0)||l.match(/^[\w\+\.\-]+:/)?"":a.baseUrl)+l}return a.urlArgs&&!/^blob\:/.test(l)?l+a.urlArgs(e,l):l},load:function(e,t){req.load(r,e,t)},execCb:function(e,t,n,r){return t.apply(r,n)},onScriptLoad:function(e){if("load"===e.type||readyRegExp.test((e.currentTarget||e.srcElement).readyState)){interactiveScript=null;var t=L(e);r.completeLoad(t.id)}},onScriptError:function(e){var t=L(e);if(!y(t.id)){var n=[];return eachProp(s,function(e,r){0!==r.indexOf("_@r")&&each(e.depMaps,function(e){if(e.id===t.id)return n.push(r),!0})}),C(makeError("scripterror",'Script error for "'+t.id+(n.length?'", needed by: '+n.join(", "):'"'),e,[t.id]))}}}).require=r.makeRequire(),r}function getInteractiveScript(){return interactiveScript&&"interactive"===interactiveScript.readyState?interactiveScript:(eachReverse(scripts(),function(e){if("interactive"===e.readyState)return interactiveScript=e}),interactiveScript)}}(this,"undefined"==typeof setTimeout?void 0:setTimeout),define("deps/require",function(){});var hyperHTML=function(e){var t=document.defaultView,n=1,r=/^area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|source|track|wbr$/i,i="ownerSVGElement",o="http://www.w3.org/2000/svg",a="connected",s="dis"+a,l=/^style|textarea$/i,c="_hyper: "+(Math.random()*new Date|0)+";",u="\x3c!--"+c+"--\x3e",d=t.Event;try{new d("Event")}catch(e){d=function(e){var t=document.createEvent("Event");return t.initEvent(e,!1,!1),t}}var p,f=t.Map||function(){var e=[],t=[];return{get:function(n){return t[e.indexOf(n)]},set:function(n,r){t[e.push(n)-1]=r}}},h=0,m=t.WeakMap||function(){var e=c+h++;return{get:function(t){return t[e]},set:function(t,n){Object.defineProperty(t,e,{configurable:!0,value:n})}}},g=t.WeakSet||function(){var e=new m;return{add:function(t){e.set(t,!0)},has:function(t){return!0===e.get(t)}}},b=Array.isArray||(p={}.toString,function(e){return"[object Array]"===p.call(e)}),y=c.trim||function(){return this.replace(/^\s+|\s+$/g,"")};function v(){return this}var w=function(e,t){var n="_"+e+"$";return{get:function(){return this[n]||(this[e]=t.call(this,e))},set:function(e){Object.defineProperty(this,n,{configurable:!0,value:e})}}},x={},k=[],C=x.hasOwnProperty,E=0,$=function(e,t){e in x||(E=k.push(e)),x[e]=t},T=function(e,t){for(var n=0;n\"'=]+",N="[ "+D+"]+"+_,R="<([A-Za-z]+[A-Za-z0-9:_-]*)((?:",P="(?:=(?:'[^']*?'|\"[^\"]*?\"|<[^>]*?>|"+_+"))?)",M=new RegExp(R+N+P+"+)([ "+D+"]*/?>)","g"),O=new RegExp(R+N+P+"*)([ "+D+"]*/>)","g"),I=L(document),q="append"in I,U="content"in S(document,"template");I.appendChild(j(I,"g")),I.appendChild(j(I,""));var W=1===I.cloneNode(!0).childNodes.length,H="importNode"in document,B=q?function(e,t){e.append.apply(e,t)}:function(e,t){for(var n=t.length,r=0;r"+t+"",B(r,Y.call(n.querySelectorAll(i)))}else n.innerHTML=t,B(r,Y.call(n.childNodes));return r},ee=U?function(e,t){var n=L(e),r=A(e).createElementNS(o,"svg");return r.innerHTML=t,B(n,Y.call(r.childNodes)),n}:function(e,t){var n=L(e),r=S(e,"div");return r.innerHTML=''+t+"",B(n,Y.call(r.firstChild.childNodes)),n};function te(e){this.childNodes=e,this.length=e.length,this.first=e[0],this.last=e[this.length-1]}te.prototype.insert=function(){var e=L(this.first);return B(e,this.childNodes),e},te.prototype.remove=function(){var e=this.first,t=this.last;if(2===this.length)t.parentNode.removeChild(t);else{var n=A(e).createRange();n.setStartBefore(this.childNodes[1]),n.setEndAfter(t),n.deleteContents()}return e};var ne=function(e,t,n){e.unshift(e.indexOf.call(t.childNodes,n))},re=function(e,t,r){return{type:e,name:r,node:t,path:function(e){var t=[],r=void 0;switch(e.nodeType){case n:case 11:r=e;break;case 8:r=e.parentNode,ne(t,r,e);break;default:r=e.ownerElement}for(e=r;r=r.parentNode;e=r)ne(t,r,e);return t}(t)}},ie=function(e,t){for(var n=t.length,r=0;rc){var v=n[p+1],w=null==v?a:o(v,0);if(l===p)e.insertBefore(o(n[l],1),w);else{for(var x=e.ownerDocument.createDocumentFragment();l<=p;)x.appendChild(o(n[l++],1));e.insertBefore(x,w)}}else null==t[s]&&s++,s===c?e.removeChild(o(t[s],-1)):de(e,o(t[s],-1),o(t[c],-1));return n},fe=new g;function he(){}he.prototype=Object.create(null);var me=function(e){return{html:e}},ge=function e(t,n){return"ELEMENT_NODE"in t?t:t.constructor===te?1/n<0?n?t.remove():t.last:n?t.insert():t.first:e(t.render(),n)},be=function(e,t,n){for(var r=new he,i=e.attributes,o=Y.call(i),a=[],s=o.length,l=0;l"},Pe=new m,Me=function(e){var t=void 0,n=void 0,r=void 0,i=void 0,a=void 0;return function(s){s=Q(s);var l=i!==s;return l&&(i=s,r=L(document),n="svg"===e?document.createElementNS(o,"svg"):r,a=Se.bind(n)),a.apply(null,arguments),l&&("svg"===e&&B(r,Y.call(n.childNodes)),t=Ie(r)),t}},Oe=function(e,t){var n=t.indexOf(":"),r=Pe.get(e),i=t;return-1e.apply(void 0,n)),window.parent===window.self)return;var r=n.map(e=>String(JSON.stringify(e.stack||e)));window.parent.postMessage({topic:e,args:r},window.parent.location.origin)},e.sub=n,e.unsub=r;e.name="core/pubsubhub";const t=new Map;function n(e,i,o={once:!1}){return o.once?n(e,function t(...n){r({topic:e,cb:t}),i(...n)}):(t.has(e)?t.get(e).add(i):t.set(e,new Set([i])),{topic:e,cb:i})}function r({topic:e,cb:n}){const r=t.get(e);return r&&r.has(n)?r.delete(n):(console.warn("Already unsubscribed:",e,n),!1)}n("error",e=>{console.error(e,e.stack)}),n("warn",e=>{console.warn(e)})}),function(e){var t={newline:/^\n+/,code:/^( {4}[^\n]+\n*)+/,fences:h,hr:/^ {0,3}((?:- *){3,}|(?:_ *){3,}|(?:\* *){3,})(?:\n+|$)/,heading:/^ *(#{1,6}) *([^\n]+?) *(?:#+ *)?(?:\n+|$)/,nptable:h,blockquote:/^( {0,3}> ?(paragraph|[^\n]*)(?:\n|$))+/,list:/^( *)(bull) [\s\S]+?(?:hr|def|\n{2,}(?! )(?!\1bull )\n*|\s*$)/,html:"^ {0,3}(?:<(script|pre|style)[\\s>][\\s\\S]*?(?:[^\\n]*\\n+|$)|comment[^\\n]*(\\n+|$)|<\\?[\\s\\S]*?\\?>\\n*|\\n*|\\n*|)[\\s\\S]*?(?:\\n{2,}|$)|<(?!script|pre|style)([a-z][\\w-]*)(?:attribute)*? */?>(?=\\h*\\n)[\\s\\S]*?(?:\\n{2,}|$)|(?=\\h*\\n)[\\s\\S]*?(?:\\n{2,}|$))",def:/^ {0,3}\[(label)\]: *\n? *]+)>?(?:(?: +\n? *| *\n *)(title))? *(?:\n+|$)/,table:h,lheading:/^([^\n]+)\n *(=|-){2,} *(?:\n+|$)/,paragraph:/^([^\n]+(?:\n(?!hr|heading|lheading| {0,3}>|<\/?(?:tag)(?: +|\n|\/?>)|<(?:script|pre|style|!--))[^\n]+)*)/,text:/^[^\n]+/};function n(e){this.tokens=[],this.tokens.links={},this.options=e||b.defaults,this.rules=t.normal,this.options.pedantic?this.rules=t.pedantic:this.options.gfm&&(this.options.tables?this.rules=t.tables:this.rules=t.gfm)}t._label=/(?!\s*\])(?:\\[\[\]]|[^\[\]])+/,t._title=/(?:"(?:\\"?|[^"\\])*"|'[^'\n]*(?:\n[^'\n]+)*\n?'|\([^()]*\))/,t.def=u(t.def).replace("label",t._label).replace("title",t._title).getRegex(),t.bullet=/(?:[*+-]|\d+\.)/,t.item=/^( *)(bull) [^\n]*(?:\n(?!\1bull )[^\n]*)*/,t.item=u(t.item,"gm").replace(/bull/g,t.bullet).getRegex(),t.list=u(t.list).replace(/bull/g,t.bullet).replace("hr","\\n+(?=\\1?(?:(?:- *){3,}|(?:_ *){3,}|(?:\\* *){3,})(?:\\n+|$))").replace("def","\\n+(?="+t.def.source+")").getRegex(),t._tag="address|article|aside|base|basefont|blockquote|body|caption|center|col|colgroup|dd|details|dialog|dir|div|dl|dt|fieldset|figcaption|figure|footer|form|frame|frameset|h[1-6]|head|header|hr|html|iframe|legend|li|link|main|menu|menuitem|meta|nav|noframes|ol|optgroup|option|p|param|section|source|summary|table|tbody|td|tfoot|th|thead|title|tr|track|ul",t._comment=//,t.html=u(t.html,"i").replace("comment",t._comment).replace("tag",t._tag).replace("attribute",/ +[a-zA-Z:_][\w.:-]*(?: *= *"[^"\n]*"| *= *'[^'\n]*'| *= *[^\s"'=<>`]+)?/).getRegex(),t.paragraph=u(t.paragraph).replace("hr",t.hr).replace("heading",t.heading).replace("lheading",t.lheading).replace("tag",t._tag).getRegex(),t.blockquote=u(t.blockquote).replace("paragraph",t.paragraph).getRegex(),t.normal=m({},t),t.gfm=m({},t.normal,{fences:/^ *(`{3,}|~{3,})[ \.]*(\S+)? *\n([\s\S]*?)\n? *\1 *(?:\n+|$)/,paragraph:/^/,heading:/^ *(#{1,6}) +([^\n]+?) *#* *(?:\n+|$)/}),t.gfm.paragraph=u(t.paragraph).replace("(?!","(?!"+t.gfm.fences.source.replace("\\1","\\2")+"|"+t.list.source.replace("\\1","\\3")+"|").getRegex(),t.tables=m({},t.gfm,{nptable:/^ *([^|\n ].*\|.*)\n *([-:]+ *\|[-| :]*)(?:\n((?:.*[^>\n ].*(?:\n|$))*)\n*|$)/,table:/^ *\|(.+)\n *\|?( *[-:]+[-| :]*)(?:\n((?: *[^>\n ].*(?:\n|$))*)\n*|$)/}),t.pedantic=m({},t.normal,{html:u("^ *(?:comment *(?:\\n|\\s*$)|<(tag)[\\s\\S]+? *(?:\\n{2,}|\\s*$)|\\s]*)*?/?> *(?:\\n{2,}|\\s*$))").replace("comment",t._comment).replace(/tag/g,"(?!(?:a|em|strong|small|s|cite|q|dfn|abbr|data|time|code|var|samp|kbd|sub|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo|span|br|wbr|ins|del|img)\\b)\\w+(?!:|[^\\w\\s@]*@)\\b").getRegex(),def:/^ *\[([^\]]+)\]: *]+)>?(?: +(["(][^\n]+[")]))? *(?:\n+|$)/}),n.rules=t,n.lex=function(e,t){return new n(t).lex(e)},n.prototype.lex=function(e){return e=e.replace(/\r\n|\r/g,"\n").replace(/\t/g," ").replace(/\u00a0/g," ").replace(/\u2424/g,"\n"),this.token(e,!0)},n.prototype.token=function(e,n){var r,i,o,a,s,l,c,u,d,p,f,h,m;for(e=e.replace(/^ +$/gm,"");e;)if((o=this.rules.newline.exec(e))&&(e=e.substring(o[0].length),o[0].length>1&&this.tokens.push({type:"space"})),o=this.rules.code.exec(e))e=e.substring(o[0].length),o=o[0].replace(/^ {4}/gm,""),this.tokens.push({type:"code",text:this.options.pedantic?o:o.replace(/\n+$/,"")});else if(o=this.rules.fences.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"code",lang:o[2],text:o[3]||""});else if(o=this.rules.heading.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"heading",depth:o[1].length,text:o[2]});else if(n&&(o=this.rules.nptable.exec(e))&&(l={type:"table",header:g(o[1].replace(/^ *| *\| *$/g,"")),align:o[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:o[3]?o[3].replace(/\n$/,"").split("\n"):[]}).header.length===l.align.length){for(e=e.substring(o[0].length),u=0;u ?/gm,""),this.token(o,n),this.tokens.push({type:"blockquote_end"});else if(o=this.rules.list.exec(e)){for(e=e.substring(o[0].length),f=(a=o[2]).length>1,this.tokens.push({type:"list_start",ordered:f,start:f?+a:""}),r=!1,p=(o=o[0].match(this.rules.item)).length,u=0;u1&&s.length>1||(e=o.slice(u+1).join("\n")+e,u=p-1)),i=r||/\n\n(?!\s*$)/.test(l),u!==p-1&&(r="\n"===l.charAt(l.length-1),i||(i=r)),m=void 0,(h=/^\[[ xX]\] /.test(l))&&(m=" "!==l[1],l=l.replace(/^\[[ xX]\] +/,"")),this.tokens.push({type:i?"loose_item_start":"list_item_start",task:h,checked:m}),this.token(l,!1),this.tokens.push({type:"list_item_end"});this.tokens.push({type:"list_end"})}else if(o=this.rules.html.exec(e))e=e.substring(o[0].length),this.tokens.push({type:this.options.sanitize?"paragraph":"html",pre:!this.options.sanitizer&&("pre"===o[1]||"script"===o[1]||"style"===o[1]),text:o[0]});else if(n&&(o=this.rules.def.exec(e)))e=e.substring(o[0].length),o[3]&&(o[3]=o[3].substring(1,o[3].length-1)),d=o[1].toLowerCase().replace(/\s+/g," "),this.tokens.links[d]||(this.tokens.links[d]={href:o[2],title:o[3]});else if(n&&(o=this.rules.table.exec(e))&&(l={type:"table",header:g(o[1].replace(/^ *| *\| *$/g,"")),align:o[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:o[3]?o[3].replace(/(?: *\| *)?\n$/,"").split("\n"):[]}).header.length===l.align.length){for(e=e.substring(o[0].length),u=0;u?@\[\]\\^_`{|}~])/,autolink:/^<(scheme:[^\s\x00-\x1f<>]*|email)>/,url:h,tag:"^comment|^|^<[a-zA-Z][\\w-]*(?:attribute)*?\\s*/?>|^<\\?[\\s\\S]*?\\?>|^|^",link:/^!?\[(label)\]\(href(?:\s+(title))?\s*\)/,reflink:/^!?\[(label)\]\[(?!\s*\])((?:\\[\[\]]?|[^\[\]\\])+)\]/,nolink:/^!?\[(?!\s*\])((?:\[[^\[\]]*\]|\\[\[\]]|[^\[\]])*)\](?:\[\])?/,strong:/^__([^\s][\s\S]*?[^\s])__(?!_)|^\*\*([^\s][\s\S]*?[^\s])\*\*(?!\*)|^__([^\s])__(?!_)|^\*\*([^\s])\*\*(?!\*)/,em:/^_([^\s][\s\S]*?[^\s_])_(?!_)|^_([^\s_][\s\S]*?[^\s])_(?!_)|^\*([^\s][\s\S]*?[^\s*])\*(?!\*)|^\*([^\s*][\s\S]*?[^\s])\*(?!\*)|^_([^\s_])_(?!_)|^\*([^\s*])\*(?!\*)/,code:/^(`+)\s*([\s\S]*?[^`]?)\s*\1(?!`)/,br:/^ {2,}\n(?!\s*$)/,del:h,text:/^[\s\S]+?(?=[\\/g,">").replace(/"/g,""").replace(/'/g,"'")}function c(e){return e.replace(/&(#(?:\d+)|(?:#x[0-9A-Fa-f]+)|(?:\w+));?/gi,function(e,t){return"colon"===(t=t.toLowerCase())?":":"#"===t.charAt(0)?"x"===t.charAt(1)?String.fromCharCode(parseInt(t.substring(2),16)):String.fromCharCode(+t.substring(1)):""})}function u(e,t){return e=e.source||e,t=t||"",{replace:function(t,n){return n=(n=n.source||n).replace(/(^|[^\[])\^/g,"$1"),e=e.replace(t,n),this},getRegex:function(){return new RegExp(e,t)}}}function d(e,t){return p[" "+e]||(/^[^:]+:\/*[^/]*$/.test(e)?p[" "+e]=e+"/":p[" "+e]=e.replace(/[^/]*$/,"")),e=p[" "+e],"//"===t.slice(0,2)?e.replace(/:[\s\S]*/,":")+t:"/"===t.charAt(0)?e.replace(/(:\/*[^/]*)[\s\S]*/,"$1")+t:e+t}r._escapes=/\\([!"#$%&'()*+,\-./:;<=>?@\[\]\\^_`{|}~])/g,r._scheme=/[a-zA-Z][a-zA-Z0-9+.-]{1,31}/,r._email=/[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+(@)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+(?![-_])/,r.autolink=u(r.autolink).replace("scheme",r._scheme).replace("email",r._email).getRegex(),r._attribute=/\s+[a-zA-Z:_][\w.:-]*(?:\s*=\s*"[^"]*"|\s*=\s*'[^']*'|\s*=\s*[^\s"'=<>`]+)?/,r.tag=u(r.tag).replace("comment",t._comment).replace("attribute",r._attribute).getRegex(),r._label=/(?:\[[^\[\]]*\]|\\[\[\]]?|`[^`]*`|[^\[\]\\])*?/,r._href=/\s*(<(?:\\[<>]?|[^\s<>\\])*>|(?:\\[()]?|\([^\s\x00-\x1f()\\]*\)|[^\s\x00-\x1f()\\])*?)/,r._title=/"(?:\\"?|[^"\\])*"|'(?:\\'?|[^'\\])*'|\((?:\\\)?|[^)\\])*\)/,r.link=u(r.link).replace("label",r._label).replace("href",r._href).replace("title",r._title).getRegex(),r.reflink=u(r.reflink).replace("label",r._label).getRegex(),r.normal=m({},r),r.pedantic=m({},r.normal,{strong:/^__(?=\S)([\s\S]*?\S)__(?!_)|^\*\*(?=\S)([\s\S]*?\S)\*\*(?!\*)/,em:/^_(?=\S)([\s\S]*?\S)_(?!_)|^\*(?=\S)([\s\S]*?\S)\*(?!\*)/,link:u(/^!?\[(label)\]\((.*?)\)/).replace("label",r._label).getRegex(),reflink:u(/^!?\[(label)\]\s*\[([^\]]*)\]/).replace("label",r._label).getRegex()}),r.gfm=m({},r.normal,{escape:u(r.escape).replace("])","~|])").getRegex(),url:u(/^((?:ftp|https?):\/\/|www\.)(?:[a-zA-Z0-9\-]+\.?)+[^\s<]*|^email/).replace("email",r._email).getRegex(),_backpedal:/(?:[^?!.,:;*_~()&]+|\([^)]*\)|&(?![a-zA-Z0-9]+;$)|[?!.,:;*_~)]+(?!$))+/,del:/^~~(?=\S)([\s\S]*?\S)~~/,text:u(r.text).replace("]|","~]|").replace("|","|https?://|ftp://|www\\.|[a-zA-Z0-9.!#$%&'*+/=?^_`{\\|}~-]+@|").getRegex()}),r.breaks=m({},r.gfm,{br:u(r.br).replace("{2,}","*").getRegex(),text:u(r.gfm.text).replace("{2,}","*").getRegex()}),i.rules=r,i.output=function(e,t,n){return new i(t,n).output(e)},i.prototype.output=function(e){for(var t,n,r,o,a,s="";e;)if(a=this.rules.escape.exec(e))e=e.substring(a[0].length),s+=a[1];else if(a=this.rules.autolink.exec(e))e=e.substring(a[0].length),r="@"===a[2]?"mailto:"+(n=l(this.mangle(a[1]))):n=l(a[1]),s+=this.renderer.link(r,null,n);else if(this.inLink||!(a=this.rules.url.exec(e))){if(a=this.rules.tag.exec(e))!this.inLink&&/^/i.test(a[0])&&(this.inLink=!1),e=e.substring(a[0].length),s+=this.options.sanitize?this.options.sanitizer?this.options.sanitizer(a[0]):l(a[0]):a[0];else if(a=this.rules.link.exec(e))e=e.substring(a[0].length),this.inLink=!0,r=a[2],this.options.pedantic?(t=/^([^'"]*[^\s])\s+(['"])(.*)\2/.exec(r))?(r=t[1],o=t[3]):o="":o=a[3]?a[3].slice(1,-1):"",r=r.trim().replace(/^<([\s\S]*)>$/,"$1"),s+=this.outputLink(a,{href:i.escapes(r),title:i.escapes(o)}),this.inLink=!1;else if((a=this.rules.reflink.exec(e))||(a=this.rules.nolink.exec(e))){if(e=e.substring(a[0].length),t=(a[2]||a[1]).replace(/\s+/g," "),!(t=this.links[t.toLowerCase()])||!t.href){s+=a[0].charAt(0),e=a[0].substring(1)+e;continue}this.inLink=!0,s+=this.outputLink(a,t),this.inLink=!1}else if(a=this.rules.strong.exec(e))e=e.substring(a[0].length),s+=this.renderer.strong(this.output(a[4]||a[3]||a[2]||a[1]));else if(a=this.rules.em.exec(e))e=e.substring(a[0].length),s+=this.renderer.em(this.output(a[6]||a[5]||a[4]||a[3]||a[2]||a[1]));else if(a=this.rules.code.exec(e))e=e.substring(a[0].length),s+=this.renderer.codespan(l(a[2].trim(),!0));else if(a=this.rules.br.exec(e))e=e.substring(a[0].length),s+=this.renderer.br();else if(a=this.rules.del.exec(e))e=e.substring(a[0].length),s+=this.renderer.del(this.output(a[1]));else if(a=this.rules.text.exec(e))e=e.substring(a[0].length),s+=this.renderer.text(l(this.smartypants(a[0])));else if(e)throw new Error("Infinite loop on byte: "+e.charCodeAt(0))}else a[0]=this.rules._backpedal.exec(a[0])[0],e=e.substring(a[0].length),"@"===a[2]?r="mailto:"+(n=l(a[0])):(n=l(a[0]),r="www."===a[1]?"http://"+n:n),s+=this.renderer.link(r,null,n);return s},i.escapes=function(e){return e?e.replace(i.rules._escapes,"$1"):e},i.prototype.outputLink=function(e,t){var n=t.href,r=t.title?l(t.title):null;return"!"!==e[0].charAt(0)?this.renderer.link(n,r,this.output(e[1])):this.renderer.image(n,r,l(e[1]))},i.prototype.smartypants=function(e){return this.options.smartypants?e.replace(/---/g,"—").replace(/--/g,"–").replace(/(^|[-\u2014/(\[{"\s])'/g,"$1‘").replace(/'/g,"’").replace(/(^|[-\u2014/(\[{\u2018\s])"/g,"$1“").replace(/"/g,"”").replace(/\.{3}/g,"…"):e},i.prototype.mangle=function(e){if(!this.options.mangle)return e;for(var t,n="",r=e.length,i=0;i.5&&(t="x"+t.toString(16)),n+="&#"+t+";";return n},o.prototype.code=function(e,t,n){if(this.options.highlight){var r=this.options.highlight(e,t);null!=r&&r!==e&&(n=!0,e=r)}return t?'
        '+(n?e:l(e,!0))+"
        \n":"
        "+(n?e:l(e,!0))+"
        "},o.prototype.blockquote=function(e){return"
        \n"+e+"
        \n"},o.prototype.html=function(e){return e},o.prototype.heading=function(e,t,n){return this.options.headerIds?"'+e+"\n":""+e+"\n"},o.prototype.hr=function(){return this.options.xhtml?"
        \n":"
        \n"},o.prototype.list=function(e,t,n){var r=t?"ol":"ul";return"<"+r+(t&&1!==n?' start="'+n+'"':"")+">\n"+e+"\n"},o.prototype.listitem=function(e){return"
      2. "+e+"
      3. \n"},o.prototype.checkbox=function(e){return" "},o.prototype.paragraph=function(e){return"

        "+e+"

        \n"},o.prototype.table=function(e,t){return t&&(t=""+t+""),"\n\n"+e+"\n"+t+"
        \n"},o.prototype.tablerow=function(e){return"\n"+e+"\n"},o.prototype.tablecell=function(e,t){var n=t.header?"th":"td";return(t.align?"<"+n+' align="'+t.align+'">':"<"+n+">")+e+"\n"},o.prototype.strong=function(e){return""+e+""},o.prototype.em=function(e){return""+e+""},o.prototype.codespan=function(e){return""+e+""},o.prototype.br=function(){return this.options.xhtml?"
        ":"
        "},o.prototype.del=function(e){return""+e+""},o.prototype.link=function(e,t,n){if(this.options.sanitize){try{var r=decodeURIComponent(c(e)).replace(/[^\w:]/g,"").toLowerCase()}catch(e){return n}if(0===r.indexOf("javascript:")||0===r.indexOf("vbscript:")||0===r.indexOf("data:"))return n}this.options.baseUrl&&!f.test(e)&&(e=d(this.options.baseUrl,e));try{e=encodeURI(e).replace(/%25/g,"%")}catch(e){return n}var i='
        "},o.prototype.image=function(e,t,n){this.options.baseUrl&&!f.test(e)&&(e=d(this.options.baseUrl,e));var r=''+n+'":">"},o.prototype.text=function(e){return e},a.prototype.strong=a.prototype.em=a.prototype.codespan=a.prototype.del=a.prototype.text=function(e){return e},a.prototype.link=a.prototype.image=function(e,t,n){return""+n},a.prototype.br=function(){return""},s.parse=function(e,t){return new s(t).parse(e)},s.prototype.parse=function(e){this.inline=new i(e.links,this.options),this.inlineText=new i(e.links,m({},this.options,{renderer:new a})),this.tokens=e.reverse();for(var t="";this.next();)t+=this.tok();return t},s.prototype.next=function(){return this.token=this.tokens.pop()},s.prototype.peek=function(){return this.tokens[this.tokens.length-1]||0},s.prototype.parseText=function(){for(var e=this.token.text;"text"===this.peek().type;)e+="\n"+this.next().text;return this.inline.output(e)},s.prototype.tok=function(){switch(this.token.type){case"space":return"";case"hr":return this.renderer.hr();case"heading":return this.renderer.heading(this.inline.output(this.token.text),this.token.depth,c(this.inlineText.output(this.token.text)));case"code":return this.renderer.code(this.token.text,this.token.lang,this.token.escaped);case"table":var e,t,n,r,i="",o="";for(n="",e=0;et)n.splice(t);else for(;n.lengthAn error occurred:

        "+l(e.message+"",!0)+"
        ";throw e}}h.exec=h,b.options=b.setOptions=function(e){return m(b.defaults,e),b},b.getDefaults=function(){return{baseUrl:null,breaks:!1,gfm:!0,headerIds:!0,headerPrefix:"",highlight:null,langPrefix:"language-",mangle:!0,pedantic:!1,renderer:new o,sanitize:!1,sanitizer:null,silent:!1,smartLists:!1,smartypants:!1,tables:!0,xhtml:!1}},b.defaults=b.getDefaults(),b.Parser=s,b.parser=s.parse,b.Renderer=o,b.TextRenderer=a,b.Lexer=n,b.lexer=n.lex,b.InlineLexer=i,b.inlineLexer=i.output,b.parse=b,"undefined"!=typeof module&&"object"==typeof exports?module.exports=b:"function"==typeof define&&define.amd?define("deps/marked",[],function(){return b}):e.marked=b}(this||("undefined"!=typeof window?window:global)),define("core/utils",["exports","core/pubsubhub","deps/marked"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.ISODate=e.name=void 0,e.markdownToHtml=function(e){const t=h(e).replace(l,">").replace(c,"&");return(0,i.default)(t)},e.makeOwnerSwapper=function(e){if(!e)throw new TypeError("Expected instance of Node.");return t=>{if(t.ownerDocument.adoptNode(e),t.firstElementChild)return t.insertBefore(e,t.firstElementChild);t.appendChild(e)}},e.calculateLeftPad=function(e){if("string"!=typeof e)throw new TypeError("Invalid input");var t=e.split("\n").filter(e=>e).reduce((e,t)=>{if(0===e)return e;const n=t.match(o)[0]||"";return Math.min(n.length,e)},1/0);return t===1/0?0:t},e.createResourceHint=function(e){if(!e||"object"!=typeof e)throw new TypeError("Missing options");if(!p.has(e.hint))throw new TypeError("Invalid resources hint");const t=new URL(e.href,document.location),n=document.createElement("link");let r=t.href;switch(n.rel=e.hint,n.rel){case"dns-prefetch":case"preconnect":r=t.origin,(e.corsMode||t.origin!==document.location.origin)&&(n.crossOrigin=e.corsMode||"anonymous");break;case"preload":"as"in e&&"string"==typeof e.as&&(f.has(e.as)||console.warn(`Unknown request destination: ${e.as}`),n.setAttribute("as",e.as))}n.href=r,e.dontRemove||n.classList.add("removeOnSave");return n},e.normalizePadding=h,e.removeReSpec=function(e){Array.from(e.querySelectorAll(".remove, script[data-requiremodule]")).forEach(e=>{e.remove()})},e.joinAnd=function(e=[],t=(e=>e)){const n=e.map(t);switch(n.length){case 0:case 1:return n.toString();case 2:return n.join(" and ");default:const e=n.join(", "),t=e.lastIndexOf(",");return`${e.substr(0,t+1)} and ${e.slice(t+2)}`}},e.xmlEscape=function(e){return e.replace(/&/g,"&").replace(/>/g,">").replace(/"/g,""").replace(/i)return 1;if(i>t)return-1;if(!isNaN(t)&&isNaN(i))return 1;if(isNaN(t)&&!isNaN(i))return-1}return 0},e.concatDate=function(e,t=""){return u.format(e).replace(s,t)},e.toShortIsoDate=function(e){return u.format(e)},e.lead0=function(e){return 1===String(e).length?"0"+e:e},e.parseSimpleDate=function(e){return new Date(e)},e.parseLastModified=function(e){return e?new Date(Date.parse(e)):new Date},e.humanDate=function(e=new Date,t=document.documentElement.lang||"en"){e instanceof Date||(e=new Date(e));const n=[t,"en"],r=e.toLocaleString(n,{day:"2-digit",timeZone:"UTC"}),i=e.toLocaleString(n,{month:"long",timeZone:"UTC"}),o=e.toLocaleString(n,{year:"numeric",timeZone:"UTC"});return`${r} ${i} ${o}`},e.isoDate=function(e){return(e instanceof Date?e:new Date(e)).toISOString()},e.toKeyValuePairs=function(e,t=", ",n="="){return Array.from(Object.entries(e)).map(([e,t])=>`${e}${n}${JSON.stringify(t)}`).join(t)},e.linkCSS=function(e,t){const n=[].concat(t).map(t=>{var n=e.createElement("link");return n.rel="stylesheet",n.href=t,n}).reduce(function(e,t){return e.appendChild(t),e},e.createDocumentFragment());e.head.appendChild(n)},e.runTransforms=function(e,n){var r=[this,e],i=Array.from(arguments);if(i.shift(),i.shift(),r=r.concat(i),n)for(var o=n.split(/\s+/),a=0;anew Date)return i}catch(e){console.error("Failed to use Cache API.",e)}const o=await fetch(e);if(!o.ok&&i)return console.warn(`Returning a stale cached response for ${n}`),i;if(r){const n=o.clone(),i=new Headers(o.headers),a=new Date(Date.now()+t);i.set("Expires",a);const s=new Response(await n.blob(),{headers:i});return await r.put(e,s).catch(console.error),await r.match(e)}return o},e.flatten=function e(t,n){const r="object"==typeof n;const i=Object(n)[Symbol.iterator]&&"function"==typeof n.values;const o=r?i?[...n.values()].reduce(e,[]):Object.values(n):[n];return[...t,...o]};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/utils";i.default.setOptions({sanitize:!1,gfm:!0});const o=/^[\ |\t]*/,a=/\s+$/gm,s=/\-/g,l=/>/gm,c=/&/gm;const u=e.ISODate=new Intl.DateTimeFormat(["en-ca-iso8601"],{timeZone:"UTC",year:"numeric",month:"2-digit",day:"2-digit"}),d=new Set(["a","abbr","acronym","b","bdo","big","br","button","cite","code","dfn","em","i","img","input","kbd","label","map","object","q","samp","script","select","small","span","strong","sub","sup","textarea","time","tt","var"]),p=new Set(["dns-prefetch","preconnect","preload","prerender"]),f=new Set(["document","embed","font","image","manifest","media","object","report","script","serviceworker","sharedworker","style","worker","xslt",""]);function h(e=""){if(!e)return"";if("string"!=typeof e)throw TypeError("Invalid input");if("\n"===e)return"\n";function t(e){return null!==e&&e.nodeType===Node.TEXT_NODE}var n=""+e,r=(new DOMParser).parseFromString(n,"text/html");Array.from(r.body.children).filter(e=>!d.has(e.localName)).filter(e=>"pre"!==e.localName).filter(e=>"table"!==e.localName).forEach(e=>{e.innerHTML=h(e.innerHTML)}),Array.from(r.body.childNodes).filter(e=>t(e)&&""===e.textContent.trim()).forEach(e=>e.parentElement.replaceChild(r.createTextNode("\n"),e)),t(r.body.firstChild)||Array.from(r.body.firstChild.children).filter(e=>"table"!==e.localName).forEach(e=>{e.innerHTML=h(e.innerHTML)}),r.normalize();const i=r.body.innerText.replace(/^\ *\n/,"").split("\n").filter(e=>e&&e.startsWith(" "))[0];var o=i?i.match(/\ +/)[0].length:0;if(o){Array.from(r.body.childNodes).filter(e=>"pre"!==e.localName).filter(t).filter(e=>{const t=e.previousElementSibling,n=t?t.localName:e.parentElement.localName;return!d.has(n)||e.textContent.trim().includes("\n")}).reduce((e,t)=>{let n="";const r=t.previousElementSibling,i=r?r.localName:t.parentElement.localName;return/^[\t\ ]/.test(t.textContent)&&d.has(i)&&(n=t.textContent.match(/^\s+/)[0]),t.textContent=n+t.textContent.replace(e,""),e},new RegExp("^ {1,"+o+"}","gm"));const e=new RegExp(`\\ {${o}}$`,"gm");Array.from(r.body.querySelectorAll("pre")).map(e=>e.previousSibling).filter(t).reduce((t,n)=>(e.test(n.textContent)&&(n.textContent=n.textContent.substr(0,n.textContent.length-t)),t),o)}return a.test(r.body.innerHTML)?r.body.innerHTML.trimRight()+"\n":r.body.innerHTML}}),define("core/post-process",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0;e.name="core/post-process";let n;e.done=new Promise(e=>{n=e});(0,t.sub)("plugins-done",async e=>{const t=[];if(Array.isArray(e.postProcess)){const n=await Promise.all(e.postProcess.filter(e=>"function"==typeof e).map(t=>Promise.resolve(t(e,document))));t.push(...n)}"function"==typeof e.afterEnd&&t.push(await Promise.resolve(e.afterEnd(e,document))),n(t)},{once:!0})}),define("core/pre-process",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0;e.name="core/pre-process";let n;e.done=new Promise(e=>{n=e});(0,t.sub)("start-all",async e=>{const t=[];if(Array.isArray(e.preProcess)){const n=await Promise.all(e.preProcess.filter(e=>"function"==typeof e).map(t=>Promise.resolve(t(e,document))));t.push(...n)}n(t)},{once:!0})}),define("core/include-config",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/include-config";const n={},r=e=>Object.assign(n,e);(0,t.sub)("start-all",r),(0,t.sub)("amend-user-config",r),(0,t.sub)("end-all",()=>{const e=document.createElement("script");e.id="initialUserConfig",e.type="application/json",e.innerHTML=JSON.stringify(n,null,2),document.head.appendChild(e)})}),define("core/override-configuration",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/override-configuration";(0,t.sub)("start-all",function(e){const n=document.location.search.replace(/;/g,"&"),r=new URLSearchParams(n),i=Array.from(r.entries()).filter(([e,t])=>!!e&&!!t).map(([e,t])=>{const n=decodeURIComponent(e),r=decodeURIComponent(t.replace(/%3D/g,"="));let i;try{i=JSON.parse(r)}catch(e){i=r}return{key:n,value:i}}).reduce((e,{key:t,value:n})=>(e[t]=n,e),{});Object.assign(e,i),(0,t.pub)("amend-user-config",i)},{once:!0})}),define("core/respec-ready",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/respec-ready";const n=new Promise(e=>{(0,t.sub)("end-all",e,{once:!0})});Object.defineProperty(document,"respecIsReady",{get:()=>n})}),define("core/base-runner",["exports","core/utils","core/post-process","core/pre-process","core/pubsubhub","core/include-config","core/override-configuration","core/respec-ready"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.runAll=async function(e){(0,i.pub)("start-all",respecConfig),a&&performance.mark(o+"-start");await r.done;const l=e.filter(e=>e&&e.run).map(s);for(const e of l)try{await e(respecConfig)}catch(e){console.error(e)}(0,i.pub)("plugins-done",respecConfig),await n.done,(0,i.pub)("end-all",respecConfig),(0,t.removeReSpec)(document),a&&(performance.mark(o+"-end"),performance.measure(o,o+"-start",o+"-end"))};const o=e.name="core/base-runner",a=performance.mark&&performance.measure;function s(e){const t=e.name||"";return t||console.warn("Plugin lacks name:",e),n=>new Promise(async(r,i)=>{const o=setTimeout(()=>{const n=`Plugin ${t} took too long.`;console.error(n,e),i(new Error(n))},15e3);a&&performance.mark(t+"-start");try{e.run.length<=1?(await e.run(n),r()):e.run(n,document,r)}catch(e){i(e)}finally{clearTimeout(o)}a&&(performance.mark(t+"-end"),performance.measure(t,t+"-start",t+"-end"))})}});var shortcut={all_shortcuts:{},add:function(e,t,n){var r={type:"keydown",propagate:!1,disable_in_input:!1,target:document,keycode:!1};if(n)for(var i in r)void 0===n[i]&&(n[i]=r[i]);else n=r;var o=n.target;"string"==typeof n.target&&(o=document.getElementById(n.target));e=e.toLowerCase();var a=function(r){var i,o;if((r=r||window.event,n.disable_in_input)&&(r.target?o=r.target:r.srcElement&&(o=r.srcElement),3==o.nodeType&&(o=o.parentNode),"INPUT"==o.tagName||"TEXTAREA"==o.tagName))return;r.keyCode?i=r.keyCode:r.which&&(i=r.which);var a=String.fromCharCode(i).toLowerCase();188==i&&(a=","),190==i&&(a=".");var s=e.split("+"),l=0,c={"`":"~",1:"!",2:"@",3:"#",4:"$",5:"%",6:"^",7:"&",8:"*",9:"(",0:")","-":"_","=":"+",";":":","'":'"',",":"<",".":">","/":"?","\\":"|"},u={esc:27,escape:27,tab:9,space:32,return:13,enter:13,backspace:8,scrolllock:145,scroll_lock:145,scroll:145,capslock:20,caps_lock:20,caps:20,numlock:144,num_lock:144,num:144,pause:19,break:19,insert:45,home:36,delete:46,end:35,pageup:33,page_up:33,pu:33,pagedown:34,page_down:34,pd:34,left:37,up:38,right:39,down:40,f1:112,f2:113,f3:114,f4:115,f5:116,f6:117,f7:118,f8:119,f9:120,f10:121,f11:122,f12:123},d={shift:{wanted:!1,pressed:!1},ctrl:{wanted:!1,pressed:!1},alt:{wanted:!1,pressed:!1},meta:{wanted:!1,pressed:!1}};r.ctrlKey&&(d.ctrl.pressed=!0),r.shiftKey&&(d.shift.pressed=!0),r.altKey&&(d.alt.pressed=!0),r.metaKey&&(d.meta.pressed=!0);for(var p,f=0;p=s[f],f1?u[p]==i&&l++:n.keycode?n.keycode==i&&l++:a==p?l++:c[a]&&r.shiftKey&&(a=c[a])==p&&l++;if(l==s.length&&d.ctrl.pressed==d.ctrl.wanted&&d.shift.pressed==d.shift.wanted&&d.alt.pressed==d.alt.wanted&&d.meta.pressed==d.meta.wanted&&(t(r),!n.propagate))return r.cancelBubble=!0,r.returnValue=!1,r.stopPropagation&&(r.stopPropagation(),r.preventDefault()),!1};this.all_shortcuts[e]={callback:a,target:o,event:n.type},o.addEventListener?o.addEventListener(n.type,a,!1):o.attachEvent?o.attachEvent("on"+n.type,a):o["on"+n.type]=a}},Zx,t0,u0,Dha,Eha,mta,nta,eXa,fXa;define("shortcut",(Zx=this,function(){return Zx.shortcut})),define("deps/text",["module"],function(e){var t,n,r,i,o,a=["Msxml2.XMLHTTP","Microsoft.XMLHTTP","Msxml2.XMLHTTP.4.0"],s=/^\s*<\?xml(\s)+version=[\'\"](\d)*.(\d)*[\'\"](\s)*\?>/im,l=/]*>\s*([\s\S]+)\s*<\/body>/im,c="undefined"!=typeof location&&location.href,u=c&&location.protocol&&location.protocol.replace(/\:/,""),d=c&&location.hostname,p=c&&(location.port||void 0),f={},h=e.config&&e.config()||{};function m(e,t){return void 0===e||""===e?t:e}return t={version:"2.0.15",strip:function(e){if(e){var t=(e=e.replace(s,"")).match(l);t&&(e=t[1])}else e="";return e},jsEscape:function(e){return e.replace(/(['\\])/g,"\\$1").replace(/[\f]/g,"\\f").replace(/[\b]/g,"\\b").replace(/[\n]/g,"\\n").replace(/[\t]/g,"\\t").replace(/[\r]/g,"\\r").replace(/[\u2028]/g,"\\u2028").replace(/[\u2029]/g,"\\u2029")},createXhr:h.createXhr||function(){var e,t,n;if("undefined"!=typeof XMLHttpRequest)return new XMLHttpRequest;if("undefined"!=typeof ActiveXObject)for(t=0;t<3;t+=1){n=a[t];try{e=new ActiveXObject(n)}catch(e){}if(e){a=[n];break}}return e},parseName:function(e){var t,n,r,i=!1,o=e.lastIndexOf("."),a=0===e.indexOf("./")||0===e.indexOf("../");return-1!==o&&(!a||o>1)?(t=e.substring(0,o),n=e.substring(o+1)):t=e,-1!==(o=(r=n||t).indexOf("!"))&&(i="strip"===r.substring(o+1),r=r.substring(0,o),n?n=r:t=r),{moduleName:t,ext:n,strip:i}},xdRegExp:/^((\w+)\:)?\/\/([^\/\\]+)/,useXhr:function(e,n,r,i){var o,a,s,l=t.xdRegExp.exec(e);return!l||(o=l[2],s=(a=(a=l[3]).split(":"))[1],a=a[0],(!o||o===n)&&(!a||a.toLowerCase()===r.toLowerCase())&&(!s&&!a||function(e,t,n,r){if(t===r)return!0;if(e===n){if("http"===e)return m(t,"80")===m(r,"80");if("https"===e)return m(t,"443")===m(r,"443")}return!1}(o,s,n,i)))},finishLoad:function(e,n,r,i){r=n?t.strip(r):r,h.isBuild&&(f[e]=r),i(r)},load:function(e,n,r,i){if(i&&i.isBuild&&!i.inlineText)r();else{h.isBuild=i&&i.isBuild;var o=t.parseName(e),a=o.moduleName+(o.ext?"."+o.ext:""),s=n.toUrl(a),l=h.useXhr||t.useXhr;0!==s.indexOf("empty:")?!c||l(s,u,d,p)?t.get(s,function(n){t.finishLoad(e,o.strip,n,r)},function(e){r.error&&r.error(e)}):n([a],function(e){t.finishLoad(o.moduleName+"."+o.ext,o.strip,e,r)}):r()}},write:function(e,n,r,i){if(f.hasOwnProperty(n)){var o=t.jsEscape(f[n]);r.asModule(e+"!"+n,"define(function () { return '"+o+"';});\n")}},writeFile:function(e,n,r,i,o){var a=t.parseName(n),s=a.ext?"."+a.ext:"",l=a.moduleName+s,c=r.toUrl(a.moduleName+s)+".js";t.load(l,r,function(n){var r=function(e){return i(c,e)};r.asModule=function(e,t){return i.asModule(e,c,t)},t.write(e,l,r,o)},o)}},"node"===h.env||!h.env&&"undefined"!=typeof process&&process.versions&&process.versions.node&&!process.versions["node-webkit"]&&!process.versions["atom-shell"]?(n=require.nodeRequire("fs"),t.get=function(e,t,r){try{var i=n.readFileSync(e,"utf8");"\ufeff"===i[0]&&(i=i.substring(1)),t(i)}catch(e){r&&r(e)}}):"xhr"===h.env||!h.env&&t.createXhr()?t.get=function(e,n,r,i){var o,a=t.createXhr();if(a.open("GET",e,!0),i)for(o in i)i.hasOwnProperty(o)&&a.setRequestHeader(o.toLowerCase(),i[o]);h.onXhr&&h.onXhr(a,e),a.onreadystatechange=function(t){var i,o;4===a.readyState&&((i=a.status||0)>399&&i<600?((o=new Error(e+" HTTP status: "+i)).xhr=a,r&&r(o)):n(a.responseText),h.onXhrComplete&&h.onXhrComplete(a,e))},a.send(null)}:"rhino"===h.env||!h.env&&"undefined"!=typeof Packages&&"undefined"!=typeof java?t.get=function(e,t){var n,r,i=new java.io.File(e),o=java.lang.System.getProperty("line.separator"),a=new java.io.BufferedReader(new java.io.InputStreamReader(new java.io.FileInputStream(i),"utf-8")),s="";try{for(n=new java.lang.StringBuffer,(r=a.readLine())&&r.length()&&65279===r.charAt(0)&&(r=r.substring(1)),null!==r&&n.append(r);null!==(r=a.readLine());)n.append(o),n.append(r);s=String(n.toString())}finally{a.close()}t(s)}:("xpconnect"===h.env||!h.env&&"undefined"!=typeof Components&&Components.classes&&Components.interfaces)&&(r=Components.classes,i=Components.interfaces,Components.utils.import("resource://gre/modules/FileUtils.jsm"),o="@mozilla.org/windows-registry-key;1"in r,t.get=function(e,t){var n,a,s,l={};o&&(e=e.replace(/\//g,"\\")),s=new FileUtils.File(e);try{(n=r["@mozilla.org/network/file-input-stream;1"].createInstance(i.nsIFileInputStream)).init(s,1,0,!1),(a=r["@mozilla.org/intl/converter-input-stream;1"].createInstance(i.nsIConverterInputStream)).init(n,"utf-8",n.available(),i.nsIConverterInputStream.DEFAULT_REPLACEMENT_CHARACTER),a.readString(n.available(),l),a.close(),n.close(),t(l.value)}catch(e){throw new Error((s&&s.path||"")+": "+e)}}),t}),define("deps/text!ui/ui.css",[],function(){return'#respec-ui {\n position: fixed;\n display: flex;\n flex-direction: row-reverse;\n top: 20px;\n right: 20px;\n width: 202px;\n text-align: right;\n z-index: 9000;\n}\n\n#respec-pill,\n.respec-info-button {\n background: #fff;\n height: 2.5em;\n color: rgb(120, 120, 120);\n border: 1px solid #ccc;\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\n}\n\n.respec-info-button {\n border: none;\n opacity: 0.75;\n border-radius: 2em;\n margin-right: 1em;\n min-width: 3.5em;\n}\n\n.respec-info-button:focus,\n.respec-info-button:hover {\n opacity: 1;\n transition: opacity 0.2s;\n}\n\n#respec-pill:disabled {\n font-size: 2.8px;\n text-indent: -9999em;\n border-top: 1.1em solid rgba(40, 40, 40, 0.2);\n border-right: 1.1em solid rgba(40, 40, 40, 0.2);\n border-bottom: 1.1em solid rgba(40, 40, 40, 0.2);\n border-left: 1.1em solid #ffffff;\n transform: translateZ(0);\n animation: respec-spin 0.5s infinite linear;\n box-shadow: none;\n}\n\n#respec-pill:disabled,\n#respec-pill:disabled:after {\n border-radius: 50%;\n width: 10em;\n height: 10em;\n}\n\n@keyframes respec-spin {\n 0% {\n transform: rotate(0deg);\n }\n 100% {\n transform: rotate(360deg);\n }\n}\n\n.respec-hidden {\n visibility: hidden;\n opacity: 0;\n transition: visibility 0s 0.2s, opacity 0.2s linear;\n}\n\n.respec-visible {\n visibility: visible;\n opacity: 1;\n transition: opacity 0.2s linear;\n}\n\n#respec-pill:hover,\n#respec-pill:focus {\n color: rgb(0, 0, 0);\n background-color: rgb(245, 245, 245);\n transition: color 0.2s;\n}\n\n#respec-menu {\n position: absolute;\n margin: 0;\n padding: 0;\n font-family: sans-serif;\n background: #fff;\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\n width: 200px;\n display: none;\n text-align: left;\n margin-top: 32px;\n font-size: 0.8em;\n}\n\n#respec-menu:not([hidden]) {\n display: block;\n}\n\n#respec-menu li {\n list-style-type: none;\n margin: 0;\n padding: 0;\n}\n\n.respec-save-buttons {\n display: grid;\n grid-template-columns: repeat(auto-fill, minmax(47%, 2fr));\n grid-gap: 0.5cm;\n padding: 0.5cm;\n}\n\n.respec-save-button:link {\n padding-top: 16px;\n color: rgb(240, 240, 240);\n background: rgb(42, 90, 168);\n justify-self: stretch;\n height: 1cm;\n text-decoration: none;\n text-align: center;\n font-size: inherit;\n border: none;\n border-radius: 0.2cm;\n}\n\n.respec-save-button:link:hover {\n color: white;\n background: rgb(42, 90, 168);\n padding: 0;\n margin: 0;\n border: 0;\n padding-top: 16px;\n}\n\n#respec-ui button:focus,\n#respec-pill:focus,\n.respec-option:focus {\n outline: 0;\n outline-style: none;\n}\n\n#respec-pill-error {\n background-color: red;\n color: white;\n}\n\n#respec-pill-warning {\n background-color: orange;\n color: white;\n}\n\n.respec-warning-list,\n.respec-error-list {\n margin: 0;\n padding: 0;\n list-style: none;\n font-family: sans-serif;\n background-color: rgb(255, 251, 230);\n font-size: 0.85em;\n}\n\n.respec-warning-list > li,\n.respec-error-list > li {\n padding: 0.4em 0.7em;\n}\n\n.respec-warning-list > li::before {\n content: "⚠️";\n padding-right: 0.5em;\n}\n.respec-warning-list p,\n.respec-error-list p {\n padding: 0;\n margin: 0;\n}\n\n.respec-warning-list li {\n color: rgb(92, 59, 0);\n border-bottom: thin solid rgb(255, 245, 194);\n}\n\n.respec-error-list,\n.respec-error-list li {\n background-color: rgb(255, 240, 240);\n}\n\n.respec-error-list li::before {\n content: "💥";\n padding-right: 0.5em;\n}\n\n.respec-error-list li {\n padding: 0.4em 0.7em;\n color: rgb(92, 59, 0);\n border-bottom: thin solid rgb(255, 215, 215);\n}\n\n.respec-error-list li > p {\n margin: 0;\n padding: 0;\n display: inline-block;\n}\n\n#respec-overlay {\n display: block;\n position: fixed;\n z-index: 10000;\n top: 0px;\n left: 0px;\n height: 100%;\n width: 100%;\n background: #000;\n}\n\n.respec-show-overlay {\n transition: opacity 0.2s linear;\n opacity: 0.5;\n}\n\n.respec-hide-overlay {\n transition: opacity 0.2s linear;\n opacity: 0;\n}\n\n.respec-modal {\n display: block;\n position: fixed;\n z-index: 11000;\n margin: auto;\n top: 10%;\n background: #fff;\n border: 5px solid #666;\n min-width: 20%;\n width: 79%;\n padding: 0;\n max-height: 80%;\n overflow-y: auto;\n margin: 0 -0.5cm;\n}\n\n@media screen and (min-width: 78em) {\n .respec-modal {\n width: 62%;\n }\n}\n\n.respec-modal h3 {\n margin: 0;\n padding: 0.2em;\n text-align: center;\n color: black;\n background: linear-gradient(\n to bottom,\n rgba(238, 238, 238, 1) 0%,\n rgba(238, 238, 238, 1) 50%,\n rgba(204, 204, 204, 1) 100%\n );\n font-size: 1em;\n}\n\n.respec-modal .inside div p {\n padding-left: 1cm;\n}\n\n#respec-menu button.respec-option {\n background: white;\n padding: 0 0.2cm;\n border: none;\n width: 100%;\n text-align: left;\n font-size: inherit;\n padding: 1.2em 1.2em;\n}\n\n#respec-menu button.respec-option:hover,\n#respec-menu button:focus {\n background-color: #eeeeee;\n}\n\n.respec-cmd-icon {\n padding-right: 0.5em;\n}\n\n#respec-ui button.respec-option:last-child {\n border: none;\n border-radius: inherit;\n}\n\n.respec-offending-element {\n display: inline-block;\n position: relative;\n background: url(data:image/gif;base64,R0lGODdhBAADAPEAANv///8AAP///wAAACwAAAAABAADAEACBZQjmIAFADs=)\n bottom repeat-x;\n}\n\n@supports (text-decoration-style: wavy) {\n .respec-offending-element {\n background: none;\n text-decoration-line: underline;\n text-decoration-style: wavy;\n text-decoration-color: red;\n }\n}\n\n.respec-button-copy-paste {\n position: absolute;\n display: block;\n padding: 0px 8px;\n height: 28px;\n width: 40px;\n color: #333;\n white-space: nowrap;\n vertical-align: middle;\n cursor: pointer;\n background-color: #eee;\n background-image: linear-gradient(#fcfcfc, #eee);\n border: 1px solid rgb(144, 184, 222);\n border-radius: 0px 0px 3px 0;\n -webkit-user-select: none;\n -moz-user-select: none;\n -ms-user-select: none;\n user-select: none;\n -webkit-appearance: none;\n margin: 0px 127px;\n border-left: 0;\n}\n\np + .respec-button-copy-paste {\n margin: 1px 127px;\n}\n\n#specref-ui {\n margin: 0 2%;\n margin-bottom: 0.5cm;\n}\n\n#specref-ui header {\n font-size: 0.7em;\n background-color: #eee;\n text-align: center;\n padding: 0.2cm;\n margin-bottom: 0.5cm;\n border-radius: 0 0 0.2cm 0.2cm;\n}\n\n#specref-ui header h1 {\n padding: 0;\n margin: 0;\n color: black;\n}\n\n#specref-ui p {\n padding: 0;\n margin: 0;\n font-size: 0.8em;\n text-align: center;\n}\n\n#specref-ui p.state {\n margin: 1cm;\n}\n\n#specref-ui .searchcomponent {\n font-size: 16px;\n display: grid;\n grid-template-columns: auto 2cm;\n}\n#specref-ui .searchcomponent:focus {\n}\n\n#specref-ui input,\n#specref-ui button {\n border: 0;\n padding: 6px 12px;\n}\n\n#specref-ui label {\n font-size: 0.6em;\n grid-column-end: 3;\n text-align: right;\n grid-column-start: 1;\n}\n\n#specref-ui input[type="search"] {\n -webkit-appearance: none;\n font-size: 16px;\n border-radius: 0.1cm 0 0 0.1cm;\n border: 1px solid rgb(204, 204, 204);\n}\n\n#specref-ui button[type="submit"] {\n color: white;\n border-radius: 0 0.1cm 0.1cm 0;\n background-color: rgb(51, 122, 183);\n}\n\n#specref-ui button[type="submit"]:hover {\n background-color: #286090;\n border-color: #204d74;\n}\n\n#specref-ui .result-stats {\n margin: 0;\n padding: 0;\n color: rgb(128, 128, 128);\n font-size: 0.7em;\n font-weight: bold;\n}\n\n#specref-ui .specref-results {\n font-size: 0.8em;\n}\n\n#specref-ui .specref-results dd + dt {\n margin-top: 0.51cm;\n}\n\n#specref-ui .specref-results a {\n text-transform: capitalize;\n}\n#specref-ui .specref-results .authors {\n display: block;\n color: #006621;\n}\n\n@media print {\n #respec-ui {\n display: none;\n }\n}\n'}),t0="undefined"!=typeof window?window:this,u0=function(e,t){var n=[],r=e.document,i=Object.getPrototypeOf,o=n.slice,a=n.concat,s=n.push,l=n.indexOf,c={},u=c.toString,d=c.hasOwnProperty,p=d.toString,f=p.call(Object),h={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType},g=function(e){return null!=e&&e===e.window},b={type:!0,src:!0,noModule:!0};function y(e,t,n){var i,o=(t=t||r).createElement("script");if(o.text=e,n)for(i in b)n[i]&&(o[i]=n[i]);t.head.appendChild(o).parentNode.removeChild(o)}function v(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?c[u.call(e)]||"object":typeof e}var w="3.3.1 -ajax,-ajax/jsonp,-ajax/load,-ajax/parseXML,-ajax/script,-ajax/var/location,-ajax/var/nonce,-ajax/var/rquery,-ajax/xhr,-manipulation/_evalUrl,-event/ajax,-effects,-effects/Tween,-effects/animatedSelector",x=function(e,t){return new x.fn.init(e,t)},k=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;function C(e){var t=!!e&&"length"in e&&e.length,n=v(e);return!m(e)&&!g(e)&&("array"===n||0===t||"number"==typeof t&&t>0&&t-1 in e)}x.fn=x.prototype={jquery:w,constructor:x,length:0,toArray:function(){return o.call(this)},get:function(e){return null==e?o.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=x.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return x.each(this,e)},map:function(e){return this.pushStack(x.map(this,function(t,n){return e.call(t,n,t)}))},slice:function(){return this.pushStack(o.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(n>=0&&n+~]|"+M+")"+M+"*"),F=new RegExp("="+M+"*([^\\]'\"]*?)"+M+"*\\]","g"),z=new RegExp(q),G=new RegExp("^"+O+"$"),V={ID:new RegExp("^#("+O+")"),CLASS:new RegExp("^\\.("+O+")"),TAG:new RegExp("^("+O+"|[*])"),ATTR:new RegExp("^"+I),PSEUDO:new RegExp("^"+q),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+P+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},X=/^(?:input|select|textarea|button)$/i,Z=/^h\d$/i,Y=/^[^{]+\{\s*\[native \w/,Q=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,J=/[+~]/,K=new RegExp("\\\\([\\da-f]{1,6}"+M+"?|("+M+")|.)","ig"),ee=function(e,t,n){var r="0x"+t-65536;return r!=r||n?t:r<0?String.fromCharCode(r+65536):String.fromCharCode(r>>10|55296,1023&r|56320)},te=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ne=function(e,t){return t?"\0"===e?"�":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},re=function(){p()},ie=ye(function(e){return!0===e.disabled&&("form"in e||"label"in e)},{dir:"parentNode",next:"legend"});try{_.apply(L=N.call(x.childNodes),x.childNodes),L[x.childNodes.length].nodeType}catch(e){_={apply:L.length?function(e,t){D.apply(e,N.call(t))}:function(e,t){for(var n=e.length,r=0;e[n++]=t[r++];);e.length=n-1}}}function oe(e,t,r,i){var o,s,c,u,d,h,b,y=t&&t.ownerDocument,k=t?t.nodeType:9;if(r=r||[],"string"!=typeof e||!e||1!==k&&9!==k&&11!==k)return r;if(!i&&((t?t.ownerDocument||t:x)!==f&&p(t),t=t||f,m)){if(11!==k&&(d=Q.exec(e)))if(o=d[1]){if(9===k){if(!(c=t.getElementById(o)))return r;if(c.id===o)return r.push(c),r}else if(y&&(c=y.getElementById(o))&&v(t,c)&&c.id===o)return r.push(c),r}else{if(d[2])return _.apply(r,t.getElementsByTagName(e)),r;if((o=d[3])&&n.getElementsByClassName&&t.getElementsByClassName)return _.apply(r,t.getElementsByClassName(o)),r}if(n.qsa&&!T[e+" "]&&(!g||!g.test(e))){if(1!==k)y=t,b=e;else if("object"!==t.nodeName.toLowerCase()){for((u=t.getAttribute("id"))?u=u.replace(te,ne):t.setAttribute("id",u=w),s=(h=a(e)).length;s--;)h[s]="#"+u+" "+be(h[s]);b=h.join(","),y=J.test(e)&&me(t.parentNode)||t}if(b)try{return _.apply(r,y.querySelectorAll(b)),r}catch(e){}finally{u===w&&t.removeAttribute("id")}}}return l(e.replace(W,"$1"),t,r,i)}function ae(){var e=[];return function t(n,i){return e.push(n+" ")>r.cacheLength&&delete t[e.shift()],t[n+" "]=i}}function se(e){return e[w]=!0,e}function le(e){var t=f.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function ce(e,t){for(var n=e.split("|"),i=n.length;i--;)r.attrHandle[n[i]]=t}function ue(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)for(;n=n.nextSibling;)if(n===t)return-1;return e?1:-1}function de(e){return function(t){return"input"===t.nodeName.toLowerCase()&&t.type===e}}function pe(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function fe(e){return function(t){return"form"in t?t.parentNode&&!1===t.disabled?"label"in t?"label"in t.parentNode?t.parentNode.disabled===e:t.disabled===e:t.isDisabled===e||t.isDisabled!==!e&&ie(t)===e:t.disabled===e:"label"in t&&t.disabled===e}}function he(e){return se(function(t){return t=+t,se(function(n,r){for(var i,o=e([],n.length,t),a=o.length;a--;)n[i=o[a]]&&(n[i]=!(r[i]=n[i]))})})}function me(e){return e&&void 0!==e.getElementsByTagName&&e}n=oe.support={},o=oe.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return!!t&&"HTML"!==t.nodeName},p=oe.setDocument=function(e){var t,i,a=e?e.ownerDocument||e:x;return a!==f&&9===a.nodeType&&a.documentElement?(h=(f=a).documentElement,m=!o(f),x!==f&&(i=f.defaultView)&&i.top!==i&&(i.addEventListener?i.addEventListener("unload",re,!1):i.attachEvent&&i.attachEvent("onunload",re)),n.attributes=le(function(e){return e.className="i",!e.getAttribute("className")}),n.getElementsByTagName=le(function(e){return e.appendChild(f.createComment("")),!e.getElementsByTagName("*").length}),n.getElementsByClassName=Y.test(f.getElementsByClassName),n.getById=le(function(e){return h.appendChild(e).id=w,!f.getElementsByName||!f.getElementsByName(w).length}),n.getById?(r.filter.ID=function(e){var t=e.replace(K,ee);return function(e){return e.getAttribute("id")===t}},r.find.ID=function(e,t){if(void 0!==t.getElementById&&m){var n=t.getElementById(e);return n?[n]:[]}}):(r.filter.ID=function(e){var t=e.replace(K,ee);return function(e){var n=void 0!==e.getAttributeNode&&e.getAttributeNode("id");return n&&n.value===t}},r.find.ID=function(e,t){if(void 0!==t.getElementById&&m){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];for(i=t.getElementsByName(e),r=0;o=i[r++];)if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),r.find.TAG=n.getElementsByTagName?function(e,t){return void 0!==t.getElementsByTagName?t.getElementsByTagName(e):n.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){for(;n=o[i++];)1===n.nodeType&&r.push(n);return r}return o},r.find.CLASS=n.getElementsByClassName&&function(e,t){if(void 0!==t.getElementsByClassName&&m)return t.getElementsByClassName(e)},b=[],g=[],(n.qsa=Y.test(f.querySelectorAll))&&(le(function(e){h.appendChild(e).innerHTML="
        ",e.querySelectorAll("[msallowcapture^='']").length&&g.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||g.push("\\["+M+"*(?:value|"+P+")"),e.querySelectorAll("[id~="+w+"-]").length||g.push("~="),e.querySelectorAll(":checked").length||g.push(":checked"),e.querySelectorAll("a#"+w+"+*").length||g.push(".#.+[+~]")}),le(function(e){e.innerHTML="";var t=f.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&g.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&g.push(":enabled",":disabled"),h.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&g.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),g.push(",.*:")})),(n.matchesSelector=Y.test(y=h.matches||h.webkitMatchesSelector||h.mozMatchesSelector||h.oMatchesSelector||h.msMatchesSelector))&&le(function(e){n.disconnectedMatch=y.call(e,"*"),y.call(e,"[s!='']:x"),b.push("!=",q)}),g=g.length&&new RegExp(g.join("|")),b=b.length&&new RegExp(b.join("|")),t=Y.test(h.compareDocumentPosition),v=t||Y.test(h.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)for(;t=t.parentNode;)if(t===e)return!0;return!1},S=t?function(e,t){if(e===t)return d=!0,0;var r=!e.compareDocumentPosition-!t.compareDocumentPosition;return r||(1&(r=(e.ownerDocument||e)===(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!n.sortDetached&&t.compareDocumentPosition(e)===r?e===f||e.ownerDocument===x&&v(x,e)?-1:t===f||t.ownerDocument===x&&v(x,t)?1:u?R(u,e)-R(u,t):0:4&r?-1:1)}:function(e,t){if(e===t)return d=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e===f?-1:t===f?1:i?-1:o?1:u?R(u,e)-R(u,t):0;if(i===o)return ue(e,t);for(n=e;n=n.parentNode;)a.unshift(n);for(n=t;n=n.parentNode;)s.unshift(n);for(;a[r]===s[r];)r++;return r?ue(a[r],s[r]):a[r]===x?-1:s[r]===x?1:0},f):f},oe.matches=function(e,t){return oe(e,null,null,t)},oe.matchesSelector=function(e,t){if((e.ownerDocument||e)!==f&&p(e),t=t.replace(F,"='$1']"),n.matchesSelector&&m&&!T[t+" "]&&(!b||!b.test(t))&&(!g||!g.test(t)))try{var r=y.call(e,t);if(r||n.disconnectedMatch||e.document&&11!==e.document.nodeType)return r}catch(e){}return oe(t,f,null,[e]).length>0},oe.contains=function(e,t){return(e.ownerDocument||e)!==f&&p(e),v(e,t)},oe.attr=function(e,t){(e.ownerDocument||e)!==f&&p(e);var i=r.attrHandle[t.toLowerCase()],o=i&&A.call(r.attrHandle,t.toLowerCase())?i(e,t,!m):void 0;return void 0!==o?o:n.attributes||!m?e.getAttribute(t):(o=e.getAttributeNode(t))&&o.specified?o.value:null},oe.escape=function(e){return(e+"").replace(te,ne)},oe.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},oe.uniqueSort=function(e){var t,r=[],i=0,o=0;if(d=!n.detectDuplicates,u=!n.sortStable&&e.slice(0),e.sort(S),d){for(;t=e[o++];)t===e[o]&&(i=r.push(o));for(;i--;)e.splice(r[i],1)}return u=null,e},i=oe.getText=function(e){var t,n="",r=0,o=e.nodeType;if(o){if(1===o||9===o||11===o){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=i(e)}else if(3===o||4===o)return e.nodeValue}else for(;t=e[r++];)n+=i(t);return n},(r=oe.selectors={cacheLength:50,createPseudo:se,match:V,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(K,ee),e[3]=(e[3]||e[4]||e[5]||"").replace(K,ee),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||oe.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&oe.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return V.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&z.test(n)&&(t=a(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(K,ee).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=E[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&E(e,function(e){return t.test("string"==typeof e.className&&e.className||void 0!==e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r){var i=oe.attr(r,e);return null==i?"!="===t:!t||(i+="","="===t?i===n:"!="===t?i!==n:"^="===t?n&&0===i.indexOf(n):"*="===t?n&&i.indexOf(n)>-1:"$="===t?n&&i.slice(-n.length)===n:"~="===t?(" "+i.replace(U," ")+" ").indexOf(n)>-1:"|="===t&&(i===n||i.slice(0,n.length+1)===n+"-"))}},CHILD:function(e,t,n,r,i){var o="nth"!==e.slice(0,3),a="last"!==e.slice(-4),s="of-type"===t;return 1===r&&0===i?function(e){return!!e.parentNode}:function(t,n,l){var c,u,d,p,f,h,m=o!==a?"nextSibling":"previousSibling",g=t.parentNode,b=s&&t.nodeName.toLowerCase(),y=!l&&!s,v=!1;if(g){if(o){for(;m;){for(p=t;p=p[m];)if(s?p.nodeName.toLowerCase()===b:1===p.nodeType)return!1;h=m="only"===e&&!h&&"nextSibling"}return!0}if(h=[a?g.firstChild:g.lastChild],a&&y){for(v=(f=(c=(u=(d=(p=g)[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]||[])[0]===k&&c[1])&&c[2],p=f&&g.childNodes[f];p=++f&&p&&p[m]||(v=f=0)||h.pop();)if(1===p.nodeType&&++v&&p===t){u[e]=[k,f,v];break}}else if(y&&(v=f=(c=(u=(d=(p=t)[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]||[])[0]===k&&c[1]),!1===v)for(;(p=++f&&p&&p[m]||(v=f=0)||h.pop())&&((s?p.nodeName.toLowerCase()!==b:1!==p.nodeType)||!++v||(y&&((u=(d=p[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]=[k,v]),p!==t)););return(v-=i)===r||v%r==0&&v/r>=0}}},PSEUDO:function(e,t){var n,i=r.pseudos[e]||r.setFilters[e.toLowerCase()]||oe.error("unsupported pseudo: "+e);return i[w]?i(t):i.length>1?(n=[e,e,"",t],r.setFilters.hasOwnProperty(e.toLowerCase())?se(function(e,n){for(var r,o=i(e,t),a=o.length;a--;)e[r=R(e,o[a])]=!(n[r]=o[a])}):function(e){return i(e,0,n)}):i}},pseudos:{not:se(function(e){var t=[],n=[],r=s(e.replace(W,"$1"));return r[w]?se(function(e,t,n,i){for(var o,a=r(e,null,i,[]),s=e.length;s--;)(o=a[s])&&(e[s]=!(t[s]=o))}):function(e,i,o){return t[0]=e,r(t,null,o,n),t[0]=null,!n.pop()}}),has:se(function(e){return function(t){return oe(e,t).length>0}}),contains:se(function(e){return e=e.replace(K,ee),function(t){return(t.textContent||t.innerText||i(t)).indexOf(e)>-1}}),lang:se(function(e){return G.test(e||"")||oe.error("unsupported lang: "+e),e=e.replace(K,ee).toLowerCase(),function(t){var n;do{if(n=m?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return(n=n.toLowerCase())===e||0===n.indexOf(e+"-")}while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===h},focus:function(e){return e===f.activeElement&&(!f.hasFocus||f.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:fe(!1),disabled:fe(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!r.pseudos.empty(e)},header:function(e){return Z.test(e.nodeName)},input:function(e){return X.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:he(function(){return[0]}),last:he(function(e,t){return[t-1]}),eq:he(function(e,t,n){return[n<0?n+t:n]}),even:he(function(e,t){for(var n=0;n=0;)e.push(r);return e}),gt:he(function(e,t,n){for(var r=n<0?n+t:n;++r1?function(t,n,r){for(var i=e.length;i--;)if(!e[i](t,n,r))return!1;return!0}:e[0]}function we(e,t,n,r,i){for(var o,a=[],s=0,l=e.length,c=null!=t;s-1&&(o[c]=!(a[c]=d))}}else b=we(b===a?b.splice(h,b.length):b),i?i(null,a,b,l):_.apply(a,b)})}function ke(e){for(var t,n,i,o=e.length,a=r.relative[e[0].type],s=a||r.relative[" "],l=a?1:0,u=ye(function(e){return e===t},s,!0),d=ye(function(e){return R(t,e)>-1},s,!0),p=[function(e,n,r){var i=!a&&(r||n!==c)||((t=n).nodeType?u(e,n,r):d(e,n,r));return t=null,i}];l1&&ve(p),l>1&&be(e.slice(0,l-1).concat({value:" "===e[l-2].type?"*":""})).replace(W,"$1"),n,l0,l=i.length>0,u=function(e,t,n,a,u){var d,h,g,b=0,y="0",v=e&&[],w=[],x=c,C=e||l&&r.find.TAG("*",u),E=k+=null==x?1:Math.random()||.1,$=C.length;for(u&&(c=t===f||t||u);y!==$&&null!=(d=C[y]);y++){if(l&&d){for(h=0,t||d.ownerDocument===f||(p(d),n=!m);g=i[h++];)if(g(d,t||f,n)){a.push(d);break}u&&(k=E)}s&&((d=!g&&d)&&b--,e&&v.push(d))}if(b+=y,s&&y!==b){for(h=0;g=o[h++];)g(v,w,t,n);if(e){if(b>0)for(;y--;)v[y]||w[y]||(w[y]=j.call(a));w=we(w)}_.apply(a,w),u&&!e&&w.length>0&&b+o.length>1&&oe.uniqueSort(a)}return u&&(k=E,c=x),v},s?se(u):u))).selector=e}return g},l=oe.select=function(e,t,n,i){var o,l,c,u,d,p="function"==typeof e&&e,f=!i&&a(e=p.selector||e);if(n=n||[],1===f.length){if((l=f[0]=f[0].slice(0)).length>2&&"ID"===(c=l[0]).type&&9===t.nodeType&&m&&r.relative[l[1].type]){if(!(t=(r.find.ID(c.matches[0].replace(K,ee),t)||[])[0]))return n;p&&(t=t.parentNode),e=e.slice(l.shift().value.length)}for(o=V.needsContext.test(e)?0:l.length;o--&&(c=l[o],!r.relative[u=c.type]);)if((d=r.find[u])&&(i=d(c.matches[0].replace(K,ee),J.test(l[0].type)&&me(t.parentNode)||t))){if(l.splice(o,1),!(e=i.length&&be(l)))return _.apply(n,i),n;break}}return(p||s(e,f))(i,t,!m,n,!t||J.test(e)&&me(t.parentNode)||t),n},n.sortStable=w.split("").sort(S).join("")===w,n.detectDuplicates=!!d,p(),n.sortDetached=le(function(e){return 1&e.compareDocumentPosition(f.createElement("fieldset"))}),le(function(e){return e.innerHTML="","#"===e.firstChild.getAttribute("href")})||ce("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),n.attributes&&le(function(e){return e.innerHTML="",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||ce("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),le(function(e){return null==e.getAttribute("disabled")})||ce(P,function(e,t,n){var r;if(!n)return!0===e[t]?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),oe}(e);x.find=E,x.expr=E.selectors,x.expr[":"]=x.expr.pseudos,x.uniqueSort=x.unique=E.uniqueSort,x.text=E.getText,x.isXMLDoc=E.isXML,x.contains=E.contains,x.escapeSelector=E.escape;var $=function(e,t,n){for(var r=[],i=void 0!==n;(e=e[t])&&9!==e.nodeType;)if(1===e.nodeType){if(i&&x(e).is(n))break;r.push(e)}return r},T=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},S=x.expr.match.needsContext;function A(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var L=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,t,n){return m(t)?x.grep(e,function(e,r){return!!t.call(e,r,e)!==n}):t.nodeType?x.grep(e,function(e){return e===t!==n}):"string"!=typeof t?x.grep(e,function(e){return l.call(t,e)>-1!==n}):x.filter(t,e,n)}x.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?x.find.matchesSelector(r,e)?[r]:[]:x.find.matches(e,x.grep(t,function(e){return 1===e.nodeType}))},x.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(x(e).filter(function(){for(t=0;t1?x.uniqueSort(n):n},filter:function(e){return this.pushStack(j(this,e||[],!1))},not:function(e){return this.pushStack(j(this,e||[],!0))},is:function(e){return!!j(this,"string"==typeof e&&S.test(e)?x(e):e||[],!1).length}});var D,_=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/;(x.fn.init=function(e,t,n){var i,o;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(i="<"===e[0]&&">"===e[e.length-1]&&e.length>=3?[null,e,null]:_.exec(e))||!i[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(i[1]){if(t=t instanceof x?t[0]:t,x.merge(this,x.parseHTML(i[1],t&&t.nodeType?t.ownerDocument||t:r,!0)),L.test(i[1])&&x.isPlainObject(t))for(i in t)m(this[i])?this[i](t[i]):this.attr(i,t[i]);return this}return(o=r.getElementById(i[2]))&&(this[0]=o,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(x):x.makeArray(e,this)}).prototype=x.fn,D=x(r);var N=/^(?:parents|prev(?:Until|All))/,R={children:!0,contents:!0,next:!0,prev:!0};function P(e,t){for(;(e=e[t])&&1!==e.nodeType;);return e}x.fn.extend({has:function(e){var t=x(e,this),n=t.length;return this.filter(function(){for(var e=0;e-1:1===n.nodeType&&x.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(o.length>1?x.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?l.call(x(e),this[0]):l.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(x.uniqueSort(x.merge(this.get(),x(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),x.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return $(e,"parentNode")},parentsUntil:function(e,t,n){return $(e,"parentNode",n)},next:function(e){return P(e,"nextSibling")},prev:function(e){return P(e,"previousSibling")},nextAll:function(e){return $(e,"nextSibling")},prevAll:function(e){return $(e,"previousSibling")},nextUntil:function(e,t,n){return $(e,"nextSibling",n)},prevUntil:function(e,t,n){return $(e,"previousSibling",n)},siblings:function(e){return T((e.parentNode||{}).firstChild,e)},children:function(e){return T(e.firstChild)},contents:function(e){return A(e,"iframe")?e.contentDocument:(A(e,"template")&&(e=e.content||e),x.merge([],e.childNodes))}},function(e,t){x.fn[e]=function(n,r){var i=x.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(i=x.filter(r,i)),this.length>1&&(R[e]||x.uniqueSort(i),N.test(e)&&i.reverse()),this.pushStack(i)}});var M=/[^\x20\t\r\n\f]+/g;function O(e){return e}function I(e){throw e}function q(e,t,n,r){var i;try{e&&m(i=e.promise)?i.call(e).done(t).fail(n):e&&m(i=e.then)?i.call(e,t,n):t.apply(void 0,[e].slice(r))}catch(e){n.apply(void 0,[e])}}x.Callbacks=function(e){var t,n;e="string"==typeof e?(t=e,n={},x.each(t.match(M)||[],function(e,t){n[t]=!0}),n):x.extend({},e);var r,i,o,a,s=[],l=[],c=-1,u=function(){for(a=a||e.once,o=r=!0;l.length;c=-1)for(i=l.shift();++c-1;)s.splice(n,1),n<=c&&c--}),this},has:function(e){return e?x.inArray(e,s)>-1:s.length>0},empty:function(){return s&&(s=[]),this},disable:function(){return a=l=[],s=i="",this},disabled:function(){return!s},lock:function(){return a=l=[],i||r||(s=i=""),this},locked:function(){return!!a},fireWith:function(e,t){return a||(t=[e,(t=t||[]).slice?t.slice():t],l.push(t),r||u()),this},fire:function(){return d.fireWith(this,arguments),this},fired:function(){return!!o}};return d},x.extend({Deferred:function(t){var n=[["notify","progress",x.Callbacks("memory"),x.Callbacks("memory"),2],["resolve","done",x.Callbacks("once memory"),x.Callbacks("once memory"),0,"resolved"],["reject","fail",x.Callbacks("once memory"),x.Callbacks("once memory"),1,"rejected"]],r="pending",i={state:function(){return r},always:function(){return o.done(arguments).fail(arguments),this},catch:function(e){return i.then(null,e)},pipe:function(){var e=arguments;return x.Deferred(function(t){x.each(n,function(n,r){var i=m(e[r[4]])&&e[r[4]];o[r[1]](function(){var e=i&&i.apply(this,arguments);e&&m(e.promise)?e.promise().progress(t.notify).done(t.resolve).fail(t.reject):t[r[0]+"With"](this,i?[e]:arguments)})}),e=null}).promise()},then:function(t,r,i){var o=0;function a(t,n,r,i){return function(){var s=this,l=arguments,c=function(){var e,c;if(!(t=o&&(r!==I&&(s=void 0,l=[e]),n.rejectWith(s,l))}};t?u():(x.Deferred.getStackHook&&(u.stackTrace=x.Deferred.getStackHook()),e.setTimeout(u))}}return x.Deferred(function(e){n[0][3].add(a(0,e,m(i)?i:O,e.notifyWith)),n[1][3].add(a(0,e,m(t)?t:O)),n[2][3].add(a(0,e,m(r)?r:I))}).promise()},promise:function(e){return null!=e?x.extend(e,i):i}},o={};return x.each(n,function(e,t){var a=t[2],s=t[5];i[t[1]]=a.add,s&&a.add(function(){r=s},n[3-e][2].disable,n[3-e][3].disable,n[0][2].lock,n[0][3].lock),a.add(t[3].fire),o[t[0]]=function(){return o[t[0]+"With"](this===o?void 0:this,arguments),this},o[t[0]+"With"]=a.fireWith}),i.promise(o),t&&t.call(o,o),o},when:function(e){var t=arguments.length,n=t,r=Array(n),i=o.call(arguments),a=x.Deferred(),s=function(e){return function(n){r[e]=this,i[e]=arguments.length>1?o.call(arguments):n,--t||a.resolveWith(r,i)}};if(t<=1&&(q(e,a.done(s(n)).resolve,a.reject,!t),"pending"===a.state()||m(i[n]&&i[n].then)))return a.then();for(;n--;)q(i[n],s(n),a.reject);return a.promise()}});var U=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;x.Deferred.exceptionHook=function(t,n){e.console&&e.console.warn&&t&&U.test(t.name)&&e.console.warn("jQuery.Deferred exception: "+t.message,t.stack,n)},x.readyException=function(t){e.setTimeout(function(){throw t})};var W=x.Deferred();function H(){r.removeEventListener("DOMContentLoaded",H),e.removeEventListener("load",H),x.ready()}x.fn.ready=function(e){return W.then(e).catch(function(e){x.readyException(e)}),this},x.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--x.readyWait:x.isReady)||(x.isReady=!0,!0!==e&&--x.readyWait>0||W.resolveWith(r,[x]))}}),x.ready.then=W.then,"complete"===r.readyState||"loading"!==r.readyState&&!r.documentElement.doScroll?e.setTimeout(x.ready):(r.addEventListener("DOMContentLoaded",H),e.addEventListener("load",H));var B=function(e,t,n,r,i,o,a){var s=0,l=e.length,c=null==n;if("object"===v(n)){i=!0;for(s in n)B(e,t,s,n[s],!0,o,a)}else if(void 0!==r&&(i=!0,m(r)||(a=!0),c&&(a?(t.call(e,r),t=null):(c=t,t=function(e,t,n){return c.call(x(e),n)})),t))for(;s1,null,!0)},removeData:function(e){return this.each(function(){Q.remove(this,e)})}}),x.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Y.get(e,t),n&&(!r||Array.isArray(n)?r=Y.access(e,t,x.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=x.queue(e,t),r=n.length,i=n.shift(),o=x._queueHooks(e,t);"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,function(){x.dequeue(e,t)},o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Y.get(e,n)||Y.access(e,n,{empty:x.Callbacks("once memory").add(function(){Y.remove(e,[t+"queue",n])})})}}),x.fn.extend({queue:function(e,t){var n=2;return"string"!=typeof e&&(t=e,e="fx",n--),arguments.length\x20\t\r\n\f]+)/i,ue=/^$|^module$|\/(?:java|ecma)script/i,de={option:[1,""],thead:[1,"","
        "],col:[2,"","
        "],tr:[2,"","
        "],td:[3,"","
        "],_default:[0,"",""]};function pe(e,t){var n;return n=void 0!==e.getElementsByTagName?e.getElementsByTagName(t||"*"):void 0!==e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&A(e,t)?x.merge([e],n):n}function fe(e,t){for(var n=0,r=e.length;n-1)i&&i.push(o);else if(c=x.contains(o.ownerDocument,o),a=pe(d.appendChild(o),"script"),c&&fe(a),n)for(u=0;o=a[u++];)ue.test(o.type||"")&&n.push(o);return d}he=r.createDocumentFragment().appendChild(r.createElement("div")),(me=r.createElement("input")).setAttribute("type","radio"),me.setAttribute("checked","checked"),me.setAttribute("name","t"),he.appendChild(me),h.checkClone=he.cloneNode(!0).cloneNode(!0).lastChild.checked,he.innerHTML="",h.noCloneChecked=!!he.cloneNode(!0).lastChild.defaultValue;var ye=r.documentElement,ve=/^key/,we=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,xe=/^([^.]*)(?:\.(.+)|)/;function ke(){return!0}function Ce(){return!1}function Ee(){try{return r.activeElement}catch(e){}}function $e(e,t,n,r,i,o){var a,s;if("object"==typeof t){"string"!=typeof n&&(r=r||n,n=void 0);for(s in t)$e(e,s,n,r,t[s],o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=Ce;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return x().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=x.guid++)),e.each(function(){x.event.add(this,t,i,r,n)})}x.event={global:{},add:function(e,t,n,r,i){var o,a,s,l,c,u,d,p,f,h,m,g=Y.get(e);if(g)for(n.handler&&(n=(o=n).handler,i=o.selector),i&&x.find.matchesSelector(ye,i),n.guid||(n.guid=x.guid++),(l=g.events)||(l=g.events={}),(a=g.handle)||(a=g.handle=function(t){return void 0!==x&&x.event.triggered!==t.type?x.event.dispatch.apply(e,arguments):void 0}),c=(t=(t||"").match(M)||[""]).length;c--;)f=m=(s=xe.exec(t[c])||[])[1],h=(s[2]||"").split(".").sort(),f&&(d=x.event.special[f]||{},f=(i?d.delegateType:d.bindType)||f,d=x.event.special[f]||{},u=x.extend({type:f,origType:m,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&x.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=l[f])||((p=l[f]=[]).delegateCount=0,d.setup&&!1!==d.setup.call(e,r,h,a)||e.addEventListener&&e.addEventListener(f,a)),d.add&&(d.add.call(e,u),u.handler.guid||(u.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,u):p.push(u),x.event.global[f]=!0)},remove:function(e,t,n,r,i){var o,a,s,l,c,u,d,p,f,h,m,g=Y.hasData(e)&&Y.get(e);if(g&&(l=g.events)){for(c=(t=(t||"").match(M)||[""]).length;c--;)if(f=m=(s=xe.exec(t[c])||[])[1],h=(s[2]||"").split(".").sort(),f){for(d=x.event.special[f]||{},p=l[f=(r?d.delegateType:d.bindType)||f]||[],s=s[2]&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;o--;)u=p[o],!i&&m!==u.origType||n&&n.guid!==u.guid||s&&!s.test(u.namespace)||r&&r!==u.selector&&("**"!==r||!u.selector)||(p.splice(o,1),u.selector&&p.delegateCount--,d.remove&&d.remove.call(e,u));a&&!p.length&&(d.teardown&&!1!==d.teardown.call(e,h,g.handle)||x.removeEvent(e,f,g.handle),delete l[f])}else for(f in l)x.event.remove(e,f+t[c],n,r,!0);x.isEmptyObject(l)&&Y.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=x.event.fix(e),l=new Array(arguments.length),c=(Y.get(this,"events")||{})[s.type]||[],u=x.event.special[s.type]||{};for(l[0]=s,t=1;t=1))for(;c!==this;c=c.parentNode||this)if(1===c.nodeType&&("click"!==e.type||!0!==c.disabled)){for(o=[],a={},n=0;n-1:x.find(i,this,null,[c]).length),a[i]&&o.push(r);o.length&&s.push({elem:c,handlers:o})}return c=this,l\x20\t\r\n\f]*)[^>]*)\/>/gi,Se=/\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&x(e).children("tbody")[0]||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function _e(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Ne(e,t){var n,r,i,o,a,s,l,c;if(1===t.nodeType){if(Y.hasData(e)&&(o=Y.access(e),a=Y.set(t,o),c=o.events)){delete a.handle,a.events={};for(i in c)for(n=0,r=c[i].length;n1&&"string"==typeof g&&!h.checkClone&&Ae.test(g))return e.each(function(i){var o=e.eq(i);b&&(t[0]=g.call(this,i,o.html())),Re(o,t,n,r)});if(p&&(o=(i=be(t,e[0].ownerDocument,!1,e,r)).firstChild,1===i.childNodes.length&&(i=o),o||r)){for(l=(s=x.map(pe(i,"script"),De)).length;d")},clone:function(e,t,n){var r,i,o,a,s,l,c,u=e.cloneNode(!0),d=x.contains(e.ownerDocument,e);if(!(h.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||x.isXMLDoc(e)))for(a=pe(u),r=0,i=(o=pe(e)).length;r0&&fe(a,!d&&pe(e,"script")),u},cleanData:function(e){for(var t,n,r,i=x.event.special,o=0;void 0!==(n=e[o]);o++)if(X(n)){if(t=n[Y.expando]){if(t.events)for(r in t.events)i[r]?x.event.remove(n,r):x.removeEvent(n,r,t.handle);n[Y.expando]=void 0}n[Q.expando]&&(n[Q.expando]=void 0)}}}),x.fn.extend({detach:function(e){return Pe(this,e,!0)},remove:function(e){return Pe(this,e)},text:function(e){return B(this,function(e){return void 0===e?x.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return Re(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||je(this,e).appendChild(e)})},prepend:function(){return Re(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=je(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(x.cleanData(pe(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return x.clone(this,e,t)})},html:function(e){return B(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!Se.test(e)&&!de[(ce.exec(e)||["",""])[1].toLowerCase()]){e=x.htmlPrefilter(e);try{for(;n=0&&(l+=Math.max(0,Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-o-l-s-.5))),l}function Je(e,t,n){var r=Oe(e),i=qe(e,t,r),o="border-box"===x.css(e,"boxSizing",!1,r),a=o;if(Me.test(i)){if(!n)return i;i="auto"}return a=a&&(h.boxSizingReliable()||i===e.style[t]),("auto"===i||!parseFloat(i)&&"inline"===x.css(e,"display",!1,r))&&(i=e["offset"+t[0].toUpperCase()+t.slice(1)],a=!0),(i=parseFloat(i)||0)+Qe(e,t,n||(o?"border":"content"),a,r,i)+"px"}x.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=qe(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=V(t),l=Fe.test(t),c=e.style;if(l||(t=Ze(s)),a=x.cssHooks[t]||x.cssHooks[s],void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:c[t];"string"===(o=typeof n)&&(i=ne.exec(n))&&i[1]&&(n=function(e,t,n,r){var i,o,a=20,s=r?function(){return r.cur()}:function(){return x.css(e,t,"")},l=s(),c=n&&n[3]||(x.cssNumber[t]?"":"px"),u=(x.cssNumber[t]||"px"!==c&&+l)&&ne.exec(x.css(e,t));if(u&&u[3]!==c){for(l/=2,c=c||u[3],u=+l||1;a--;)x.style(e,t,u+c),(1-o)*(1-(o=s()/l||.5))<=0&&(a=0),u/=o;u*=2,x.style(e,t,u+c),n=n||[]}return n&&(u=+u||+l||0,i=n[1]?u+(n[1]+1)*n[2]:+n[2],r&&(r.unit=c,r.start=u,r.end=i)),i}(e,t,i),o="number"),null!=n&&n==n&&("number"===o&&(n+=i&&i[3]||(x.cssNumber[s]?"":"px")),h.clearCloneStyle||""!==n||0!==t.indexOf("background")||(c[t]="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(l?c.setProperty(t,n):c[t]=n))}},css:function(e,t,n,r){var i,o,a,s=V(t);return Fe.test(t)||(t=Ze(s)),(a=x.cssHooks[t]||x.cssHooks[s])&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=qe(e,t,r)),"normal"===i&&t in Ge&&(i=Ge[t]),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),x.each(["height","width"],function(e,t){x.cssHooks[t]={get:function(e,n,r){if(n)return!Be.test(x.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?Je(e,t,r):oe(e,ze,function(){return Je(e,t,r)})},set:function(e,n,r){var i,o=Oe(e),a="border-box"===x.css(e,"boxSizing",!1,o),s=r&&Qe(e,t,r,a,o);return a&&h.scrollboxSize()===o.position&&(s-=Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-parseFloat(o[t])-Qe(e,t,"border",!1,o)-.5)),s&&(i=ne.exec(n))&&"px"!==(i[3]||"px")&&(e.style[t]=n,n=x.css(e,t)),Ye(0,n,s)}}}),x.cssHooks.marginLeft=Ue(h.reliableMarginLeft,function(e,t){if(t)return(parseFloat(qe(e,"marginLeft"))||e.getBoundingClientRect().left-oe(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),x.each({margin:"",padding:"",border:"Width"},function(e,t){x.cssHooks[e+t]={expand:function(n){for(var r=0,i={},o="string"==typeof n?n.split(" "):[n];r<4;r++)i[e+re[r]+t]=o[r]||o[r-2]||o[0];return i}},"margin"!==e&&(x.cssHooks[e+t].set=Ye)}),x.fn.extend({css:function(e,t){return B(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=Oe(e),i=t.length;a1)}}),x.fn.delay=function(t,n){return t=x.fx&&x.fx.speeds[t]||t,n=n||"fx",this.queue(n,function(n,r){var i=e.setTimeout(n,t);r.stop=function(){e.clearTimeout(i)}})},We=r.createElement("input"),He=r.createElement("select").appendChild(r.createElement("option")),We.type="checkbox",h.checkOn=""!==We.value,h.optSelected=He.selected,(We=r.createElement("input")).value="t",We.type="radio",h.radioValue="t"===We.value;var Ke,et=x.expr.attrHandle;x.fn.extend({attr:function(e,t){return B(this,x.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){x.removeAttr(this,e)})}}),x.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return void 0===e.getAttribute?x.prop(e,t,n):(1===o&&x.isXMLDoc(e)||(i=x.attrHooks[t.toLowerCase()]||(x.expr.match.bool.test(t)?Ke:void 0)),void 0!==n?null===n?void x.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=x.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!h.radioValue&&"radio"===t&&A(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(M);if(i&&1===e.nodeType)for(;n=i[r++];)e.removeAttribute(n)}}),Ke={set:function(e,t,n){return!1===t?x.removeAttr(e,n):e.setAttribute(n,n),n}},x.each(x.expr.match.bool.source.match(/\w+/g),function(e,t){var n=et[t]||x.find.attr;et[t]=function(e,t,r){var i,o,a=t.toLowerCase();return r||(o=et[a],et[a]=i,i=null!=n(e,t,r)?a:null,et[a]=o),i}});var tt=/^(?:input|select|textarea|button)$/i,nt=/^(?:a|area)$/i;function rt(e){return(e.match(M)||[]).join(" ")}function it(e){return e.getAttribute&&e.getAttribute("class")||""}function ot(e){return Array.isArray(e)?e:"string"==typeof e&&e.match(M)||[]}x.fn.extend({prop:function(e,t){return B(this,x.prop,e,t,arguments.length>1)},removeProp:function(e){return this.each(function(){delete this[x.propFix[e]||e]})}}),x.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&x.isXMLDoc(e)||(t=x.propFix[t]||t,i=x.propHooks[t]),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=x.find.attr(e,"tabindex");return t?parseInt(t,10):tt.test(e.nodeName)||nt.test(e.nodeName)&&e.href?0:-1}}},propFix:{for:"htmlFor",class:"className"}}),h.optSelected||(x.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),x.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){x.propFix[this.toLowerCase()]=this}),x.fn.extend({addClass:function(e){var t,n,r,i,o,a,s,l=0;if(m(e))return this.each(function(t){x(this).addClass(e.call(this,t,it(this)))});if((t=ot(e)).length)for(;n=this[l++];)if(i=it(n),r=1===n.nodeType&&" "+rt(i)+" "){for(a=0;o=t[a++];)r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=rt(r))&&n.setAttribute("class",s)}return this},removeClass:function(e){var t,n,r,i,o,a,s,l=0;if(m(e))return this.each(function(t){x(this).removeClass(e.call(this,t,it(this)))});if(!arguments.length)return this.attr("class","");if((t=ot(e)).length)for(;n=this[l++];)if(i=it(n),r=1===n.nodeType&&" "+rt(i)+" "){for(a=0;o=t[a++];)for(;r.indexOf(" "+o+" ")>-1;)r=r.replace(" "+o+" "," ");i!==(s=rt(r))&&n.setAttribute("class",s)}return this},toggleClass:function(e,t){var n=typeof e,r="string"===n||Array.isArray(e);return"boolean"==typeof t&&r?t?this.addClass(e):this.removeClass(e):m(e)?this.each(function(n){x(this).toggleClass(e.call(this,n,it(this),t),t)}):this.each(function(){var t,i,o,a;if(r)for(i=0,o=x(this),a=ot(e);t=a[i++];)o.hasClass(t)?o.removeClass(t):o.addClass(t);else void 0!==e&&"boolean"!==n||((t=it(this))&&Y.set(this,"__className__",t),this.setAttribute&&this.setAttribute("class",t||!1===e?"":Y.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;for(t=" "+e+" ";n=this[r++];)if(1===n.nodeType&&(" "+rt(it(n))+" ").indexOf(t)>-1)return!0;return!1}});var at=/\r/g;x.fn.extend({val:function(e){var t,n,r,i=this[0];return arguments.length?(r=m(e),this.each(function(n){var i;1===this.nodeType&&(null==(i=r?e.call(this,n,x(this).val()):e)?i="":"number"==typeof i?i+="":Array.isArray(i)&&(i=x.map(i,function(e){return null==e?"":e+""})),(t=x.valHooks[this.type]||x.valHooks[this.nodeName.toLowerCase()])&&"set"in t&&void 0!==t.set(this,i,"value")||(this.value=i))})):i?(t=x.valHooks[i.type]||x.valHooks[i.nodeName.toLowerCase()])&&"get"in t&&void 0!==(n=t.get(i,"value"))?n:"string"==typeof(n=i.value)?n.replace(at,""):null==n?"":n:void 0}}),x.extend({valHooks:{option:{get:function(e){var t=x.find.attr(e,"value");return null!=t?t:rt(x.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:[],l=a?o+1:i.length;for(r=o<0?l:a?o:0;r-1)&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),x.each(["radio","checkbox"],function(){x.valHooks[this]={set:function(e,t){if(Array.isArray(t))return e.checked=x.inArray(x(e).val(),t)>-1}},h.checkOn||(x.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})}),h.focusin="onfocusin"in e;var st=/^(?:focusinfocus|focusoutblur)$/,lt=function(e){e.stopPropagation()};x.extend(x.event,{trigger:function(t,n,i,o){var a,s,l,c,u,p,f,h,b=[i||r],y=d.call(t,"type")?t.type:t,v=d.call(t,"namespace")?t.namespace.split("."):[];if(s=h=l=i=i||r,3!==i.nodeType&&8!==i.nodeType&&!st.test(y+x.event.triggered)&&(y.indexOf(".")>-1&&(y=(v=y.split(".")).shift(),v.sort()),u=y.indexOf(":")<0&&"on"+y,(t=t[x.expando]?t:new x.Event(y,"object"==typeof t&&t)).isTrigger=o?2:3,t.namespace=v.join("."),t.rnamespace=t.namespace?new RegExp("(^|\\.)"+v.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,t.result=void 0,t.target||(t.target=i),n=null==n?[t]:x.makeArray(n,[t]),f=x.event.special[y]||{},o||!f.trigger||!1!==f.trigger.apply(i,n))){if(!o&&!f.noBubble&&!g(i)){for(c=f.delegateType||y,st.test(c+y)||(s=s.parentNode);s;s=s.parentNode)b.push(s),l=s;l===(i.ownerDocument||r)&&b.push(l.defaultView||l.parentWindow||e)}for(a=0;(s=b[a++])&&!t.isPropagationStopped();)h=s,t.type=a>1?c:f.bindType||y,(p=(Y.get(s,"events")||{})[t.type]&&Y.get(s,"handle"))&&p.apply(s,n),(p=u&&s[u])&&p.apply&&X(s)&&(t.result=p.apply(s,n),!1===t.result&&t.preventDefault());return t.type=y,o||t.isDefaultPrevented()||f._default&&!1!==f._default.apply(b.pop(),n)||!X(i)||u&&m(i[y])&&!g(i)&&((l=i[u])&&(i[u]=null),x.event.triggered=y,t.isPropagationStopped()&&h.addEventListener(y,lt),i[y](),t.isPropagationStopped()&&h.removeEventListener(y,lt),x.event.triggered=void 0,l&&(i[u]=l)),t.result}},simulate:function(e,t,n){var r=x.extend(new x.Event,n,{type:e,isSimulated:!0});x.event.trigger(r,null,t)}}),x.fn.extend({trigger:function(e,t){return this.each(function(){x.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return x.event.trigger(e,t,n,!0)}}),h.focusin||x.each({focus:"focusin",blur:"focusout"},function(e,t){var n=function(e){x.event.simulate(t,e.target,x.event.fix(e))};x.event.special[t]={setup:function(){var r=this.ownerDocument||this,i=Y.access(r,t);i||r.addEventListener(e,n,!0),Y.access(r,t,(i||0)+1)},teardown:function(){var r=this.ownerDocument||this,i=Y.access(r,t)-1;i?Y.access(r,t,i):(r.removeEventListener(e,n,!0),Y.remove(r,t))}}});var ct,ut=/\[\]$/,dt=/\r?\n/g,pt=/^(?:submit|button|image|reset|file)$/i,ft=/^(?:input|select|textarea|keygen)/i;function ht(e,t,n,r){var i;if(Array.isArray(t))x.each(t,function(t,i){n||ut.test(e)?r(e,i):ht(e+"["+("object"==typeof i&&null!=i?t:"")+"]",i,n,r)});else if(n||"object"!==v(t))r(e,t);else for(i in t)ht(e+"["+i+"]",t[i],n,r)}x.param=function(e,t){var n,r=[],i=function(e,t){var n=m(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(Array.isArray(e)||e.jquery&&!x.isPlainObject(e))x.each(e,function(){i(this.name,this.value)});else for(n in e)ht(n,e[n],t,i);return r.join("&")},x.fn.extend({serialize:function(){return x.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=x.prop(this,"elements");return e?x.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!x(this).is(":disabled")&&ft.test(this.nodeName)&&!pt.test(e)&&(this.checked||!le.test(e))}).map(function(e,t){var n=x(this).val();return null==n?null:Array.isArray(n)?x.map(n,function(e){return{name:t.name,value:e.replace(dt,"\r\n")}}):{name:t.name,value:n.replace(dt,"\r\n")}}).get()}}),x.fn.extend({wrapAll:function(e){var t;return this[0]&&(m(e)&&(e=e.call(this[0])),t=x(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){for(var e=this;e.firstElementChild;)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(e){return m(e)?this.each(function(t){x(this).wrapInner(e.call(this,t))}):this.each(function(){var t=x(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=m(e);return this.each(function(n){x(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(e){return this.parent(e).not("body").each(function(){x(this).replaceWith(this.childNodes)}),this}}),x.expr.pseudos.hidden=function(e){return!x.expr.pseudos.visible(e)},x.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},h.createHTMLDocument=((ct=r.implementation.createHTMLDocument("").body).innerHTML="
        ",2===ct.childNodes.length),x.parseHTML=function(e,t,n){return"string"!=typeof e?[]:("boolean"==typeof t&&(n=t,t=!1),t||(h.createHTMLDocument?((i=(t=r.implementation.createHTMLDocument("")).createElement("base")).href=r.location.href,t.head.appendChild(i)):t=r),o=L.exec(e),a=!n&&[],o?[t.createElement(o[1])]:(o=be([e],t,a),a&&a.length&&x(a).remove(),x.merge([],o.childNodes)));var i,o,a},x.offset={setOffset:function(e,t,n){var r,i,o,a,s,l,c=x.css(e,"position"),u=x(e),d={};"static"===c&&(e.style.position="relative"),s=u.offset(),o=x.css(e,"top"),l=x.css(e,"left"),("absolute"===c||"fixed"===c)&&(o+l).indexOf("auto")>-1?(a=(r=u.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(l)||0),m(t)&&(t=t.call(e,n,x.extend({},s))),null!=t.top&&(d.top=t.top-s.top+a),null!=t.left&&(d.left=t.left-s.left+i),"using"in t?t.using.call(e,d):u.css(d)}},x.fn.extend({offset:function(e){if(arguments.length)return void 0===e?this:this.each(function(t){x.offset.setOffset(this,e,t)});var t,n,r=this[0];return r?r.getClientRects().length?(t=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:t.top+n.pageYOffset,left:t.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this[0]){var e,t,n,r=this[0],i={top:0,left:0};if("fixed"===x.css(r,"position"))t=r.getBoundingClientRect();else{for(t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;e&&(e===n.body||e===n.documentElement)&&"static"===x.css(e,"position");)e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=x(e).offset()).top+=x.css(e,"borderTopWidth",!0),i.left+=x.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-x.css(r,"marginTop",!0),left:t.left-i.left-x.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){for(var e=this.offsetParent;e&&"static"===x.css(e,"position");)e=e.offsetParent;return e||ye})}}),x.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,t){var n="pageYOffset"===t;x.fn[e]=function(r){return B(this,function(e,r,i){var o;if(g(e)?o=e:9===e.nodeType&&(o=e.defaultView),void 0===i)return o?o[t]:e[r];o?o.scrollTo(n?o.pageXOffset:i,n?i:o.pageYOffset):e[r]=i},e,r,arguments.length)}}),x.each(["top","left"],function(e,t){x.cssHooks[t]=Ue(h.pixelPosition,function(e,n){if(n)return n=qe(e,t),Me.test(n)?x(e).position()[t]+"px":n})}),x.each({Height:"height",Width:"width"},function(e,t){x.each({padding:"inner"+e,content:t,"":"outer"+e},function(n,r){x.fn[r]=function(i,o){var a=arguments.length&&(n||"boolean"!=typeof i),s=n||(!0===i||!0===o?"margin":"border");return B(this,function(t,n,i){var o;return g(t)?0===r.indexOf("outer")?t["inner"+e]:t.document.documentElement["client"+e]:9===t.nodeType?(o=t.documentElement,Math.max(t.body["scroll"+e],o["scroll"+e],t.body["offset"+e],o["offset"+e],o["client"+e])):void 0===i?x.css(t,n,s):x.style(t,n,i,s)},t,a?i:void 0,a)}})}),x.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,t){x.fn[t]=function(e,n){return arguments.length>0?this.on(t,null,e,n):this.trigger(t)}}),x.fn.extend({hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),x.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)}}),x.proxy=function(e,t){var n,r,i;if("string"==typeof t&&(n=e[t],t=e,e=n),m(e))return r=o.call(arguments,2),(i=function(){return e.apply(t||this,r.concat(o.call(arguments)))}).guid=e.guid=e.guid||x.guid++,i},x.holdReady=function(e){e?x.readyWait++:x.ready(!0)},x.isArray=Array.isArray,x.parseJSON=JSON.parse,x.nodeName=A,x.isFunction=m,x.isWindow=g,x.camelCase=V,x.type=v,x.now=Date.now,x.isNumeric=function(e){var t=x.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},"function"==typeof define&&define.amd&&define("jquery",[],function(){return x});var mt=e.jQuery,gt=e.$;return x.noConflict=function(t){return e.$===x&&(e.$=gt),t&&e.jQuery===x&&(e.jQuery=mt),x},t||(e.jQuery=e.$=x),x},"object"==typeof module&&"object"==typeof module.exports?module.exports=t0.document?u0(t0,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return u0(e)}:u0(t0),define("deps/jquery",function(){}),define("core/jquery-enhanced",["exports","core/pubsubhub","core/utils","deps/jquery"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/jquery-enhanced";window.$=$,window.$.fn.renameElement=function(e){var n=[];return this.each(function(){for(var r=$(this.ownerDocument.createElement(e)),i=0,o=this.attributes.length;i""!==e).reduce((e,t)=>e.add(t),new Set)]},window.$.fn.linkTargets=function(){var e=this[0].closest("[data-link-for]"),t=e?e.dataset.linkFor.toLowerCase():"",n=this.getDfnTitles(),r=[];for(const e of n){r.push({for:t,title:e});const n=e.split(".");2===n.length&&r.push({for:n[0],title:n[1]}),r.push({for:"",title:e})}return r},window.$.fn.makeID=function(e="",t="",n=!1){const r=this[0];if(r.id)return r.id;t||(t=(r.title?r.title:r.textContent).trim());var i=n?t:t.toLowerCase();if((i=i.replace(/[\W]+/gim,"-").replace(/^-+/,"").replace(/-+$/,""))?!/\.$/.test(i)&&/^[a-z]/i.test(i)||(i="x"+i):i="generatedID",e&&(i=`${e}-${i}`),r.ownerDocument.getElementById(i)){let e=0,t=i+"-"+e;for(;r.ownerDocument.getElementById(t);)t=i+"-"+e++;i=t}return r.id=i,i},window.$.fn.allTextNodes=function(e){for(var t=[],n={},r=0,i=e.length;r(e.setAttribute("aria-"+t,n),e),e)}l.id="respec-ui-styles",l.textContent=a.default,l.classList.add("removeOnSave"),document.head.appendChild(l);const u=$(""),d=$("");var p,f;const h=[],m=[],g={};(0,n.sub)("start-all",()=>{document.body.insertAdjacentElement("afterbegin",u[0])},{once:!0}),(0,n.sub)("end-all",()=>{document.body.insertAdjacentElement("afterbegin",u[0])},{once:!0});const b=$("");b.click(function(e){e.stopPropagation(),d[0].hidden?(d[0].classList.remove("respec-hidden"),d[0].classList.add("respec-visible")):(d[0].classList.add("respec-hidden"),d[0].classList.remove("respec-visible")),this.setAttribute("aria-expanded",String(d[0].hidden)),d[0].hidden=!d[0].hidden}).appendTo(u),document.documentElement.addEventListener("click",function(){d[0].hidden||(d[0].classList.remove("respec-visible"),d[0].classList.add("respec-hidden"),d[0].hidden=!0)}),d.appendTo(u);const y=new Map([["controls","respec-menu"],["expanded","false"],["haspopup","true"],["label","ReSpec Menu"]]);function v(e,t,n,r){if(t.push(e),g.hasOwnProperty(n))return void g[n].text(t.length);g[n]=$("").appendTo(u).click(function(){this.setAttribute("aria-expanded","true");for(var e=$("
          "),o=0,a=t.length;o
          ").appendTo(e).find("span").text("["+s.name+"] "+s.message).end().find("a").css({fontSize:"1.1em",color:"#999",cursor:"pointer"}).click(function(){var e=$(this),t=e.text(),n=e.parent().find("pre");"⊞"===t?(e.text("⊟"),n.show()):(e.text("⊞"),n.hide())}).end().find("pre").text(s.stack).css({marginLeft:"0",maxWidth:"100%",overflowY:"hidden",overflowX:"scroll"}).hide().end();else{const t=document.createElement("tmp");t.innerHTML=(0,i.markdownToHtml)(s);const n=document.createElement("li");if(t.firstElementChild===t.lastElementChild)for(;t.firstElementChild&&t.firstElementChild.hasChildNodes();)n.appendChild(t.firstElementChild.firstChild);else n.innerHTML=t.innerHTML;e[0].appendChild(n)}}w.freshModal(r,e,this)});const o=new Map([["expanded","false"],["haspopup","true"],["controls","respec-pill-"+n+"-modal"],["label","Document "+r.toLowerCase()]]);c(g[n][0],o)}c(b[0],y);const w=e.ui={show:function(){try{u[0].hidden=!1}catch(e){console.error(e)}},hide:function(){u[0].hidden=!0},enable:function(){b[0].removeAttribute("disabled")},addCommand:function(e,t,n,r){r=r||"";var i=function(){require([t],function(e){e.show()})},a="respec-button-"+e.toLowerCase().replace(/\s+/,"-"),s=$('
        1. ").click(i).appendTo(d);return n&&o.default.add(n,i),s[0].querySelector("button")},error:function(e){v(e,h,"error","Errors")},warning:function(e){v(e,m,"warning","Warnings")},closeModal:function(e){f&&(f[0].classList.remove("respec-show-overlay"),f[0].classList.add("respec-hide-overlay"),f[0].addEventListener("transitionend",()=>{f.remove(),f=null})),e&&e.setAttribute("aria-expanded","false"),p&&(p.remove(),p=null)},freshModal:function(e,t,n){p&&p.remove(),f&&f.remove(),f=$("
          ");const r=n.id+"-modal",i=r+"-heading";(p=$("")).find("h3").text(e),p.find("h3")[0].id=i;const o=new Map([["labelledby",i]]);c(p[0],o),p.find(".inside").append(t),$(document.body).append(f).append(p),f.click(()=>{this.closeModal(n)}),f[0].classList.toggle("respec-show-overlay"),p[0].hidden=!1}};o.default.add("Esc",function(){w.closeModal()}),o.default.add("Ctrl+Alt+Shift+E",function(){g.error&&g.error.click()}),o.default.add("Ctrl+Alt+Shift+W",function(){g.warning&&g.warning.click()}),window.respecUI=w,(0,n.sub)("error",function(e){w.error(e)}),(0,n.sub)("warn",function(e){w.warning(e)})}),define("core/l10n",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e){e.l10n=i[o]||i.en};var t=Object.assign||function(e){for(var t=1;te.add(t),this.rules)}async lint(e,i=window.document){const a=[...r.get(this).rules].map(r=>(async function(e){(await e).map(async e=>{const t=await e,r=n({},o,t),{description:i,help:a,howToFix:s,name:l,occurrences:c,offendingElements:u}=r,d=`${i} ${s} ${a} ("${l}" x ${c})`;return u.forEach(e=>{e.classList.add("respec-offending-element")}),console.warn(`Linter (${l}):`,i,...u),d}).forEach(async e=>{(0,t.pub)("warn",await e)})})(r.lint(e,i)));await a}};e.default=i;const o={name:"unknown",description:"",occurrences:0,howToFix:"",offendingElements:[],help:""}}),define("core/LinterRule",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0});const t=new WeakMap;e.default=class{constructor(e,n){t.set(this,{name:e,lintingFunction:n})}get name(){return t.get(this).name}lint(e={lint:{[this.name]:!1}},n=document){return r=e,i=this.name,!1!==r.hasOwnProperty("lint")&&!1!==r.lint&&r.lint[i]?[].concat(t.get(this).lintingFunction(e,n)):[];var r,i}}}),define("core/linter-rules/no-headingless-sections",["exports","core/LinterRule","../l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=t)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t`.",help:"See developer console."},nl:{description:"Alle secties moeten beginnen met een `h2-6` element.",howToFix:"Voeg een `h2-6` toe aan de conflicterende sectie of gebruik een `
          `.",help:"Zie de developer console."}},l=n.lang in s?n.lang:"en",c=({firstElementChild:e})=>null===e||!1===/^h[1-6]$/.test(e.localName);e.rule=new i.default(a,function(e,t){const n=Array.from(t.querySelectorAll("section")).filter(c);return n.length?o({name:a,offendingElements:n,occurrences:n.length},s[l]):[]})}),define("core/linter-rules/no-http-props",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;te.endsWith("URI")||"prevED"===e).filter(n=>new URL(e[n],t.location.href).href.startsWith("http://")).reduce((e,t)=>e.concat(t),[]);if(!n.length)return[];const r=o({name:a,occurrences:n.length},s[l]);return r.howToFix+=n.map(e=>"`"+e+"`").join(", ")+".",r})}),define("w3c/l10n",["exports","core/l10n"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="w3c/l10n";const n={en:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."},ko:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."},zh:{status_at_publication:"本章节描述了本文档的发布状态。其它更新版本可能会覆盖本文档。W3C的文档列 表和最新版本可通过W3C技术报告索引访问。"},ja:{status_at_publication:"この節には、公開時点でのこの文書の位置づけが記されている。他の文書によって置き換えられる可能性がある。現時点でのW3Cの発行文書とこのテクニカルレポートの最新版は、下記から参照できる。 W3C technical reports index (https://www.w3.org/TR/)"},nl:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."}};Object.keys(n).reduce((e,t)=>(Object.assign(e[t],n[t]),e),t.l10n)}),define("w3c/linter-rules/privsec-section",["exports","core/LinterRule","../l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=t)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t{const t=/(privacy|security)/im.test(e),n=/(considerations)/im.test(e);return t&&n||t}))&&n.push(o({name:a,occurrences:1},s[l])),n})}),define("core/linter-rules/check-punctuation",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t`"${e}"`).join(", ")}.`}},c=t.lang in l?t.lang:"en";e.rule=new i.default(a,function(e,t){const n=new RegExp(`[${s.join("")}\\]]$|^ *$`,"m"),r=[...t.querySelectorAll("p:not(#back-to-top)")].filter(e=>!n.test(e.textContent.trim()));return r.length?o({name:a,offendingElements:r,occurrences:r.length},l[c]):[]})}),define("core/linter-rules/local-refs-exist",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t p:first-child {\n margin-top: 0;\n}\n\n.section dd > p:last-child {\n margin-bottom: 0;\n}\n\n.section dd {\n margin-bottom: 1em;\n}\n\n.section dl.attrs dd,\n.section dl.eldef dd {\n margin-bottom: 0;\n}\n\n#issue-summary > ul,\n.respec-dfn-list {\n column-count: 2;\n}\n\n#issue-summary li,\n.respec-dfn-list li {\n list-style: none;\n}\n\ndetails.respec-tests-details {\n margin-left: 1em;\n display: inline-block;\n vertical-align: top;\n}\n\ndetails.respec-tests-details > * {\n padding-right: 2em;\n}\n\ndetails.respec-tests-details[open] {\n z-index: 999999;\n position: absolute;\n border: thin solid #cad3e2;\n border-radius: .3em;\n background-color: white;\n padding-bottom: .5em;\n}\n\ndetails.respec-tests-details[open] > summary {\n border-bottom: thin solid #cad3e2;\n padding-left: 1em;\n margin-bottom: 1em;\n line-height: 2em;\n}\n\ndetails.respec-tests-details > ul {\n width: 100%;\n margin-top: -0.3em;\n}\n\ndetails.respec-tests-details > li {\n padding-left: 1em;\n}\n\n@media print {\n .removeOnSave {\n display: none;\n }\n}\n'}),define("core/style",["exports","deps/text!core/css/respec2.css"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){e.noReSpecCSS&&i.remove();n()};var n,r=(n=t)&&n.__esModule?n:{default:n};e.name="core/style";const i=document.createElement("style");i.id="respec-mainstyle",i.textContent=r.default,document.head.appendChild(i)}),define("w3c/style",["exports","core/utils","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,i){if(!e.specStatus){const t="`respecConfig.specStatus` missing. Defaulting to 'base'.";e.specStatus="base",(0,n.pub)("warn",t)}let o="W3C-";switch(e.specStatus.toUpperCase()){case"CG-DRAFT":case"CG-FINAL":case"BG-DRAFT":case"BG-FINAL":o=e.specStatus.toLowerCase();break;case"FPWD":case"LC":case"WD-NOTE":case"LC-NOTE":o+="WD";break;case"WG-NOTE":case"FPWD-NOTE":o+="WG-NOTE.css";break;case"UNOFFICIAL":o+="UD";break;case"FINDING":case"FINDING-DRAFT":case"BASE":o="base.css";break;default:o+=e.specStatus}const a=function(e){let t="";switch(e){case null:case!0:t="2016";break;default:e&&!isNaN(e)&&(t=e.toString().trim())}return t}(e.useExperimentalStyles||"2016");a&&!e.noToc&&(0,n.sub)("end-all",function(){!function(e,t){const n=e.createElement("script");n.addEventListener("load",function(){window.location.hash&&(window.location=window.location)},{once:!0}),n.src=`https://www.w3.org/scripts/TR/${t}/fixup.js`,e.body.appendChild(n)}(r,a)},{once:!0});const s=`https://www.w3.org/StyleSheets/TR/${a?a+"/":""}${o}`;(0,t.linkCSS)(r,s),i()};e.name="w3c/style";const r=[{hint:"preconnect",href:"https://www.w3.org"},{hint:"preload",href:"https://www.w3.org/scripts/TR/2016/fixup.js",as:"script"},{hint:"preload",href:"https://www.w3.org/StyleSheets/TR/2016/base.css",as:"style"},{hint:"preload",href:"https://www.w3.org/StyleSheets/TR/2016/logos/W3C",as:"image"}].map(t.createResourceHint).reduce(function(e,t){return e.appendChild(t),e},document.createDocumentFragment());r.appendChild(function(){const e=document.createElement("link");return e.rel="stylesheet",e.href="https://www.w3.org/StyleSheets/TR/2016/base.css",e.classList.add("removeOnSave"),e}()),document.head.querySelector("meta[name=viewport]")||r.insertBefore(function(){const e=document.createElement("meta");return e.name="viewport",e.content=(0,t.toKeyValuePairs)({width:"device-width","initial-scale":"1","shrink-to-fit":"no"}).replace(/\"/g,""),e}(),r.firstChild),document.head.insertBefore(r,document.head.firstChild)}),define("core/github",["exports","core/l10n","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.fetchAll=o,e.fetchIndex=function(e,t){return o(e.replace(/\{[^}]+\}/,""),t)},e.run=async function(e){if(!e.hasOwnProperty("github")||!e.github)return;if("object"==typeof e.github&&!e.github.hasOwnProperty("repoURL")){const e="Config option `[github](https://github.com/w3c/respec/wiki/github)` is missing property `repoURL`.";return void(0,n.pub)("error",e)}let t;try{t=new URL(e.github.repoURL||e.github,"https://github.com")}catch(e){return void(0,n.pub)("error",`\`respecConf.github\` is not a valid URL? (${t})`)}if("https://github.com"!==t.origin){const e=`\`respecConf.github\` must be HTTPS and pointing to GitHub. (${t})`;return void(0,n.pub)("error",e)}const[r,o]=t.pathname.split("/").filter(e=>e);if(!r||!o){const e="`respecConf.github` URL needs a path with, for example, w3c/my-spec";return void(0,n.pub)("error",e)}const a=e.github.branch||"gh-pages",s={edDraftURI:`https://${r.toLowerCase()}.github.io/${o}/`,githubToken:void 0,githubUser:void 0,githubAPI:`https://api.github.com/repos/${r}/${o}`,issueBase:new URL("./issues/",t).href,otherLinks:[],pullBase:new URL("./pulls/",t).href,shortName:o},l={key:e.l10n.participate,data:[{value:`GitHub ${r}/${o}`,href:t},{value:e.l10n.file_a_bug,href:s.issueBase},{value:e.l10n.commit_history,href:new URL(`./commits/${a}`,t.href).href},{value:e.l10n.pull_requests,href:s.pullBase}]},c={branch:a,repoURL:t.href},u=i({},s,e,{github:c});Object.assign(e,u),e.otherLinks.unshift(l)};var r;(r=t)&&r.__esModule;var i=Object.assign||function(e){for(var t=1;t]+)>\s*;\s*rel="next"/))&&u[1]||null);var c,u;return l?o(l,t,n):n}}),define("core/data-include",["exports","core/pubsubhub","core/utils"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,i){const o=Array.from(r.querySelectorAll("[data-include]")).map(async e=>{const r=e.dataset.include;if(!r)return;const i="include-"+String(Math.random()).substr(2);e.dataset.includeId=i;try{const o=await fetch(r),a=await o.text();!function(e,t,r){const i=document.querySelector(`[data-include-id=${t}]`),o=i.ownerDocument,a=(0,n.runTransforms)(e,i.dataset.oninclude,r),s="string"==typeof i.dataset.includeReplace;let l;switch(i.dataset.includeFormat){case"text":s?(l=o.createTextNode(a),i.parentNode.replaceChild(l,i)):i.textContent=a;break;default:if(i.innerHTML=a,s){for(l=o.createDocumentFragment();i.hasChildNodes();)l.append(i.removeChild(i.firstChild));i.parentNode.replaceChild(l,i)}}o.contains(i)&&(c=i,["data-include","data-include-format","data-include-replace","data-include-id","oninclude"].forEach(e=>c.removeAttribute(e)));var c}(a,i,r)}catch(n){const i=`\`data-include\` failed: \`${r}\` (${n.message}). See console for details.`;console.error("data-include failed for element: ",e,n),(0,t.pub)("error",i)}});Promise.all(o).then(i)};e.name="core/data-include"}),define("core/markdown",["exports","core/utils"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){const r=!!t.querySelector("[data-format=markdown]:not(body)"),s="markdown"===e.format;if(!s&&!r)return n();if(!s)return o(t.body).map(e=>{const t=i(e,e.ownerDocument);return{structuredInternals:t,elem:e}}).forEach(({elem:e,structuredInternals:t})=>{if(e.setAttribute("aria-busy","true"),"section"===t.firstElementChild.localName&&"section"===e.localName){const n=t.firstElementChild;for(n.remove();n.hasChildNodes();)e.appendChild(n.firstChild)}else e.innerHTML="";e.appendChild(t),e.setAttribute("aria-busy","false")}),n();const l=t.getElementById("respec-ui");l.remove();const c=t.createElement("html"),u=t.createElement("body");u.innerHTML=t.body.innerHTML,c.appendChild(u),a(c);const d=u.innerHTML.replace(/

          \s*<\/p>/gm,"");u.innerHTML=d,p=u.querySelectorAll(".nolinks a[href]"),Array.from(p).forEach(e=>{const t=e.ownerDocument.createTextNode(e.textContent);e.parentElement.replaceChild(t,e)});var p;var f=i(u,t);u.appendChild(f),u.insertAdjacentElement("afterbegin",l),t.body.parentNode.replaceChild(u,t.body),n()};e.name="core/markdown";function n(e){return n=>{const r=Array.from(n.querySelectorAll(e));return r.reverse().forEach(e=>{e.innerHTML=(0,t.markdownToHtml)(e.innerHTML)}),r}}class r{constructor(e){this.doc=e,this.root=e.createDocumentFragment(),this.stack=[this.root],this.current=this.root}findPosition(e){return parseInt(e.tagName.charAt(1),10)}findParent(e){let t;for(;e>0;)if(e--,t=this.stack[e])return t}findHeader({firstChild:e}){for(;e;){if(/H[1-6]/.test(e.tagName))return e;e=e.nextSibling}return null}addHeader(e){const t=this.doc.createElement("section"),n=this.findPosition(e);t.appendChild(e),this.findParent(n).appendChild(t),this.stack[n]=t,this.stack.length=n+1,this.current=t}addSection(e,t){const n=this.findHeader(e),r=n?this.findPosition(n):1,i=this.findParent(r);n&&e.removeChild(n),e.appendChild(t(e)),n&&e.insertBefore(n,e.firstChild),i.appendChild(e),this.current=i}addElement(e){this.current.appendChild(e)}}function i(e,t){return function e(n){const i=new r(t);for(;n.firstChild;){const t=n.firstChild;if(t.nodeType===Node.ELEMENT_NODE)switch(t.localName){case"h1":case"h2":case"h3":case"h4":case"h5":case"h6":i.addHeader(t);break;case"section":i.addSection(t,e);break;default:i.addElement(t)}else n.removeChild(t)}return i.root}(e)}const o=n("[data-format='markdown']:not(body)"),a=n("[data-format=markdown]:not(body), section, div, address, article, aside, figure, header, main, body")}),Dha=this,Eha=function(){return function(e){var t={};function n(r){if(t[r])return t[r].exports;var i=t[r]={exports:{},id:r,loaded:!1};return e[r].call(i.exports,i,i.exports,n),i.loaded=!0,i.exports}return n.m=e,n.c=t,n.p="",n(0)}([function(e,t,n){var r=n(1).default,i=n(2).default;t.__esModule=!0;var o=r(n(3)),a=i(n(20)),s=i(n(5)),l=r(n(4)),c=r(n(21)),u=i(n(33));function d(){var e=new o.HandlebarsEnvironment;return l.extend(e,o),e.SafeString=a.default,e.Exception=s.default,e.Utils=l,e.escapeExpression=l.escapeExpression,e.VM=c,e.template=function(t){return c.template(t,e)},e}var p=d();p.create=d,u.default(p),p.default=p,t.default=p,e.exports=t.default},function(e,t){t.default=function(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&(t[n]=e[n]);return t.default=e,t},t.__esModule=!0},function(e,t){t.default=function(e){return e&&e.__esModule?e:{default:e}},t.__esModule=!0},function(e,t,n){var r=n(2).default;t.__esModule=!0,t.HandlebarsEnvironment=u;var i=n(4),o=r(n(5)),a=n(9),s=n(17),l=r(n(19));t.VERSION="4.0.11";t.COMPILER_REVISION=7;t.REVISION_CHANGES={1:"<= 1.0.rc.2",2:"== 1.0.0-rc.3",3:"== 1.0.0-rc.4",4:"== 1.x.x",5:"== 2.0.0-alpha.x",6:">= 2.0.0-beta.1",7:">= 4.0.0"};var c="[object Object]";function u(e,t,n){this.helpers=e||{},this.partials=t||{},this.decorators=n||{},a.registerDefaultHelpers(this),s.registerDefaultDecorators(this)}u.prototype={constructor:u,logger:l.default,log:l.default.log,registerHelper:function(e,t){if(i.toString.call(e)===c){if(t)throw new o.default("Arg not supported with multiple helpers");i.extend(this.helpers,e)}else this.helpers[e]=t},unregisterHelper:function(e){delete this.helpers[e]},registerPartial:function(e,t){if(i.toString.call(e)===c)i.extend(this.partials,e);else{if(void 0===t)throw new o.default('Attempting to register a partial called "'+e+'" as undefined');this.partials[e]=t}},unregisterPartial:function(e){delete this.partials[e]},registerDecorator:function(e,t){if(i.toString.call(e)===c){if(t)throw new o.default("Arg not supported with multiple decorators");i.extend(this.decorators,e)}else this.decorators[e]=t},unregisterDecorator:function(e){delete this.decorators[e]}};var d=l.default.log;t.log=d,t.createFrame=i.createFrame,t.logger=l.default},function(e,t){t.__esModule=!0,t.extend=a,t.indexOf=function(e,t){for(var n=0,r=e.length;n":">",'"':""","'":"'","`":"`","=":"="},r=/[&<>"'`=]/g,i=/[&<>"'`=]/;function o(e){return n[e]}function a(e){for(var t=1;t0?(n.ids&&(n.ids=[n.name]),e.helpers.each(t,n)):i(this);if(n.data&&n.ids){var a=r.createFrame(n.data);a.contextPath=r.appendContextPath(n.data.contextPath,n.name),n={data:a}}return o(t,n)})},e.exports=t.default},function(e,t,n){var r=n(2).default;t.__esModule=!0;var i=n(4),o=r(n(5));t.default=function(e){e.registerHelper("each",function(e,t){if(!t)throw new o.default("Must pass iterator to #each");var n=t.fn,r=t.inverse,a=0,s="",l=void 0,c=void 0;function u(t,r,o){l&&(l.key=t,l.index=r,l.first=0===r,l.last=!!o,c&&(l.contextPath=c+t)),s+=n(e[t],{data:l,blockParams:i.blockParams([e[t],t],[c+t,null])})}if(t.data&&t.ids&&(c=i.appendContextPath(t.data.contextPath,t.ids[0])+"."),i.isFunction(e)&&(e=e.call(this)),t.data&&(l=i.createFrame(t.data)),e&&"object"==typeof e)if(i.isArray(e))for(var d=e.length;a=0?t:parseInt(e,10)}return e},log:function(e){if(e=i.lookupLevel(e),"undefined"!=typeof console&&i.lookupLevel(i.level)<=e){var t=i.methodMap[e];console[t]||(t="log");for(var n=arguments.length,r=Array(n>1?n-1:0),o=1;o *:hover > span.permalink { visibility: visible; }\n"},3:function(e,t,n,r,i){return" float: right;\n"},5:function(e,t,n,r,i){return" visibility: hidden;\n"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{};return"/* --- PERMALINKS --- */\n"+(null!=(o=n.if.call(a,null!=t?t.permalinkHide:t,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"\n.permalink {\n width: 1px;\n height: 1px;\n overflow: visible;\n font-size: 10pt;\n font-style: normal;\n vertical-align: middle;\n margin-left: 4px;\n"+(null!=(o=n.if.call(a,null!=t?t.permalinkEdge:t,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+(null!=(o=n.if.call(a,null!=t?t.permalinkHide:t,{name:"if",hash:{},fn:e.program(5,i,0),inverse:e.noop,data:i}))?o:"")+"}\n\n.permalink a, .permalink a:link, .permalink a:visited, .permalink a:hover, .permalink a:focus, .permalink a:active {\n background:transparent !important;\n text-decoration:none;\n font-weight: bold;\n color:#666 !important;\n}\n\n.permalink abbr {\n border:0;\n}\n"},useData:!0}),n["attribute.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression((n.escapeAttributeName||t&&t.escapeAttributeName||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.name:o,{name:"escapeAttributeName",hash:{},data:i}))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:u)?a.call(c,{name:"qualifiers",hash:{},data:i}):a)+"attribute "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["callback.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"callback "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" = "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" ("+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+");"},useData:!0}),n["const.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"const "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+""+l("function"==typeof(a=null!=(a=n.nullable||(null!=t?t.nullable:t))?a:u)?a.call(c,{name:"nullable",hash:{},data:i}):a)+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" = "+l((n.stringifyIdlConst||t&&t.stringifyIdlConst||u).call(c,null!=(o=null!=t?t.obj:t)?o.value:o,{name:"stringifyIdlConst",hash:{},data:i}))+";\n"},useData:!0}),n["dict-member.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" = "+e.escapeExpression((n.stringifyIdlConst||t&&t.stringifyIdlConst||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.default:o,{name:"stringifyIdlConst",hash:{},data:i}))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:u)?a.call(c,{name:"qualifiers",hash:{},data:i}):a)+""+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.typePad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.default:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["dictionary.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" : "+e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.inheritance:o,t))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.partial||(null!=t?t.partial:t))?a:u)?a.call(c,{name:"partial",hash:{},data:i}):a)+"dictionary "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.inheritance:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+"};"},useData:!0}),n["enum-item.html"]=t({1:function(e,t,n,r,i){return","},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression,u="function";return c((n.idn||t&&t.idn||l).call(s,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+'"'+c(typeof(a=null!=(a=n.name||(null!=t?t.name:t))?a:l)===u?a.call(s,{name:"name",hash:{},data:i}):a)+'"'+(null!=(o=n.if.call(s,null!=t?t.needsComma:t,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"\n"},useData:!0}),n["enum.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"enum "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"};"},useData:!0}),n["extended-attribute.html"]=t({1:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return"'+c("function"==typeof(a=null!=(a=n.name||(null!=t?t.name:t))?a:l)?a.call(s,{name:"name",hash:{},data:i}):a)+""+(null!=(o=n.if.call(s,null!=t?t.rhs:t,{name:"if",hash:{},fn:e.program(2,i,0),inverse:e.noop,data:i}))?o:"")+(null!=(o=(n.jsIf||t&&t.jsIf||l).call(s,null!=t?t.arguments:t,{name:"jsIf",hash:{},fn:e.program(5,i,0),inverse:e.noop,data:i}))?o:"")+""},2:function(e,t,n,r,i){var o;return'='+(null!=(o=(n.extAttrRhs||t&&t.extAttrRhs||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=t?t.rhs:t,{name:"extAttrRhs",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+""},3:function(e,t,n,r,i){return e.escapeExpression(e.lambda(t,t))},5:function(e,t,n,r,i){var o;return"("+(null!=(o=(n.joinNonWhitespace||t&&t.joinNonWhitespace||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=t?t.arguments:t,", ",{name:"joinNonWhitespace",hash:{},fn:e.program(6,i,0),inverse:e.noop,data:i}))?o:"")+")"},6:function(e,t,n,r,i){return e.escapeExpression((n.param||t&&t.param||n.helperMissing).call(null!=t?t:e.nullContext||{},t,{name:"param",hash:{},data:i}))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return c((n.idn||t&&t.idn||l).call(s,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"["+(null!=(o=(n.join||t&&t.join||l).call(s,null!=t?t.extAttrs:t,null!=t?t.sep:t,{name:"join",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"]"+c("function"==typeof(a=null!=(a=n.end||(null!=t?t.end:t))?a:l)?a.call(s,{name:"end",hash:{},data:i}):a)},useData:!0}),n["field.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=e.lambda,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+s((n.pads||t&&t.pads||c).call(l,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["implements.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression,c=e.lambda;return""+l((n.extAttr||t&&t.extAttr||s).call(a,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+l(c(null!=(o=null!=t?t.obj:t)?o.target:o,t))+" implements "+l(c(null!=(o=null!=t?t.obj:t)?o.implements:o,t))+";"},useData:!0}),n["includes.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression,c=e.lambda;return""+l((n.extAttr||t&&t.extAttr||s).call(a,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+l(c(null!=(o=null!=t?t.obj:t)?o.target:o,t))+" includes "+l(c(null!=(o=null!=t?t.obj:t)?o.includes:o,t))+";"},useData:!0}),n["interface.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" : "+e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.inheritance:o,t))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing,d="function";return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l(typeof(a=null!=(a=n.partial||(null!=t?t.partial:t))?a:u)===d?a.call(c,{name:"partial",hash:{},data:i}):a)+l(typeof(a=null!=(a=n.callback||(null!=t?t.callback:t))?a:u)===d?a.call(c,{name:"callback",hash:{},data:i}):a)+"interface "+l(typeof(a=null!=(a=n.mixin||(null!=t?t.mixin:t))?a:u)===d?a.call(c,{name:"mixin",hash:{},data:i}):a)+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.inheritance:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o=typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)===d?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"};"},useData:!0}),n["iterable.html"]=t({1:function(e,t,n,r,i){return"iterable"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+s("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:c)?a.call(l,{name:"qualifiers",hash:{},data:i}):a)+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"<"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+">;\n"},useData:!0}),n["line-comment.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression;return""+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"//"+l("function"==typeof(o=null!=(o=n.comment||(null!=t?t.comment:t))?o:s)?o.call(a,{name:"comment",hash:{},data:i}):o)+"\n"},useData:!0}),n["maplike.html"]=t({1:function(e,t,n,r,i){return"maplike"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+s("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:c)?a.call(l,{name:"qualifiers",hash:{},data:i}):a)+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"<"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+">;\n"},useData:!0}),n["method.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l((n.extAttrInline||t&&t.extAttrInline||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttrInline",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.special||(null!=t?t.special:t))?a:u)?a.call(c,{name:"special",hash:{},data:i}):a)+""+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"("+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+");\n"},useData:!0}),n["multiline-comment.html"]=t({1:function(e,t,n,r,i,o,a){var s=e.escapeExpression;return s((n.idn||t&&t.idn||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=a[1]?a[1].indent:a[1],{name:"idn",hash:{},data:i}))+s(e.lambda(t,t))+"\n"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i,o,a){var s,l,c=null!=t?t:e.nullContext||{},u=n.helperMissing,d=e.escapeExpression;return""+d((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"/*"+d("function"==typeof(l=null!=(l=n.firstLine||(null!=t?t.firstLine:t))?l:u)?l.call(c,{name:"firstLine",hash:{},data:i}):l)+"\n"+(null!=(s=n.each.call(c,null!=t?t.innerLine:t,{name:"each",hash:{},fn:e.program(1,i,0,o,a),inverse:e.noop,data:i}))?s:"")+d((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+d("function"==typeof(l=null!=(l=n.lastLine||(null!=t?t.lastLine:t))?l:u)?l.call(c,{name:"lastLine",hash:{},data:i}):l)+"*/\n"},useData:!0,useDepths:!0}),n["param.html"]=t({1:function(e,t,n,r,i){var o;return" = "+e.escapeExpression((n.stringifyIdlConst||t&&t.stringifyIdlConst||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.default:o,{name:"stringifyIdlConst",hash:{},data:i}))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return""+c((n.extAttrInline||t&&t.extAttrInline||l).call(s,null!=t?t.obj:t,{name:"extAttrInline",hash:{},data:i}))+c("function"==typeof(a=null!=(a=n.optional||(null!=t?t.optional:t))?a:l)?a.call(s,{name:"optional",hash:{},data:i}):a)+""+c((n.idlType||t&&t.idlType||l).call(s,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+c("function"==typeof(a=null!=(a=n.variadic||(null!=t?t.variadic:t))?a:l)?a.call(s,{name:"variadic",hash:{},data:i}):a)+" "+c(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))+""+(null!=(o=n.if.call(s,null!=(o=null!=t?t.obj:t)?o.default:o,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""},useData:!0}),n["typedef.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=e.lambda,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return"typedef "+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";"},useData:!0}),n}),define("w3c/templates/cgbg-sotd",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const t=hyperHTML;return t`

          ${e.l10n.sotd}

          ${e.isPreview?t`
          This is a preview @@ -562,4 +562,4 @@ ${[e.additionalSections]}`})}),define("w3c/templates/show-logo",["exports","core ${i} ${t} `}}),define("core/list-sorter",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.sortListItems=r,e.sortDefinitionTerms=o,e.run=function(e,n,i){for(const e of document.querySelectorAll("[data-sort]")){let n;const i=e.dataset.sort||"ascending";switch(e.localName){case"dl":n=o(e,i);break;case"ol":case"ul":n=r(e,i);break;default:(0,t.pub)("warning",`ReSpec can't sort ${e.localName} elements.`)}if(n){const t=document.createRange();t.selectNodeContents(e),t.deleteContents(),e.appendChild(n)}}i()};e.name="core/list-sorter";function n(e){return({textContent:t},{textContent:n})=>"ascending"===e?t.localeCompare(n):n.localeCompare(t)}function r(e,t){return i(e,"li").sort(n(t)).reduce((e,t)=>(e.appendChild(t),e),document.createDocumentFragment())}function i(e,t){let n;try{n=e.querySelectorAll(`:scope > ${t}`)}catch(r){let i="";e.id||(i=`temp-${String(Math.random()).substr(2)}`,e.id=i);const o=`#${e.id} > ${t}`;n=e.parentElement.querySelectorAll(o),i&&(e.id="")}return[...n]}function o(e,t){return i(e,"dt").sort(n(t)).reduce((e,t)=>{const{nodeType:n,nodeName:r}=t,i=document.createDocumentFragment();let{nextSibling:o}=t;for(;o&&o.nextSibling;){i.appendChild(o.cloneNode(!0));const{nodeType:e,nodeName:t}=o.nextSibling;if(e===n&&t===r)break;o=o.nextSibling}return i.prepend(t.cloneNode(!0)),e.appendChild(i),e},document.createDocumentFragment())}}),define("deps/text!core/css/var.css",[],function(){return"var:hover {\n border-bottom: 1px dotted;\n cursor: pointer;\n}\n\nvar.respec-hl {\n color: var(--color, #000);\n background-color: var(--bg-color);\n box-shadow: 0 0 0px 2px var(--bg-color);\n}\n\n/* highlight colors\n https://github.com/w3c/tr-design/issues/152\n*/\nvar.respec-hl-c1 {\n --bg-color: #f4d200;\n}\n\nvar.respec-hl-c2 {\n --bg-color: #ff87a2;\n}\n\nvar.respec-hl-c3 {\n --bg-color: #96e885;\n}\n\nvar.respec-hl-c4 {\n --bg-color: #3eeed2;\n}\n\nvar.respec-hl-c5 {\n --bg-color: #eacfb6;\n}\n\nvar.respec-hl-c6 {\n --bg-color: #82ddff;\n}\n\nvar.respec-hl-c7 {\n --bg-color: #ffbcf2;\n}\n\n@media print {\n var.respec-hl {\n background: none;\n color: #000;\n box-shadow: unset;\n }\n}\n"}),define("core/highlight-vars",["exports","core/pubsubhub","deps/text!core/css/var.css"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){if(!e.highlightVars)return;const n=document.createElement("style");n.textContent=i.default,n.classList.add("removeOnSave"),document.head.appendChild(n),[...document.querySelectorAll("var")].forEach(e=>e.addEventListener("click",o)),(0,t.sub)("beforesave",e=>{[...e.querySelectorAll("var.respec-hl")].forEach(l)})};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/highlight-vars";function o(e){e.stopPropagation();const{target:t}=e,n=function(e){const t=e.textContent.trim(),n=e.closest("section"),r=s(e),i=[...n.querySelectorAll("var")].filter(e=>e.textContent.trim()===t),o=i[0].classList.contains("respec-hl");if(a.set(r,o),o)return i.forEach(e=>l(e,r)),[];i.forEach(e=>(c=e,u=r,void c.classList.add("respec-hl",u)));var c,u;return i}(t),r=()=>{const e=s(t);n.forEach(t=>l(t,e)),[...a.keys()].forEach(e=>a.set(e,!0))};n.length&&document.body.addEventListener("click",r,{once:!0})}const a=new Map([["respec-hl-c1",!0],["respec-hl-c2",!0],["respec-hl-c3",!0],["respec-hl-c4",!0],["respec-hl-c5",!0],["respec-hl-c6",!0],["respec-hl-c7",!0]]);function s(e){const{value:t}=e.classList,n=/respec-hl-\w+/,r=n.test(t)&&t.match(n);return r?r[0]:!0===a.get("respec-hl-c1")?"respec-hl-c1":[...a.keys()].find(e=>a.get(e))||"respec-hl-c1"}function l(e,t){e.classList.remove("respec-hl",t),e.classList.length||e.removeAttribute("class")}}),window.addEventListener("error",e=>{console.error(e.error,e.message,e)}),require.config({shim:{shortcut:{exports:"shortcut"},highlight:{exports:"hljs"}},paths:{"handlebars.runtime":"deps/handlebars","deps/highlight":"https://www.w3.org/Tools/respec/respec-highlight"},deps:["deps/hyperhtml","deps/url-search-params"]}),define("profile-oai",["deps/domReady","core/base-runner","core/ui","core/l10n","oai/defaults","core/style","w3c/style","w3c/l10n","core/github","core/data-include","core/markdown","oai/headers","w3c/abstract","w3c/conformance","core/data-transform","core/inlines","core/dfn","w3c/rfc2119","core/examples","core/issues-notes","core/requirements","core/best-practices","core/figures","core/webidl","core/data-cite","core/biblio","core/webidl-index","core/link-to-dfn","core/contrib","core/fix-headers","core/structure","w3c/informative","w3c/permalinks","core/id-headers","core/location-hash","core/caniuse","ui/save-html","ui/search-specref","ui/dfn-list","ui/about-respec","core/seo","w3c/seo","core/highlight","core/webidl-clipboard","core/data-tests","core/list-sorter","core/highlight-vars","core/linter"],(e,t,{ui:n},...r)=>{n.show(),e(async()=>{try{await t.runAll(r),await document.respecIsReady}catch(e){console.error(e)}finally{n.enable()}})}),require(["profile-oai"]); -//# sourceMappingURL=respec-oai.build.js.map \ No newline at end of file +//# sourceMappingURL=respec-oai.build.js.map From 086a63327337337b90b1dac3a703dd9f9307dd35 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 10 Jun 2021 10:40:46 -0600 Subject: [PATCH 017/152] Update ReSpec versions (#2615) Signed-off-by: GitHub Co-authored-by: webron --- oas/latest.html | 4083 +++++++++++++++++++++++++++++++++++++++++++++++ oas/v2.0.html | 4 +- oas/v3.0.0.html | 4 +- oas/v3.0.1.html | 4 +- oas/v3.0.2.html | 4 +- oas/v3.0.3.html | 4 +- oas/v3.1.0.html | 4 +- 7 files changed, 4095 insertions(+), 12 deletions(-) create mode 100644 oas/latest.html diff --git a/oas/latest.html b/oas/latest.html new file mode 100644 index 0000000000..fca28102c4 --- /dev/null +++ b/oas/latest.html @@ -0,0 +1,4083 @@ +OpenAPI Specification v3.1.0 | Introduction, Definitions, & More + + +

          OpenAPI Specification v3.1.0

          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.
          +

          OpenAPI Specification

          +

          Version 3.1.0

          +

          The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

          +

          This document is licensed under The Apache License, Version 2.0.

          +

          Introduction

          +

          The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to HTTP APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

          +

          An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

          + +

          Definitions

          +

          OpenAPI Document

          +

          A self-contained or composite resource which defines or describes an API or elements of an API. The OpenAPI document MUST contain at least one paths field, a components field or a webhooks field. An OpenAPI document uses and conforms to the OpenAPI Specification.

          +

          Path Templating

          +

          Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.

          +

          Each template expression in the path MUST correspond to a path parameter that is included in the Path Item itself and/or in each of the Path Item’s Operations. An exception is if the path item is empty, for example due to ACL constraints, matching path parameters are not required.

          +

          The value for these path parameters MUST NOT contain any unescaped “generic syntax” characters described by [[!RFC3986]]: forward slashes (/), question marks (?), or hashes (#).

          +

          Media Types

          +

          Media type definitions are spread across several resources. +The media type definitions SHOULD be in compliance with [[!RFC6838]].

          +

          Some examples of possible media type definitions:

          +
          
          +  text/plain; charset=utf-8
          +  application/json
          +  application/vnd.github+json
          +  application/vnd.github.v3+json
          +  application/vnd.github.v3.raw+json
          +  application/vnd.github.v3.text+json
          +  application/vnd.github.v3.html+json
          +  application/vnd.github.v3.full+json
          +  application/vnd.github.v3.diff
          +  application/vnd.github.v3.patch
          +
          +

          HTTP Status Codes

          +

          The HTTP Status Codes are used to indicate the status of the executed operation. +The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

          +

          Specification

          +

          Versions

          +

          The OpenAPI Specification is versioned using a major.minor.patch versioning scheme. The major.minor portion of the version string (for example 3.1) SHALL designate the OAS feature set. .patch versions address errors in, or provide clarifications to, this document, not the feature set. Tooling which supports OAS 3.1 SHOULD be compatible with all OAS 3.1.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.1.0 and 3.1.1 for example.

          +

          Occasionally, non-backwards compatible changes may be made in minor versions of the OAS where impact is believed to be low relative to the benefit provided.

          +

          An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the version of the OAS that it uses.

          +

          Format

          +

          An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

          +

          For example, if a field has an array value, the JSON array representation will be used:

          +
          
          +{
          +   "field": [ 1, 2, 3 ]
          +}
          +
          +

          All field names in the specification are case sensitive. +This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

          +

          The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

          +

          Patterned fields MUST have unique names within the containing object.

          +

          In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

          + +

          Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

          +

          Document Structure

          +

          An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. In the latter case, Reference Objects and Schema Object $ref keywords are used.

          +

          It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

          +

          Data Types

          +

          Data types in the OAS are based on the types supported by the JSON Schema Specification Draft 2020-12. +Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. +Models are defined using the Schema Object, which is a superset of JSON Schema Specification Draft 2020-12.

          +

          As defined by the JSON Schema Validation vocabulary, data types can have an optional modifier property: format. +OAS defines additional formats to provide fine detail for primitive data types.

          +

          The formats defined by the OAS are:

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          typeformatComments
          integerint32signed 32 bits
          integerint64signed 64 bits (a.k.a long)
          numberfloat
          numberdouble
          stringpasswordA hint to UIs to obscure input.
          +

          Rich Text Formatting

          +

          Throughout the specification description fields are noted as supporting CommonMark markdown formatting. +Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

          +

          Relative References in URIs

          +

          Unless specified otherwise, all properties that are URIs MAY be relative references as defined by [[!RFC3986]].

          +

          Relative references, including those in Reference Objects, PathItem Object $ref fields, Link Object operationRef fields and Example Object externalValue fields, are resolved using the referring document as the Base URI according to [[!RFC3986]].

          +

          If a URI contains a fragment identifier, then the fragment should be resolved per the fragment resolution mechanism of the referenced document. If the representation of the referenced document is JSON or YAML, then the fragment identifier SHOULD be interpreted as a JSON-Pointer as per [[!RFC6901]].

          +

          Relative references in Schema Objects, including any that appear as $id values, use the nearest parent $id as a Base URI, as described by JSON Schema Specification Draft 2020-12. If no parent schema contains an $id, then the Base URI MUST be determined according to [[!RFC3986]].

          +

          Relative References in URLs

          +

          Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. +Unless specified otherwise, relative references are resolved using the URLs defined in the Server Object as a Base URL. Note that these themselves MAY be relative to the referring document.

          +

          Schema

          +

          In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

          +

          OpenAPI Object

          +

          This is the root object of the OpenAPI document.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          openapistringREQUIRED. This string MUST be the version number of the OpenAPI Specification that the OpenAPI document uses. The openapi field SHOULD be used by tooling to interpret the OpenAPI document. This is not related to the API info.version string.
          infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
          jsonSchemaDialectstringThe default value for the $schema keyword within Schema Objects contained within this OAS document. This MUST be in the form of a URI.
          servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
          pathsPaths ObjectThe available paths and operations for the API.
          webhooksMap[string, Path Item Object | Reference Object] ]The incoming webhooks that MAY be received as part of this API and that the API consumer MAY choose to implement. Closely related to the callbacks feature, this section describes requests initiated other than by an API call, for example by an out of band registration. The key name is a unique string to refer to each webhook, while the (optionally referenced) Path Item Object describes a request that may be initiated by the API provider and the expected responses. An example is available.
          componentsComponents ObjectAn element to hold various schemas for the document.
          security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition. To make security optional, an empty security requirement ({}) can be included in the array.
          tags[Tag Object]A list of tags used by the document with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
          externalDocsExternal Documentation ObjectAdditional external documentation.
          +

          This object MAY be extended with Specification Extensions.

          +

          Info Object

          +

          The object provides metadata about the API. +The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          titlestringREQUIRED. The title of the API.
          summarystringA short summary of the API.
          descriptionstringA description of the API. CommonMark syntax MAY be used for rich text representation.
          termsOfServicestringA URL to the Terms of Service for the API. This MUST be in the form of a URL.
          contactContact ObjectThe contact information for the exposed API.
          licenseLicense ObjectThe license information for the exposed API.
          versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
          +

          This object MAY be extended with Specification Extensions.

          +

          Info Object Example

          +
          
          +{
          +  "title": "Sample Pet Store App",
          +  "summary": "A pet store manager.",
          +  "description": "This is a sample server for a pet store.",
          +  "termsOfService": "https://example.com/terms/",
          +  "contact": {
          +    "name": "API Support",
          +    "url": "https://www.example.com/support",
          +    "email": "support@example.com"
          +  },
          +  "license": {
          +    "name": "Apache 2.0",
          +    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
          +  },
          +  "version": "1.0.1"
          +}
          +
          +
          
          +title: Sample Pet Store App
          +summary: A pet store manager.
          +description: This is a sample server for a pet store.
          +termsOfService: https://example.com/terms/
          +contact:
          +  name: API Support
          +  url: https://www.example.com/support
          +  email: support@example.com
          +license:
          +  name: Apache 2.0
          +  url: https://www.apache.org/licenses/LICENSE-2.0.html
          +version: 1.0.1
          +
          +

          Contact Object

          +

          Contact information for the exposed API.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringThe identifying name of the contact person/organization.
          urlstringThe URL pointing to the contact information. This MUST be in the form of a URL.
          emailstringThe email address of the contact person/organization. This MUST be in the form of an email address.
          +

          This object MAY be extended with Specification Extensions.

          +

          Contact Object Example

          +
          
          +{
          +  "name": "API Support",
          +  "url": "https://www.example.com/support",
          +  "email": "support@example.com"
          +}
          +
          +
          
          +name: API Support
          +url: https://www.example.com/support
          +email: support@example.com
          +
          +

          License Object

          +

          License information for the exposed API.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringREQUIRED. The license name used for the API.
          identifierstringAn SPDX license expression for the API. The identifier field is mutually exclusive of the url field.
          urlstringA URL to the license used for the API. This MUST be in the form of a URL. The url field is mutually exclusive of the identifier field.
          +

          This object MAY be extended with Specification Extensions.

          +

          License Object Example

          +
          
          +{
          +  "name": "Apache 2.0",
          +  "identifier": "Apache-2.0"
          +}
          +
          +
          
          +name: Apache 2.0
          +identifier: Apache-2.0
          +
          +

          Server Object

          +

          An object representing a Server.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
          descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
          variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
          +

          This object MAY be extended with Specification Extensions.

          +

          Server Object Example

          +

          A single server would be described as:

          +
          
          +{
          +  "url": "https://development.gigantic-server.com/v1",
          +  "description": "Development server"
          +}
          +
          +
          
          +url: https://development.gigantic-server.com/v1
          +description: Development server
          +
          +

          The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

          +
          
          +{
          +  "servers": [
          +    {
          +      "url": "https://development.gigantic-server.com/v1",
          +      "description": "Development server"
          +    },
          +    {
          +      "url": "https://staging.gigantic-server.com/v1",
          +      "description": "Staging server"
          +    },
          +    {
          +      "url": "https://api.gigantic-server.com/v1",
          +      "description": "Production server"
          +    }
          +  ]
          +}
          +
          +
          
          +servers:
          +- url: https://development.gigantic-server.com/v1
          +  description: Development server
          +- url: https://staging.gigantic-server.com/v1
          +  description: Staging server
          +- url: https://api.gigantic-server.com/v1
          +  description: Production server
          +
          +

          The following shows how variables can be used for a server configuration:

          +
          
          +{
          +  "servers": [
          +    {
          +      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
          +      "description": "The production API server",
          +      "variables": {
          +        "username": {
          +          "default": "demo",
          +          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
          +        },
          +        "port": {
          +          "enum": [
          +            "8443",
          +            "443"
          +          ],
          +          "default": "8443"
          +        },
          +        "basePath": {
          +          "default": "v2"
          +        }
          +      }
          +    }
          +  ]
          +}
          +
          +
          
          +servers:
          +- url: https://{username}.gigantic-server.com:{port}/{basePath}
          +  description: The production API server
          +  variables:
          +    username:
          +      # note! no enum here means it is an open value
          +      default: demo
          +      description: this value is assigned by the service provider, in this example `gigantic-server.com`
          +    port:
          +      enum:
          +        - '8443'
          +        - '443'
          +      default: '8443'
          +    basePath:
          +      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
          +      default: v2
          +
          +

          Server Variable Object

          +

          An object representing a Server Variable for server URL template substitution.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          enum[string]An enumeration of string values to be used if the substitution options are from a limited set. The array MUST NOT be empty.
          defaultstringREQUIRED. The default value to use for substitution, which SHALL be sent if an alternate value is not supplied. Note this behavior is different than the Schema Object’s treatment of default values, because in those cases parameter values are optional. If the enum is defined, the value MUST exist in the enum’s values.
          descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
          +

          This object MAY be extended with Specification Extensions.

          +

          Components Object

          +

          Holds a set of reusable objects for different aspects of the OAS. +All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          schemasMap[string, Schema Object]An object to hold reusable Schema Objects.
          responsesMap[string, Response Object | Reference Object]An object to hold reusable Response Objects.
          parametersMap[string, Parameter Object | Reference Object]An object to hold reusable Parameter Objects.
          examplesMap[string, Example Object | Reference Object]An object to hold reusable Example Objects.
          requestBodiesMap[string, Request Body Object | Reference Object]An object to hold reusable Request Body Objects.
          headersMap[string, Header Object | Reference Object]An object to hold reusable Header Objects.
          securitySchemesMap[string, Security Scheme Object | Reference Object]An object to hold reusable Security Scheme Objects.
          linksMap[string, Link Object | Reference Object]An object to hold reusable Link Objects.
          callbacksMap[string, Callback Object | Reference Object]An object to hold reusable Callback Objects.
          pathItemsMap[string, Path Item Object | Reference Object]An object to hold reusable Path Item Object.
          +

          This object MAY be extended with Specification Extensions.

          +

          All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

          +

          Field Name Examples:

          +
          
          +User
          +User_1
          +User_Name
          +user-name
          +my.org.User
          +
          +

          Components Object Example

          +
          
          +"components": {
          +  "schemas": {
          +    "GeneralError": {
          +      "type": "object",
          +      "properties": {
          +        "code": {
          +          "type": "integer",
          +          "format": "int32"
          +        },
          +        "message": {
          +          "type": "string"
          +        }
          +      }
          +    },
          +    "Category": {
          +      "type": "object",
          +      "properties": {
          +        "id": {
          +          "type": "integer",
          +          "format": "int64"
          +        },
          +        "name": {
          +          "type": "string"
          +        }
          +      }
          +    },
          +    "Tag": {
          +      "type": "object",
          +      "properties": {
          +        "id": {
          +          "type": "integer",
          +          "format": "int64"
          +        },
          +        "name": {
          +          "type": "string"
          +        }
          +      }
          +    }
          +  },
          +  "parameters": {
          +    "skipParam": {
          +      "name": "skip",
          +      "in": "query",
          +      "description": "number of items to skip",
          +      "required": true,
          +      "schema": {
          +        "type": "integer",
          +        "format": "int32"
          +      }
          +    },
          +    "limitParam": {
          +      "name": "limit",
          +      "in": "query",
          +      "description": "max records to return",
          +      "required": true,
          +      "schema" : {
          +        "type": "integer",
          +        "format": "int32"
          +      }
          +    }
          +  },
          +  "responses": {
          +    "NotFound": {
          +      "description": "Entity not found."
          +    },
          +    "IllegalInput": {
          +      "description": "Illegal input for operation."
          +    },
          +    "GeneralError": {
          +      "description": "General Error",
          +      "content": {
          +        "application/json": {
          +          "schema": {
          +            "$ref": "#/components/schemas/GeneralError"
          +          }
          +        }
          +      }
          +    }
          +  },
          +  "securitySchemes": {
          +    "api_key": {
          +      "type": "apiKey",
          +      "name": "api_key",
          +      "in": "header"
          +    },
          +    "petstore_auth": {
          +      "type": "oauth2",
          +      "flows": {
          +        "implicit": {
          +          "authorizationUrl": "https://example.org/api/oauth/dialog",
          +          "scopes": {
          +            "write:pets": "modify pets in your account",
          +            "read:pets": "read your pets"
          +          }
          +        }
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +components:
          +  schemas:
          +    GeneralError:
          +      type: object
          +      properties:
          +        code:
          +          type: integer
          +          format: int32
          +        message:
          +          type: string
          +    Category:
          +      type: object
          +      properties:
          +        id:
          +          type: integer
          +          format: int64
          +        name:
          +          type: string
          +    Tag:
          +      type: object
          +      properties:
          +        id:
          +          type: integer
          +          format: int64
          +        name:
          +          type: string
          +  parameters:
          +    skipParam:
          +      name: skip
          +      in: query
          +      description: number of items to skip
          +      required: true
          +      schema:
          +        type: integer
          +        format: int32
          +    limitParam:
          +      name: limit
          +      in: query
          +      description: max records to return
          +      required: true
          +      schema:
          +        type: integer
          +        format: int32
          +  responses:
          +    NotFound:
          +      description: Entity not found.
          +    IllegalInput:
          +      description: Illegal input for operation.
          +    GeneralError:
          +      description: General Error
          +      content:
          +        application/json:
          +          schema:
          +            $ref: '#/components/schemas/GeneralError'
          +  securitySchemes:
          +    api_key:
          +      type: apiKey
          +      name: api_key
          +      in: header
          +    petstore_auth:
          +      type: oauth2
          +      flows: 
          +        implicit:
          +          authorizationUrl: https://example.org/api/oauth/dialog
          +          scopes:
          +            write:pets: modify pets in your account
          +            read:pets: read your pets
          +
          +

          Paths Object

          +

          Holds the relative paths to the individual endpoints and their operations. +The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to Access Control List (ACL) constraints.

          +

          Patterned Fields

          + + + + + + + + + + + + + + + +
          Field PatternTypeDescription
          /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a forward slash (/). The path is appended (no relative URL resolution) to the expanded URL from the Server Object’s url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
          +

          This object MAY be extended with Specification Extensions.

          +

          Path Templating Matching

          +

          Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

          +
          
          +  /pets/{petId}
          +  /pets/mine
          +
          +

          The following paths are considered identical and invalid:

          +
          
          +  /pets/{petId}
          +  /pets/{name}
          +
          +

          The following may lead to ambiguous resolution:

          +
          
          +  /{entity}/me
          +  /books/{id}
          +
          +

          Paths Object Example

          +
          
          +{
          +  "/pets": {
          +    "get": {
          +      "description": "Returns all pets from the system that the user has access to",
          +      "responses": {
          +        "200": {          
          +          "description": "A list of pets.",
          +          "content": {
          +            "application/json": {
          +              "schema": {
          +                "type": "array",
          +                "items": {
          +                  "$ref": "#/components/schemas/pet"
          +                }
          +              }
          +            }
          +          }
          +        }
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +/pets:
          +  get:
          +    description: Returns all pets from the system that the user has access to
          +    responses:
          +      '200':
          +        description: A list of pets.
          +        content:
          +          application/json:
          +            schema:
          +              type: array
          +              items:
          +                $ref: '#/components/schemas/pet'
          +
          +

          Path Item Object

          +

          Describes the operations available on a single path. +A Path Item MAY be empty, due to ACL constraints. +The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          $refstringAllows for a referenced definition of this path item. The referenced structure MUST be in the form of a Path Item Object. In case a Path Item Object field appears both in the defined object and the referenced object, the behavior is undefined. See the rules for resolving Relative References.
          summarystringAn optional, string summary, intended to apply to all operations in this path.
          descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
          getOperation ObjectA definition of a GET operation on this path.
          putOperation ObjectA definition of a PUT operation on this path.
          postOperation ObjectA definition of a POST operation on this path.
          deleteOperation ObjectA definition of a DELETE operation on this path.
          optionsOperation ObjectA definition of a OPTIONS operation on this path.
          headOperation ObjectA definition of a HEAD operation on this path.
          patchOperation ObjectA definition of a PATCH operation on this path.
          traceOperation ObjectA definition of a TRACE operation on this path.
          servers[Server Object]An alternative server array to service all operations in this path.
          parameters[Parameter Object | Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
          +

          This object MAY be extended with Specification Extensions.

          +

          Path Item Object Example

          +
          
          +{
          +  "get": {
          +    "description": "Returns pets based on ID",
          +    "summary": "Find pets by ID",
          +    "operationId": "getPetsById",
          +    "responses": {
          +      "200": {
          +        "description": "pet response",
          +        "content": {
          +          "*/*": {
          +            "schema": {
          +              "type": "array",
          +              "items": {
          +                "$ref": "#/components/schemas/Pet"
          +              }
          +            }
          +          }
          +        }
          +      },
          +      "default": {
          +        "description": "error payload",
          +        "content": {
          +          "text/html": {
          +            "schema": {
          +              "$ref": "#/components/schemas/ErrorModel"
          +            }
          +          }
          +        }
          +      }
          +    }
          +  },
          +  "parameters": [
          +    {
          +      "name": "id",
          +      "in": "path",
          +      "description": "ID of pet to use",
          +      "required": true,
          +      "schema": {
          +        "type": "array",
          +        "items": {
          +          "type": "string"
          +        }
          +      },
          +      "style": "simple"
          +    }
          +  ]
          +}
          +
          +
          
          +get:
          +  description: Returns pets based on ID
          +  summary: Find pets by ID
          +  operationId: getPetsById
          +  responses:
          +    '200':
          +      description: pet response
          +      content:
          +        '*/*' :
          +          schema:
          +            type: array
          +            items:
          +              $ref: '#/components/schemas/Pet'
          +    default:
          +      description: error payload
          +      content:
          +        'text/html':
          +          schema:
          +            $ref: '#/components/schemas/ErrorModel'
          +parameters:
          +- name: id
          +  in: path
          +  description: ID of pet to use
          +  required: true
          +  schema:
          +    type: array
          +    items:
          +      type: string  
          +  style: simple
          +
          +

          Operation Object

          +

          Describes a single API operation on a path.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
          summarystringA short summary of what the operation does.
          descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
          externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
          operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. The operationId value is case-sensitive. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
          parameters[Parameter Object | Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
          requestBodyRequest Body Object | Reference ObjectThe request body applicable for this operation. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as [GET]section-4.3.1), [HEAD]section-4.3.2) and [DELETE]section-4.3.5)), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.
          responsesResponses ObjectThe list of possible responses as they are returned from executing this operation.
          callbacksMap[string, Callback Object | Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses.
          deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
          security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. To make security optional, an empty security requirement ({}) can be included in the array. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
          servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
          +

          This object MAY be extended with Specification Extensions.

          +

          Operation Object Example

          +
          
          +{
          +  "tags": [
          +    "pet"
          +  ],
          +  "summary": "Updates a pet in the store with form data",
          +  "operationId": "updatePetWithForm",
          +  "parameters": [
          +    {
          +      "name": "petId",
          +      "in": "path",
          +      "description": "ID of pet that needs to be updated",
          +      "required": true,
          +      "schema": {
          +        "type": "string"
          +      }
          +    }
          +  ],
          +  "requestBody": {
          +    "content": {
          +      "application/x-www-form-urlencoded": {
          +        "schema": {
          +          "type": "object",
          +          "properties": {
          +            "name": { 
          +              "description": "Updated name of the pet",
          +              "type": "string"
          +            },
          +            "status": {
          +              "description": "Updated status of the pet",
          +              "type": "string"
          +            }
          +          },
          +          "required": ["status"] 
          +        }
          +      }
          +    }
          +  },
          +  "responses": {
          +    "200": {
          +      "description": "Pet updated.",
          +      "content": {
          +        "application/json": {},
          +        "application/xml": {}
          +      }
          +    },
          +    "405": {
          +      "description": "Method Not Allowed",
          +      "content": {
          +        "application/json": {},
          +        "application/xml": {}
          +      }
          +    }
          +  },
          +  "security": [
          +    {
          +      "petstore_auth": [
          +        "write:pets",
          +        "read:pets"
          +      ]
          +    }
          +  ]
          +}
          +
          +
          
          +tags:
          +- pet
          +summary: Updates a pet in the store with form data
          +operationId: updatePetWithForm
          +parameters:
          +- name: petId
          +  in: path
          +  description: ID of pet that needs to be updated
          +  required: true
          +  schema:
          +    type: string
          +requestBody:
          +  content:
          +    'application/x-www-form-urlencoded':
          +      schema:
          +       type: object
          +       properties:
          +          name: 
          +            description: Updated name of the pet
          +            type: string
          +          status:
          +            description: Updated status of the pet
          +            type: string
          +       required:
          +         - status
          +responses:
          +  '200':
          +    description: Pet updated.
          +    content: 
          +      'application/json': {}
          +      'application/xml': {}
          +  '405':
          +    description: Method Not Allowed
          +    content: 
          +      'application/json': {}
          +      'application/xml': {}
          +security:
          +- petstore_auth:
          +  - write:pets
          +  - read:pets
          +
          +

          External Documentation Object

          +

          Allows referencing an external resource for extended documentation.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          descriptionstringA description of the target documentation. CommonMark syntax MAY be used for rich text representation.
          urlstringREQUIRED. The URL for the target documentation. This MUST be in the form of a URL.
          +

          This object MAY be extended with Specification Extensions.

          +

          External Documentation Object Example

          +
          
          +{
          +  "description": "Find more info here",
          +  "url": "https://example.com"
          +}
          +
          +
          
          +description: Find more info here
          +url: https://example.com
          +
          +

          Parameter Object

          +

          Describes a single operation parameter.

          +

          A unique parameter is defined by a combination of a name and location.

          +

          Parameter Locations

          +

          There are four possible parameter locations specified by the in field:

          +
            +
          • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
          • +
          • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
          • +
          • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
          • +
          • cookie - Used to pass a specific cookie value to the API.
          • +
          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
          • If in is "path", the name field MUST correspond to a template expression occurring within the path field in the Paths Object. See Path Templating for further information.
          • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
          • For all other cases, the name corresponds to the parameter name used by the in property.
          instringREQUIRED. The location of the parameter. Possible values are "query", "header", "path" or "cookie".
          descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
          requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is "path", this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
          deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage. Default value is false.
          allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored. Use of this property is NOT RECOMMENDED, as it is likely to be removed in a later revision.
          +

          The rules for serialization of the parameter are specified in one of two ways. +For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
          explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
          allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
          schemaSchema ObjectThe schema defining the type used for the parameter.
          exampleAnyExample of the parameter’s potential value. The example SHOULD match the specified schema and encoding properties if present. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema that contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
          examplesMap[ string, Example Object | Reference Object]Examples of the parameter’s potential value. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema that contains an example, the examples value SHALL override the example provided by the schema.
          +

          For more complex scenarios, the content property can define the media type and schema of the parameter. +A parameter MUST contain either a schema property, or a content property, but not both. +When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

          + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
          +

          Style Values

          +

          In order to support common ways of serializing simple parameters, a set of style values are defined.

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          styletypeinComments
          matrixprimitive, array, objectpathPath-style parameters defined by [[!RFC6570]]
          labelprimitive, array, objectpathLabel style parameters defined by [[!RFC6570]]
          formprimitive, array, objectquery, cookieForm style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
          simplearraypath, headerSimple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0.
          spaceDelimitedarray, objectquerySpace separated array or object values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
          pipeDelimitedarray, objectqueryPipe separated array or object values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
          deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
          +

          Style Examples

          +

          Assume a parameter named color has one of the following values:

          +
          
          +   string -> "blue"
          +   array -> ["blue","black","brown"]
          +   object -> { "R": 100, "G": 200, "B": 150 }
          +
          +

          The following table shows examples of rendering differences for each value.

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          styleexplodeemptystringarrayobject
          matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
          matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
          labelfalse..blue.blue.black.brown.R.100.G.200.B.150
          labeltrue..blue.blue.black.brown.R=100.G=200.B=150
          formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
          formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
          simplefalsen/ablueblue,black,brownR,100,G,200,B,150
          simpletruen/ablueblue,black,brownR=100,G=200,B=150
          spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
          pipeDelimitedfalsen/an/ablue|black|brownR|100|G|200|B|150
          deepObjecttruen/an/an/acolor[R]=100&color[G]=200&color[B]=150
          +

          This object MAY be extended with Specification Extensions.

          +

          Parameter Object Examples

          +

          A header parameter with an array of 64 bit integer numbers:

          +
          
          +{
          +  "name": "token",
          +  "in": "header",
          +  "description": "token to be passed as a header",
          +  "required": true,
          +  "schema": {
          +    "type": "array",
          +    "items": {
          +      "type": "integer",
          +      "format": "int64"
          +    }
          +  },
          +  "style": "simple"
          +}
          +
          +
          
          +name: token
          +in: header
          +description: token to be passed as a header
          +required: true
          +schema:
          +  type: array
          +  items:
          +    type: integer
          +    format: int64
          +style: simple
          +
          +

          A path parameter of a string value:

          +
          
          +{
          +  "name": "username",
          +  "in": "path",
          +  "description": "username to fetch",
          +  "required": true,
          +  "schema": {
          +    "type": "string"
          +  }
          +}
          +
          +
          
          +name: username
          +in: path
          +description: username to fetch
          +required: true
          +schema:
          +  type: string
          +
          +

          An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

          +
          
          +{
          +  "name": "id",
          +  "in": "query",
          +  "description": "ID of the object to fetch",
          +  "required": false,
          +  "schema": {
          +    "type": "array",
          +    "items": {
          +      "type": "string"
          +    }
          +  },
          +  "style": "form",
          +  "explode": true
          +}
          +
          +
          
          +name: id
          +in: query
          +description: ID of the object to fetch
          +required: false
          +schema:
          +  type: array
          +  items:
          +    type: string
          +style: form
          +explode: true
          +
          +

          A free-form query parameter, allowing undefined parameters of a specific type:

          +
          
          +{
          +  "in": "query",
          +  "name": "freeForm",
          +  "schema": {
          +    "type": "object",
          +    "additionalProperties": {
          +      "type": "integer"
          +    },
          +  },
          +  "style": "form"
          +}
          +
          +
          
          +in: query
          +name: freeForm
          +schema:
          +  type: object
          +  additionalProperties:
          +    type: integer
          +style: form
          +
          +

          A complex parameter using content to define serialization:

          +
          
          +{
          +  "in": "query",
          +  "name": "coordinates",
          +  "content": {
          +    "application/json": {
          +      "schema": {
          +        "type": "object",
          +        "required": [
          +          "lat",
          +          "long"
          +        ],
          +        "properties": {
          +          "lat": {
          +            "type": "number"
          +          },
          +          "long": {
          +            "type": "number"
          +          }
          +        }
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +in: query
          +name: coordinates
          +content:
          +  application/json:
          +    schema:
          +      type: object
          +      required:
          +        - lat
          +        - long
          +      properties:
          +        lat:
          +          type: number
          +        long:
          +          type: number
          +
          +

          Request Body Object

          +

          Describes a single request body.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
          contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          requiredbooleanDetermines if the request body is required in the request. Defaults to false.
          +

          This object MAY be extended with Specification Extensions.

          +

          Request Body Examples

          +

          A request body with a referenced model definition.

          +
          
          +{
          +  "description": "user to add to the system",
          +  "content": {
          +    "application/json": {
          +      "schema": {
          +        "$ref": "#/components/schemas/User"
          +      },
          +      "examples": {
          +          "user" : {
          +            "summary": "User Example", 
          +            "externalValue": "https://foo.bar/examples/user-example.json"
          +          } 
          +        }
          +    },
          +    "application/xml": {
          +      "schema": {
          +        "$ref": "#/components/schemas/User"
          +      },
          +      "examples": {
          +          "user" : {
          +            "summary": "User example in XML",
          +            "externalValue": "https://foo.bar/examples/user-example.xml"
          +          }
          +        }
          +    },
          +    "text/plain": {
          +      "examples": {
          +        "user" : {
          +            "summary": "User example in Plain text",
          +            "externalValue": "https://foo.bar/examples/user-example.txt" 
          +        }
          +      } 
          +    },
          +    "*/*": {
          +      "examples": {
          +        "user" : {
          +            "summary": "User example in other format",
          +            "externalValue": "https://foo.bar/examples/user-example.whatever"
          +        }
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +description: user to add to the system
          +content: 
          +  'application/json':
          +    schema:
          +      $ref: '#/components/schemas/User'
          +    examples:
          +      user:
          +        summary: User Example
          +        externalValue: 'https://foo.bar/examples/user-example.json'
          +  'application/xml':
          +    schema:
          +      $ref: '#/components/schemas/User'
          +    examples:
          +      user:
          +        summary: User example in XML
          +        externalValue: 'https://foo.bar/examples/user-example.xml'
          +  'text/plain':
          +    examples:
          +      user:
          +        summary: User example in Plain text
          +        externalValue: 'https://foo.bar/examples/user-example.txt'
          +  '*/*':
          +    examples:
          +      user: 
          +        summary: User example in other format
          +        externalValue: 'https://foo.bar/examples/user-example.whatever'
          +
          +

          A body parameter that is an array of string values:

          +
          
          +{
          +  "description": "user to add to the system",
          +  "required": true,
          +  "content": {
          +    "text/plain": {
          +      "schema": {
          +        "type": "array",
          +        "items": {
          +          "type": "string"
          +        }
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +description: user to add to the system
          +required: true
          +content:
          +  text/plain:
          +    schema:
          +      type: array
          +      items:
          +        type: string
          +
          +

          Media Type Object

          +

          Each Media Type Object provides schema and examples for the media type identified by its key.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          schemaSchema ObjectThe schema defining the content of the request, response, or parameter.
          exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
          examplesMap[ string, Example Object | Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
          encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
          +

          This object MAY be extended with Specification Extensions.

          +

          Media Type Examples

          +
          
          +{
          +  "application/json": {
          +    "schema": {
          +         "$ref": "#/components/schemas/Pet"
          +    },
          +    "examples": {
          +      "cat" : {
          +        "summary": "An example of a cat",
          +        "value": 
          +          {
          +            "name": "Fluffy",
          +            "petType": "Cat",
          +            "color": "White",
          +            "gender": "male",
          +            "breed": "Persian"
          +          }
          +      },
          +      "dog": {
          +        "summary": "An example of a dog with a cat's name",
          +        "value" :  { 
          +          "name": "Puma",
          +          "petType": "Dog",
          +          "color": "Black",
          +          "gender": "Female",
          +          "breed": "Mixed"
          +        },
          +      "frog": {
          +          "$ref": "#/components/examples/frog-example"
          +        }
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +application/json: 
          +  schema:
          +    $ref: "#/components/schemas/Pet"
          +  examples:
          +    cat:
          +      summary: An example of a cat
          +      value:
          +        name: Fluffy
          +        petType: Cat
          +        color: White
          +        gender: male
          +        breed: Persian
          +    dog:
          +      summary: An example of a dog with a cat's name
          +      value:
          +        name: Puma
          +        petType: Dog
          +        color: Black
          +        gender: Female
          +        breed: Mixed
          +    frog:
          +      $ref: "#/components/examples/frog-example"
          +
          +

          Considerations for File Uploads

          +

          In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type.

          +

          In contrast with the 3.0 specification, the format keyword has no effect on the content-encoding of the schema. JSON Schema offers a contentEncoding keyword, which may be used to specify the Content-Encoding for the schema. The contentEncoding keyword supports all encodings defined in [[!RFC4648]], including “base64” and “base64url”, as well as “quoted-printable” from [[!RFC2045]]. The encoding specified by the contentEncoding keyword is independent of an encoding specified by the Content-Type header in the request or response or metadata of a multipart body – when both are present, the encoding specified in the contentEncoding is applied first and then the encoding specified in the Content-Type header.

          +

          JSON Schema also offers a contentMediaType keyword. However, when the media type is already specified by the Media Type Object’s key, or by the contentType field of an Encoding Object, the contentMediaType keyword SHALL be ignored if present.

          +

          Examples:

          +

          Content transferred in binary (octet-stream) MAY omit schema:

          +
          
          +# a PNG image as a binary file:
          +content:
          +    image/png: {}
          +
          +
          
          +# an arbitrary binary file:
          +content:
          +    application/octet-stream: {}
          +
          +

          Binary content transferred with base64 encoding:

          +
          
          +content:
          +    image/png:
          +        schema:
          +            type: string
          +            contentMediaType: image/png
          +            contentEncoding: base64
          +
          +

          Note that the Content-Type remains image/png, describing the semantics of the payload. The JSON Schema type and contentEncoding fields explain that the payload is transferred as text. The JSON Schema contentMediaType is technically redundant, but can be used by JSON Schema tools that may not be aware of the OpenAPI context.

          +

          These examples apply to either input payloads of file uploads or response payloads.

          +

          A requestBody for submitting a file in a POST operation may look like the following example:

          +
          
          +requestBody:
          +  content:
          +    application/octet-stream: {}
          +
          +

          In addition, specific media types MAY be specified:

          +
          
          +# multiple, specific media types may be specified:
          +requestBody:
          +  content:
          +    # a binary file of type png or jpeg
          +    image/jpeg: {}
          +    image/png: {}
          +
          +

          To upload multiple files, a multipart media type MUST be used:

          +
          
          +requestBody:
          +  content:
          +    multipart/form-data:
          +      schema:
          +        properties:
          +          # The property name 'file' will be used for all files.
          +          file:
          +            type: array
          +            items: {}
          +
          +

          As seen in the section on multipart/form-data below, the empty schema for items indicates a media type of application/octet-stream.

          +

          Support for x-www-form-urlencoded Request Bodies

          +

          To submit content using form url encoding via [[!RFC1866]], the following +definition may be used:

          +
          
          +requestBody:
          +  content:
          +    application/x-www-form-urlencoded:
          +      schema:
          +        type: object
          +        properties:
          +          id:
          +            type: string
          +            format: uuid
          +          address:
          +            # complex types are stringified to support RFC 1866
          +            type: object
          +            properties: {}
          +
          +

          In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

          +

          When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object’s style property as form.

          +

          Special Considerations for multipart Content

          +

          It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

          +

          In a multipart/form-data request body, each schema property, or each element of a schema array property, takes a section in the payload with an internal header as defined by [[!RFC7578]]. The serialization strategy for each property of a multipart/form-data request body can be specified in an associated Encoding Object.

          +

          When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred – thus, the following default Content-Types are defined for multipart:

          +
            +
          • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
          • +
          • If the property is complex, or an array of complex values, the default Content-Type is application/json
          • +
          • If the property is a type: string with a contentEncoding, the default Content-Type is application/octet-stream
          • +
          +

          Per the JSON Schema specification, contentMediaType without contentEncoding present is treated as if contentEncoding: identity were present. While useful for embedding text documents such as text/html into JSON strings, it is not useful for a multipart/form-data part, as it just causes the document to be treated as text/plain instead of its actual media type. Use the Encoding Object without contentMediaType if no contentEncoding is required.

          +

          Examples:

          +
          
          +requestBody:
          +  content:
          +    multipart/form-data:
          +      schema:
          +        type: object
          +        properties:
          +          id:
          +            type: string
          +            format: uuid
          +          address:
          +            # default Content-Type for objects is `application/json`
          +            type: object
          +            properties: {}
          +          profileImage:
          +            # Content-Type for application-level encoded resource is `text/plain`
          +            type: string
          +            contentMediaType: image/png
          +            contentEncoding: base64
          +          children:
          +            # default Content-Type for arrays is based on the _inner_ type (`text/plain` here)
          +            type: array
          +            items:
          +              type: string
          +          addresses:
          +            # default Content-Type for arrays is based on the _inner_ type (object shown, so `application/json` in this example)
          +            type: array
          +            items:
          +              type: object
          +              $ref: '#/components/schemas/Address'
          +
          +

          An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

          +

          Encoding Object

          +

          A single encoding definition applied to a single schema property.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for object - application/json; for array – the default is defined based on the inner type; for all other cases the default is application/octet-stream. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
          headersMap[string, Header Object | Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
          stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
          explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
          allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
          +

          This object MAY be extended with Specification Extensions.

          +

          Encoding Object Example

          +
          
          +requestBody:
          +  content:
          +    multipart/form-data:
          +      schema:
          +        type: object
          +        properties:
          +          id:
          +            # default is text/plain
          +            type: string
          +            format: uuid
          +          address:
          +            # default is application/json
          +            type: object
          +            properties: {}
          +          historyMetadata:
          +            # need to declare XML format!
          +            description: metadata in XML format
          +            type: object
          +            properties: {}
          +          profileImage: {}
          +      encoding:
          +        historyMetadata:
          +          # require XML Content-Type in utf-8 encoding
          +          contentType: application/xml; charset=utf-8
          +        profileImage:
          +          # only accept png/jpeg
          +          contentType: image/png, image/jpeg
          +          headers:
          +            X-Rate-Limit-Limit:
          +              description: The number of allowed requests in the current period
          +              schema:
          +                type: integer
          +
          +

          Responses Object

          +

          A container for the expected responses of an operation. +The container maps a HTTP response code to the expected response.

          +

          The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. +However, documentation is expected to cover a successful operation response and any known errors.

          +

          The default MAY be used as a default response object for all HTTP codes +that are not covered individually by the Responses Object.

          +

          The Responses Object MUST contain at least one response code, and if only one +response code is provided it SHOULD be the response for a successful operation +call.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          defaultResponse Object | Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses.
          +

          Patterned Fields

          + + + + + + + + + + + + + + + +
          Field PatternTypeDescription
          HTTP Status CodeResponse Object | Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. Only the following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
          +

          This object MAY be extended with Specification Extensions.

          +

          Responses Object Example

          +

          A 200 response for a successful operation and a default response for others (implying an error):

          +
          
          +{
          +  "200": {
          +    "description": "a pet to be returned",
          +    "content": {
          +      "application/json": {
          +        "schema": {
          +          "$ref": "#/components/schemas/Pet"
          +        }
          +      }
          +    }
          +  },
          +  "default": {
          +    "description": "Unexpected error",
          +    "content": {
          +      "application/json": {
          +        "schema": {
          +          "$ref": "#/components/schemas/ErrorModel"
          +        }
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +'200':
          +  description: a pet to be returned
          +  content: 
          +    application/json:
          +      schema:
          +        $ref: '#/components/schemas/Pet'
          +default:
          +  description: Unexpected error
          +  content:
          +    application/json:
          +      schema:
          +        $ref: '#/components/schemas/ErrorModel'
          +
          +

          Response Object

          +

          Describes a single response from an API Operation, including design-time, static +links to operations based on the response.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          descriptionstringREQUIRED. A description of the response. CommonMark syntax MAY be used for rich text representation.
          headersMap[string, Header Object | Reference Object]Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
          contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          linksMap[string, Link Object | Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
          +

          This object MAY be extended with Specification Extensions.

          +

          Response Object Examples

          +

          Response of an array of a complex type:

          +
          
          +{
          +  "description": "A complex object array response",
          +  "content": {
          +    "application/json": {
          +      "schema": {
          +        "type": "array",
          +        "items": {
          +          "$ref": "#/components/schemas/VeryComplexType"
          +        }
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +description: A complex object array response
          +content: 
          +  application/json:
          +    schema: 
          +      type: array
          +      items:
          +        $ref: '#/components/schemas/VeryComplexType'
          +
          +

          Response with a string type:

          +
          
          +{
          +  "description": "A simple string response",
          +  "content": {
          +    "text/plain": {
          +      "schema": {
          +        "type": "string"
          +      }
          +    }
          +  }
          +
          +}
          +
          +
          
          +description: A simple string response
          +content:
          +  text/plain:
          +    schema:
          +      type: string
          +
          +

          Plain text response with headers:

          +
          
          +{
          +  "description": "A simple string response",
          +  "content": {
          +    "text/plain": {
          +      "schema": {
          +        "type": "string",
          +        "example": "whoa!"
          +      }
          +    }
          +  },
          +  "headers": {
          +    "X-Rate-Limit-Limit": {
          +      "description": "The number of allowed requests in the current period",
          +      "schema": {
          +        "type": "integer"
          +      }
          +    },
          +    "X-Rate-Limit-Remaining": {
          +      "description": "The number of remaining requests in the current period",
          +      "schema": {
          +        "type": "integer"
          +      }
          +    },
          +    "X-Rate-Limit-Reset": {
          +      "description": "The number of seconds left in the current period",
          +      "schema": {
          +        "type": "integer"
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +description: A simple string response
          +content:
          +  text/plain:
          +    schema:
          +      type: string
          +    example: 'whoa!'
          +headers:
          +  X-Rate-Limit-Limit:
          +    description: The number of allowed requests in the current period
          +    schema:
          +      type: integer
          +  X-Rate-Limit-Remaining:
          +    description: The number of remaining requests in the current period
          +    schema:
          +      type: integer
          +  X-Rate-Limit-Reset:
          +    description: The number of seconds left in the current period
          +    schema:
          +      type: integer
          +
          +

          Response with no return value:

          +
          
          +{
          +  "description": "object created"
          +}
          +
          +
          
          +description: object created
          +
          +

          Callback Object

          +

          A map of possible out-of band callbacks related to the parent operation. +Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. +The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

          +

          To describe incoming requests from the API provider independent from another API call, use the webhooks field.

          +

          Patterned Fields

          + + + + + + + + + + + + + + + +
          Field PatternTypeDescription
          {expression}Path Item Object | Reference ObjectA Path Item Object, or a reference to one, used to define a callback request and expected responses. A complete example is available.
          +

          This object MAY be extended with Specification Extensions.

          +

          Key Expression

          +

          The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. +A simple example might be $request.body#/url. +However, using a runtime expression the complete HTTP message can be accessed. +This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

          +

          For example, given the following HTTP request:

          +
          
          +POST /subscribe/myevent?queryUrl=https://clientdomain.com/stillrunning HTTP/1.1
          +Host: example.org
          +Content-Type: application/json
          +Content-Length: 187
          +
          +{
          +  "failedUrl" : "https://clientdomain.com/failed",
          +  "successUrls" : [
          +    "https://clientdomain.com/fast",
          +    "https://clientdomain.com/medium",
          +    "https://clientdomain.com/slow"
          +  ] 
          +}
          +
          +201 Created
          +Location: https://example.org/subscription/1
          +
          +

          The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          ExpressionValue
          $urlhttps://example.org/subscribe/myevent?queryUrl=https://clientdomain.com/stillrunning
          $methodPOST
          $request.path.eventTypemyevent
          $request.query.queryUrlhttps://clientdomain.com/stillrunning
          $request.header.content-Typeapplication/json
          $request.body#/failedUrlhttps://clientdomain.com/failed
          $request.body#/successUrls/2https://clientdomain.com/medium
          $response.header.Locationhttps://example.org/subscription/1
          +

          Callback Object Examples

          +

          The following example uses the user provided queryUrl query string parameter to define the callback URL. This is an example of how to use a callback object to describe a WebHook callback that goes with the subscription operation to enable registering for the WebHook.

          +
          
          +myCallback:
          +  '{$request.query.queryUrl}':
          +    post:
          +      requestBody:
          +        description: Callback payload
          +        content:
          +          'application/json':
          +            schema:
          +              $ref: '#/components/schemas/SomePayload'
          +      responses:
          +        '200':
          +          description: callback successfully processed
          +
          +

          The following example shows a callback where the server is hard-coded, but the query string parameters are populated from the id and email property in the request body.

          +
          
          +transactionCallback:
          +  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
          +    post:
          +      requestBody:
          +        description: Callback payload
          +        content:
          +          'application/json':
          +            schema:
          +              $ref: '#/components/schemas/SomePayload'
          +      responses:
          +        '200':
          +          description: callback successfully processed
          +
          +

          Example Object

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          summarystringShort description for the example.
          descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
          valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
          externalValuestringA URI that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive. See the rules for resolving Relative References.
          +

          This object MAY be extended with Specification Extensions.

          +

          In all cases, the example value is expected to be compatible with the type schema +of its associated value. Tooling implementations MAY choose to +validate compatibility automatically, and reject the example value(s) if incompatible.

          +

          Example Object Examples

          +

          In a request body:

          +
          
          +requestBody:
          +  content:
          +    'application/json':
          +      schema:
          +        $ref: '#/components/schemas/Address'
          +      examples: 
          +        foo:
          +          summary: A foo example
          +          value: {"foo": "bar"}
          +        bar:
          +          summary: A bar example
          +          value: {"bar": "baz"}
          +    'application/xml':
          +      examples: 
          +        xmlExample:
          +          summary: This is an example in XML
          +          externalValue: 'https://example.org/examples/address-example.xml'
          +    'text/plain':
          +      examples:
          +        textExample: 
          +          summary: This is a text example
          +          externalValue: 'https://foo.bar/examples/address-example.txt'
          +
          +

          In a parameter:

          +
          
          +parameters:
          +  - name: 'zipCode'
          +    in: 'query'
          +    schema:
          +      type: 'string'
          +      format: 'zip-code'
          +    examples:
          +      zip-example: 
          +        $ref: '#/components/examples/zip-example'
          +
          +

          In a response:

          +
          
          +responses:
          +  '200':
          +    description: your car appointment has been booked
          +    content: 
          +      application/json:
          +        schema:
          +          $ref: '#/components/schemas/SuccessResponse'
          +        examples:
          +          confirmation-success:
          +            $ref: '#/components/examples/confirmation-success'
          +
          +

          Link Object

          +

          The Link object represents a possible design-time link for a response. +The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

          +

          Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

          +

          For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          operationRefstringA relative or absolute URI reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition. See the rules for resolving Relative References.
          operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
          parametersMap[string, Any | {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
          requestBodyAny | {expression}A literal value or {expression} to use as a request body when calling the target operation.
          descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
          serverServer ObjectA server object to be used by the target operation.
          +

          This object MAY be extended with Specification Extensions.

          +

          A linked operation MUST be identified using either an operationRef or operationId. +In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. +Because of the potential for name clashes, the operationRef syntax is preferred +for OpenAPI documents with external references.

          +

          Examples

          +

          Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

          +
          
          +paths:
          +  /users/{id}:
          +    parameters:
          +    - name: id
          +      in: path
          +      required: true
          +      description: the user identifier, as userId 
          +      schema:
          +        type: string
          +    get:
          +      responses:
          +        '200':
          +          description: the user being returned
          +          content:
          +            application/json:
          +              schema:
          +                type: object
          +                properties:
          +                  uuid: # the unique user id
          +                    type: string
          +                    format: uuid
          +          links:
          +            address:
          +              # the target link operationId
          +              operationId: getUserAddress
          +              parameters:
          +                # get the `id` field from the request path parameter named `id`
          +                userId: $request.path.id
          +  # the path item of the linked operation
          +  /users/{userid}/address:
          +    parameters:
          +    - name: userid
          +      in: path
          +      required: true
          +      description: the user identifier, as userId 
          +      schema:
          +        type: string
          +    # linked operation
          +    get:
          +      operationId: getUserAddress
          +      responses:
          +        '200':
          +          description: the user's address
          +
          +

          When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

          +

          Values from the response body can be used to drive a linked operation.

          +
          
          +links:
          +  address:
          +    operationId: getUserAddressByUUID
          +    parameters:
          +      # get the `uuid` field from the `uuid` field in the response body
          +      userUuid: $response.body#/uuid
          +
          +

          Clients follow all links at their discretion. +Neither permissions, nor the capability to make a successful call to that link, is guaranteed +solely by the existence of a relationship.

          +

          OperationRef Examples

          +

          As references to operationId MAY NOT be possible (the operationId is an optional +field in an Operation Object), references MAY also be made through a relative operationRef:

          +
          
          +links:
          +  UserRepositories:
          +    # returns array of '#/components/schemas/repository'
          +    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
          +    parameters:
          +      username: $response.body#/username
          +
          +

          or an absolute operationRef:

          +
          
          +links:
          +  UserRepositories:
          +    # returns array of '#/components/schemas/repository'
          +    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
          +    parameters:
          +      username: $response.body#/username
          +
          +

          Note that in the use of operationRef, the escaped forward-slash is necessary when +using JSON references.

          +

          Runtime Expressions

          +

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. +This mechanism is used by Link Objects and Callback Objects.

          +

          The runtime expression is defined by the following [ABNF] syntax

          +
          
          +      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
          +      source = ( header-reference / query-reference / path-reference / body-reference )
          +      header-reference = "header." token
          +      query-reference = "query." name  
          +      path-reference = "path." name
          +      body-reference = "body" ["#" json-pointer ]
          +      json-pointer    = *( "/" reference-token )
          +      reference-token = *( unescaped / escaped )
          +      unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
          +         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
          +      escaped         = "~" ( "0" / "1" )
          +        ; representing '~' and '/', respectively
          +      name = *( CHAR )
          +      token = 1*tchar
          +      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
          +        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
          +
          +

          Here, json-pointer is taken from [[!RFC6901]], char from [[!RFC7159]] and token from [[!RFC7230]].

          +

          The name identifier is case-sensitive, whereas token is not.

          +

          The table below provides examples of runtime expressions and examples of their use in a value:

          +

          Examples

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Source Locationexample expressionnotes
          HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
          Requested media type$request.header.accept
          Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
          Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
          Request URL$url
          Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
          Response header$response.header.ServerSingle header values only are available
          +

          Runtime expressions preserve the type of the referenced value. +Expressions can be embedded into string values by surrounding the expression with {} curly braces.

          +

          Header Object

          +

          The Header Object follows the structure of the Parameter Object with the following changes:

          +
            +
          1. name MUST NOT be specified, it is given in the corresponding headers map.
          2. +
          3. in MUST NOT be specified, it is implicitly in header.
          4. +
          5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
          6. +
          +

          Header Object Example

          +

          A simple header of type integer:

          +
          
          +{
          +  "description": "The number of allowed requests in the current period",
          +  "schema": {
          +    "type": "integer"
          +  }
          +}
          +
          +
          
          +description: The number of allowed requests in the current period
          +schema:
          +  type: integer
          +
          +

          Tag Object

          +

          Adds metadata to a single tag that is used by the Operation Object. +It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringREQUIRED. The name of the tag.
          descriptionstringA description for the tag. CommonMark syntax MAY be used for rich text representation.
          externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
          +

          This object MAY be extended with Specification Extensions.

          +

          Tag Object Example

          +
          
          +{
          +	"name": "pet",
          +	"description": "Pets operations"
          +}
          +
          +
          
          +name: pet
          +description: Pets operations
          +
          +

          Reference Object

          +

          A simple object to allow referencing other components in the OpenAPI document, internally and externally.

          +

          The $ref string value contains a URI [[!RFC3986]], which identifies the location of the value being referenced.

          +

          See the rules for resolving Relative References.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          $refstringREQUIRED. The reference identifier. This MUST be in the form of a URI.
          summarystringA short summary which by default SHOULD override that of the referenced component. If the referenced object-type does not allow a summary field, then this field has no effect.
          descriptionstringA description which by default SHOULD override that of the referenced component. CommonMark syntax MAY be used for rich text representation. If the referenced object-type does not allow a description field, then this field has no effect.
          +

          This object cannot be extended with additional properties and any properties added SHALL be ignored.

          +

          Note that this restriction on additional properties is a difference between Reference Objects and Schema Objects that contain a $ref keyword.

          +

          Reference Object Example

          +
          
          +{
          +	"$ref": "#/components/schemas/Pet"
          +}
          +
          +
          
          +$ref: '#/components/schemas/Pet'
          +
          +

          Relative Schema Document Example

          +
          
          +{
          +  "$ref": "Pet.json"
          +}
          +
          +
          
          +$ref: Pet.yaml
          +
          +

          Relative Documents With Embedded Schema Example

          +
          
          +{
          +  "$ref": "definitions.json#/Pet"
          +}
          +
          +
          
          +$ref: definitions.yaml#/Pet
          +
          +

          Schema Object

          +

          The Schema Object allows the definition of input and output data types. +These types can be objects, but also primitives and arrays. This object is a superset of the JSON Schema Specification Draft 2020-12.

          +

          For more information about the properties, see JSON Schema Core and JSON Schema Validation.

          +

          Unless stated otherwise, the property definitions follow those of JSON Schema and do not add any additional semantics. +Where JSON Schema indicates that behavior is defined by the application (e.g. for annotations), OAS also defers the definition of semantics to the application consuming the OpenAPI document.

          +

          Properties

          +

          The OpenAPI Schema Object dialect is defined as requiring the OAS base vocabulary, in addition to the vocabularies as specified in the JSON Schema draft 2020-12 general purpose meta-schema.

          +

          The OpenAPI Schema Object dialect for this version of the specification is identified by the URI https://spec.openapis.org/oas/3.1/dialect/base (the “OAS dialect schema id”).

          +

          The following properties are taken from the JSON Schema specification but their definitions have been extended by the OAS:

          +
            +
          • description - CommonMark syntax MAY be used for rich text representation.
          • +
          • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
          • +
          +

          In addition to the JSON Schema properties comprising the OAS dialect, the Schema Object supports keywords from any other vocabularies, or entirely arbitrary properties.

          +

          The OpenAPI Specification’s base vocabulary is comprised of the following keywords:

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
          xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
          externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
          exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.

          Deprecated: The example property has been deprecated in favor of the JSON Schema examples keyword. Use of example is discouraged, and later versions of this specification may remove it.
          +

          This object MAY be extended with Specification Extensions, though as noted, additional properties MAY omit the x- prefix within this object.

          +
          Composition and Inheritance (Polymorphism)
          +

          The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. +allOf takes an array of object definitions that are validated independently but together compose a single object.

          +

          While composition offers model extensibility, it does not imply a hierarchy between the models. +To support polymorphism, the OpenAPI Specification adds the discriminator field. +When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. +As such, the discriminator field MUST be a required field. +There are two ways to define the value of a discriminator for an inheriting instance.

          +
            +
          • Use the schema name.
          • +
          • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. +As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
          • +
          +
          XML Modeling
          +

          The xml property allows extra definitions when translating the JSON definition to XML. +The XML Object contains additional information about the available options.

          +
          Specifying Schema Dialects
          +

          It is important for tooling to be able to determine which dialect or meta-schema any given resource wishes to be processed with: JSON Schema Core, JSON Schema Validation, OpenAPI Schema dialect, or some custom meta-schema.

          +

          The $schema keyword MAY be present in any root Schema Object, and if present MUST be used to determine which dialect should be used when processing the schema. This allows use of Schema Objects which comply with other drafts of JSON Schema than the default Draft 2020-12 support. Tooling MUST support the OAS dialect schema id, and MAY support additional values of $schema.

          +

          To allow use of a different default $schema value for all Schema Objects contained within an OAS document, a jsonSchemaDialect value may be set within the OpenAPI Object. If this default is not set, then the OAS dialect schema id MUST be used for these Schema Objects. The value of $schema within a Schema Object always overrides any default.

          +

          When a Schema Object is referenced from an external resource which is not an OAS document (e.g. a bare JSON Schema resource), then the value of the $schema keyword for schemas within that resource MUST follow JSON Schema rules.

          +

          Schema Object Examples

          +
          Primitive Sample
          +
          
          +{
          +  "type": "string",
          +  "format": "email"
          +}
          +
          +
          
          +type: string
          +format: email
          +
          +
          Simple Model
          +
          
          +{
          +  "type": "object",
          +  "required": [
          +    "name"
          +  ],
          +  "properties": {
          +    "name": {
          +      "type": "string"
          +    },
          +    "address": {
          +      "$ref": "#/components/schemas/Address"
          +    },
          +    "age": {
          +      "type": "integer",
          +      "format": "int32",
          +      "minimum": 0
          +    }
          +  }
          +}
          +
          +
          
          +type: object
          +required:
          +- name
          +properties:
          +  name:
          +    type: string
          +  address:
          +    $ref: '#/components/schemas/Address'
          +  age:
          +    type: integer
          +    format: int32
          +    minimum: 0
          +
          +
          Model with Map/Dictionary Properties
          +

          For a simple string to string mapping:

          +
          
          +{
          +  "type": "object",
          +  "additionalProperties": {
          +    "type": "string"
          +  }
          +}
          +
          +
          
          +type: object
          +additionalProperties:
          +  type: string
          +
          +

          For a string to model mapping:

          +
          
          +{
          +  "type": "object",
          +  "additionalProperties": {
          +    "$ref": "#/components/schemas/ComplexModel"
          +  }
          +}
          +
          +
          
          +type: object
          +additionalProperties:
          +  $ref: '#/components/schemas/ComplexModel'
          +
          +
          Model with Example
          +
          
          +{
          +  "type": "object",
          +  "properties": {
          +    "id": {
          +      "type": "integer",
          +      "format": "int64"
          +    },
          +    "name": {
          +      "type": "string"
          +    }
          +  },
          +  "required": [
          +    "name"
          +  ],
          +  "example": {
          +    "name": "Puma",
          +    "id": 1
          +  }
          +}
          +
          +
          
          +type: object
          +properties:
          +  id:
          +    type: integer
          +    format: int64
          +  name:
          +    type: string
          +required:
          +- name
          +example:
          +  name: Puma
          +  id: 1
          +
          +
          Models with Composition
          +
          
          +{
          +  "components": {
          +    "schemas": {
          +      "ErrorModel": {
          +        "type": "object",
          +        "required": [
          +          "message",
          +          "code"
          +        ],
          +        "properties": {
          +          "message": {
          +            "type": "string"
          +          },
          +          "code": {
          +            "type": "integer",
          +            "minimum": 100,
          +            "maximum": 600
          +          }
          +        }
          +      },
          +      "ExtendedErrorModel": {
          +        "allOf": [
          +          {
          +            "$ref": "#/components/schemas/ErrorModel"
          +          },
          +          {
          +            "type": "object",
          +            "required": [
          +              "rootCause"
          +            ],
          +            "properties": {
          +              "rootCause": {
          +                "type": "string"
          +              }
          +            }
          +          }
          +        ]
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +components:
          +  schemas:
          +    ErrorModel:
          +      type: object
          +      required:
          +      - message
          +      - code
          +      properties:
          +        message:
          +          type: string
          +        code:
          +          type: integer
          +          minimum: 100
          +          maximum: 600
          +    ExtendedErrorModel:
          +      allOf:
          +      - $ref: '#/components/schemas/ErrorModel'
          +      - type: object
          +        required:
          +        - rootCause
          +        properties:
          +          rootCause:
          +            type: string
          +
          +
          Models with Polymorphism Support
          +
          
          +{
          +  "components": {
          +    "schemas": {
          +      "Pet": {
          +        "type": "object",
          +        "discriminator": {
          +          "propertyName": "petType"
          +        },
          +        "properties": {
          +          "name": {
          +            "type": "string"
          +          },
          +          "petType": {
          +            "type": "string"
          +          }
          +        },
          +        "required": [
          +          "name",
          +          "petType"
          +        ]
          +      },
          +      "Cat": {
          +        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
          +        "allOf": [
          +          {
          +            "$ref": "#/components/schemas/Pet"
          +          },
          +          {
          +            "type": "object",
          +            "properties": {
          +              "huntingSkill": {
          +                "type": "string",
          +                "description": "The measured skill for hunting",
          +                "default": "lazy",
          +                "enum": [
          +                  "clueless",
          +                  "lazy",
          +                  "adventurous",
          +                  "aggressive"
          +                ]
          +              }
          +            },
          +            "required": [
          +              "huntingSkill"
          +            ]
          +          }
          +        ]
          +      },
          +      "Dog": {
          +        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
          +        "allOf": [
          +          {
          +            "$ref": "#/components/schemas/Pet"
          +          },
          +          {
          +            "type": "object",
          +            "properties": {
          +              "packSize": {
          +                "type": "integer",
          +                "format": "int32",
          +                "description": "the size of the pack the dog is from",
          +                "default": 0,
          +                "minimum": 0
          +              }
          +            },
          +            "required": [
          +              "packSize"
          +            ]
          +          }
          +        ]
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +components:
          +  schemas:
          +    Pet:
          +      type: object
          +      discriminator:
          +        propertyName: petType
          +      properties:
          +        name:
          +          type: string
          +        petType:
          +          type: string
          +      required:
          +      - name
          +      - petType
          +    Cat:  ## "Cat" will be used as the discriminator value
          +      description: A representation of a cat
          +      allOf:
          +      - $ref: '#/components/schemas/Pet'
          +      - type: object
          +        properties:
          +          huntingSkill:
          +            type: string
          +            description: The measured skill for hunting
          +            enum:
          +            - clueless
          +            - lazy
          +            - adventurous
          +            - aggressive
          +        required:
          +        - huntingSkill
          +    Dog:  ## "Dog" will be used as the discriminator value
          +      description: A representation of a dog
          +      allOf:
          +      - $ref: '#/components/schemas/Pet'
          +      - type: object
          +        properties:
          +          packSize:
          +            type: integer
          +            format: int32
          +            description: the size of the pack the dog is from
          +            default: 0
          +            minimum: 0
          +        required:
          +        - packSize
          +
          +

          Discriminator Object

          +

          When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the document of an alternative schema based on the value associated with it.

          +

          When using the discriminator, inline schemas will not be considered.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
          mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
          +

          This object MAY be extended with Specification Extensions.

          +

          The discriminator object is legal only when using one of the composite keywords oneOf, anyOf, allOf.

          +

          In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

          +
          
          +MyResponseType:
          +  oneOf:
          +  - $ref: '#/components/schemas/Cat'
          +  - $ref: '#/components/schemas/Dog'
          +  - $ref: '#/components/schemas/Lizard'
          +
          +

          which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

          +
          
          +MyResponseType:
          +  oneOf:
          +  - $ref: '#/components/schemas/Cat'
          +  - $ref: '#/components/schemas/Dog'
          +  - $ref: '#/components/schemas/Lizard'
          +  discriminator:
          +    propertyName: petType
          +
          +

          The expectation now is that a property with name petType MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

          +
          
          +{
          +  "id": 12345,
          +  "petType": "Cat"
          +}
          +
          +

          Will indicate that the Cat schema be used in conjunction with this payload.

          +

          In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

          +
          
          +MyResponseType:
          +  oneOf:
          +  - $ref: '#/components/schemas/Cat'
          +  - $ref: '#/components/schemas/Dog'
          +  - $ref: '#/components/schemas/Lizard'
          +  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
          +  discriminator:
          +    propertyName: petType
          +    mapping:
          +      dog: '#/components/schemas/Dog'
          +      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
          +
          +

          Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

          +

          When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

          +

          In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

          +

          For example:

          +
          
          +components:
          +  schemas:
          +    Pet:
          +      type: object
          +      required:
          +      - petType
          +      properties:
          +        petType:
          +          type: string
          +      discriminator:
          +        propertyName: petType
          +        mapping:
          +          dog: Dog
          +    Cat:
          +      allOf:
          +      - $ref: '#/components/schemas/Pet'
          +      - type: object
          +        # all other properties specific to a `Cat`
          +        properties:
          +          name:
          +            type: string
          +    Dog:
          +      allOf:
          +      - $ref: '#/components/schemas/Pet'
          +      - type: object
          +        # all other properties specific to a `Dog`
          +        properties:
          +          bark:
          +            type: string
          +    Lizard:
          +      allOf:
          +      - $ref: '#/components/schemas/Pet'
          +      - type: object
          +        # all other properties specific to a `Lizard`
          +        properties:
          +          lovesRocks:
          +            type: boolean
          +
          +

          a payload like this:

          +
          
          +{
          +  "petType": "Cat",
          +  "name": "misty"
          +}
          +
          +

          will indicate that the Cat schema be used. Likewise this schema:

          +
          
          +{
          +  "petType": "dog",
          +  "bark": "soft"
          +}
          +
          +

          will map to Dog because of the definition in the mapping element.

          +

          XML Object

          +

          A metadata object that allows for more fine-tuned XML model definitions.

          +

          When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. +See examples for expected behavior.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
          namespacestringThe URI of the namespace definition. This MUST be in the form of an absolute URI.
          prefixstringThe prefix to be used for the name.
          attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
          wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
          +

          This object MAY be extended with Specification Extensions.

          +

          XML Object Examples

          +

          The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

          +
          No XML Element
          +

          Basic string property:

          +
          
          +{
          +    "animals": {
          +        "type": "string"
          +    }
          +}
          +
          +
          
          +animals:
          +  type: string
          +
          +
          
          +<animals>...</animals>
          +
          +

          Basic string array property (wrapped is false by default):

          +
          
          +{
          +    "animals": {
          +        "type": "array",
          +        "items": {
          +            "type": "string"
          +        }
          +    }
          +}
          +
          +
          
          +animals:
          +  type: array
          +  items:
          +    type: string
          +
          +
          
          +<animals>...</animals>
          +<animals>...</animals>
          +<animals>...</animals>
          +
          +
          XML Name Replacement
          +
          
          +{
          +  "animals": {
          +    "type": "string",
          +    "xml": {
          +      "name": "animal"
          +    }
          +  }
          +}
          +
          +
          
          +animals:
          +  type: string
          +  xml:
          +    name: animal
          +
          +
          
          +<animal>...</animal>
          +
          +
          XML Attribute, Prefix and Namespace
          +

          In this example, a full model definition is shown.

          +
          
          +{
          +  "Person": {
          +    "type": "object",
          +    "properties": {
          +      "id": {
          +        "type": "integer",
          +        "format": "int32",
          +        "xml": {
          +          "attribute": true
          +        }
          +      },
          +      "name": {
          +        "type": "string",
          +        "xml": {
          +          "namespace": "https://example.com/schema/sample",
          +          "prefix": "sample"
          +        }
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +Person:
          +  type: object
          +  properties:
          +    id:
          +      type: integer
          +      format: int32
          +      xml:
          +        attribute: true
          +    name:
          +      type: string
          +      xml:
          +        namespace: https://example.com/schema/sample
          +        prefix: sample
          +
          +
          
          +<Person id="123">
          +    <sample:name xmlns:sample="https://example.com/schema/sample">example</sample:name>
          +</Person>
          +
          +
          XML Arrays
          +

          Changing the element names:

          +
          
          +{
          +  "animals": {
          +    "type": "array",
          +    "items": {
          +      "type": "string",
          +      "xml": {
          +        "name": "animal"
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +animals:
          +  type: array
          +  items:
          +    type: string
          +    xml:
          +      name: animal
          +
          +
          
          +<animal>value</animal>
          +<animal>value</animal>
          +
          +

          The external name property has no effect on the XML:

          +
          
          +{
          +  "animals": {
          +    "type": "array",
          +    "items": {
          +      "type": "string",
          +      "xml": {
          +        "name": "animal"
          +      }
          +    },
          +    "xml": {
          +      "name": "aliens"
          +    }
          +  }
          +}
          +
          +
          
          +animals:
          +  type: array
          +  items:
          +    type: string
          +    xml:
          +      name: animal
          +  xml:
          +    name: aliens
          +
          +
          
          +<animal>value</animal>
          +<animal>value</animal>
          +
          +

          Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

          +
          
          +{
          +  "animals": {
          +    "type": "array",
          +    "items": {
          +      "type": "string"
          +    },
          +    "xml": {
          +      "wrapped": true
          +    }
          +  }
          +}
          +
          +
          
          +animals:
          +  type: array
          +  items:
          +    type: string
          +  xml:
          +    wrapped: true
          +
          +
          
          +<animals>
          +  <animals>value</animals>
          +  <animals>value</animals>
          +</animals>
          +
          +

          To overcome the naming problem in the example above, the following definition can be used:

          +
          
          +{
          +  "animals": {
          +    "type": "array",
          +    "items": {
          +      "type": "string",
          +      "xml": {
          +        "name": "animal"
          +      }
          +    },
          +    "xml": {
          +      "wrapped": true
          +    }
          +  }
          +}
          +
          +
          
          +animals:
          +  type: array
          +  items:
          +    type: string
          +    xml:
          +      name: animal
          +  xml:
          +    wrapped: true
          +
          +
          
          +<animals>
          +  <animal>value</animal>
          +  <animal>value</animal>
          +</animals>
          +
          +

          Affecting both internal and external names:

          +
          
          +{
          +  "animals": {
          +    "type": "array",
          +    "items": {
          +      "type": "string",
          +      "xml": {
          +        "name": "animal"
          +      }
          +    },
          +    "xml": {
          +      "name": "aliens",
          +      "wrapped": true
          +    }
          +  }
          +}
          +
          +
          
          +animals:
          +  type: array
          +  items:
          +    type: string
          +    xml:
          +      name: animal
          +  xml:
          +    name: aliens
          +    wrapped: true
          +
          +
          
          +<aliens>
          +  <animal>value</animal>
          +  <animal>value</animal>
          +</aliens>
          +
          +

          If we change the external element but not the internal ones:

          +
          
          +{
          +  "animals": {
          +    "type": "array",
          +    "items": {
          +      "type": "string"
          +    },
          +    "xml": {
          +      "name": "aliens",
          +      "wrapped": true
          +    }
          +  }
          +}
          +
          +
          
          +animals:
          +  type: array
          +  items:
          +    type: string
          +  xml:
          +    name: aliens
          +    wrapped: true
          +
          +
          
          +<aliens>
          +  <aliens>value</aliens>
          +  <aliens>value</aliens>
          +</aliens>
          +
          +

          Security Scheme Object

          +

          Defines a security scheme that can be used by the operations.

          +

          Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), mutual TLS (use of a client certificate), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and OpenID Connect Discovery. +Please note that as of 2020, the implicit flow is about to be deprecated by OAuth 2.0 Security Best Current Practice. Recommended for most use case is Authorization Code Grant flow with PKCE.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeApplies ToDescription
          typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "mutualTLS", "oauth2", "openIdConnect".
          descriptionstringAnyA description for security scheme. CommonMark syntax MAY be used for rich text representation.
          namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
          instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
          schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]]. The values used SHOULD be registered in the IANA Authentication Scheme registry.
          bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
          flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
          openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL. The OpenID Connect standard requires the use of TLS.
          +

          This object MAY be extended with Specification Extensions.

          +

          Security Scheme Object Example

          +
          Basic Authentication Sample
          +
          
          +{
          +  "type": "http",
          +  "scheme": "basic"
          +}
          +
          +
          
          +type: http
          +scheme: basic
          +
          +
          API Key Sample
          +
          
          +{
          +  "type": "apiKey",
          +  "name": "api_key",
          +  "in": "header"
          +}
          +
          +
          
          +type: apiKey
          +name: api_key
          +in: header
          +
          +
          JWT Bearer Sample
          +
          
          +{
          +  "type": "http",
          +  "scheme": "bearer",
          +  "bearerFormat": "JWT",
          +}
          +
          +
          
          +type: http
          +scheme: bearer
          +bearerFormat: JWT
          +
          +
          Implicit OAuth2 Sample
          +
          
          +{
          +  "type": "oauth2",
          +  "flows": {
          +    "implicit": {
          +      "authorizationUrl": "https://example.com/api/oauth/dialog",
          +      "scopes": {
          +        "write:pets": "modify pets in your account",
          +        "read:pets": "read your pets"
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +type: oauth2
          +flows: 
          +  implicit:
          +    authorizationUrl: https://example.com/api/oauth/dialog
          +    scopes:
          +      write:pets: modify pets in your account
          +      read:pets: read your pets
          +
          +

          OAuth Flows Object

          +

          Allows configuration of the supported OAuth Flows.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
          passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
          clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
          authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
          +

          This object MAY be extended with Specification Extensions.

          +

          OAuth Flow Object

          +

          Configuration details for a supported OAuth Flow

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeApplies ToDescription
          authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
          tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
          refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
          scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.
          +

          This object MAY be extended with Specification Extensions.

          +

          OAuth Flow Object Examples

          +
          
          +{
          +  "type": "oauth2",
          +  "flows": {
          +    "implicit": {
          +      "authorizationUrl": "https://example.com/api/oauth/dialog",
          +      "scopes": {
          +        "write:pets": "modify pets in your account",
          +        "read:pets": "read your pets"
          +      }
          +    },
          +    "authorizationCode": {
          +      "authorizationUrl": "https://example.com/api/oauth/dialog",
          +      "tokenUrl": "https://example.com/api/oauth/token",
          +      "scopes": {
          +        "write:pets": "modify pets in your account",
          +        "read:pets": "read your pets"
          +      }
          +    }
          +  }
          +}
          +
          +
          
          +type: oauth2
          +flows: 
          +  implicit:
          +    authorizationUrl: https://example.com/api/oauth/dialog
          +    scopes:
          +      write:pets: modify pets in your account
          +      read:pets: read your pets
          +  authorizationCode:
          +    authorizationUrl: https://example.com/api/oauth/dialog
          +    tokenUrl: https://example.com/api/oauth/token
          +    scopes:
          +      write:pets: modify pets in your account
          +      read:pets: read your pets 
          +
          +

          Security Requirement Object

          +

          Lists the required security schemes to execute this operation. +The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

          +

          Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. +This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

          +

          When a list of Security Requirement Objects is defined on the OpenAPI Object or Operation Object, only one of the Security Requirement Objects in the list needs to be satisfied to authorize the request.

          +

          Patterned Fields

          + + + + + + + + + + + + + + + +
          Field PatternTypeDescription
          {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution, and the list MAY be empty if authorization does not require a specified scope. For other security scheme types, the array MAY contain a list of role names which are required for the execution, but are not otherwise defined or exchanged in-band.
          +

          Security Requirement Object Examples

          +
          Non-OAuth2 Security Requirement
          +
          
          +{
          +  "api_key": []
          +}
          +
          +
          
          +api_key: []
          +
          +
          OAuth2 Security Requirement
          +
          
          +{
          +  "petstore_auth": [
          +    "write:pets",
          +    "read:pets"
          +  ]
          +}
          +
          +
          
          +petstore_auth:
          +- write:pets
          +- read:pets
          +
          +
          Optional OAuth2 Security
          +

          Optional OAuth2 security as would be defined in an OpenAPI Object or an Operation Object:

          +
          
          +{
          +  "security": [
          +    {},
          +    {
          +      "petstore_auth": [
          +        "write:pets",
          +        "read:pets"
          +      ]
          +    }
          +  ]
          +}
          +
          +
          
          +security:
          +  - {}
          +  - petstore_auth:
          +    - write:pets
          +    - read:pets
          +
          +

          Specification Extensions

          +

          While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          +

          The extensions properties are implemented as patterned fields that are always prefixed by "x-".

          + + + + + + + + + + + + + + + +
          Field PatternTypeDescription
          ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. Field names beginning x-oai- and x-oas- are reserved for uses defined by the OpenAPI Initiative. The value can be null, a primitive, an array or an object.
          +

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          +

          Security Filtering

          +

          Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

          +

          The reasoning is to allow an additional layer of access control over the documentation. +While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

          +

          Two examples of this:

          +
            +
          1. The Paths Object MAY be present but empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They would still have access to at least the Info Object which may contain additional information regarding authentication.
          2. +
          3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the Paths Object, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
          4. +
          +

          Appendix A: Revision History

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          VersionDateNotes
          3.1.02021-02-15Release of the OpenAPI Specification 3.1.0
          3.1.0-rc12020-10-08rc1 of the 3.1 specification
          3.1.0-rc02020-06-18rc0 of the 3.1 specification
          3.0.32020-02-20Patch release of the OpenAPI Specification 3.0.3
          3.0.22018-10-08Patch release of the OpenAPI Specification 3.0.2
          3.0.12017-12-06Patch release of the OpenAPI Specification 3.0.1
          3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
          3.0.0-rc22017-06-16rc2 of the 3.0 specification
          3.0.0-rc12017-04-27rc1 of the 3.0 specification
          3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
          2.02015-12-31Donation of Swagger 2.0 to the OpenAPI Initiative
          2.02014-09-08Release of Swagger 2.0
          1.22014-03-14Initial release of the formal document.
          1.12012-08-22Release of Swagger 1.1
          1.02011-08-10First release of the Swagger Specification
          + diff --git a/oas/v2.0.html b/oas/v2.0.html index d269a5da5c..cfb1c5c857 100644 --- a/oas/v2.0.html +++ b/oas/v2.0.html @@ -1,4 +1,4 @@ -OpenAPI Specification +OpenAPI Specification v2.0 | Introduction, Definitions, & More -
          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.
          +

          OpenAPI Specification v2.0

          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.

          OpenAPI Specification

          (fka Swagger RESTful API Documentation Specification)

          Version 2.0

          diff --git a/oas/v3.0.0.html b/oas/v3.0.0.html index 44d87ae2fc..e9098e3421 100644 --- a/oas/v3.0.0.html +++ b/oas/v3.0.0.html @@ -1,4 +1,4 @@ -OpenAPI Specification +OpenAPI Specification v3.0.0 | Introduction, Definitions, & More -
          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.
          +

          OpenAPI Specification v3.0.0

          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.

          OpenAPI Specification

          Version 3.0.0

          The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

          diff --git a/oas/v3.0.1.html b/oas/v3.0.1.html index 436ab8265d..8bfef16b4c 100644 --- a/oas/v3.0.1.html +++ b/oas/v3.0.1.html @@ -1,4 +1,4 @@ -OpenAPI Specification +OpenAPI Specification v3.0.1 | Introduction, Definitions, & More -
          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.
          +

          OpenAPI Specification v3.0.1

          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.

          OpenAPI Specification

          Version 3.0.1

          The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

          diff --git a/oas/v3.0.2.html b/oas/v3.0.2.html index bf51ee773e..7156024e05 100644 --- a/oas/v3.0.2.html +++ b/oas/v3.0.2.html @@ -1,4 +1,4 @@ -OpenAPI Specification +OpenAPI Specification v3.0.2 | Introduction, Definitions, & More -
          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.
          +

          OpenAPI Specification v3.0.2

          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.

          OpenAPI Specification

          Version 3.0.2

          The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

          diff --git a/oas/v3.0.3.html b/oas/v3.0.3.html index d0dcd3b79a..44040d185e 100644 --- a/oas/v3.0.3.html +++ b/oas/v3.0.3.html @@ -1,4 +1,4 @@ -OpenAPI Specification +OpenAPI Specification v3.0.3 | Introduction, Definitions, & More -
          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.
          +

          OpenAPI Specification v3.0.3

          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.

          OpenAPI Specification

          Version 3.0.3

          The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

          diff --git a/oas/v3.1.0.html b/oas/v3.1.0.html index 751f55370c..fca28102c4 100644 --- a/oas/v3.1.0.html +++ b/oas/v3.1.0.html @@ -1,4 +1,4 @@ -OpenAPI Specification +OpenAPI Specification v3.1.0 | Introduction, Definitions, & More -
          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.
          +

          OpenAPI Specification v3.1.0

          The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.

          OpenAPI Specification

          Version 3.1.0

          The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

          From bf1b16b7216c42ab7dcc26c89aab0263aaca241b Mon Sep 17 00:00:00 2001 From: Jason Desrosiers Date: Thu, 7 Oct 2021 09:15:53 -0700 Subject: [PATCH 018/152] Release 2021-09-28 schemas for v3.0 and v3.1 (#2732) --- oas/3.0/schema/2012-09-28 | 1662 ++++++++++++++++++++++++++++++++ oas/3.1/schema-base/2021-09-28 | 24 + oas/3.1/schema/2021-09-28 | 1351 ++++++++++++++++++++++++++ 3 files changed, 3037 insertions(+) create mode 100644 oas/3.0/schema/2012-09-28 create mode 100644 oas/3.1/schema-base/2021-09-28 create mode 100644 oas/3.1/schema/2021-09-28 diff --git a/oas/3.0/schema/2012-09-28 b/oas/3.0/schema/2012-09-28 new file mode 100644 index 0000000000..dadd2837eb --- /dev/null +++ b/oas/3.0/schema/2012-09-28 @@ -0,0 +1,1662 @@ +{ + "id": "https://spec.openapis.org/oas/3.0/schema/2021-09-28", + "$schema": "http://json-schema.org/draft-04/schema#", + "description": "Validation schema for OpenAPI Specification 3.0.X.", + "type": "object", + "required": [ + "openapi", + "info", + "paths" + ], + "properties": { + "openapi": { + "type": "string", + "pattern": "^3\\.0\\.\\d(-.+)?$" + }, + "info": { + "$ref": "#/definitions/Info" + }, + "externalDocs": { + "$ref": "#/definitions/ExternalDocumentation" + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/definitions/Server" + } + }, + "security": { + "type": "array", + "items": { + "$ref": "#/definitions/SecurityRequirement" + } + }, + "tags": { + "type": "array", + "items": { + "$ref": "#/definitions/Tag" + }, + "uniqueItems": true + }, + "paths": { + "$ref": "#/definitions/Paths" + }, + "components": { + "$ref": "#/definitions/Components" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false, + "definitions": { + "Reference": { + "type": "object", + "required": [ + "$ref" + ], + "patternProperties": { + "^\\$ref$": { + "type": "string", + "format": "uri-reference" + } + } + }, + "Info": { + "type": "object", + "required": [ + "title", + "version" + ], + "properties": { + "title": { + "type": "string" + }, + "description": { + "type": "string" + }, + "termsOfService": { + "type": "string", + "format": "uri-reference" + }, + "contact": { + "$ref": "#/definitions/Contact" + }, + "license": { + "$ref": "#/definitions/License" + }, + "version": { + "type": "string" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "Contact": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "url": { + "type": "string", + "format": "uri-reference" + }, + "email": { + "type": "string", + "format": "email" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "License": { + "type": "object", + "required": [ + "name" + ], + "properties": { + "name": { + "type": "string" + }, + "url": { + "type": "string", + "format": "uri-reference" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "Server": { + "type": "object", + "required": [ + "url" + ], + "properties": { + "url": { + "type": "string" + }, + "description": { + "type": "string" + }, + "variables": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/ServerVariable" + } + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "ServerVariable": { + "type": "object", + "required": [ + "default" + ], + "properties": { + "enum": { + "type": "array", + "items": { + "type": "string" + } + }, + "default": { + "type": "string" + }, + "description": { + "type": "string" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "Components": { + "type": "object", + "properties": { + "schemas": { + "type": "object", + "patternProperties": { + "^[a-zA-Z0-9\\.\\-_]+$": { + "oneOf": [ + { + "$ref": "#/definitions/Schema" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + } + }, + "responses": { + "type": "object", + "patternProperties": { + "^[a-zA-Z0-9\\.\\-_]+$": { + "oneOf": [ + { + "$ref": "#/definitions/Reference" + }, + { + "$ref": "#/definitions/Response" + } + ] + } + } + }, + "parameters": { + "type": "object", + "patternProperties": { + "^[a-zA-Z0-9\\.\\-_]+$": { + "oneOf": [ + { + "$ref": "#/definitions/Reference" + }, + { + "$ref": "#/definitions/Parameter" + } + ] + } + } + }, + "examples": { + "type": "object", + "patternProperties": { + "^[a-zA-Z0-9\\.\\-_]+$": { + "oneOf": [ + { + "$ref": "#/definitions/Reference" + }, + { + "$ref": "#/definitions/Example" + } + ] + } + } + }, + "requestBodies": { + "type": "object", + "patternProperties": { + "^[a-zA-Z0-9\\.\\-_]+$": { + "oneOf": [ + { + "$ref": "#/definitions/Reference" + }, + { + "$ref": "#/definitions/RequestBody" + } + ] + } + } + }, + "headers": { + "type": "object", + "patternProperties": { + "^[a-zA-Z0-9\\.\\-_]+$": { + "oneOf": [ + { + "$ref": "#/definitions/Reference" + }, + { + "$ref": "#/definitions/Header" + } + ] + } + } + }, + "securitySchemes": { + "type": "object", + "patternProperties": { + "^[a-zA-Z0-9\\.\\-_]+$": { + "oneOf": [ + { + "$ref": "#/definitions/Reference" + }, + { + "$ref": "#/definitions/SecurityScheme" + } + ] + } + } + }, + "links": { + "type": "object", + "patternProperties": { + "^[a-zA-Z0-9\\.\\-_]+$": { + "oneOf": [ + { + "$ref": "#/definitions/Reference" + }, + { + "$ref": "#/definitions/Link" + } + ] + } + } + }, + "callbacks": { + "type": "object", + "patternProperties": { + "^[a-zA-Z0-9\\.\\-_]+$": { + "oneOf": [ + { + "$ref": "#/definitions/Reference" + }, + { + "$ref": "#/definitions/Callback" + } + ] + } + } + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "Schema": { + "type": "object", + "properties": { + "title": { + "type": "string" + }, + "multipleOf": { + "type": "number", + "minimum": 0, + "exclusiveMinimum": true + }, + "maximum": { + "type": "number" + }, + "exclusiveMaximum": { + "type": "boolean", + "default": false + }, + "minimum": { + "type": "number" + }, + "exclusiveMinimum": { + "type": "boolean", + "default": false + }, + "maxLength": { + "type": "integer", + "minimum": 0 + }, + "minLength": { + "type": "integer", + "minimum": 0, + "default": 0 + }, + "pattern": { + "type": "string", + "format": "regex" + }, + "maxItems": { + "type": "integer", + "minimum": 0 + }, + "minItems": { + "type": "integer", + "minimum": 0, + "default": 0 + }, + "uniqueItems": { + "type": "boolean", + "default": false + }, + "maxProperties": { + "type": "integer", + "minimum": 0 + }, + "minProperties": { + "type": "integer", + "minimum": 0, + "default": 0 + }, + "required": { + "type": "array", + "items": { + "type": "string" + }, + "minItems": 1, + "uniqueItems": true + }, + "enum": { + "type": "array", + "items": { + }, + "minItems": 1, + "uniqueItems": false + }, + "type": { + "type": "string", + "enum": [ + "array", + "boolean", + "integer", + "number", + "object", + "string" + ] + }, + "not": { + "oneOf": [ + { + "$ref": "#/definitions/Schema" + }, + { + "$ref": "#/definitions/Reference" + } + ] + }, + "allOf": { + "type": "array", + "items": { + "oneOf": [ + { + "$ref": "#/definitions/Schema" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + }, + "oneOf": { + "type": "array", + "items": { + "oneOf": [ + { + "$ref": "#/definitions/Schema" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + }, + "anyOf": { + "type": "array", + "items": { + "oneOf": [ + { + "$ref": "#/definitions/Schema" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + }, + "items": { + "oneOf": [ + { + "$ref": "#/definitions/Schema" + }, + { + "$ref": "#/definitions/Reference" + } + ] + }, + "properties": { + "type": "object", + "additionalProperties": { + "oneOf": [ + { + "$ref": "#/definitions/Schema" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + }, + "additionalProperties": { + "oneOf": [ + { + "$ref": "#/definitions/Schema" + }, + { + "$ref": "#/definitions/Reference" + }, + { + "type": "boolean" + } + ], + "default": true + }, + "description": { + "type": "string" + }, + "format": { + "type": "string" + }, + "default": { + }, + "nullable": { + "type": "boolean", + "default": false + }, + "discriminator": { + "$ref": "#/definitions/Discriminator" + }, + "readOnly": { + "type": "boolean", + "default": false + }, + "writeOnly": { + "type": "boolean", + "default": false + }, + "example": { + }, + "externalDocs": { + "$ref": "#/definitions/ExternalDocumentation" + }, + "deprecated": { + "type": "boolean", + "default": false + }, + "xml": { + "$ref": "#/definitions/XML" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "Discriminator": { + "type": "object", + "required": [ + "propertyName" + ], + "properties": { + "propertyName": { + "type": "string" + }, + "mapping": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } + }, + "XML": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "namespace": { + "type": "string", + "format": "uri" + }, + "prefix": { + "type": "string" + }, + "attribute": { + "type": "boolean", + "default": false + }, + "wrapped": { + "type": "boolean", + "default": false + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "Response": { + "type": "object", + "required": [ + "description" + ], + "properties": { + "description": { + "type": "string" + }, + "headers": { + "type": "object", + "additionalProperties": { + "oneOf": [ + { + "$ref": "#/definitions/Header" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + }, + "content": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/MediaType" + } + }, + "links": { + "type": "object", + "additionalProperties": { + "oneOf": [ + { + "$ref": "#/definitions/Link" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "MediaType": { + "type": "object", + "properties": { + "schema": { + "oneOf": [ + { + "$ref": "#/definitions/Schema" + }, + { + "$ref": "#/definitions/Reference" + } + ] + }, + "example": { + }, + "examples": { + "type": "object", + "additionalProperties": { + "oneOf": [ + { + "$ref": "#/definitions/Example" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + }, + "encoding": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/Encoding" + } + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false, + "allOf": [ + { + "$ref": "#/definitions/ExampleXORExamples" + } + ] + }, + "Example": { + "type": "object", + "properties": { + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "value": { + }, + "externalValue": { + "type": "string", + "format": "uri-reference" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "Header": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "required": { + "type": "boolean", + "default": false + }, + "deprecated": { + "type": "boolean", + "default": false + }, + "allowEmptyValue": { + "type": "boolean", + "default": false + }, + "style": { + "type": "string", + "enum": [ + "simple" + ], + "default": "simple" + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "type": "boolean", + "default": false + }, + "schema": { + "oneOf": [ + { + "$ref": "#/definitions/Schema" + }, + { + "$ref": "#/definitions/Reference" + } + ] + }, + "content": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/MediaType" + }, + "minProperties": 1, + "maxProperties": 1 + }, + "example": { + }, + "examples": { + "type": "object", + "additionalProperties": { + "oneOf": [ + { + "$ref": "#/definitions/Example" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false, + "allOf": [ + { + "$ref": "#/definitions/ExampleXORExamples" + }, + { + "$ref": "#/definitions/SchemaXORContent" + } + ] + }, + "Paths": { + "type": "object", + "patternProperties": { + "^\\/": { + "$ref": "#/definitions/PathItem" + }, + "^x-": { + } + }, + "additionalProperties": false + }, + "PathItem": { + "type": "object", + "properties": { + "$ref": { + "type": "string" + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/definitions/Server" + } + }, + "parameters": { + "type": "array", + "items": { + "oneOf": [ + { + "$ref": "#/definitions/Parameter" + }, + { + "$ref": "#/definitions/Reference" + } + ] + }, + "uniqueItems": true + } + }, + "patternProperties": { + "^(get|put|post|delete|options|head|patch|trace)$": { + "$ref": "#/definitions/Operation" + }, + "^x-": { + } + }, + "additionalProperties": false + }, + "Operation": { + "type": "object", + "required": [ + "responses" + ], + "properties": { + "tags": { + "type": "array", + "items": { + "type": "string" + } + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/definitions/ExternalDocumentation" + }, + "operationId": { + "type": "string" + }, + "parameters": { + "type": "array", + "items": { + "oneOf": [ + { + "$ref": "#/definitions/Parameter" + }, + { + "$ref": "#/definitions/Reference" + } + ] + }, + "uniqueItems": true + }, + "requestBody": { + "oneOf": [ + { + "$ref": "#/definitions/RequestBody" + }, + { + "$ref": "#/definitions/Reference" + } + ] + }, + "responses": { + "$ref": "#/definitions/Responses" + }, + "callbacks": { + "type": "object", + "additionalProperties": { + "oneOf": [ + { + "$ref": "#/definitions/Callback" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + }, + "deprecated": { + "type": "boolean", + "default": false + }, + "security": { + "type": "array", + "items": { + "$ref": "#/definitions/SecurityRequirement" + } + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/definitions/Server" + } + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "Responses": { + "type": "object", + "properties": { + "default": { + "oneOf": [ + { + "$ref": "#/definitions/Response" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + }, + "patternProperties": { + "^[1-5](?:\\d{2}|XX)$": { + "oneOf": [ + { + "$ref": "#/definitions/Response" + }, + { + "$ref": "#/definitions/Reference" + } + ] + }, + "^x-": { + } + }, + "minProperties": 1, + "additionalProperties": false + }, + "SecurityRequirement": { + "type": "object", + "additionalProperties": { + "type": "array", + "items": { + "type": "string" + } + } + }, + "Tag": { + "type": "object", + "required": [ + "name" + ], + "properties": { + "name": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/definitions/ExternalDocumentation" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "ExternalDocumentation": { + "type": "object", + "required": [ + "url" + ], + "properties": { + "description": { + "type": "string" + }, + "url": { + "type": "string", + "format": "uri-reference" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "ExampleXORExamples": { + "description": "Example and examples are mutually exclusive", + "not": { + "required": [ + "example", + "examples" + ] + } + }, + "SchemaXORContent": { + "description": "Schema and content are mutually exclusive, at least one is required", + "not": { + "required": [ + "schema", + "content" + ] + }, + "oneOf": [ + { + "required": [ + "schema" + ] + }, + { + "required": [ + "content" + ], + "description": "Some properties are not allowed if content is present", + "allOf": [ + { + "not": { + "required": [ + "style" + ] + } + }, + { + "not": { + "required": [ + "explode" + ] + } + }, + { + "not": { + "required": [ + "allowReserved" + ] + } + }, + { + "not": { + "required": [ + "example" + ] + } + }, + { + "not": { + "required": [ + "examples" + ] + } + } + ] + } + ] + }, + "Parameter": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "in": { + "type": "string" + }, + "description": { + "type": "string" + }, + "required": { + "type": "boolean", + "default": false + }, + "deprecated": { + "type": "boolean", + "default": false + }, + "allowEmptyValue": { + "type": "boolean", + "default": false + }, + "style": { + "type": "string" + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "type": "boolean", + "default": false + }, + "schema": { + "oneOf": [ + { + "$ref": "#/definitions/Schema" + }, + { + "$ref": "#/definitions/Reference" + } + ] + }, + "content": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/MediaType" + }, + "minProperties": 1, + "maxProperties": 1 + }, + "example": { + }, + "examples": { + "type": "object", + "additionalProperties": { + "oneOf": [ + { + "$ref": "#/definitions/Example" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false, + "required": [ + "name", + "in" + ], + "allOf": [ + { + "$ref": "#/definitions/ExampleXORExamples" + }, + { + "$ref": "#/definitions/SchemaXORContent" + }, + { + "$ref": "#/definitions/ParameterLocation" + } + ] + }, + "ParameterLocation": { + "description": "Parameter location", + "oneOf": [ + { + "description": "Parameter in path", + "required": [ + "required" + ], + "properties": { + "in": { + "enum": [ + "path" + ] + }, + "style": { + "enum": [ + "matrix", + "label", + "simple" + ], + "default": "simple" + }, + "required": { + "enum": [ + true + ] + } + } + }, + { + "description": "Parameter in query", + "properties": { + "in": { + "enum": [ + "query" + ] + }, + "style": { + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ], + "default": "form" + } + } + }, + { + "description": "Parameter in header", + "properties": { + "in": { + "enum": [ + "header" + ] + }, + "style": { + "enum": [ + "simple" + ], + "default": "simple" + } + } + }, + { + "description": "Parameter in cookie", + "properties": { + "in": { + "enum": [ + "cookie" + ] + }, + "style": { + "enum": [ + "form" + ], + "default": "form" + } + } + } + ] + }, + "RequestBody": { + "type": "object", + "required": [ + "content" + ], + "properties": { + "description": { + "type": "string" + }, + "content": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/MediaType" + } + }, + "required": { + "type": "boolean", + "default": false + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "SecurityScheme": { + "oneOf": [ + { + "$ref": "#/definitions/APIKeySecurityScheme" + }, + { + "$ref": "#/definitions/HTTPSecurityScheme" + }, + { + "$ref": "#/definitions/OAuth2SecurityScheme" + }, + { + "$ref": "#/definitions/OpenIdConnectSecurityScheme" + } + ] + }, + "APIKeySecurityScheme": { + "type": "object", + "required": [ + "type", + "name", + "in" + ], + "properties": { + "type": { + "type": "string", + "enum": [ + "apiKey" + ] + }, + "name": { + "type": "string" + }, + "in": { + "type": "string", + "enum": [ + "header", + "query", + "cookie" + ] + }, + "description": { + "type": "string" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "HTTPSecurityScheme": { + "type": "object", + "required": [ + "scheme", + "type" + ], + "properties": { + "scheme": { + "type": "string" + }, + "bearerFormat": { + "type": "string" + }, + "description": { + "type": "string" + }, + "type": { + "type": "string", + "enum": [ + "http" + ] + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false, + "oneOf": [ + { + "description": "Bearer", + "properties": { + "scheme": { + "type": "string", + "pattern": "^[Bb][Ee][Aa][Rr][Ee][Rr]$" + } + } + }, + { + "description": "Non Bearer", + "not": { + "required": [ + "bearerFormat" + ] + }, + "properties": { + "scheme": { + "not": { + "type": "string", + "pattern": "^[Bb][Ee][Aa][Rr][Ee][Rr]$" + } + } + } + } + ] + }, + "OAuth2SecurityScheme": { + "type": "object", + "required": [ + "type", + "flows" + ], + "properties": { + "type": { + "type": "string", + "enum": [ + "oauth2" + ] + }, + "flows": { + "$ref": "#/definitions/OAuthFlows" + }, + "description": { + "type": "string" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "OpenIdConnectSecurityScheme": { + "type": "object", + "required": [ + "type", + "openIdConnectUrl" + ], + "properties": { + "type": { + "type": "string", + "enum": [ + "openIdConnect" + ] + }, + "openIdConnectUrl": { + "type": "string", + "format": "uri-reference" + }, + "description": { + "type": "string" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "OAuthFlows": { + "type": "object", + "properties": { + "implicit": { + "$ref": "#/definitions/ImplicitOAuthFlow" + }, + "password": { + "$ref": "#/definitions/PasswordOAuthFlow" + }, + "clientCredentials": { + "$ref": "#/definitions/ClientCredentialsFlow" + }, + "authorizationCode": { + "$ref": "#/definitions/AuthorizationCodeOAuthFlow" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "ImplicitOAuthFlow": { + "type": "object", + "required": [ + "authorizationUrl", + "scopes" + ], + "properties": { + "authorizationUrl": { + "type": "string", + "format": "uri-reference" + }, + "refreshUrl": { + "type": "string", + "format": "uri-reference" + }, + "scopes": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "PasswordOAuthFlow": { + "type": "object", + "required": [ + "tokenUrl", + "scopes" + ], + "properties": { + "tokenUrl": { + "type": "string", + "format": "uri-reference" + }, + "refreshUrl": { + "type": "string", + "format": "uri-reference" + }, + "scopes": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "ClientCredentialsFlow": { + "type": "object", + "required": [ + "tokenUrl", + "scopes" + ], + "properties": { + "tokenUrl": { + "type": "string", + "format": "uri-reference" + }, + "refreshUrl": { + "type": "string", + "format": "uri-reference" + }, + "scopes": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "AuthorizationCodeOAuthFlow": { + "type": "object", + "required": [ + "authorizationUrl", + "tokenUrl", + "scopes" + ], + "properties": { + "authorizationUrl": { + "type": "string", + "format": "uri-reference" + }, + "tokenUrl": { + "type": "string", + "format": "uri-reference" + }, + "refreshUrl": { + "type": "string", + "format": "uri-reference" + }, + "scopes": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false + }, + "Link": { + "type": "object", + "properties": { + "operationId": { + "type": "string" + }, + "operationRef": { + "type": "string", + "format": "uri-reference" + }, + "parameters": { + "type": "object", + "additionalProperties": { + } + }, + "requestBody": { + }, + "description": { + "type": "string" + }, + "server": { + "$ref": "#/definitions/Server" + } + }, + "patternProperties": { + "^x-": { + } + }, + "additionalProperties": false, + "not": { + "description": "Operation Id and Operation Ref are mutually exclusive", + "required": [ + "operationId", + "operationRef" + ] + } + }, + "Callback": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/PathItem" + }, + "patternProperties": { + "^x-": { + } + } + }, + "Encoding": { + "type": "object", + "properties": { + "contentType": { + "type": "string" + }, + "headers": { + "type": "object", + "additionalProperties": { + "oneOf": [ + { + "$ref": "#/definitions/Header" + }, + { + "$ref": "#/definitions/Reference" + } + ] + } + }, + "style": { + "type": "string", + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ] + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "type": "boolean", + "default": false + } + }, + "additionalProperties": false + } + } +} diff --git a/oas/3.1/schema-base/2021-09-28 b/oas/3.1/schema-base/2021-09-28 new file mode 100644 index 0000000000..f75bf16c50 --- /dev/null +++ b/oas/3.1/schema-base/2021-09-28 @@ -0,0 +1,24 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/schema-base/2021-09-28", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$ref": "https://spec.openapis.org/oas/3.1/schema/2021-09-28", + "properties": { + "jsonSchemaDialect": { + "$ref": "#/$defs/dialect" + } + }, + "$defs": { + "dialect": { + "const": "https://spec.openapis.org/oas/3.1/dialect/base" + }, + "schema": { + "$dynamicAnchor": "meta", + "$ref": "https://spec.openapis.org/oas/3.1/dialect/base", + "properties": { + "$schema": { + "$ref": "#/$defs/dialect" + } + } + } + } +} diff --git a/oas/3.1/schema/2021-09-28 b/oas/3.1/schema/2021-09-28 new file mode 100644 index 0000000000..4ea4da67b5 --- /dev/null +++ b/oas/3.1/schema/2021-09-28 @@ -0,0 +1,1351 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/schema/2021-09-28", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "type": "object", + "properties": { + "openapi": { + "type": "string", + "pattern": "^3\\.1\\.\\d+(-.+)?$" + }, + "info": { + "$ref": "#/$defs/info" + }, + "jsonSchemaDialect": { + "type": "string", + "format": "uri", + "default": "https://spec.openapis.org/oas/3.1/dialect/base" + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + }, + "paths": { + "$ref": "#/$defs/paths" + }, + "webhooks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + }, + "components": { + "$ref": "#/$defs/components" + }, + "security": { + "type": "array", + "items": { + "$ref": "#/$defs/security-requirement" + } + }, + "tags": { + "type": "array", + "items": { + "$ref": "#/$defs/tag" + } + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + } + }, + "required": [ + "openapi", + "info" + ], + "anyOf": [ + { + "required": [ + "paths" + ] + }, + { + "required": [ + "components" + ] + }, + { + "required": [ + "webhooks" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false, + "$defs": { + "info": { + "type": "object", + "properties": { + "title": { + "type": "string" + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "termsOfService": { + "type": "string" + }, + "contact": { + "$ref": "#/$defs/contact" + }, + "license": { + "$ref": "#/$defs/license" + }, + "version": { + "type": "string" + } + }, + "required": [ + "title", + "version" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "contact": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "url": { + "type": "string" + }, + "email": { + "type": "string" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "license": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "identifier": { + "type": "string" + }, + "url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "name" + ], + "oneOf": [ + { + "required": [ + "identifier" + ] + }, + { + "required": [ + "url" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "server": { + "type": "object", + "properties": { + "url": { + "type": "string", + "format": "uri-reference" + }, + "description": { + "type": "string" + }, + "variables": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/server-variable" + } + } + }, + "required": [ + "url" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "server-variable": { + "type": "object", + "properties": { + "enum": { + "type": "array", + "items": { + "type": "string" + }, + "minItems": 1 + }, + "default": { + "type": "string" + }, + "descriptions": { + "type": "string" + } + }, + "required": [ + "default" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "components": { + "type": "object", + "properties": { + "schemas": { + "type": "object", + "additionalProperties": { + "$dynamicRef": "#meta" + } + }, + "responses": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/response-or-reference" + } + }, + "parameters": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/parameter-or-reference" + } + }, + "examples": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/example-or-reference" + } + }, + "requestBodies": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/request-body-or-reference" + } + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "securitySchemes": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/security-scheme-or-reference" + } + }, + "links": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/link-or-reference" + } + }, + "callbacks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/callbacks-or-reference" + } + }, + "pathItems": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + } + }, + "patternProperties": { + "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": { + "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected", + "propertyNames": { + "pattern": "^[a-zA-Z0-9._-]+$" + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "paths": { + "type": "object", + "patternProperties": { + "^/": { + "$ref": "#/$defs/path-item" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "path-item": { + "type": "object", + "properties": { + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + }, + "parameters": { + "type": "array", + "items": { + "$ref": "#/$defs/parameter-or-reference" + } + } + }, + "patternProperties": { + "^(get|put|post|delete|options|head|patch|trace)$": { + "$ref": "#/$defs/operation" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "path-item-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/path-item" + } + }, + "operation": { + "type": "object", + "properties": { + "tags": { + "type": "array", + "items": { + "type": "string" + } + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + }, + "operationId": { + "type": "string" + }, + "parameters": { + "type": "array", + "items": { + "$ref": "#/$defs/parameter-or-reference" + } + }, + "requestBody": { + "$ref": "#/$defs/request-body-or-reference" + }, + "responses": { + "$ref": "#/$defs/responses" + }, + "callbacks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/callbacks-or-reference" + } + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "security": { + "type": "array", + "items": { + "$ref": "#/$defs/security-requirement" + } + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "external-documentation": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "url" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "parameter": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "in": { + "enum": [ + "query", + "header", + "path", + "cookie" + ] + }, + "description": { + "type": "string" + }, + "required": { + "default": false, + "type": "boolean" + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "allowEmptyValue": { + "default": false, + "type": "boolean" + }, + "schema": { + "$dynamicRef": "#meta" + }, + "content": { + "$ref": "#/$defs/content" + } + }, + "required": [ + "in" + ], + "oneOf": [ + { + "required": [ + "schema" + ] + }, + { + "required": [ + "content" + ] + } + ], + "dependentSchemas": { + "schema": { + "properties": { + "style": { + "type": "string" + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + } + }, + "allOf": [ + { + "$ref": "#/$defs/examples" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form" + } + ], + "$defs": { + "styles-for-path": { + "if": { + "properties": { + "in": { + "const": "path" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "name": { + "pattern": "[^/#?]+$" + }, + "style": { + "default": "simple", + "enum": [ + "matrix", + "label", + "simple" + ] + }, + "required": { + "const": true + } + }, + "required": [ + "required" + ] + } + }, + "styles-for-header": { + "if": { + "properties": { + "in": { + "const": "header" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "simple", + "const": "simple" + } + } + } + }, + "styles-for-query": { + "if": { + "properties": { + "in": { + "const": "query" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "form", + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ] + } + } + } + }, + "styles-for-cookie": { + "if": { + "properties": { + "in": { + "const": "cookie" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "form", + "const": "form" + } + } + } + }, + "styles-for-form": { + "if": { + "properties": { + "style": { + "const": "form" + } + }, + "required": [ + "style" + ] + }, + "then": { + "properties": { + "explode": { + "default": true + } + } + }, + "else": { + "properties": { + "explode": { + "default": false + } + } + } + } + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "parameter-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/parameter" + } + }, + "request-body": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "content": { + "$ref": "#/$defs/content" + }, + "required": { + "default": false, + "type": "boolean" + } + }, + "required": [ + "content" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "request-body-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/request-body" + } + }, + "content": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/media-type" + }, + "propertyNames": { + "format": "media-range" + } + }, + "media-type": { + "type": "object", + "properties": { + "schema": { + "$dynamicRef": "#meta" + }, + "encoding": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/encoding" + } + } + }, + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/examples" + } + ], + "unevaluatedProperties": false + }, + "encoding": { + "type": "object", + "properties": { + "contentType": { + "type": "string", + "format": "media-range" + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "style": { + "default": "form", + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ] + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + } + }, + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/encoding/$defs/explode-default" + } + ], + "unevaluatedProperties": false, + "$defs": { + "explode-default": { + "if": { + "properties": { + "style": { + "const": "form" + } + }, + "required": [ + "style" + ] + }, + "then": { + "properties": { + "explode": { + "default": true + } + } + }, + "else": { + "properties": { + "explode": { + "default": false + } + } + } + } + } + }, + "responses": { + "type": "object", + "properties": { + "default": { + "$ref": "#/$defs/response-or-reference" + } + }, + "patternProperties": { + "^[1-5](?:[0-9]{2}|XX)$": { + "$ref": "#/$defs/response-or-reference" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "response": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "content": { + "$ref": "#/$defs/content" + }, + "links": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/link-or-reference" + } + } + }, + "required": [ + "description" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "response-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/response" + } + }, + "callbacks": { + "type": "object", + "$ref": "#/$defs/specification-extensions", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + }, + "callbacks-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/callbacks" + } + }, + "example": { + "type": "object", + "properties": { + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "value": true, + "externalValue": { + "type": "string", + "format": "uri" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "example-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/example" + } + }, + "link": { + "type": "object", + "properties": { + "operationRef": { + "type": "string", + "format": "uri-reference" + }, + "operationId": true, + "parameters": { + "$ref": "#/$defs/map-of-strings" + }, + "requestBody": true, + "description": { + "type": "string" + }, + "body": { + "$ref": "#/$defs/server" + } + }, + "oneOf": [ + { + "required": [ + "operationRef" + ] + }, + { + "required": [ + "operationId" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "link-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/link" + } + }, + "header": { + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "required": { + "default": false, + "type": "boolean" + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "schema": { + "$dynamicRef": "#meta" + }, + "content": { + "$ref": "#/$defs/content" + } + }, + "oneOf": [ + { + "required": [ + "schema" + ] + }, + { + "required": [ + "content" + ] + } + ], + "dependentSchemas": { + "schema": { + "properties": { + "style": { + "default": "simple", + "const": "simple" + }, + "explode": { + "default": false, + "type": "boolean" + } + }, + "$ref": "#/$defs/examples" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "header-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/header" + } + }, + "tag": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + } + }, + "required": [ + "name" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "reference": { + "type": "object", + "properties": { + "$ref": { + "type": "string", + "format": "uri-reference" + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + } + }, + "unevaluatedProperties": false + }, + "schema": { + "$dynamicAnchor": "meta", + "type": [ + "object", + "boolean" + ] + }, + "security-scheme": { + "type": "object", + "properties": { + "type": { + "enum": [ + "apiKey", + "http", + "mutualTLS", + "oauth2", + "openIdConnect" + ] + }, + "description": { + "type": "string" + } + }, + "required": [ + "type" + ], + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-apikey" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-http" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-http-bearer" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-oauth2" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-oidc" + } + ], + "unevaluatedProperties": false, + "$defs": { + "type-apikey": { + "if": { + "properties": { + "type": { + "const": "apiKey" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "name": { + "type": "string" + }, + "in": { + "enum": [ + "query", + "header", + "cookie" + ] + } + }, + "required": [ + "name", + "in" + ] + } + }, + "type-http": { + "if": { + "properties": { + "type": { + "const": "http" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "scheme": { + "type": "string" + } + }, + "required": [ + "scheme" + ] + } + }, + "type-http-bearer": { + "if": { + "properties": { + "type": { + "const": "http" + }, + "scheme": { + "type": "string", + "pattern": "^[Bb][Ee][Aa][Rr][Ee][Rr]$" + } + }, + "required": [ + "type", + "scheme" + ] + }, + "then": { + "properties": { + "bearerFormat": { + "type": "string" + } + } + } + }, + "type-oauth2": { + "if": { + "properties": { + "type": { + "const": "oauth2" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "flows": { + "$ref": "#/$defs/oauth-flows" + } + }, + "required": [ + "flows" + ] + } + }, + "type-oidc": { + "if": { + "properties": { + "type": { + "const": "openIdConnect" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "openIdConnectUrl": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "openIdConnectUrl" + ] + } + } + } + }, + "security-scheme-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/security-scheme" + } + }, + "oauth-flows": { + "type": "object", + "properties": { + "implicit": { + "$ref": "#/$defs/oauth-flows/$defs/implicit" + }, + "password": { + "$ref": "#/$defs/oauth-flows/$defs/password" + }, + "clientCredentials": { + "$ref": "#/$defs/oauth-flows/$defs/client-credentials" + }, + "authorizationCode": { + "$ref": "#/$defs/oauth-flows/$defs/authorization-code" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false, + "$defs": { + "implicit": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "authorizationUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "password": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "client-credentials": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "authorization-code": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string" + }, + "tokenUrl": { + "type": "string" + }, + "refreshUrl": { + "type": "string" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "authorizationUrl", + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + } + } + }, + "security-requirement": { + "type": "object", + "additionalProperties": { + "type": "array", + "items": { + "type": "string" + } + } + }, + "specification-extensions": { + "patternProperties": { + "^x-": true + } + }, + "examples": { + "properties": { + "example": true, + "examples": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/example-or-reference" + } + } + } + }, + "map-of-strings": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } +} From 88b7cb05d1554891a7f5f000b0b501c7147b7a74 Mon Sep 17 00:00:00 2001 From: Jason Desrosiers Date: Thu, 7 Oct 2021 10:13:39 -0700 Subject: [PATCH 019/152] Fix typo in URL for 3.0 schema release (#2741) --- oas/3.0/schema/{2012-09-28 => 2021-09-28} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename oas/3.0/schema/{2012-09-28 => 2021-09-28} (100%) diff --git a/oas/3.0/schema/2012-09-28 b/oas/3.0/schema/2021-09-28 similarity index 100% rename from oas/3.0/schema/2012-09-28 rename to oas/3.0/schema/2021-09-28 From 18717adbff3148874e87aaa4606c8836624c4b1f Mon Sep 17 00:00:00 2001 From: Jason Desrosiers Date: Thu, 11 Nov 2021 09:15:05 -0800 Subject: [PATCH 020/152] Add "latest" URLs for downloading meta schemas (#2747) --- oas/3.0/schema/latest | 1 + oas/3.1/schema-base/latest | 1 + oas/3.1/schema/latest | 1 + 3 files changed, 3 insertions(+) create mode 120000 oas/3.0/schema/latest create mode 120000 oas/3.1/schema-base/latest create mode 120000 oas/3.1/schema/latest diff --git a/oas/3.0/schema/latest b/oas/3.0/schema/latest new file mode 120000 index 0000000000..0f359a9358 --- /dev/null +++ b/oas/3.0/schema/latest @@ -0,0 +1 @@ +2012-09-28 \ No newline at end of file diff --git a/oas/3.1/schema-base/latest b/oas/3.1/schema-base/latest new file mode 120000 index 0000000000..50eb6cd6bc --- /dev/null +++ b/oas/3.1/schema-base/latest @@ -0,0 +1 @@ +2021-09-28 \ No newline at end of file diff --git a/oas/3.1/schema/latest b/oas/3.1/schema/latest new file mode 120000 index 0000000000..50eb6cd6bc --- /dev/null +++ b/oas/3.1/schema/latest @@ -0,0 +1 @@ +2021-09-28 \ No newline at end of file From 54da8c53b454851e67b7616d726985e4398d6a8c Mon Sep 17 00:00:00 2001 From: Jason Desrosiers Date: Thu, 2 Dec 2021 08:41:56 -0800 Subject: [PATCH 021/152] Fix "latest" symlink for 3.0 schema (#2810) --- oas/3.0/schema/latest | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/oas/3.0/schema/latest b/oas/3.0/schema/latest index 0f359a9358..50eb6cd6bc 120000 --- a/oas/3.0/schema/latest +++ b/oas/3.0/schema/latest @@ -1 +1 @@ -2012-09-28 \ No newline at end of file +2021-09-28 \ No newline at end of file From 68ed2e43865e144fc0969b413b52590fb1cdd29b Mon Sep 17 00:00:00 2001 From: Darrel Date: Thu, 3 Feb 2022 12:42:30 -0500 Subject: [PATCH 022/152] Added formats to the registry as defined by OpenAPI v3 (#2857) * Added formats to the registry as defined by OpenAPI v3 * Fixed date-time format * Removed boolean as format is not needed --- registries/_format/binary.md | 21 +++++++++++++++++++++ registries/_format/byte.md | 21 +++++++++++++++++++++ registries/_format/date-time.md | 21 +++++++++++++++++++++ registries/_format/date.md | 21 +++++++++++++++++++++ registries/_format/double.md | 21 +++++++++++++++++++++ registries/_format/float.md | 21 +++++++++++++++++++++ registries/_format/int32.md | 21 +++++++++++++++++++++ registries/_format/int64.md | 21 +++++++++++++++++++++ 8 files changed, 168 insertions(+) create mode 100644 registries/_format/binary.md create mode 100644 registries/_format/byte.md create mode 100644 registries/_format/date-time.md create mode 100644 registries/_format/date.md create mode 100644 registries/_format/double.md create mode 100644 registries/_format/float.md create mode 100644 registries/_format/int32.md create mode 100644 registries/_format/int64.md diff --git a/registries/_format/binary.md b/registries/_format/binary.md new file mode 100644 index 0000000000..85508c2c0f --- /dev/null +++ b/registries/_format/binary.md @@ -0,0 +1,21 @@ +--- +owner: DarrelMiller +issue: +description: any sequence of octets +base_type: string +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents any sequece of octets. This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_format/byte.md b/registries/_format/byte.md new file mode 100644 index 0000000000..69533e5327 --- /dev/null +++ b/registries/_format/byte.md @@ -0,0 +1,21 @@ +--- +owner: DarrelMiller +issue: +description: base64 encoded characters +base_type: string +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents any sequece of octets encoded as a base64 string. This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_format/date-time.md b/registries/_format/date-time.md new file mode 100644 index 0000000000..497271b24e --- /dev/null +++ b/registries/_format/date-time.md @@ -0,0 +1,21 @@ +--- +owner: DarrelMiller +issue: +description: date and time as defined by date-time - RFC3339 +base_type: string +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a date and time as defined by date-time - [RFC3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339#anchor14one). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_format/date.md b/registries/_format/date.md new file mode 100644 index 0000000000..a1d7345d3b --- /dev/null +++ b/registries/_format/date.md @@ -0,0 +1,21 @@ +--- +owner: DarrelMiller +issue: +description: date as defined by full-date - RFC3339 +base_type: string +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a date as defined by full-date - [RFC3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339#anchor14one). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_format/double.md b/registries/_format/double.md new file mode 100644 index 0000000000..417af4c715 --- /dev/null +++ b/registries/_format/double.md @@ -0,0 +1,21 @@ +--- +owner: DarrelMiller +issue: +description: double precision floating point number +base_type: number +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a double precision (64bit) floating point number as defined by [IEEE Std 754-2019](https://ieeexplore.ieee.org/document/8766229). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_format/float.md b/registries/_format/float.md new file mode 100644 index 0000000000..cbe24fdc7b --- /dev/null +++ b/registries/_format/float.md @@ -0,0 +1,21 @@ +--- +owner: DarrelMiller +issue: +description: single precision floating point number +base_type: number +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a single precision (32bit) floating point number as defined by [IEEE Std 754-2019](https://ieeexplore.ieee.org/document/8766229). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_format/int32.md b/registries/_format/int32.md new file mode 100644 index 0000000000..a22ed98821 --- /dev/null +++ b/registries/_format/int32.md @@ -0,0 +1,21 @@ +--- +owner: DarrelMiller +issue: +description: signed 32-bit integer +base_type: number +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a signed 32-bit integer, with the range −2,147,483,648 through 2,147,483,647. This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} diff --git a/registries/_format/int64.md b/registries/_format/int64.md new file mode 100644 index 0000000000..0fd3ebf1fa --- /dev/null +++ b/registries/_format/int64.md @@ -0,0 +1,21 @@ +--- +owner: DarrelMiller +issue: +description: signed 64-bit integer +base_type: number +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a signed 64-bit integer, with the range -9223372036854775808 through 9223372036854775807. This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} From 2ac4417fe321dfa124a7aa707b445730fa14b9ee Mon Sep 17 00:00:00 2001 From: Jason Desrosiers Date: Thu, 10 Mar 2022 09:25:59 -0800 Subject: [PATCH 023/152] Add version 2022-02-27 of v3.1 schemas (#2889) --- oas/3.0/schema/2021-09-28 | 2 +- oas/3.1/dialect/base | 6 +- oas/3.1/meta/base | 10 +- oas/3.1/schema-base/2022-02-27 | 23 + oas/3.1/schema-base/latest | 2 +- oas/3.1/schema/2022-02-27 | 1420 ++++++++++++++++++++++++++++++++ oas/3.1/schema/latest | 2 +- 7 files changed, 1460 insertions(+), 5 deletions(-) create mode 100644 oas/3.1/schema-base/2022-02-27 create mode 100644 oas/3.1/schema/2022-02-27 diff --git a/oas/3.0/schema/2021-09-28 b/oas/3.0/schema/2021-09-28 index dadd2837eb..4360553fe5 100644 --- a/oas/3.0/schema/2021-09-28 +++ b/oas/3.0/schema/2021-09-28 @@ -1,7 +1,7 @@ { "id": "https://spec.openapis.org/oas/3.0/schema/2021-09-28", "$schema": "http://json-schema.org/draft-04/schema#", - "description": "Validation schema for OpenAPI Specification 3.0.X.", + "description": "The description of OpenAPI v3.0.x documents, as defined by https://spec.openapis.org/oas/v3.0.3", "type": "object", "required": [ "openapi", diff --git a/oas/3.1/dialect/base b/oas/3.1/dialect/base index d54b0d4d7c..eae8386e8a 100644 --- a/oas/3.1/dialect/base +++ b/oas/3.1/dialect/base @@ -1,6 +1,10 @@ { "$id": "https://spec.openapis.org/oas/3.1/dialect/base", "$schema": "https://json-schema.org/draft/2020-12/schema", + + "title": "OpenAPI 3.1 Schema Object Dialect", + "description": "A JSON Schema dialect describing schemas found in OpenAPI documents", + "$vocabulary": { "https://json-schema.org/draft/2020-12/vocab/core": true, "https://json-schema.org/draft/2020-12/vocab/applicator": true, @@ -11,9 +15,9 @@ "https://json-schema.org/draft/2020-12/vocab/content": true, "https://spec.openapis.org/oas/3.1/vocab/base": false }, + "$dynamicAnchor": "meta", - "title": "OpenAPI 3.1 Schema Object Dialect", "allOf": [ { "$ref": "https://json-schema.org/draft/2020-12/schema" }, { "$ref": "https://spec.openapis.org/oas/3.1/meta/base" } diff --git a/oas/3.1/meta/base b/oas/3.1/meta/base index f3ee03fb96..a7a59f1c7d 100644 --- a/oas/3.1/meta/base +++ b/oas/3.1/meta/base @@ -1,11 +1,15 @@ { "$id": "https://spec.openapis.org/oas/3.1/meta/base", "$schema": "https://json-schema.org/draft/2020-12/schema", + + "title": "OAS Base vocabulary", + "description": "A JSON Schema Vocabulary used in the OpenAPI Schema Dialect", + "$vocabulary": { "https://spec.openapis.org/oas/3.1/vocab/base": true }, + "$dynamicAnchor": "meta", - "title": "OAS Base vocabulary", "type": ["object", "boolean"], "properties": { @@ -14,12 +18,14 @@ "externalDocs": { "$ref": "#/$defs/external-docs" }, "xml": { "$ref": "#/$defs/xml" } }, + "$defs": { "extensible": { "patternProperties": { "^x-": true } }, + "discriminator": { "$ref": "#/$defs/extensible", "type": "object", @@ -37,6 +43,7 @@ "required": ["propertyName"], "unevaluatedProperties": false }, + "external-docs": { "$ref": "#/$defs/extensible", "type": "object", @@ -52,6 +59,7 @@ "required": ["url"], "unevaluatedProperties": false }, + "xml": { "$ref": "#/$defs/extensible", "type": "object", diff --git a/oas/3.1/schema-base/2022-02-27 b/oas/3.1/schema-base/2022-02-27 new file mode 100644 index 0000000000..04c9f60206 --- /dev/null +++ b/oas/3.1/schema-base/2022-02-27 @@ -0,0 +1,23 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/schema-base/2022-02-27", + "$schema": "https://json-schema.org/draft/2020-12/schema", + + "description": "The description of OpenAPI v3.1.x documents using the OpenAPI JSON Schema dialect, as defined by https://spec.openapis.org/oas/v3.1.0", + + "$ref": "https://spec.openapis.org/oas/3.1/schema/2022-02-27", + "properties": { + "jsonSchemaDialect": { "$ref": "#/$defs/dialect" } + }, + + "$defs": { + "dialect": { "const": "https://spec.openapis.org/oas/3.1/dialect/base" }, + + "schema": { + "$dynamicAnchor": "meta", + "$ref": "https://spec.openapis.org/oas/3.1/dialect/base", + "properties": { + "$schema": { "$ref": "#/$defs/dialect" } + } + } + } +} diff --git a/oas/3.1/schema-base/latest b/oas/3.1/schema-base/latest index 50eb6cd6bc..2a70283d03 120000 --- a/oas/3.1/schema-base/latest +++ b/oas/3.1/schema-base/latest @@ -1 +1 @@ -2021-09-28 \ No newline at end of file +2022-02-27 \ No newline at end of file diff --git a/oas/3.1/schema/2022-02-27 b/oas/3.1/schema/2022-02-27 new file mode 100644 index 0000000000..ed0fd49a65 --- /dev/null +++ b/oas/3.1/schema/2022-02-27 @@ -0,0 +1,1420 @@ +{ + "$id": "https://spec.openapis.org/oas/3.1/schema/2022-02-27", + "$schema": "https://json-schema.org/draft/2020-12/schema", + "description": "The description of OpenAPI v3.1.x documents without schema validation, as defined by https://spec.openapis.org/oas/v3.1.0", + "type": "object", + "properties": { + "openapi": { + "type": "string", + "pattern": "^3\\.1\\.\\d+(-.+)?$" + }, + "info": { + "$ref": "#/$defs/info" + }, + "jsonSchemaDialect": { + "type": "string", + "format": "uri", + "default": "https://spec.openapis.org/oas/3.1/dialect/base" + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + }, + "default": [ + { "url": "/" } + ] + }, + "paths": { + "$ref": "#/$defs/paths" + }, + "webhooks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + }, + "components": { + "$ref": "#/$defs/components" + }, + "security": { + "type": "array", + "items": { + "$ref": "#/$defs/security-requirement" + } + }, + "tags": { + "type": "array", + "items": { + "$ref": "#/$defs/tag" + } + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + } + }, + "required": [ + "openapi", + "info" + ], + "anyOf": [ + { + "required": [ + "paths" + ] + }, + { + "required": [ + "components" + ] + }, + { + "required": [ + "webhooks" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false, + "$defs": { + "info": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#info-object", + "type": "object", + "properties": { + "title": { + "type": "string" + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "termsOfService": { + "type": "string", + "format": "uri" + }, + "contact": { + "$ref": "#/$defs/contact" + }, + "license": { + "$ref": "#/$defs/license" + }, + "version": { + "type": "string" + } + }, + "required": [ + "title", + "version" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "contact": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#contact-object", + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "url": { + "type": "string", + "format": "uri" + }, + "email": { + "type": "string", + "format": "email" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "license": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#license-object", + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "identifier": { + "type": "string" + }, + "url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "name" + ], + "oneOf": [ + { + "required": [ + "identifier" + ] + }, + { + "required": [ + "url" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "server": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#server-object", + "type": "object", + "properties": { + "url": { + "type": "string", + "format": "uri-reference" + }, + "description": { + "type": "string" + }, + "variables": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/server-variable" + } + } + }, + "required": [ + "url" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "server-variable": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#server-variable-object", + "type": "object", + "properties": { + "enum": { + "type": "array", + "items": { + "type": "string" + }, + "minItems": 1 + }, + "default": { + "type": "string" + }, + "description": { + "type": "string" + } + }, + "required": [ + "default" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "components": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#components-object", + "type": "object", + "properties": { + "schemas": { + "type": "object", + "additionalProperties": { + "$dynamicRef": "#meta" + } + }, + "responses": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/response-or-reference" + } + }, + "parameters": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/parameter-or-reference" + } + }, + "examples": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/example-or-reference" + } + }, + "requestBodies": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/request-body-or-reference" + } + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "securitySchemes": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/security-scheme-or-reference" + } + }, + "links": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/link-or-reference" + } + }, + "callbacks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/callbacks-or-reference" + } + }, + "pathItems": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + } + }, + "patternProperties": { + "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": { + "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected", + "propertyNames": { + "pattern": "^[a-zA-Z0-9._-]+$" + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "paths": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#paths-object", + "type": "object", + "patternProperties": { + "^/": { + "$ref": "#/$defs/path-item" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "path-item": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#path-item-object", + "type": "object", + "properties": { + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + }, + "parameters": { + "type": "array", + "items": { + "$ref": "#/$defs/parameter-or-reference" + } + } + }, + "patternProperties": { + "^(get|put|post|delete|options|head|patch|trace)$": { + "$ref": "#/$defs/operation" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "path-item-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/path-item" + } + }, + "operation": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#operation-object", + "type": "object", + "properties": { + "tags": { + "type": "array", + "items": { + "type": "string" + } + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + }, + "operationId": { + "type": "string" + }, + "parameters": { + "type": "array", + "items": { + "$ref": "#/$defs/parameter-or-reference" + } + }, + "requestBody": { + "$ref": "#/$defs/request-body-or-reference" + }, + "responses": { + "$ref": "#/$defs/responses" + }, + "callbacks": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/callbacks-or-reference" + } + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "security": { + "type": "array", + "items": { + "$ref": "#/$defs/security-requirement" + } + }, + "servers": { + "type": "array", + "items": { + "$ref": "#/$defs/server" + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "external-documentation": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#external-documentation-object", + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "url" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "parameter": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#parameter-object", + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "in": { + "enum": [ + "query", + "header", + "path", + "cookie" + ] + }, + "description": { + "type": "string" + }, + "required": { + "default": false, + "type": "boolean" + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "schema": { + "$dynamicRef": "#meta" + }, + "content": { + "$ref": "#/$defs/content", + "minProperties": 1, + "maxProperties": 1 + } + }, + "required": [ + "name", + "in" + ], + "oneOf": [ + { + "required": [ + "schema" + ] + }, + { + "required": [ + "content" + ] + } + ], + "if": { + "properties": { + "in": { + "const": "query" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "allowEmptyValue": { + "default": false, + "type": "boolean" + } + } + }, + "dependentSchemas": { + "schema": { + "properties": { + "style": { + "type": "string" + }, + "explode": { + "type": "boolean" + } + }, + "allOf": [ + { + "$ref": "#/$defs/examples" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie" + }, + { + "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form" + } + ], + "$defs": { + "styles-for-path": { + "if": { + "properties": { + "in": { + "const": "path" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "name": { + "pattern": "[^/#?]+$" + }, + "style": { + "default": "simple", + "enum": [ + "matrix", + "label", + "simple" + ] + }, + "required": { + "const": true + } + }, + "required": [ + "required" + ] + } + }, + "styles-for-header": { + "if": { + "properties": { + "in": { + "const": "header" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "simple", + "const": "simple" + } + } + } + }, + "styles-for-query": { + "if": { + "properties": { + "in": { + "const": "query" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "form", + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ] + }, + "allowReserved": { + "default": false, + "type": "boolean" + } + } + } + }, + "styles-for-cookie": { + "if": { + "properties": { + "in": { + "const": "cookie" + } + }, + "required": [ + "in" + ] + }, + "then": { + "properties": { + "style": { + "default": "form", + "const": "form" + } + } + } + }, + "styles-for-form": { + "if": { + "properties": { + "style": { + "const": "form" + } + }, + "required": [ + "style" + ] + }, + "then": { + "properties": { + "explode": { + "default": true + } + } + }, + "else": { + "properties": { + "explode": { + "default": false + } + } + } + } + } + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "parameter-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/parameter" + } + }, + "request-body": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#request-body-object", + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "content": { + "$ref": "#/$defs/content" + }, + "required": { + "default": false, + "type": "boolean" + } + }, + "required": [ + "content" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "request-body-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/request-body" + } + }, + "content": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#fixed-fields-10", + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/media-type" + }, + "propertyNames": { + "format": "media-range" + } + }, + "media-type": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#media-type-object", + "type": "object", + "properties": { + "schema": { + "$dynamicRef": "#meta" + }, + "encoding": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/encoding" + } + } + }, + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/examples" + } + ], + "unevaluatedProperties": false + }, + "encoding": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#encoding-object", + "type": "object", + "properties": { + "contentType": { + "type": "string", + "format": "media-range" + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "style": { + "default": "form", + "enum": [ + "form", + "spaceDelimited", + "pipeDelimited", + "deepObject" + ] + }, + "explode": { + "type": "boolean" + }, + "allowReserved": { + "default": false, + "type": "boolean" + } + }, + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/encoding/$defs/explode-default" + } + ], + "unevaluatedProperties": false, + "$defs": { + "explode-default": { + "if": { + "properties": { + "style": { + "const": "form" + } + }, + "required": [ + "style" + ] + }, + "then": { + "properties": { + "explode": { + "default": true + } + } + }, + "else": { + "properties": { + "explode": { + "default": false + } + } + } + } + } + }, + "responses": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#responses-object", + "type": "object", + "properties": { + "default": { + "$ref": "#/$defs/response-or-reference" + } + }, + "patternProperties": { + "^[1-5](?:[0-9]{2}|XX)$": { + "$ref": "#/$defs/response-or-reference" + } + }, + "minProperties": 1, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "response": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#response-object", + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "headers": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/header-or-reference" + } + }, + "content": { + "$ref": "#/$defs/content" + }, + "links": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/link-or-reference" + } + } + }, + "required": [ + "description" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "response-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/response" + } + }, + "callbacks": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#callback-object", + "type": "object", + "$ref": "#/$defs/specification-extensions", + "additionalProperties": { + "$ref": "#/$defs/path-item-or-reference" + } + }, + "callbacks-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/callbacks" + } + }, + "example": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#example-object", + "type": "object", + "properties": { + "summary": { + "type": "string" + }, + "description": { + "type": "string" + }, + "value": true, + "externalValue": { + "type": "string", + "format": "uri" + } + }, + "not": { + "required": [ + "value", + "externalValue" + ] + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "example-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/example" + } + }, + "link": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#link-object", + "type": "object", + "properties": { + "operationRef": { + "type": "string", + "format": "uri-reference" + }, + "operationId": true, + "parameters": { + "$ref": "#/$defs/map-of-strings" + }, + "requestBody": true, + "description": { + "type": "string" + }, + "body": { + "$ref": "#/$defs/server" + } + }, + "oneOf": [ + { + "required": [ + "operationRef" + ] + }, + { + "required": [ + "operationId" + ] + } + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "link-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/link" + } + }, + "header": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#header-object", + "type": "object", + "properties": { + "description": { + "type": "string" + }, + "required": { + "default": false, + "type": "boolean" + }, + "deprecated": { + "default": false, + "type": "boolean" + }, + "schema": { + "$dynamicRef": "#meta" + }, + "content": { + "$ref": "#/$defs/content", + "minProperties": 1, + "maxProperties": 1 + } + }, + "oneOf": [ + { + "required": [ + "schema" + ] + }, + { + "required": [ + "content" + ] + } + ], + "dependentSchemas": { + "schema": { + "properties": { + "style": { + "default": "simple", + "const": "simple" + }, + "explode": { + "default": false, + "type": "boolean" + } + }, + "$ref": "#/$defs/examples" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "header-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/header" + } + }, + "tag": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#tag-object", + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "description": { + "type": "string" + }, + "externalDocs": { + "$ref": "#/$defs/external-documentation" + } + }, + "required": [ + "name" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "reference": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#reference-object", + "type": "object", + "properties": { + "$ref": { + "type": "string", + "format": "uri-reference" + }, + "summary": { + "type": "string" + }, + "description": { + "type": "string" + } + }, + "unevaluatedProperties": false + }, + "schema": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#schema-object", + "$dynamicAnchor": "meta", + "type": [ + "object", + "boolean" + ] + }, + "security-scheme": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#security-scheme-object", + "type": "object", + "properties": { + "type": { + "enum": [ + "apiKey", + "http", + "mutualTLS", + "oauth2", + "openIdConnect" + ] + }, + "description": { + "type": "string" + } + }, + "required": [ + "type" + ], + "allOf": [ + { + "$ref": "#/$defs/specification-extensions" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-apikey" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-http" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-http-bearer" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-oauth2" + }, + { + "$ref": "#/$defs/security-scheme/$defs/type-oidc" + } + ], + "unevaluatedProperties": false, + "$defs": { + "type-apikey": { + "if": { + "properties": { + "type": { + "const": "apiKey" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "name": { + "type": "string" + }, + "in": { + "enum": [ + "query", + "header", + "cookie" + ] + } + }, + "required": [ + "name", + "in" + ] + } + }, + "type-http": { + "if": { + "properties": { + "type": { + "const": "http" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "scheme": { + "type": "string" + } + }, + "required": [ + "scheme" + ] + } + }, + "type-http-bearer": { + "if": { + "properties": { + "type": { + "const": "http" + }, + "scheme": { + "type": "string", + "pattern": "^[Bb][Ee][Aa][Rr][Ee][Rr]$" + } + }, + "required": [ + "type", + "scheme" + ] + }, + "then": { + "properties": { + "bearerFormat": { + "type": "string" + } + } + } + }, + "type-oauth2": { + "if": { + "properties": { + "type": { + "const": "oauth2" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "flows": { + "$ref": "#/$defs/oauth-flows" + } + }, + "required": [ + "flows" + ] + } + }, + "type-oidc": { + "if": { + "properties": { + "type": { + "const": "openIdConnect" + } + }, + "required": [ + "type" + ] + }, + "then": { + "properties": { + "openIdConnectUrl": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "openIdConnectUrl" + ] + } + } + } + }, + "security-scheme-or-reference": { + "if": { + "type": "object", + "required": [ + "$ref" + ] + }, + "then": { + "$ref": "#/$defs/reference" + }, + "else": { + "$ref": "#/$defs/security-scheme" + } + }, + "oauth-flows": { + "type": "object", + "properties": { + "implicit": { + "$ref": "#/$defs/oauth-flows/$defs/implicit" + }, + "password": { + "$ref": "#/$defs/oauth-flows/$defs/password" + }, + "clientCredentials": { + "$ref": "#/$defs/oauth-flows/$defs/client-credentials" + }, + "authorizationCode": { + "$ref": "#/$defs/oauth-flows/$defs/authorization-code" + } + }, + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false, + "$defs": { + "implicit": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string", + "format": "uri" + }, + "refreshUrl": { + "type": "string", + "format": "uri" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "authorizationUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "password": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string", + "format": "uri" + }, + "refreshUrl": { + "type": "string", + "format": "uri" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "client-credentials": { + "type": "object", + "properties": { + "tokenUrl": { + "type": "string", + "format": "uri" + }, + "refreshUrl": { + "type": "string", + "format": "uri" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + }, + "authorization-code": { + "type": "object", + "properties": { + "authorizationUrl": { + "type": "string", + "format": "uri" + }, + "tokenUrl": { + "type": "string", + "format": "uri" + }, + "refreshUrl": { + "type": "string", + "format": "uri" + }, + "scopes": { + "$ref": "#/$defs/map-of-strings" + } + }, + "required": [ + "authorizationUrl", + "tokenUrl", + "scopes" + ], + "$ref": "#/$defs/specification-extensions", + "unevaluatedProperties": false + } + } + }, + "security-requirement": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#security-requirement-object", + "type": "object", + "additionalProperties": { + "type": "array", + "items": { + "type": "string" + } + } + }, + "specification-extensions": { + "$comment": "https://spec.openapis.org/oas/v3.1.0#specification-extensions", + "patternProperties": { + "^x-": true + } + }, + "examples": { + "properties": { + "example": true, + "examples": { + "type": "object", + "additionalProperties": { + "$ref": "#/$defs/example-or-reference" + } + } + } + }, + "map-of-strings": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } +} diff --git a/oas/3.1/schema/latest b/oas/3.1/schema/latest index 50eb6cd6bc..2a70283d03 120000 --- a/oas/3.1/schema/latest +++ b/oas/3.1/schema/latest @@ -1 +1 @@ -2021-09-28 \ No newline at end of file +2022-02-27 \ No newline at end of file From b4cc42540dc94275dd2920271427be29b05732ef Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 10 Mar 2022 12:35:24 -0500 Subject: [PATCH 024/152] Update ReSpec versions (#2836) Signed-off-by: GitHub Co-authored-by: earth2marsh --- oas/latest.html | 8 ++++---- oas/v3.0.0.html | 6 +++--- oas/v3.0.1.html | 6 +++--- oas/v3.0.2.html | 6 +++--- oas/v3.0.3.html | 6 +++--- oas/v3.1.0.html | 8 ++++---- 6 files changed, 20 insertions(+), 20 deletions(-) diff --git a/oas/latest.html b/oas/latest.html index fca28102c4..81eeaf5158 100644 --- a/oas/latest.html +++ b/oas/latest.html @@ -1031,7 +1031,7 @@ requestBody Request Body Object | Reference Object -The request body applicable for this operation. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as [GET]section-4.3.1), [HEAD]section-4.3.2) and [DELETE]section-4.3.5)), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible. +The request body applicable for this operation. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as GET, HEAD and DELETE), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible. responses @@ -1650,7 +1650,7 @@ content Map[string, Media Type Object] -REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/* +REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/* required @@ -2161,7 +2161,7 @@ content Map[string, Media Type Object] -A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/* +A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/* links @@ -2628,7 +2628,7 @@

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          -

          The runtime expression is defined by the following [ABNF] syntax

          +

          The runtime expression is defined by the following ABNF syntax

          
                 expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
                 source = ( header-reference / query-reference / path-reference / body-reference )
          diff --git a/oas/v3.0.0.html b/oas/v3.0.0.html
          index e9098e3421..166c317e1a 100644
          --- a/oas/v3.0.0.html
          +++ b/oas/v3.0.0.html
          @@ -1642,7 +1642,7 @@
           
            content
           Map[string, Media Type Object]
          -REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          +REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
           
           
            required
          @@ -2151,7 +2151,7 @@
           
            content
           Map[string, Media Type Object]
          -A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          +A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
           
           
            links
          @@ -2609,7 +2609,7 @@
           

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          -

          The runtime expression is defined by the following [ABNF] syntax

          +

          The runtime expression is defined by the following ABNF syntax

          
                 expression = ( "$url" | "$method" | "$statusCode" | "$request." source | "$response." source )
                 source = ( header-reference | query-reference | path-reference | body-reference )  
          diff --git a/oas/v3.0.1.html b/oas/v3.0.1.html
          index 8bfef16b4c..10c2fadc87 100644
          --- a/oas/v3.0.1.html
          +++ b/oas/v3.0.1.html
          @@ -1642,7 +1642,7 @@
           
            content
           Map[string, Media Type Object]
          -REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          +REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
           
           
            required
          @@ -2151,7 +2151,7 @@
           
            content
           Map[string, Media Type Object]
          -A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          +A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
           
           
            links
          @@ -2609,7 +2609,7 @@
           

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          -

          The runtime expression is defined by the following [ABNF] syntax

          +

          The runtime expression is defined by the following ABNF syntax

          
                 expression = ( "$url" | "$method" | "$statusCode" | "$request." source | "$response." source )
                 source = ( header-reference | query-reference | path-reference | body-reference )  
          diff --git a/oas/v3.0.2.html b/oas/v3.0.2.html
          index 7156024e05..b460bc63f8 100644
          --- a/oas/v3.0.2.html
          +++ b/oas/v3.0.2.html
          @@ -1651,7 +1651,7 @@
           
            content
           Map[string, Media Type Object]
          -REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          +REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
           
           
            required
          @@ -2160,7 +2160,7 @@
           
            content
           Map[string, Media Type Object]
          -A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          +A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
           
           
            links
          @@ -2620,7 +2620,7 @@
           

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          -

          The runtime expression is defined by the following [ABNF] syntax

          +

          The runtime expression is defined by the following ABNF syntax

          
                 expression = ( "$url" | "$method" | "$statusCode" | "$request." source | "$response." source )
                 source = ( header-reference | query-reference | path-reference | body-reference )  
          diff --git a/oas/v3.0.3.html b/oas/v3.0.3.html
          index 44040d185e..3a87e84fc6 100644
          --- a/oas/v3.0.3.html
          +++ b/oas/v3.0.3.html
          @@ -1653,7 +1653,7 @@
           
            content
           Map[string, Media Type Object]
          -REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          +REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
           
           
            required
          @@ -2161,7 +2161,7 @@
           
            content
           Map[string, Media Type Object]
          -A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          +A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
           
           
            links
          @@ -2627,7 +2627,7 @@
           

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          -

          The runtime expression is defined by the following [ABNF] syntax

          +

          The runtime expression is defined by the following ABNF syntax

          
                 expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
                 source = ( header-reference / query-reference / path-reference / body-reference )
          diff --git a/oas/v3.1.0.html b/oas/v3.1.0.html
          index fca28102c4..81eeaf5158 100644
          --- a/oas/v3.1.0.html
          +++ b/oas/v3.1.0.html
          @@ -1031,7 +1031,7 @@
           
            requestBody
           Request Body Object | Reference Object
          -The request body applicable for this operation.  The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies.  In other cases where the HTTP spec is vague (such as [GET]section-4.3.1), [HEAD]section-4.3.2) and [DELETE]section-4.3.5)), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.
          +The request body applicable for this operation.  The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies.  In other cases where the HTTP spec is vague (such as GET, HEAD and DELETE), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.
           
           
            responses
          @@ -1650,7 +1650,7 @@
           
            content
           Map[string, Media Type Object]
          -REQUIRED. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          +REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
           
           
            required
          @@ -2161,7 +2161,7 @@
           
            content
           Map[string, Media Type Object]
          -A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
          +A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
           
           
            links
          @@ -2628,7 +2628,7 @@
           

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          -

          The runtime expression is defined by the following [ABNF] syntax

          +

          The runtime expression is defined by the following ABNF syntax

          
                 expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
                 source = ( header-reference / query-reference / path-reference / body-reference )
          
          From 452b94d1a8a482da66ac6ec0e6b10378000cf361 Mon Sep 17 00:00:00 2001
          From: Jason Desrosiers 
          Date: Thu, 13 Oct 2022 09:15:05 -0700
          Subject: [PATCH 025/152] Publish 3.1 schemas for version 2022-10-07 (#3043)
          
          ---
           oas/3.1/schema-base/2022-10-07 |   23 +
           oas/3.1/schema-base/latest     |    2 +-
           oas/3.1/schema/2022-10-07      | 1440 ++++++++++++++++++++++++++++++++
           oas/3.1/schema/latest          |    2 +-
           4 files changed, 1465 insertions(+), 2 deletions(-)
           create mode 100644 oas/3.1/schema-base/2022-10-07
           create mode 100644 oas/3.1/schema/2022-10-07
          
          diff --git a/oas/3.1/schema-base/2022-10-07 b/oas/3.1/schema-base/2022-10-07
          new file mode 100644
          index 0000000000..752e98be4e
          --- /dev/null
          +++ b/oas/3.1/schema-base/2022-10-07
          @@ -0,0 +1,23 @@
          +{
          +  "$id": "https://spec.openapis.org/oas/3.1/schema-base/2022-10-07",
          +  "$schema": "https://json-schema.org/draft/2020-12/schema",
          +
          +  "description": "The description of OpenAPI v3.1.x documents using the OpenAPI JSON Schema dialect, as defined by https://spec.openapis.org/oas/v3.1.0",
          +
          +  "$ref": "https://spec.openapis.org/oas/3.1/schema/2022-10-07",
          +  "properties": {
          +    "jsonSchemaDialect": { "$ref": "#/$defs/dialect" }
          +  },
          +
          +  "$defs": {
          +    "dialect": { "const": "https://spec.openapis.org/oas/3.1/dialect/base" },
          +
          +    "schema": {
          +      "$dynamicAnchor": "meta",
          +      "$ref": "https://spec.openapis.org/oas/3.1/dialect/base",
          +      "properties": {
          +        "$schema": { "$ref": "#/$defs/dialect" }
          +      }
          +    }
          +  }
          +}
          diff --git a/oas/3.1/schema-base/latest b/oas/3.1/schema-base/latest
          index 2a70283d03..0855e8794b 120000
          --- a/oas/3.1/schema-base/latest
          +++ b/oas/3.1/schema-base/latest
          @@ -1 +1 @@
          -2022-02-27
          \ No newline at end of file
          +2022-10-07
          \ No newline at end of file
          diff --git a/oas/3.1/schema/2022-10-07 b/oas/3.1/schema/2022-10-07
          new file mode 100644
          index 0000000000..468bc7e5f5
          --- /dev/null
          +++ b/oas/3.1/schema/2022-10-07
          @@ -0,0 +1,1440 @@
          +{
          +  "$id": "https://spec.openapis.org/oas/3.1/schema/2022-10-07",
          +  "$schema": "https://json-schema.org/draft/2020-12/schema",
          +  "description": "The description of OpenAPI v3.1.x documents without schema validation, as defined by https://spec.openapis.org/oas/v3.1.0",
          +  "type": "object",
          +  "properties": {
          +    "openapi": {
          +      "type": "string",
          +      "pattern": "^3\\.1\\.\\d+(-.+)?$"
          +    },
          +    "info": {
          +      "$ref": "#/$defs/info"
          +    },
          +    "jsonSchemaDialect": {
          +      "type": "string",
          +      "format": "uri",
          +      "default": "https://spec.openapis.org/oas/3.1/dialect/base"
          +    },
          +    "servers": {
          +      "type": "array",
          +      "items": {
          +        "$ref": "#/$defs/server"
          +      },
          +      "default": [
          +        {
          +          "url": "/"
          +        }
          +      ]
          +    },
          +    "paths": {
          +      "$ref": "#/$defs/paths"
          +    },
          +    "webhooks": {
          +      "type": "object",
          +      "additionalProperties": {
          +        "$ref": "#/$defs/path-item-or-reference"
          +      }
          +    },
          +    "components": {
          +      "$ref": "#/$defs/components"
          +    },
          +    "security": {
          +      "type": "array",
          +      "items": {
          +        "$ref": "#/$defs/security-requirement"
          +      }
          +    },
          +    "tags": {
          +      "type": "array",
          +      "items": {
          +        "$ref": "#/$defs/tag"
          +      }
          +    },
          +    "externalDocs": {
          +      "$ref": "#/$defs/external-documentation"
          +    }
          +  },
          +  "required": [
          +    "openapi",
          +    "info"
          +  ],
          +  "anyOf": [
          +    {
          +      "required": [
          +        "paths"
          +      ]
          +    },
          +    {
          +      "required": [
          +        "components"
          +      ]
          +    },
          +    {
          +      "required": [
          +        "webhooks"
          +      ]
          +    }
          +  ],
          +  "$ref": "#/$defs/specification-extensions",
          +  "unevaluatedProperties": false,
          +  "$defs": {
          +    "info": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#info-object",
          +      "type": "object",
          +      "properties": {
          +        "title": {
          +          "type": "string"
          +        },
          +        "summary": {
          +          "type": "string"
          +        },
          +        "description": {
          +          "type": "string"
          +        },
          +        "termsOfService": {
          +          "type": "string",
          +          "format": "uri"
          +        },
          +        "contact": {
          +          "$ref": "#/$defs/contact"
          +        },
          +        "license": {
          +          "$ref": "#/$defs/license"
          +        },
          +        "version": {
          +          "type": "string"
          +        }
          +      },
          +      "required": [
          +        "title",
          +        "version"
          +      ],
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "contact": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#contact-object",
          +      "type": "object",
          +      "properties": {
          +        "name": {
          +          "type": "string"
          +        },
          +        "url": {
          +          "type": "string",
          +          "format": "uri"
          +        },
          +        "email": {
          +          "type": "string",
          +          "format": "email"
          +        }
          +      },
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "license": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#license-object",
          +      "type": "object",
          +      "properties": {
          +        "name": {
          +          "type": "string"
          +        },
          +        "identifier": {
          +          "type": "string"
          +        },
          +        "url": {
          +          "type": "string",
          +          "format": "uri"
          +        }
          +      },
          +      "required": [
          +        "name"
          +      ],
          +      "dependentSchemas": {
          +        "identifier": {
          +          "not": {
          +            "required": [
          +              "url"
          +            ]
          +          }
          +        }
          +      },
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "server": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#server-object",
          +      "type": "object",
          +      "properties": {
          +        "url": {
          +          "type": "string",
          +          "format": "uri-reference"
          +        },
          +        "description": {
          +          "type": "string"
          +        },
          +        "variables": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/server-variable"
          +          }
          +        }
          +      },
          +      "required": [
          +        "url"
          +      ],
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "server-variable": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#server-variable-object",
          +      "type": "object",
          +      "properties": {
          +        "enum": {
          +          "type": "array",
          +          "items": {
          +            "type": "string"
          +          },
          +          "minItems": 1
          +        },
          +        "default": {
          +          "type": "string"
          +        },
          +        "description": {
          +          "type": "string"
          +        }
          +      },
          +      "required": [
          +        "default"
          +      ],
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "components": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#components-object",
          +      "type": "object",
          +      "properties": {
          +        "schemas": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$dynamicRef": "#meta"
          +          }
          +        },
          +        "responses": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/response-or-reference"
          +          }
          +        },
          +        "parameters": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/parameter-or-reference"
          +          }
          +        },
          +        "examples": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/example-or-reference"
          +          }
          +        },
          +        "requestBodies": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/request-body-or-reference"
          +          }
          +        },
          +        "headers": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/header-or-reference"
          +          }
          +        },
          +        "securitySchemes": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/security-scheme-or-reference"
          +          }
          +        },
          +        "links": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/link-or-reference"
          +          }
          +        },
          +        "callbacks": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/callbacks-or-reference"
          +          }
          +        },
          +        "pathItems": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/path-item-or-reference"
          +          }
          +        }
          +      },
          +      "patternProperties": {
          +        "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": {
          +          "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected",
          +          "propertyNames": {
          +            "pattern": "^[a-zA-Z0-9._-]+$"
          +          }
          +        }
          +      },
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "paths": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#paths-object",
          +      "type": "object",
          +      "patternProperties": {
          +        "^/": {
          +          "$ref": "#/$defs/path-item"
          +        }
          +      },
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "path-item": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#path-item-object",
          +      "type": "object",
          +      "properties": {
          +        "summary": {
          +          "type": "string"
          +        },
          +        "description": {
          +          "type": "string"
          +        },
          +        "servers": {
          +          "type": "array",
          +          "items": {
          +            "$ref": "#/$defs/server"
          +          }
          +        },
          +        "parameters": {
          +          "type": "array",
          +          "items": {
          +            "$ref": "#/$defs/parameter-or-reference"
          +          }
          +        },
          +        "get": {
          +          "$ref": "#/$defs/operation"
          +        },
          +        "put": {
          +          "$ref": "#/$defs/operation"
          +        },
          +        "post": {
          +          "$ref": "#/$defs/operation"
          +        },
          +        "delete": {
          +          "$ref": "#/$defs/operation"
          +        },
          +        "options": {
          +          "$ref": "#/$defs/operation"
          +        },
          +        "head": {
          +          "$ref": "#/$defs/operation"
          +        },
          +        "patch": {
          +          "$ref": "#/$defs/operation"
          +        },
          +        "trace": {
          +          "$ref": "#/$defs/operation"
          +        }
          +      },
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "path-item-or-reference": {
          +      "if": {
          +        "type": "object",
          +        "required": [
          +          "$ref"
          +        ]
          +      },
          +      "then": {
          +        "$ref": "#/$defs/reference"
          +      },
          +      "else": {
          +        "$ref": "#/$defs/path-item"
          +      }
          +    },
          +    "operation": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#operation-object",
          +      "type": "object",
          +      "properties": {
          +        "tags": {
          +          "type": "array",
          +          "items": {
          +            "type": "string"
          +          }
          +        },
          +        "summary": {
          +          "type": "string"
          +        },
          +        "description": {
          +          "type": "string"
          +        },
          +        "externalDocs": {
          +          "$ref": "#/$defs/external-documentation"
          +        },
          +        "operationId": {
          +          "type": "string"
          +        },
          +        "parameters": {
          +          "type": "array",
          +          "items": {
          +            "$ref": "#/$defs/parameter-or-reference"
          +          }
          +        },
          +        "requestBody": {
          +          "$ref": "#/$defs/request-body-or-reference"
          +        },
          +        "responses": {
          +          "$ref": "#/$defs/responses"
          +        },
          +        "callbacks": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/callbacks-or-reference"
          +          }
          +        },
          +        "deprecated": {
          +          "default": false,
          +          "type": "boolean"
          +        },
          +        "security": {
          +          "type": "array",
          +          "items": {
          +            "$ref": "#/$defs/security-requirement"
          +          }
          +        },
          +        "servers": {
          +          "type": "array",
          +          "items": {
          +            "$ref": "#/$defs/server"
          +          }
          +        }
          +      },
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "external-documentation": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#external-documentation-object",
          +      "type": "object",
          +      "properties": {
          +        "description": {
          +          "type": "string"
          +        },
          +        "url": {
          +          "type": "string",
          +          "format": "uri"
          +        }
          +      },
          +      "required": [
          +        "url"
          +      ],
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "parameter": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#parameter-object",
          +      "type": "object",
          +      "properties": {
          +        "name": {
          +          "type": "string"
          +        },
          +        "in": {
          +          "enum": [
          +            "query",
          +            "header",
          +            "path",
          +            "cookie"
          +          ]
          +        },
          +        "description": {
          +          "type": "string"
          +        },
          +        "required": {
          +          "default": false,
          +          "type": "boolean"
          +        },
          +        "deprecated": {
          +          "default": false,
          +          "type": "boolean"
          +        },
          +        "schema": {
          +          "$dynamicRef": "#meta"
          +        },
          +        "content": {
          +          "$ref": "#/$defs/content",
          +          "minProperties": 1,
          +          "maxProperties": 1
          +        }
          +      },
          +      "required": [
          +        "name",
          +        "in"
          +      ],
          +      "oneOf": [
          +        {
          +          "required": [
          +            "schema"
          +          ]
          +        },
          +        {
          +          "required": [
          +            "content"
          +          ]
          +        }
          +      ],
          +      "if": {
          +        "properties": {
          +          "in": {
          +            "const": "query"
          +          }
          +        },
          +        "required": [
          +          "in"
          +        ]
          +      },
          +      "then": {
          +        "properties": {
          +          "allowEmptyValue": {
          +            "default": false,
          +            "type": "boolean"
          +          }
          +        }
          +      },
          +      "dependentSchemas": {
          +        "schema": {
          +          "properties": {
          +            "style": {
          +              "type": "string"
          +            },
          +            "explode": {
          +              "type": "boolean"
          +            }
          +          },
          +          "allOf": [
          +            {
          +              "$ref": "#/$defs/examples"
          +            },
          +            {
          +              "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path"
          +            },
          +            {
          +              "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header"
          +            },
          +            {
          +              "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query"
          +            },
          +            {
          +              "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie"
          +            },
          +            {
          +              "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form"
          +            }
          +          ],
          +          "$defs": {
          +            "styles-for-path": {
          +              "if": {
          +                "properties": {
          +                  "in": {
          +                    "const": "path"
          +                  }
          +                },
          +                "required": [
          +                  "in"
          +                ]
          +              },
          +              "then": {
          +                "properties": {
          +                  "name": {
          +                    "pattern": "[^/#?]+$"
          +                  },
          +                  "style": {
          +                    "default": "simple",
          +                    "enum": [
          +                      "matrix",
          +                      "label",
          +                      "simple"
          +                    ]
          +                  },
          +                  "required": {
          +                    "const": true
          +                  }
          +                },
          +                "required": [
          +                  "required"
          +                ]
          +              }
          +            },
          +            "styles-for-header": {
          +              "if": {
          +                "properties": {
          +                  "in": {
          +                    "const": "header"
          +                  }
          +                },
          +                "required": [
          +                  "in"
          +                ]
          +              },
          +              "then": {
          +                "properties": {
          +                  "style": {
          +                    "default": "simple",
          +                    "const": "simple"
          +                  }
          +                }
          +              }
          +            },
          +            "styles-for-query": {
          +              "if": {
          +                "properties": {
          +                  "in": {
          +                    "const": "query"
          +                  }
          +                },
          +                "required": [
          +                  "in"
          +                ]
          +              },
          +              "then": {
          +                "properties": {
          +                  "style": {
          +                    "default": "form",
          +                    "enum": [
          +                      "form",
          +                      "spaceDelimited",
          +                      "pipeDelimited",
          +                      "deepObject"
          +                    ]
          +                  },
          +                  "allowReserved": {
          +                    "default": false,
          +                    "type": "boolean"
          +                  }
          +                }
          +              }
          +            },
          +            "styles-for-cookie": {
          +              "if": {
          +                "properties": {
          +                  "in": {
          +                    "const": "cookie"
          +                  }
          +                },
          +                "required": [
          +                  "in"
          +                ]
          +              },
          +              "then": {
          +                "properties": {
          +                  "style": {
          +                    "default": "form",
          +                    "const": "form"
          +                  }
          +                }
          +              }
          +            },
          +            "styles-for-form": {
          +              "if": {
          +                "properties": {
          +                  "style": {
          +                    "const": "form"
          +                  }
          +                },
          +                "required": [
          +                  "style"
          +                ]
          +              },
          +              "then": {
          +                "properties": {
          +                  "explode": {
          +                    "default": true
          +                  }
          +                }
          +              },
          +              "else": {
          +                "properties": {
          +                  "explode": {
          +                    "default": false
          +                  }
          +                }
          +              }
          +            }
          +          }
          +        }
          +      },
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "parameter-or-reference": {
          +      "if": {
          +        "type": "object",
          +        "required": [
          +          "$ref"
          +        ]
          +      },
          +      "then": {
          +        "$ref": "#/$defs/reference"
          +      },
          +      "else": {
          +        "$ref": "#/$defs/parameter"
          +      }
          +    },
          +    "request-body": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#request-body-object",
          +      "type": "object",
          +      "properties": {
          +        "description": {
          +          "type": "string"
          +        },
          +        "content": {
          +          "$ref": "#/$defs/content"
          +        },
          +        "required": {
          +          "default": false,
          +          "type": "boolean"
          +        }
          +      },
          +      "required": [
          +        "content"
          +      ],
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "request-body-or-reference": {
          +      "if": {
          +        "type": "object",
          +        "required": [
          +          "$ref"
          +        ]
          +      },
          +      "then": {
          +        "$ref": "#/$defs/reference"
          +      },
          +      "else": {
          +        "$ref": "#/$defs/request-body"
          +      }
          +    },
          +    "content": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#fixed-fields-10",
          +      "type": "object",
          +      "additionalProperties": {
          +        "$ref": "#/$defs/media-type"
          +      },
          +      "propertyNames": {
          +        "format": "media-range"
          +      }
          +    },
          +    "media-type": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#media-type-object",
          +      "type": "object",
          +      "properties": {
          +        "schema": {
          +          "$dynamicRef": "#meta"
          +        },
          +        "encoding": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/encoding"
          +          }
          +        }
          +      },
          +      "allOf": [
          +        {
          +          "$ref": "#/$defs/specification-extensions"
          +        },
          +        {
          +          "$ref": "#/$defs/examples"
          +        }
          +      ],
          +      "unevaluatedProperties": false
          +    },
          +    "encoding": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#encoding-object",
          +      "type": "object",
          +      "properties": {
          +        "contentType": {
          +          "type": "string",
          +          "format": "media-range"
          +        },
          +        "headers": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/header-or-reference"
          +          }
          +        },
          +        "style": {
          +          "default": "form",
          +          "enum": [
          +            "form",
          +            "spaceDelimited",
          +            "pipeDelimited",
          +            "deepObject"
          +          ]
          +        },
          +        "explode": {
          +          "type": "boolean"
          +        },
          +        "allowReserved": {
          +          "default": false,
          +          "type": "boolean"
          +        }
          +      },
          +      "allOf": [
          +        {
          +          "$ref": "#/$defs/specification-extensions"
          +        },
          +        {
          +          "$ref": "#/$defs/encoding/$defs/explode-default"
          +        }
          +      ],
          +      "unevaluatedProperties": false,
          +      "$defs": {
          +        "explode-default": {
          +          "if": {
          +            "properties": {
          +              "style": {
          +                "const": "form"
          +              }
          +            },
          +            "required": [
          +              "style"
          +            ]
          +          },
          +          "then": {
          +            "properties": {
          +              "explode": {
          +                "default": true
          +              }
          +            }
          +          },
          +          "else": {
          +            "properties": {
          +              "explode": {
          +                "default": false
          +              }
          +            }
          +          }
          +        }
          +      }
          +    },
          +    "responses": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#responses-object",
          +      "type": "object",
          +      "properties": {
          +        "default": {
          +          "$ref": "#/$defs/response-or-reference"
          +        }
          +      },
          +      "patternProperties": {
          +        "^[1-5](?:[0-9]{2}|XX)$": {
          +          "$ref": "#/$defs/response-or-reference"
          +        }
          +      },
          +      "minProperties": 1,
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "response": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#response-object",
          +      "type": "object",
          +      "properties": {
          +        "description": {
          +          "type": "string"
          +        },
          +        "headers": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/header-or-reference"
          +          }
          +        },
          +        "content": {
          +          "$ref": "#/$defs/content"
          +        },
          +        "links": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/link-or-reference"
          +          }
          +        }
          +      },
          +      "required": [
          +        "description"
          +      ],
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "response-or-reference": {
          +      "if": {
          +        "type": "object",
          +        "required": [
          +          "$ref"
          +        ]
          +      },
          +      "then": {
          +        "$ref": "#/$defs/reference"
          +      },
          +      "else": {
          +        "$ref": "#/$defs/response"
          +      }
          +    },
          +    "callbacks": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#callback-object",
          +      "type": "object",
          +      "$ref": "#/$defs/specification-extensions",
          +      "additionalProperties": {
          +        "$ref": "#/$defs/path-item-or-reference"
          +      }
          +    },
          +    "callbacks-or-reference": {
          +      "if": {
          +        "type": "object",
          +        "required": [
          +          "$ref"
          +        ]
          +      },
          +      "then": {
          +        "$ref": "#/$defs/reference"
          +      },
          +      "else": {
          +        "$ref": "#/$defs/callbacks"
          +      }
          +    },
          +    "example": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#example-object",
          +      "type": "object",
          +      "properties": {
          +        "summary": {
          +          "type": "string"
          +        },
          +        "description": {
          +          "type": "string"
          +        },
          +        "value": true,
          +        "externalValue": {
          +          "type": "string",
          +          "format": "uri"
          +        }
          +      },
          +      "not": {
          +        "required": [
          +          "value",
          +          "externalValue"
          +        ]
          +      },
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "example-or-reference": {
          +      "if": {
          +        "type": "object",
          +        "required": [
          +          "$ref"
          +        ]
          +      },
          +      "then": {
          +        "$ref": "#/$defs/reference"
          +      },
          +      "else": {
          +        "$ref": "#/$defs/example"
          +      }
          +    },
          +    "link": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#link-object",
          +      "type": "object",
          +      "properties": {
          +        "operationRef": {
          +          "type": "string",
          +          "format": "uri-reference"
          +        },
          +        "operationId": {
          +          "type": "string"
          +        },
          +        "parameters": {
          +          "$ref": "#/$defs/map-of-strings"
          +        },
          +        "requestBody": true,
          +        "description": {
          +          "type": "string"
          +        },
          +        "body": {
          +          "$ref": "#/$defs/server"
          +        }
          +      },
          +      "oneOf": [
          +        {
          +          "required": [
          +            "operationRef"
          +          ]
          +        },
          +        {
          +          "required": [
          +            "operationId"
          +          ]
          +        }
          +      ],
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "link-or-reference": {
          +      "if": {
          +        "type": "object",
          +        "required": [
          +          "$ref"
          +        ]
          +      },
          +      "then": {
          +        "$ref": "#/$defs/reference"
          +      },
          +      "else": {
          +        "$ref": "#/$defs/link"
          +      }
          +    },
          +    "header": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#header-object",
          +      "type": "object",
          +      "properties": {
          +        "description": {
          +          "type": "string"
          +        },
          +        "required": {
          +          "default": false,
          +          "type": "boolean"
          +        },
          +        "deprecated": {
          +          "default": false,
          +          "type": "boolean"
          +        },
          +        "schema": {
          +          "$dynamicRef": "#meta"
          +        },
          +        "content": {
          +          "$ref": "#/$defs/content",
          +          "minProperties": 1,
          +          "maxProperties": 1
          +        }
          +      },
          +      "oneOf": [
          +        {
          +          "required": [
          +            "schema"
          +          ]
          +        },
          +        {
          +          "required": [
          +            "content"
          +          ]
          +        }
          +      ],
          +      "dependentSchemas": {
          +        "schema": {
          +          "properties": {
          +            "style": {
          +              "default": "simple",
          +              "const": "simple"
          +            },
          +            "explode": {
          +              "default": false,
          +              "type": "boolean"
          +            }
          +          },
          +          "$ref": "#/$defs/examples"
          +        }
          +      },
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "header-or-reference": {
          +      "if": {
          +        "type": "object",
          +        "required": [
          +          "$ref"
          +        ]
          +      },
          +      "then": {
          +        "$ref": "#/$defs/reference"
          +      },
          +      "else": {
          +        "$ref": "#/$defs/header"
          +      }
          +    },
          +    "tag": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#tag-object",
          +      "type": "object",
          +      "properties": {
          +        "name": {
          +          "type": "string"
          +        },
          +        "description": {
          +          "type": "string"
          +        },
          +        "externalDocs": {
          +          "$ref": "#/$defs/external-documentation"
          +        }
          +      },
          +      "required": [
          +        "name"
          +      ],
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false
          +    },
          +    "reference": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#reference-object",
          +      "type": "object",
          +      "properties": {
          +        "$ref": {
          +          "type": "string",
          +          "format": "uri-reference"
          +        },
          +        "summary": {
          +          "type": "string"
          +        },
          +        "description": {
          +          "type": "string"
          +        }
          +      },
          +      "unevaluatedProperties": false
          +    },
          +    "schema": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#schema-object",
          +      "$dynamicAnchor": "meta",
          +      "type": [
          +        "object",
          +        "boolean"
          +      ]
          +    },
          +    "security-scheme": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#security-scheme-object",
          +      "type": "object",
          +      "properties": {
          +        "type": {
          +          "enum": [
          +            "apiKey",
          +            "http",
          +            "mutualTLS",
          +            "oauth2",
          +            "openIdConnect"
          +          ]
          +        },
          +        "description": {
          +          "type": "string"
          +        }
          +      },
          +      "required": [
          +        "type"
          +      ],
          +      "allOf": [
          +        {
          +          "$ref": "#/$defs/specification-extensions"
          +        },
          +        {
          +          "$ref": "#/$defs/security-scheme/$defs/type-apikey"
          +        },
          +        {
          +          "$ref": "#/$defs/security-scheme/$defs/type-http"
          +        },
          +        {
          +          "$ref": "#/$defs/security-scheme/$defs/type-http-bearer"
          +        },
          +        {
          +          "$ref": "#/$defs/security-scheme/$defs/type-oauth2"
          +        },
          +        {
          +          "$ref": "#/$defs/security-scheme/$defs/type-oidc"
          +        }
          +      ],
          +      "unevaluatedProperties": false,
          +      "$defs": {
          +        "type-apikey": {
          +          "if": {
          +            "properties": {
          +              "type": {
          +                "const": "apiKey"
          +              }
          +            },
          +            "required": [
          +              "type"
          +            ]
          +          },
          +          "then": {
          +            "properties": {
          +              "name": {
          +                "type": "string"
          +              },
          +              "in": {
          +                "enum": [
          +                  "query",
          +                  "header",
          +                  "cookie"
          +                ]
          +              }
          +            },
          +            "required": [
          +              "name",
          +              "in"
          +            ]
          +          }
          +        },
          +        "type-http": {
          +          "if": {
          +            "properties": {
          +              "type": {
          +                "const": "http"
          +              }
          +            },
          +            "required": [
          +              "type"
          +            ]
          +          },
          +          "then": {
          +            "properties": {
          +              "scheme": {
          +                "type": "string"
          +              }
          +            },
          +            "required": [
          +              "scheme"
          +            ]
          +          }
          +        },
          +        "type-http-bearer": {
          +          "if": {
          +            "properties": {
          +              "type": {
          +                "const": "http"
          +              },
          +              "scheme": {
          +                "type": "string",
          +                "pattern": "^[Bb][Ee][Aa][Rr][Ee][Rr]$"
          +              }
          +            },
          +            "required": [
          +              "type",
          +              "scheme"
          +            ]
          +          },
          +          "then": {
          +            "properties": {
          +              "bearerFormat": {
          +                "type": "string"
          +              }
          +            }
          +          }
          +        },
          +        "type-oauth2": {
          +          "if": {
          +            "properties": {
          +              "type": {
          +                "const": "oauth2"
          +              }
          +            },
          +            "required": [
          +              "type"
          +            ]
          +          },
          +          "then": {
          +            "properties": {
          +              "flows": {
          +                "$ref": "#/$defs/oauth-flows"
          +              }
          +            },
          +            "required": [
          +              "flows"
          +            ]
          +          }
          +        },
          +        "type-oidc": {
          +          "if": {
          +            "properties": {
          +              "type": {
          +                "const": "openIdConnect"
          +              }
          +            },
          +            "required": [
          +              "type"
          +            ]
          +          },
          +          "then": {
          +            "properties": {
          +              "openIdConnectUrl": {
          +                "type": "string",
          +                "format": "uri"
          +              }
          +            },
          +            "required": [
          +              "openIdConnectUrl"
          +            ]
          +          }
          +        }
          +      }
          +    },
          +    "security-scheme-or-reference": {
          +      "if": {
          +        "type": "object",
          +        "required": [
          +          "$ref"
          +        ]
          +      },
          +      "then": {
          +        "$ref": "#/$defs/reference"
          +      },
          +      "else": {
          +        "$ref": "#/$defs/security-scheme"
          +      }
          +    },
          +    "oauth-flows": {
          +      "type": "object",
          +      "properties": {
          +        "implicit": {
          +          "$ref": "#/$defs/oauth-flows/$defs/implicit"
          +        },
          +        "password": {
          +          "$ref": "#/$defs/oauth-flows/$defs/password"
          +        },
          +        "clientCredentials": {
          +          "$ref": "#/$defs/oauth-flows/$defs/client-credentials"
          +        },
          +        "authorizationCode": {
          +          "$ref": "#/$defs/oauth-flows/$defs/authorization-code"
          +        }
          +      },
          +      "$ref": "#/$defs/specification-extensions",
          +      "unevaluatedProperties": false,
          +      "$defs": {
          +        "implicit": {
          +          "type": "object",
          +          "properties": {
          +            "authorizationUrl": {
          +              "type": "string",
          +              "format": "uri"
          +            },
          +            "refreshUrl": {
          +              "type": "string",
          +              "format": "uri"
          +            },
          +            "scopes": {
          +              "$ref": "#/$defs/map-of-strings"
          +            }
          +          },
          +          "required": [
          +            "authorizationUrl",
          +            "scopes"
          +          ],
          +          "$ref": "#/$defs/specification-extensions",
          +          "unevaluatedProperties": false
          +        },
          +        "password": {
          +          "type": "object",
          +          "properties": {
          +            "tokenUrl": {
          +              "type": "string",
          +              "format": "uri"
          +            },
          +            "refreshUrl": {
          +              "type": "string",
          +              "format": "uri"
          +            },
          +            "scopes": {
          +              "$ref": "#/$defs/map-of-strings"
          +            }
          +          },
          +          "required": [
          +            "tokenUrl",
          +            "scopes"
          +          ],
          +          "$ref": "#/$defs/specification-extensions",
          +          "unevaluatedProperties": false
          +        },
          +        "client-credentials": {
          +          "type": "object",
          +          "properties": {
          +            "tokenUrl": {
          +              "type": "string",
          +              "format": "uri"
          +            },
          +            "refreshUrl": {
          +              "type": "string",
          +              "format": "uri"
          +            },
          +            "scopes": {
          +              "$ref": "#/$defs/map-of-strings"
          +            }
          +          },
          +          "required": [
          +            "tokenUrl",
          +            "scopes"
          +          ],
          +          "$ref": "#/$defs/specification-extensions",
          +          "unevaluatedProperties": false
          +        },
          +        "authorization-code": {
          +          "type": "object",
          +          "properties": {
          +            "authorizationUrl": {
          +              "type": "string",
          +              "format": "uri"
          +            },
          +            "tokenUrl": {
          +              "type": "string",
          +              "format": "uri"
          +            },
          +            "refreshUrl": {
          +              "type": "string",
          +              "format": "uri"
          +            },
          +            "scopes": {
          +              "$ref": "#/$defs/map-of-strings"
          +            }
          +          },
          +          "required": [
          +            "authorizationUrl",
          +            "tokenUrl",
          +            "scopes"
          +          ],
          +          "$ref": "#/$defs/specification-extensions",
          +          "unevaluatedProperties": false
          +        }
          +      }
          +    },
          +    "security-requirement": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#security-requirement-object",
          +      "type": "object",
          +      "additionalProperties": {
          +        "type": "array",
          +        "items": {
          +          "type": "string"
          +        }
          +      }
          +    },
          +    "specification-extensions": {
          +      "$comment": "https://spec.openapis.org/oas/v3.1.0#specification-extensions",
          +      "patternProperties": {
          +        "^x-": true
          +      }
          +    },
          +    "examples": {
          +      "properties": {
          +        "example": true,
          +        "examples": {
          +          "type": "object",
          +          "additionalProperties": {
          +            "$ref": "#/$defs/example-or-reference"
          +          }
          +        }
          +      }
          +    },
          +    "map-of-strings": {
          +      "type": "object",
          +      "additionalProperties": {
          +        "type": "string"
          +      }
          +    }
          +  }
          +}
          diff --git a/oas/3.1/schema/latest b/oas/3.1/schema/latest
          index 2a70283d03..0855e8794b 120000
          --- a/oas/3.1/schema/latest
          +++ b/oas/3.1/schema/latest
          @@ -1 +1 @@
          -2022-02-27
          \ No newline at end of file
          +2022-10-07
          \ No newline at end of file
          
          From 2c2162ef8ac852fe9d44c2721a96657fa8d0522b Mon Sep 17 00:00:00 2001
          From: Darrel 
          Date: Thu, 26 Jan 2023 12:12:38 -0500
          Subject: [PATCH 026/152] Add new extension namespace registry (#3107)
          
          * Add new extension namespace registry
          
          * Fixed error in format registry table
          
          * Added clarification registry submission process
          
          * Update index.md
          
          Added a clarification and a fix.
          ---
           _config.yml                        |  5 +++++
           api/namespace.json                 | 11 +++++++++++
           registries/_namespace/ms.md        | 19 +++++++++++++++++++
           registries/_namespace/oas-draft.md | 19 +++++++++++++++++++
           registry/index.md                  |  2 +-
           registry/namespace.md              | 19 +++++++++++++++++++
           6 files changed, 74 insertions(+), 1 deletion(-)
           create mode 100644 api/namespace.json
           create mode 100644 registries/_namespace/ms.md
           create mode 100644 registries/_namespace/oas-draft.md
           create mode 100644 registry/namespace.md
          
          diff --git a/_config.yml b/_config.yml
          index 4175c0b24e..3f265bad6a 100644
          --- a/_config.yml
          +++ b/_config.yml
          @@ -30,3 +30,8 @@ collections:
               name: Alternative Schema Type Registry
               output: true
               permalink: /registry/:collection/:title
          +  namespace:
          +    slug: namespace
          +    name: Extension Namespace Registry
          +    output: true
          +    permalink: /registry/:collection/:title
          diff --git a/api/namespace.json b/api/namespace.json
          new file mode 100644
          index 0000000000..c86d6f590e
          --- /dev/null
          +++ b/api/namespace.json
          @@ -0,0 +1,11 @@
          +---
          +---
          +{
          +{% for page in site.namespace %}"{{ page.slug }}": {
          +  "slug": "{{ page.slug }}",
          +  "issue": "{{ page.issue }}",
          +  "description": "{{ page.description }}",
          +  "owner": "{{ page.owner }}"
          +}{% unless forloop.last %},{% endunless %}
          +{% endfor %}
          +}
          diff --git a/registries/_namespace/ms.md b/registries/_namespace/ms.md
          new file mode 100644
          index 0000000000..a1651a7e53
          --- /dev/null
          +++ b/registries/_namespace/ms.md
          @@ -0,0 +1,19 @@
          +---
          +owner: DarrelMiller
          +issue: 
          +description: Extensions created and used by Microsoft
          +layout: default
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +
          +The `x-{{page.slug}}-` prefix is reserved for extensions created by Microsoft. These extensions are available for use by anyone.
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          diff --git a/registries/_namespace/oas-draft.md b/registries/_namespace/oas-draft.md
          new file mode 100644
          index 0000000000..94ddc0b80e
          --- /dev/null
          +++ b/registries/_namespace/oas-draft.md
          @@ -0,0 +1,19 @@
          +---
          +owner: DarrelMiller
          +issue: 
          +description: Extensions created by OAI to indicate proposed changes to the OAS specification
          +layout: default
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +
          +The `x-{{page.slug}}-` prefix is reserved for extensions created as part of the [draft features(https://github.com/OAI/OpenAPI-Specification/blob/main/DEVELOPMENT.md#draft-features)] process. These extensions are available for use by anyone.
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          diff --git a/registry/index.md b/registry/index.md
          index 6189e53c53..d94588abca 100644
          --- a/registry/index.md
          +++ b/registry/index.md
          @@ -5,7 +5,7 @@ permalink: /registry/index.html
           
           ## Contributing
           
          -Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value.
          +Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) against the `gh-pages` branch and add a new Markdown file to a folder in the `registries/_{registryName}`. The name of the file is considered the registration entry, ignoring the file extension. Alternatively you can open an [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to discuss a registry value.
           
           ### Contents
           
          diff --git a/registry/namespace.md b/registry/namespace.md
          new file mode 100644
          index 0000000000..b64f795f0c
          --- /dev/null
          +++ b/registry/namespace.md
          @@ -0,0 +1,19 @@
          +---
          +layout: default
          +permalink: /registry/namespace/index.html
          +---
          +
          +# Namespace Registry
          +
          +To allow for creators of OpenAPI descriptions to define new extensions without the risk of name collisions, a namespace registry is maintained by OAI. The namespace registry is a simple list of unique identifiers that are used as part of a prefix for extensions to ensure uniqueness. A prefix has the format `x-{namespace}-` where `{namespace}` is a unique string associated to the creator of the extensions within the namespace. Namespace identifiers MUST be registered as lowercase identifiers.
          +
          +## Contributing
          +
          +Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value.
          +
          +## Values
          +
          +|Value|Prefix|Description|Issue|
          +|---|---|---|---|
          +{% for value in site.namespace %}| {{ value.slug }} | x-{{ value.slug }}-|{{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
          +{% endfor %}
          
          From b5715b198dc727ed63a9e4f86c3e24a35c7c882b Mon Sep 17 00:00:00 2001
          From: Pavel Kornev 
          Date: Thu, 9 Feb 2023 18:13:43 +0100
          Subject: [PATCH 027/152] Reserve x-sap- namespace for SAP extensions (#3151)
          
          ---
           registries/_namespace/sap.md | 21 +++++++++++++++++++++
           1 file changed, 21 insertions(+)
           create mode 100644 registries/_namespace/sap.md
          
          diff --git a/registries/_namespace/sap.md b/registries/_namespace/sap.md
          new file mode 100644
          index 0000000000..1c678fc7d8
          --- /dev/null
          +++ b/registries/_namespace/sap.md
          @@ -0,0 +1,21 @@
          +---
          +owner: ralfhandl, pavelkornev
          +issue: 
          +description: Extensions created and used by SAP
          +layout: default
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +
          +The `x-{{page.slug}}-` prefix is reserved for extensions created by SAP. These extensions are available for use by anyone.
          +
          +The official list of supported SAP extensions can be found in [SAP/openapi-specification](https://github.com/SAP/openapi-specification) repository.
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          
          From 460a67dbebbf07970f110d1ffaf990fd0dc763b3 Mon Sep 17 00:00:00 2001
          From: "Henry H. Andrews" 
          Date: Wed, 1 Mar 2023 09:39:14 -0800
          Subject: [PATCH 028/152] Make links relative
          
          This allows renderings of forks to work.
          ---
           README.md                      | 2 +-
           index.md                       | 2 +-
           registry/alternative-schema.md | 2 +-
           registry/draft-feature.md      | 2 +-
           registry/extension.md          | 2 +-
           registry/format.md             | 2 +-
           registry/index.md              | 8 ++++----
           registry/namespace.md          | 2 +-
           8 files changed, 11 insertions(+), 11 deletions(-)
          
          diff --git a/README.md b/README.md
          index fa4a0ebe4a..9fa262951d 100644
          --- a/README.md
          +++ b/README.md
          @@ -4,7 +4,7 @@ This site contains the OpenAPI Initiative Registry and content for the HTML vers
           
           ## Registry
           
          -* Proceed to [Registry](/registry/index.html)
          +* Proceed to [Registry](./registry/index.html)
           
           ## The Specification
           
          diff --git a/index.md b/index.md
          index fcc9bac2a2..f949d157ca 100644
          --- a/index.md
          +++ b/index.md
          @@ -8,7 +8,7 @@ This site contains the OpenAPI Initiative Registry and content for the HTML vers
           
           ## Registry
           
          -* Proceed to [Registry](/registry/index.html)
          +* Proceed to [Registry](./registry/index.html)
           
           ## The Specification
           
          diff --git a/registry/alternative-schema.md b/registry/alternative-schema.md
          index f558b6df06..b5f38275ed 100644
          --- a/registry/alternative-schema.md
          +++ b/registry/alternative-schema.md
          @@ -17,6 +17,6 @@ Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls
           
           |Value|Description|Issue|
           |---|---|---|
          -{% for value in site.alternative-schema %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
          +{% for value in site.alternative-schema %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
           {% endfor %}
           
          diff --git a/registry/draft-feature.md b/registry/draft-feature.md
          index 53987354dd..858d5fe402 100644
          --- a/registry/draft-feature.md
          +++ b/registry/draft-feature.md
          @@ -17,6 +17,6 @@ Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls
           
           |Value|Description|Issue|
           |---|---|---|
          -{% for value in site.draft-feature %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
          +{% for value in site.draft-feature %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
           {% endfor %}
           
          diff --git a/registry/extension.md b/registry/extension.md
          index 6691c64f5c..77b3e526d9 100644
          --- a/registry/extension.md
          +++ b/registry/extension.md
          @@ -17,6 +17,6 @@ Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls
           
           |Value|Description|Issue|
           |---|---|---|
          -{% for value in site.extension %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
          +{% for value in site.extension %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
           {% endfor %}
           
          diff --git a/registry/format.md b/registry/format.md
          index 592f848eaf..a23620794e 100644
          --- a/registry/format.md
          +++ b/registry/format.md
          @@ -17,6 +17,6 @@ Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls
           
           |Value|Description|Issue|
           |---|---|---|
          -{% for value in site.format %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
          +{% for value in site.format %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
           {% endfor %}
           
          diff --git a/registry/index.md b/registry/index.md
          index d94588abca..deae5f3784 100644
          --- a/registry/index.md
          +++ b/registry/index.md
          @@ -9,16 +9,16 @@ Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls
           
           ### Contents
           
          -{% for registry in site.collections %}{% unless registry.hidden %}* {{ registry.name }}{% endunless %}
          +{% for registry in site.collections %}{% unless registry.hidden %}* {{ registry.name }}{% endunless %}
           {% endfor %}
           
           #### API access
           
          -* [registries.json](/api/registries.json) - Registries meta-registry
          -{% for registry in site.collections %}{% unless registry.hidden %}* {{ registry.slug }}.json{% endunless %}
          +* [registries.json](./api/registries.json) - Registries meta-registry
          +{% for registry in site.collections %}{% unless registry.hidden %}* {{ registry.slug }}.json{% endunless %}
           {% endfor %}
           
           #### RSS feed
           
          -* [feed.xml](/rss/feed.xml)
          +* [feed.xml](./rss/feed.xml)
           
          diff --git a/registry/namespace.md b/registry/namespace.md
          index b64f795f0c..24cb4430c6 100644
          --- a/registry/namespace.md
          +++ b/registry/namespace.md
          @@ -15,5 +15,5 @@ Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls
           
           |Value|Prefix|Description|Issue|
           |---|---|---|---|
          -{% for value in site.namespace %}| {{ value.slug }} | x-{{ value.slug }}-|{{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
          +{% for value in site.namespace %}| {{ value.slug }} | x-{{ value.slug }}-|{{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
           {% endfor %}
          
          From 9fbab3e259809652d1fb23c1bc63a6c880fb5b95 Mon Sep 17 00:00:00 2001
          From: Henry Andrews 
          Date: Thu, 2 Mar 2023 11:02:43 -0800
          Subject: [PATCH 029/152] Remove extra "/" from URL
          
          Co-authored-by: Mike Ralphson 
          ---
           registry/index.md | 2 +-
           1 file changed, 1 insertion(+), 1 deletion(-)
          
          diff --git a/registry/index.md b/registry/index.md
          index deae5f3784..409e8f6362 100644
          --- a/registry/index.md
          +++ b/registry/index.md
          @@ -15,7 +15,7 @@ Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls
           #### API access
           
           * [registries.json](./api/registries.json) - Registries meta-registry
          -{% for registry in site.collections %}{% unless registry.hidden %}* {{ registry.slug }}.json{% endunless %}
          +{% for registry in site.collections %}{% unless registry.hidden %}* {{ registry.slug }}.json{% endunless %}
           {% endfor %}
           
           #### RSS feed
          
          From e4825310073f1f9ad1951875aa28baef51d5585e Mon Sep 17 00:00:00 2001
          From: Henry Andrews 
          Date: Thu, 2 Mar 2023 11:03:12 -0800
          Subject: [PATCH 030/152] Need to go up a level for the rss URL
          
          Co-authored-by: Mike Ralphson 
          ---
           registry/index.md | 2 +-
           1 file changed, 1 insertion(+), 1 deletion(-)
          
          diff --git a/registry/index.md b/registry/index.md
          index 409e8f6362..2575b7b1bc 100644
          --- a/registry/index.md
          +++ b/registry/index.md
          @@ -20,5 +20,5 @@ Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls
           
           #### RSS feed
           
          -* [feed.xml](./rss/feed.xml)
          +* [feed.xml](../rss/feed.xml)
           
          
          From 7592eb82c8faf8f86f52368b9b4672bf286b0081 Mon Sep 17 00:00:00 2001
          From: Vincent Biret 
          Date: Mon, 6 Mar 2023 18:29:56 -0500
          Subject: [PATCH 031/152] adds missing formats in the registry (#3167)
          
          * - typo fix
          
          * - adds UUID format
          
          * - adds URI format
          
          * - moves source links to YAML header so it can be in the table as well
          
          * - adds URI template, IRI, IRI reference and URI reference
          
          * - adds time and duration formats
          
          * - adds email and idn email formats
          
          * - adds ipv4, v6, hostname and idn hostname formats
          
          * - adds json and relative json pointers
          
          * - adds regex
          
          * - adds base64 url format
          
          * - adds decimal format
          
          * - adds char format
          
          * - typo fix
          
          * - switches base type for decimal to number
          
          * - removes link to master issue
          
          Signed-off-by: Vincent Biret 
          
          * - adds recommendation for binary format in 3.1
          
          Signed-off-by: Vincent Biret 
          
          * Update registries/_format/date.md
          
          Co-authored-by: Ralf Handl 
          
          * - fixes link to duration spec
          
          Co-authored-by: Ralf Handl 
          
          * - fixes email RFC number
          
          Co-authored-by: Ralf Handl 
          
          * - adds email rfc link
          
          Co-authored-by: Ralf Handl 
          
          * - adds IDN hostname RFC link
          
          Co-authored-by: Ralf Handl 
          
          * - adds idn email RFC link
          
          Co-authored-by: Ralf Handl 
          
          * - adds base type, version and remarks to format table
          
          Signed-off-by: Vincent Biret 
          
          * - adds version and remarks for binary format
          
          Signed-off-by: Vincent Biret 
          
          * - adds support for floating points in decimal
          
          * Apply suggestions from code review
          
          Co-authored-by: Ralf Handl 
          
          * - adds int16 to the format list
          
          Signed-off-by: Vincent Biret 
          
          * - adds link to the base64 url RFC
          
          Co-authored-by: Ralf Handl 
          
          * - adds remark for base64url format
          
          * - adds link to the base64 url RFC
          
          * - fixes link to source
          
          Signed-off-by: Vincent Biret 
          
          * - adds details about base64, base64url and byte formats
          
          Signed-off-by: Vincent Biret 
          
          * - typo fix
          
          Signed-off-by: Vincent Biret 
          
          * - adds links to base64 RFC
          
          Signed-off-by: Vincent Biret 
          
          * - first batch of review suggestions
          
          Co-authored-by: Ralf Handl 
          
          * - second batch of PR feedback
          
          Co-authored-by: Darrel 
          
          * - third batch of PR review suggestions
          
          Signed-off-by: Vincent Biret 
          
          * - moves and renames version column for formats
          
          Signed-off-by: Vincent Biret 
          
          * - adds password format
          
          Signed-off-by: Vincent Biret 
          
          * - adds a source label for formats
          
          Signed-off-by: Vincent Biret 
          
          * - removes examples from registry entries
          
          Signed-off-by: Vincent Biret 
          
          * - removes remarks column in formats
          
          Signed-off-by: Vincent Biret 
          
          * - renames oas version to deprecated version
          
          Signed-off-by: Vincent Biret 
          
          * Update registry/format.md
          
          Co-authored-by: Darrel 
          
          * - changes the deprecation to a true/false in the table
          
          Signed-off-by: Vincent Biret 
          
          * - removes the deprecation notice from detail pages
          
          Signed-off-by: Vincent Biret 
          
          * - renames deprecated version to note as PR feedback
          
          Signed-off-by: Vincent Biret 
          
          * - moves base64url, int16 and char to separate PRs
          
          * Apply suggestions from code review
          
          Co-authored-by: Darrel 
          
          * - moves decimal to a separate PR
          
          * - adds OAS source for relevant formats
          
          Signed-off-by: Vincent Biret 
          
          * Update registries/_format/idn-email.md
          
          Co-authored-by: Mike Ralphson 
          
          ---------
          
          Signed-off-by: Vincent Biret 
          Co-authored-by: Ralf Handl 
          Co-authored-by: Darrel 
          Co-authored-by: Mike Ralphson 
          ---
           registries/_format/binary.md                | 12 +++++++-
           registries/_format/byte.md                  | 14 ++++++++--
           registries/_format/commonmark.md            |  8 ++++++
           registries/_format/date-time.md             | 12 ++++++--
           registries/_format/date.md                  | 12 ++++++--
           registries/_format/double.md                |  8 ++++++
           registries/_format/duration.md              | 29 +++++++++++++++++++
           registries/_format/email.md                 | 29 +++++++++++++++++++
           registries/_format/float.md                 |  8 ++++++
           registries/_format/hostname.md              | 29 +++++++++++++++++++
           registries/_format/html.md                  |  8 ++++++
           registries/_format/idn-email.md             | 29 +++++++++++++++++++
           registries/_format/idn-hostname.md          | 29 +++++++++++++++++++
           registries/_format/int32.md                 |  8 ++++++
           registries/_format/int64.md                 |  8 ++++++
           registries/_format/int8.md                  |  8 ++++++
           registries/_format/ipv4.md                  | 29 +++++++++++++++++++
           registries/_format/ipv6.md                  | 29 +++++++++++++++++++
           registries/_format/iri-reference.md         | 29 +++++++++++++++++++
           registries/_format/iri.md                   | 29 +++++++++++++++++++
           registries/_format/json-pointer.md          | 29 +++++++++++++++++++
           registries/_format/password.md              | 29 +++++++++++++++++++
           registries/_format/regex.md                 | 29 +++++++++++++++++++
           registries/_format/relative-json-pointer.md | 31 +++++++++++++++++++++
           registries/_format/time.md                  | 29 +++++++++++++++++++
           registries/_format/uint8.md                 |  7 +++++
           registries/_format/uri-reference.md         | 29 +++++++++++++++++++
           registries/_format/uri-template.md          | 29 +++++++++++++++++++
           registries/_format/uri.md                   | 29 +++++++++++++++++++
           registries/_format/uuid.md                  | 29 +++++++++++++++++++
           registry/format.md                          | 10 ++-----
           31 files changed, 633 insertions(+), 14 deletions(-)
           create mode 100644 registries/_format/duration.md
           create mode 100644 registries/_format/email.md
           create mode 100644 registries/_format/hostname.md
           create mode 100644 registries/_format/idn-email.md
           create mode 100644 registries/_format/idn-hostname.md
           create mode 100644 registries/_format/ipv4.md
           create mode 100644 registries/_format/ipv6.md
           create mode 100644 registries/_format/iri-reference.md
           create mode 100644 registries/_format/iri.md
           create mode 100644 registries/_format/json-pointer.md
           create mode 100644 registries/_format/password.md
           create mode 100644 registries/_format/regex.md
           create mode 100644 registries/_format/relative-json-pointer.md
           create mode 100644 registries/_format/time.md
           create mode 100644 registries/_format/uri-reference.md
           create mode 100644 registries/_format/uri-template.md
           create mode 100644 registries/_format/uri.md
           create mode 100644 registries/_format/uuid.md
          
          diff --git a/registries/_format/binary.md b/registries/_format/binary.md
          index 85508c2c0f..6d63a63f3f 100644
          --- a/registries/_format/binary.md
          +++ b/registries/_format/binary.md
          @@ -4,6 +4,10 @@ issue:
           description: any sequence of octets
           base_type: string
           layout: default
          +deprecated_note: '3.1'
          +remarks: "In OpenAPI 3.1, instead set the media type appropriately and do not use a schema property. Note that only complete HTTP message bodies or complete parts in a multipart media type can accommodate binary data. JSON strings and URL path components cannot."
          +source: https://spec.openapis.org/oas/v3.0.3.html#data-types
          +source_label: OAS
           ---
           
           # {{ page.collection }}
          @@ -12,10 +16,16 @@ layout: default
           
           Base type: `{{ page.base_type }}`.
           
          -The `{{page.slug}}` format represents any sequece of octets. This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0).
          +The `{{page.slug}}` format represents any sequence of octets. This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0).
           
           {% if page.issue %}
           ### GitHub Issue
           
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/byte.md b/registries/_format/byte.md
          index 69533e5327..04e8c49d31 100644
          --- a/registries/_format/byte.md
          +++ b/registries/_format/byte.md
          @@ -1,9 +1,13 @@
           ---
           owner: DarrelMiller
           issue: 
          -description: base64 encoded characters
          +description: base64 encoded data as defined in [RFC4648](https://www.rfc-editor.org/rfc/rfc4648#section-4)
           base_type: string
           layout: default
          +deprecated_note: '3.1'
          +remarks: "In OpenAPI 3.1, instead use [`contentEncoding: base64`](https://json-schema.org/draft/2020-12/json-schema-validation.html#name-contentencoding), optionally alongside [contentMediaType](https://json-schema.org/draft/2020-12/json-schema-validation.html#name-contentmediatype)."
          +source: https://spec.openapis.org/oas/v3.0.3.html#data-types
          +source_label: OAS
           ---
           
           # {{ page.collection }}
          @@ -12,10 +16,16 @@ layout: default
           
           Base type: `{{ page.base_type }}`.
           
          -The `{{page.slug}}` format represents any sequece of octets encoded as a base64 string. This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0).
          +The `{{page.slug}}` format represents any sequence of octets encoded as a base64 string as defined in [RFC4648](https://www.rfc-editor.org/rfc/rfc4648#section-4). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0).
           
           {% if page.issue %}
           ### GitHub Issue
           
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/commonmark.md b/registries/_format/commonmark.md
          index 959b597e2a..5cccd7c593 100644
          --- a/registries/_format/commonmark.md
          +++ b/registries/_format/commonmark.md
          @@ -4,6 +4,8 @@ description: commonmark-formatted text
           base_type: string
           issue:
           layout: default
          +source: https://spec.openapis.org/oas/latest.html#data-types
          +source_label: OAS
           ---
           
           # {{ page.collection }}
          @@ -19,3 +21,9 @@ The `{{page.slug}}` format represents [CommonMark](https://commonmark.org/) form
           
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/date-time.md b/registries/_format/date-time.md
          index 497271b24e..a998aa8007 100644
          --- a/registries/_format/date-time.md
          +++ b/registries/_format/date-time.md
          @@ -1,9 +1,11 @@
           ---
           owner: DarrelMiller
           issue: 
          -description: date and time as defined by date-time - RFC3339
          +description: date and time as defined by date-time - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6)
           base_type: string
           layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-dates-times-and-duration
           ---
           
           # {{ page.collection }}
          @@ -12,10 +14,16 @@ layout: default
           
           Base type: `{{ page.base_type }}`.
           
          -The `{{page.slug}}` format represents a date and time as defined by date-time - [RFC3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339#anchor14one). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0).
          +The `{{page.slug}}` format represents a date and time as defined by date-time - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0).
           
           {% if page.issue %}
           ### GitHub Issue
           
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/date.md b/registries/_format/date.md
          index a1d7345d3b..6aca9e58c0 100644
          --- a/registries/_format/date.md
          +++ b/registries/_format/date.md
          @@ -1,9 +1,11 @@
           ---
           owner: DarrelMiller
           issue: 
          -description: date as defined by full-date - RFC3339
          +description: date as defined by full-date - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6)
           base_type: string
           layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-dates-times-and-duration
           ---
           
           # {{ page.collection }}
          @@ -12,10 +14,16 @@ layout: default
           
           Base type: `{{ page.base_type }}`.
           
          -The `{{page.slug}}` format represents a date as defined by full-date - [RFC3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339#anchor14one). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0).
          +The `{{page.slug}}` format represents a date as defined by full-date - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0).
           
           {% if page.issue %}
           ### GitHub Issue
           
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/double.md b/registries/_format/double.md
          index 417af4c715..915b515d55 100644
          --- a/registries/_format/double.md
          +++ b/registries/_format/double.md
          @@ -4,6 +4,8 @@ issue:
           description: double precision floating point number
           base_type: number
           layout: default
          +source: https://spec.openapis.org/oas/latest.html#data-types
          +source_label: OAS
           ---
           
           # {{ page.collection }}
          @@ -19,3 +21,9 @@ The `{{page.slug}}` format represents a double precision (64bit) floating point
           
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/duration.md b/registries/_format/duration.md
          new file mode 100644
          index 0000000000..e33fe8e942
          --- /dev/null
          +++ b/registries/_format/duration.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue: 
          +description: duration as defined by duration - RFC3339
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-dates-times-and-duration
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format represents a duration as defined by duration - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339.html#appendix-A).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/email.md b/registries/_format/email.md
          new file mode 100644
          index 0000000000..9e3976d32d
          --- /dev/null
          +++ b/registries/_format/email.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: An email address as defined as Mailbox in RFC5321
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-email-addresses
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is an email address as defined as Mailbox in [RFC5321](https://www.rfc-editor.org/rfc/rfc5321).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/float.md b/registries/_format/float.md
          index cbe24fdc7b..9a44e5d1a8 100644
          --- a/registries/_format/float.md
          +++ b/registries/_format/float.md
          @@ -4,6 +4,8 @@ issue:
           description: single precision floating point number
           base_type: number
           layout: default
          +source: https://spec.openapis.org/oas/latest.html#data-types
          +source_label: OAS
           ---
           
           # {{ page.collection }}
          @@ -19,3 +21,9 @@ The `{{page.slug}}` format represents a single precision (32bit) floating point
           
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/hostname.md b/registries/_format/hostname.md
          new file mode 100644
          index 0000000000..f4e237202e
          --- /dev/null
          +++ b/registries/_format/hostname.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: A host name as defined by RFC1123
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-hostnames
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is a host name as defined by [RFC1123](https://www.rfc-editor.org/info/rfc1123).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/html.md b/registries/_format/html.md
          index 49b89db7b0..1103ae48e2 100644
          --- a/registries/_format/html.md
          +++ b/registries/_format/html.md
          @@ -4,6 +4,8 @@ description: HTML-formatted text
           base_type: string
           issue:
           layout: default
          +source: https://spec.openapis.org/oas/latest.html#data-types
          +source_label: OAS
           ---
           
           # {{ page.collection }}
          @@ -19,3 +21,9 @@ The `{{page.slug}}` format represents HTML-formatted text.
           
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/idn-email.md b/registries/_format/idn-email.md
          new file mode 100644
          index 0000000000..f508b3c343
          --- /dev/null
          +++ b/registries/_format/idn-email.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: An email address as defined as Mailbox in RFC6531
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-email-addresses
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is an email address as defined as Mailbox in [RFC6531](https://www.rfc-editor.org/rfc/rfc6531).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/idn-hostname.md b/registries/_format/idn-hostname.md
          new file mode 100644
          index 0000000000..103213a7ec
          --- /dev/null
          +++ b/registries/_format/idn-hostname.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: An internationalized host name as defined by RFC5890
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-hostnames
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is an internationalized host name as defined by [RFC5890](https://www.rfc-editor.org/rfc/rfc5890.html).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/int32.md b/registries/_format/int32.md
          index a22ed98821..c459058867 100644
          --- a/registries/_format/int32.md
          +++ b/registries/_format/int32.md
          @@ -4,6 +4,8 @@ issue:
           description: signed 32-bit integer
           base_type: number
           layout: default
          +source: https://spec.openapis.org/oas/latest.html#data-types
          +source_label: OAS
           ---
           
           # {{ page.collection }}
          @@ -19,3 +21,9 @@ The `{{page.slug}}` format represents a signed 32-bit integer, with the range 
           
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/int64.md b/registries/_format/int64.md
          index 0fd3ebf1fa..9430c7ce4e 100644
          --- a/registries/_format/int64.md
          +++ b/registries/_format/int64.md
          @@ -4,6 +4,8 @@ issue:
           description: signed 64-bit integer
           base_type: number
           layout: default
          +source: https://spec.openapis.org/oas/latest.html#data-types
          +source_label: OAS
           ---
           
           # {{ page.collection }}
          @@ -19,3 +21,9 @@ The `{{page.slug}}` format represents a signed 64-bit integer, with the range -9
           
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/int8.md b/registries/_format/int8.md
          index 38524e7a7b..b07ea1d5b2 100644
          --- a/registries/_format/int8.md
          +++ b/registries/_format/int8.md
          @@ -4,6 +4,8 @@ issue: 845
           description: signed 8-bit integer
           base_type: number
           layout: default
          +source: https://spec.openapis.org/oas/latest.html#data-types
          +source_label: OAS
           ---
           
           # {{ page.collection }}
          @@ -19,3 +21,9 @@ The `{{page.slug}}` format represents a signed 8-bit integer, with the range -12
           
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/ipv4.md b/registries/_format/ipv4.md
          new file mode 100644
          index 0000000000..9609c0c1ce
          --- /dev/null
          +++ b/registries/_format/ipv4.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: An IPv4 address as defined as dotted-quad by RFC2673
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-ip-addresses
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is an IPv4 address as defined as dotted-quad by [RFC2673](https://www.rfc-editor.org/info/rfc2673).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/ipv6.md b/registries/_format/ipv6.md
          new file mode 100644
          index 0000000000..92732de58f
          --- /dev/null
          +++ b/registries/_format/ipv6.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: An IPv6 address as defined by RFC4673
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-ip-addresses
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is an IPv6 address as defined by [RFC4291](https://www.rfc-editor.org/info/rfc4291).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/iri-reference.md b/registries/_format/iri-reference.md
          new file mode 100644
          index 0000000000..605d75bbb5
          --- /dev/null
          +++ b/registries/_format/iri-reference.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: A Internationalized Resource Identifier as defined in RFC3987
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-resource-identifiers
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is a Internationalized Resource Identifier as defined in [RFC3987](https://www.rfc-editor.org/info/rfc3987).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/iri.md b/registries/_format/iri.md
          new file mode 100644
          index 0000000000..605d75bbb5
          --- /dev/null
          +++ b/registries/_format/iri.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: A Internationalized Resource Identifier as defined in RFC3987
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-resource-identifiers
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is a Internationalized Resource Identifier as defined in [RFC3987](https://www.rfc-editor.org/info/rfc3987).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/json-pointer.md b/registries/_format/json-pointer.md
          new file mode 100644
          index 0000000000..4f96a6d020
          --- /dev/null
          +++ b/registries/_format/json-pointer.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: A JSON string representation of a JSON Pointer as defined in RFC6901
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-json-pointers
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is a JSON string representation of a JSON Pointer as defined in [RFC6901](https://www.rfc-editor.org/info/rfc6901).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/password.md b/registries/_format/password.md
          new file mode 100644
          index 0000000000..26216ca175
          --- /dev/null
          +++ b/registries/_format/password.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: a string that hints to UIs to obscure input.
          +base_type: string
          +layout: default
          +source: https://spec.openapis.org/oas/latest.html#data-types
          +source_label: OAS
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is a string that hints to UIs to obscure input.
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          diff --git a/registries/_format/regex.md b/registries/_format/regex.md
          new file mode 100644
          index 0000000000..2c6de3a2ea
          --- /dev/null
          +++ b/registries/_format/regex.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: A regular expression as defined in ECMA-262
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-regex
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is a regular expression as defined in ECMA-262.
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/relative-json-pointer.md b/registries/_format/relative-json-pointer.md
          new file mode 100644
          index 0000000000..c1eb233a97
          --- /dev/null
          +++ b/registries/_format/relative-json-pointer.md
          @@ -0,0 +1,31 @@
          +---
          +owner: baywet
          +issue:
          +description: A JSON string representation of a relative JSON Pointer as defined in draft RFC 01
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-json-pointers
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is a JSON string representation of a relative JSON Pointer as defined in draft RFC 01.
          +
          +[Relative JSON pointers draft RFC 01](https://datatracker.ietf.org/doc/html/draft-handrews-relative-json-pointer-01).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/time.md b/registries/_format/time.md
          new file mode 100644
          index 0000000000..d1291fcf02
          --- /dev/null
          +++ b/registries/_format/time.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue: 
          +description: time as defined by full-time - RFC3339
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-dates-times-and-duration
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format represents a time as defined by full-time - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/uint8.md b/registries/_format/uint8.md
          index e9919ab03c..c9797dd746 100644
          --- a/registries/_format/uint8.md
          +++ b/registries/_format/uint8.md
          @@ -4,6 +4,8 @@ issue: 845
           description: unsigned 8-bit integer
           base_type: number
           layout: default
          +source: https://spec.openapis.org/oas/latest.html#data-types
          +source_label: OAS
           ---
           
           # {{ page.collection }}
          @@ -20,3 +22,8 @@ The `{{page.slug}}` format represents an unsigned 8-bit integer, with the range
           * [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
           {% endif %}
           
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/uri-reference.md b/registries/_format/uri-reference.md
          new file mode 100644
          index 0000000000..aeb939857f
          --- /dev/null
          +++ b/registries/_format/uri-reference.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: A URI reference as defined in [RFC3986](https://www.rfc-editor.org/info/rfc3986)
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-resource-identifiers
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is a URI reference as defined in RFC3986.
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/uri-template.md b/registries/_format/uri-template.md
          new file mode 100644
          index 0000000000..bf256e4cbc
          --- /dev/null
          +++ b/registries/_format/uri-template.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: A URI Template as defined in RFC6570
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-uri-template
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is a URI Template as defined in [RFC6570](https://www.rfc-editor.org/rfc/rfc6570).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/uri.md b/registries/_format/uri.md
          new file mode 100644
          index 0000000000..39199b2dc0
          --- /dev/null
          +++ b/registries/_format/uri.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: A Uniform Resource Identifier as defined in RFC3986
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-resource-identifiers
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is a Uniform Resource Identifier as defined in [RFC3986](https://www.rfc-editor.org/rfc/rfc3986.html).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registries/_format/uuid.md b/registries/_format/uuid.md
          new file mode 100644
          index 0000000000..391843623c
          --- /dev/null
          +++ b/registries/_format/uuid.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: A Universally Unique IDentifier as defined in RFC4122
          +base_type: string
          +layout: default
          +source_label: JSON Schema
          +source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-resource-identifiers
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format a Universally Unique IDentifier as defined in [RFC4122](https://www.rfc-editor.org/rfc/rfc4122).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          diff --git a/registry/format.md b/registry/format.md
          index a23620794e..7f1a9b5f2f 100644
          --- a/registry/format.md
          +++ b/registry/format.md
          @@ -5,18 +5,14 @@ permalink: /registry/format/index.html
           
           # Formats Registry
           
          -## Master Issue
          -
          -* [#845](https://github.com/OAI/OpenAPI-Specification/issues/845)
          -
           ## Contributing
           
           Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value.
           
           ## Values
           
          -|Value|Description|Issue|
          -|---|---|---|
          -{% for value in site.format %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} |
          +|Value|Description|Type|Source|Deprecated|
          +|---|---|----|---|---|----|
          +{% for value in site.format %}| {{ value.slug }} | {{ value.description }} | {{ value.base_type }} | {% if value.source %}{% if value.source_label %}{{value.source_label}}{% else %}Open{% endif %}{% endif %} | {% if value.deprecated_note %}Yes{% else %}No{% endif %} |
           {% endfor %}
           
          
          From 83844b867c8e6504f97d267ffedda405161bb181 Mon Sep 17 00:00:00 2001
          From: Vincent Biret 
          Date: Thu, 16 Mar 2023 09:43:30 -0400
          Subject: [PATCH 032/152]  - adds int16 format (#3186)
          
          * - adds int16 format
          
          * Update registries/_format/int16.md
          ---
           registries/_format/int16.md | 27 +++++++++++++++++++++++++++
           1 file changed, 27 insertions(+)
           create mode 100644 registries/_format/int16.md
          
          diff --git a/registries/_format/int16.md b/registries/_format/int16.md
          new file mode 100644
          index 0000000000..51626b6c41
          --- /dev/null
          +++ b/registries/_format/int16.md
          @@ -0,0 +1,27 @@
          +---
          +owner: DarrelMiller
          +issue: 
          +description: signed 16-bit integer
          +base_type: number
          +layout: default
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format represents a signed 16-bit integer, with the range -32768 through +32767.
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          
          From 660331ffb84e8c7ab915e5130aade2946f34c9e4 Mon Sep 17 00:00:00 2001
          From: Vincent Biret 
          Date: Thu, 16 Mar 2023 09:44:34 -0400
          Subject: [PATCH 033/152] - adds a char format description (#3185)
          
          ---
           registries/_format/char.md | 27 +++++++++++++++++++++++++++
           1 file changed, 27 insertions(+)
           create mode 100644 registries/_format/char.md
          
          diff --git a/registries/_format/char.md b/registries/_format/char.md
          new file mode 100644
          index 0000000000..4ac98e911d
          --- /dev/null
          +++ b/registries/_format/char.md
          @@ -0,0 +1,27 @@
          +---
          +owner: baywet
          +issue:
          +description: A single character
          +base_type: string
          +layout: default
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is a single character.
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          
          From 94c88210f7fe34e54c5655a67e81cc241e790158 Mon Sep 17 00:00:00 2001
          From: Vincent Biret 
          Date: Thu, 16 Mar 2023 09:45:25 -0400
          Subject: [PATCH 034/152] - adds a base64url format description (#3184)
          
          ---
           registries/_format/base64url.md | 29 +++++++++++++++++++++++++++++
           1 file changed, 29 insertions(+)
           create mode 100644 registries/_format/base64url.md
          
          diff --git a/registries/_format/base64url.md b/registries/_format/base64url.md
          new file mode 100644
          index 0000000000..0756f637b0
          --- /dev/null
          +++ b/registries/_format/base64url.md
          @@ -0,0 +1,29 @@
          +---
          +owner: baywet
          +issue:
          +description: Binary data encoded as a url-safe string as defined in [RFC4648](https://www.rfc-editor.org/rfc/rfc4648#section-5)
          +base_type: string
          +layout: default
          +deprecated_note: '3.1'
          +remarks: "When using OpenAPI 3.1 it's recommended not to use this format and instead use [`contentEncoding` with a value of `base64url`](https://json-schema.org/draft/2020-12/json-schema-validation.html#name-contentencoding)."
          +---
          +
          +# {{ page.collection }}
          +
          +## {{ page.slug }} - {{ page.description }}
          +
          +Base type: `{{ page.base_type }}`.
          +
          +The `{{page.slug}}` format is binary data encoded as a url-safe string as defined in [RFC4648](https://www.rfc-editor.org/rfc/rfc4648#section-5).
          +
          +{% if page.issue %}
          +### GitHub Issue
          +
          +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }})
          +{% endif %}
          +
          +{% if page.remarks %}
          +### Remarks
          +
          +{{ page.remarks }}
          +{% endif %}
          \ No newline at end of file
          
          From 003ee43b5acc6b0c8c601b5998cbb682b35ec2e1 Mon Sep 17 00:00:00 2001
          From: "github-actions[bot]"
           <41898282+github-actions[bot]@users.noreply.github.com>
          Date: Thu, 16 Mar 2023 18:30:53 +0000
          Subject: [PATCH 035/152] Update ReSpec versions (#3203)
          
          Signed-off-by: GitHub 
          Co-authored-by: darrelmiller 
          ---
           oas/latest.html | 94 ++++++++++++++++++++++++-------------------------
           oas/v2.0.html   | 62 ++++++++++++++++----------------
           oas/v3.0.0.html | 90 +++++++++++++++++++++++-----------------------
           oas/v3.0.1.html | 88 ++++++++++++++++++++++-----------------------
           oas/v3.0.2.html | 88 ++++++++++++++++++++++-----------------------
           oas/v3.0.3.html | 88 ++++++++++++++++++++++-----------------------
           oas/v3.1.0.html | 94 ++++++++++++++++++++++++-------------------------
           7 files changed, 302 insertions(+), 302 deletions(-)
          
          diff --git a/oas/latest.html b/oas/latest.html
          index 81eeaf5158..cac1eb2671 100644
          --- a/oas/latest.html
          +++ b/oas/latest.html
          @@ -16,13 +16,13 @@
           

          An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

          Definitions

          -

          OpenAPI Document

          +

          OpenAPI Document

          A self-contained or composite resource which defines or describes an API or elements of an API. The OpenAPI document MUST contain at least one paths field, a components field or a webhooks field. An OpenAPI document uses and conforms to the OpenAPI Specification.

          -

          Path Templating

          +

          Path Templating

          Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.

          Each template expression in the path MUST correspond to a path parameter that is included in the Path Item itself and/or in each of the Path Item’s Operations. An exception is if the path item is empty, for example due to ACL constraints, matching path parameters are not required.

          The value for these path parameters MUST NOT contain any unescaped “generic syntax” characters described by [[!RFC3986]]: forward slashes (/), question marks (?), or hashes (#).

          -

          Media Types

          +

          Media Types

          Media type definitions are spread across several resources. The media type definitions SHOULD be in compliance with [[!RFC6838]].

          Some examples of possible media type definitions:

          @@ -38,7 +38,7 @@ application/vnd.github.v3.diff application/vnd.github.v3.patch
          -

          HTTP Status Codes

          +

          HTTP Status Codes

          The HTTP Status Codes are used to indicate the status of the executed operation. The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

          Specification

          @@ -64,10 +64,10 @@
        2. Keys used in YAML maps MUST be limited to a scalar string, as defined by the YAML Failsafe schema ruleset.
        3. Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

          -

          Document Structure

          +

          Document Structure

          An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. In the latter case, Reference Objects and Schema Object $ref keywords are used.

          It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

          -

          Data Types

          +

          Data Types

          Data types in the OAS are based on the types supported by the JSON Schema Specification Draft 2020-12. Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. Models are defined using the Schema Object, which is a superset of JSON Schema Specification Draft 2020-12.

          @@ -110,20 +110,20 @@ -

          Rich Text Formatting

          +

          Rich Text Formatting

          Throughout the specification description fields are noted as supporting CommonMark markdown formatting. Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

          -

          Relative References in URIs

          +

          Relative References in URIs

          Unless specified otherwise, all properties that are URIs MAY be relative references as defined by [[!RFC3986]].

          Relative references, including those in Reference Objects, PathItem Object $ref fields, Link Object operationRef fields and Example Object externalValue fields, are resolved using the referring document as the Base URI according to [[!RFC3986]].

          If a URI contains a fragment identifier, then the fragment should be resolved per the fragment resolution mechanism of the referenced document. If the representation of the referenced document is JSON or YAML, then the fragment identifier SHOULD be interpreted as a JSON-Pointer as per [[!RFC6901]].

          Relative references in Schema Objects, including any that appear as $id values, use the nearest parent $id as a Base URI, as described by JSON Schema Specification Draft 2020-12. If no parent schema contains an $id, then the Base URI MUST be determined according to [[!RFC3986]].

          -

          Relative References in URLs

          +

          Relative References in URLs

          Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. Unless specified otherwise, relative references are resolved using the URLs defined in the Server Object as a Base URL. Note that these themselves MAY be relative to the referring document.

          Schema

          In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

          -

          OpenAPI Object

          +

          OpenAPI Object

          This is the root object of the OpenAPI document.

          Fixed Fields

          @@ -188,7 +188,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Info Object

          +

          Info Object

          The object provides metadata about the API. The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

          Fixed Fields

          @@ -272,7 +272,7 @@ url: https://www.apache.org/licenses/LICENSE-2.0.html version: 1.0.1
          -

          Contact Object

          +

          Contact Object

          Contact information for the exposed API.

          Fixed Fields

          @@ -315,7 +315,7 @@ url:https://www.example.com/supportemail:support@example.com -

          License Object

          +

          License Object

          License information for the exposed API.

          Fixed Fields

          @@ -356,7 +356,7 @@ name:Apache2.0identifier:Apache-2.0 -

          Server Object

          +

          Server Object

          An object representing a Server.

          Fixed Fields

          @@ -471,7 +471,7 @@ # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`default:v2 -

          Server Variable Object

          +

          Server Variable Object

          An object representing a Server Variable for server URL template substitution.

          Fixed Fields

          @@ -501,7 +501,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Components Object

          +

          Components Object

          Holds a set of reusable objects for different aspects of the OAS. All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

          Fixed Fields

          @@ -747,7 +747,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          Paths Object

          +

          Paths Object

          Holds the relative paths to the individual endpoints and their operations. The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to Access Control List (ACL) constraints.

          Patterned Fields

          @@ -823,7 +823,7 @@ items: $ref: '#/components/schemas/pet' -

          Path Item Object

          +

          Path Item Object

          Describes the operations available on a single path. A Path Item MAY be empty, due to ACL constraints. The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

          @@ -986,7 +986,7 @@ type: string style: simple -

          Operation Object

          +

          Operation Object

          Describes a single API operation on a path.

          Fixed Fields

          @@ -1168,7 +1168,7 @@ -write:pets-read:pets -

          External Documentation Object

          +

          External Documentation Object

          Allows referencing an external resource for extended documentation.

          Fixed Fields

          @@ -1204,7 +1204,7 @@ description:Findmoreinfohereurl:https://example.com -

          Parameter Object

          +

          Parameter Object

          Describes a single operation parameter.

          A unique parameter is defined by a combination of a name and location.

          Parameter Locations

          @@ -1319,7 +1319,7 @@
          -

          Style Values

          +

          Style Values

          In order to support common ways of serializing simple parameters, a set of style values are defined.

          @@ -1630,7 +1630,7 @@ long:type:number -

          Request Body Object

          +

          Request Body Object

          Describes a single request body.

          Fixed Fields

          @@ -1762,7 +1762,7 @@ items:type:string -

          Media Type Object

          +

          Media Type Object

          Each Media Type Object provides schema and examples for the media type identified by its key.

          Fixed Fields

          @@ -1975,7 +1975,7 @@ $ref:'#/components/schemas/Address'

          An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

          -

          Encoding Object

          +

          Encoding Object

          A single encoding definition applied to a single schema property.

          Fixed Fields

          @@ -2050,7 +2050,7 @@ schema:type:integer -

          Responses Object

          +

          Responses Object

          A container for the expected responses of an operation. The container maps a HTTP response code to the expected response.

          The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. @@ -2135,7 +2135,7 @@ schema: $ref: '#/components/schemas/ErrorModel' -

          Response Object

          +

          Response Object

          Describes a single response from an API Operation, including design-time, static links to operations based on the response.

          Fixed Fields

          @@ -2282,7 +2282,7 @@
          
           description: object created
           
          -

          Callback Object

          +

          Callback Object

          A map of possible out-of band callbacks related to the parent operation. Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

          @@ -2403,7 +2403,7 @@ '200': description: callback successfully processed -

          Example Object

          +

          Example Object

          Fixed Fields

          @@ -2491,7 +2491,7 @@ confirmation-success:$ref:'#/components/examples/confirmation-success' -

          Link Object

          +

          Link Object

          The Link object represents a possible design-time link for a response. The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

          Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

          @@ -2625,7 +2625,7 @@

          Note that in the use of operationRef, the escaped forward-slash is necessary when using JSON references.

          -

          Runtime Expressions

          +

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          The runtime expression is defined by the following ABNF syntax

          @@ -2650,7 +2650,7 @@

          Here, json-pointer is taken from [[!RFC6901]], char from [[!RFC7159]] and token from [[!RFC7230]].

          The name identifier is case-sensitive, whereas token is not.

          The table below provides examples of runtime expressions and examples of their use in a value:

          -

          Examples

          +

          Examples

          @@ -2699,7 +2699,7 @@

          Runtime expressions preserve the type of the referenced value. Expressions can be embedded into string values by surrounding the expression with {} curly braces.

          -

          Header Object

          +

          Header Object

          The Header Object follows the structure of the Parameter Object with the following changes:

          1. name MUST NOT be specified, it is given in the corresponding headers map.
          2. @@ -2721,7 +2721,7 @@ schema: type: integer -

          Tag Object

          +

          Tag Object

          Adds metadata to a single tag that is used by the Operation Object. It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

          Fixed Fields

          @@ -2763,7 +2763,7 @@ name: pet description: Pets operations -

          Reference Object

          +

          Reference Object

          A simple object to allow referencing other components in the OpenAPI document, internally and externally.

          The $ref string value contains a URI [[!RFC3986]], which identifies the location of the value being referenced.

          See the rules for resolving Relative References.

          @@ -2823,7 +2823,7 @@
          
           $ref: definitions.yaml#/Pet
           
          -

          Schema Object

          +

          Schema Object

          The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is a superset of the JSON Schema Specification Draft 2020-12.

          For more information about the properties, see JSON Schema Core and JSON Schema Validation.

          @@ -2839,7 +2839,7 @@

          In addition to the JSON Schema properties comprising the OAS dialect, the Schema Object supports keywords from any other vocabularies, or entirely arbitrary properties.

          The OpenAPI Specification’s base vocabulary is comprised of the following keywords:

          -

          Fixed Fields

          +

          Fixed Fields

          @@ -2872,7 +2872,7 @@

          This object MAY be extended with Specification Extensions, though as noted, additional properties MAY omit the x- prefix within this object.

          -
          Composition and Inheritance (Polymorphism)
          +

          Composition and Inheritance (Polymorphism)

          The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. allOf takes an array of object definitions that are validated independently but together compose a single object.

          While composition offers model extensibility, it does not imply a hierarchy between the models. @@ -3198,7 +3198,7 @@ required: - packSize -

          Discriminator Object

          +

          Discriminator Object

          When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the document of an alternative schema based on the value associated with it.

          When using the discriminator, inline schemas will not be considered.

          Fixed Fields

          @@ -3323,7 +3323,7 @@ }

          will map to Dog because of the definition in the mapping element.

          -

          XML Object

          +

          XML Object

          A metadata object that allows for more fine-tuned XML model definitions.

          When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. See examples for expected behavior.

          @@ -3654,7 +3654,7 @@ <aliens>value</aliens> </aliens> -

          Security Scheme Object

          +

          Security Scheme Object

          Defines a security scheme that can be used by the operations.

          Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), mutual TLS (use of a client certificate), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and OpenID Connect Discovery. Please note that as of 2020, the implicit flow is about to be deprecated by OAuth 2.0 Security Best Current Practice. Recommended for most use case is Authorization Code Grant flow with PKCE.

          @@ -3782,7 +3782,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          OAuth Flows Object

          +

          OAuth Flows Object

          Allows configuration of the supported OAuth Flows.

          Fixed Fields

          @@ -3817,7 +3817,7 @@

          This object MAY be extended with Specification Extensions.

          -

          OAuth Flow Object

          +

          OAuth Flow Object

          Configuration details for a supported OAuth Flow

          Fixed Fields

          @@ -3895,7 +3895,7 @@ write:pets:modifypetsinyouraccountread:pets:readyourpets -

          Security Requirement Object

          +

          Security Requirement Object

          Lists the required security schemes to execute this operation. The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

          Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. @@ -3964,7 +3964,7 @@ - write:pets - read:pets -

          Specification Extensions

          +

          Specification Extensions

          While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          The extensions properties are implemented as patterned fields that are always prefixed by "x-".

          @@ -3984,7 +3984,7 @@

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          -

          Security Filtering

          +

          Security Filtering

          Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

          The reasoning is to allow an additional layer of access control over the documentation. While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

          @@ -3993,7 +3993,7 @@
        4. The Paths Object MAY be present but empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They would still have access to at least the Info Object which may contain additional information regarding authentication.
        5. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the Paths Object, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
        6. -

          Appendix A: Revision History

          +

          Appendix A: Revision History

          diff --git a/oas/v2.0.html b/oas/v2.0.html index cfb1c5c857..a9773948e3 100644 --- a/oas/v2.0.html +++ b/oas/v2.0.html @@ -48,9 +48,9 @@

          Definitions

          -

          Path Templating

          +

          Path Templating

          Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

          -

          Mime Types

          +

          Mime Types

          Mime type definitions are spread across several resources. The mime type definitions should be in compliance with [[!RFC6838]].

          Some examples of possible mime type definitions:

          
          @@ -65,7 +65,7 @@
             application/vnd.github.v3.diff
             application/vnd.github.v3.patch
           
          -

          HTTP Status Codes

          +

          HTTP Status Codes

          The HTTP Status Codes are used to indicate the status of the executed operation. The available status codes are described by [[!RFC7231]] and in the IANA Status Code Registry.

          Specification

          Format

          @@ -166,7 +166,7 @@

          Schema

          -

          Swagger Object

          +

          Swagger Object

          This is the root document object for the API specification. It combines what previously was the Resource Listing and API Declaration (version 1.2 and earlier) together into one document.

          Fixed Fields

          @@ -272,7 +272,7 @@
          -

          Info Object

          +

          Info Object

          The object provides metadata about the API. The metadata can be used by the clients if needed, and can be presented in the Swagger-UI for convenience.

          Fixed Fields

          @@ -364,7 +364,7 @@ url:http://www.apache.org/licenses/LICENSE-2.0.htmlversion:1.0.1 -

          Contact Object

          +

          Contact Object

          Contact information for the exposed API.

          Fixed Fields

          @@ -423,7 +423,7 @@ url:http://www.swagger.io/supportemail:support@swagger.io -

          License Object

          +

          License Object

          License information for the exposed API.

          Fixed Fields

          @@ -475,7 +475,7 @@ name:Apache2.0url:http://www.apache.org/licenses/LICENSE-2.0.html -

          Paths Object

          +

          Paths Object

          Holds the relative paths to the individual endpoints. The path is appended to the basePath in order to construct the full URL. The Paths may be empty, due to ACL constraints.

          Patterned Fields

          @@ -538,7 +538,7 @@ items: $ref: '#/definitions/pet' -

          Path Item Object

          +

          Path Item Object

          Describes the operations available on a single path. A Path Item may be empty, due to ACL constraints. The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

          Fixed Fields

          @@ -688,7 +688,7 @@ type: string collectionFormat: csv -

          Operation Object

          +

          Operation Object

          Describes a single API operation on a path.

          Fixed Fields

          @@ -873,7 +873,7 @@ -write:pets-read:pets -

          External Documentation Object

          +

          External Documentation Object

          Allows referencing an external resource for extended documentation.

          Fixed Fields

          @@ -925,7 +925,7 @@ description:Findmoreinfohereurl:https://swagger.io -

          Parameter Object

          +

          Parameter Object

          Describes a single operation parameter.

          A unique parameter is defined by a combination of a name and location.

          There are five possible parameter types.

          @@ -1241,7 +1241,7 @@ required: true type: file -

          Items Object

          +

          Items Object

          A limited subset of JSON-Schema’s items object. It is used by parameter definitions that are not located in "body".

          Fixed Fields

          @@ -1387,7 +1387,7 @@ minimum:0maximum:63 -

          Responses Object

          +

          Responses Object

          A container for the expected responses of an operation. The container maps a HTTP response code to the expected response. It is not expected from the documentation to necessarily cover all possible HTTP response codes, since they may not be known in advance. However, it is expected from the documentation to cover a successful operation response and any known errors.

          The default can be used as the default response object for all HTTP codes that are not covered individually by the specification.

          The Responses Object MUST contain at least one response code, and it SHOULD be the response for a successful operation call.

          @@ -1458,7 +1458,7 @@ schema: $ref: '#/definitions/ErrorModel' -

          Response Object

          +

          Response Object

          Describes a single response from an API Operation.

          Fixed Fields

          @@ -1590,7 +1590,7 @@
          
           description: object created
           
          -

          Headers Object

          +

          Headers Object

          Lists the headers that can be sent as part of a response.

          Patterned Fields

          @@ -1638,7 +1638,7 @@ description:Thenumberofsecondsleftinthecurrentperiodtype:integer -

          Example Object

          +

          Example Object

          Allows sharing examples for operation responses.

          Patterned Fields

          @@ -1678,7 +1678,7 @@ gender:Femalebreed:Mixed -

          Header Object

          +

          Header Object

          @@ -1809,7 +1809,7 @@ description:Thenumberofallowedrequestsinthecurrentperiodtype:integer -

          Tag Object

          +

          Tag Object

          Allows adding meta data to a single tag that is used by the Operation Object. It is not mandatory to have a Tag Object per tag used there.

          Fixed Fields

          @@ -1866,7 +1866,7 @@ name:petdescription:Petsoperations -

          Reference Object

          +

          Reference Object

          A simple object to allow referencing other definitions in the specification. It can be used to reference parameters and responses that are defined at the top level for reuse.

          The Reference Object is a JSON Reference that uses a JSON Pointer as its value. For this specification, only canonical dereferencing is supported.

          Fixed Fields

          @@ -1913,7 +1913,7 @@
          
           $ref: 'definitions.yaml#/Pet'
           
          -

          Schema Object

          +

          Schema Object

          The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is based on the JSON Schema Specification Draft 4 and uses a predefined subset of it. On top of this subset, there are extensions provided by this specification to allow for more complete documentation.

          Further information about the properties can be found in JSON Schema Core and JSON Schema Validation. Unless stated otherwise, the property definitions follow the JSON Schema specification as referenced here.

          The following properties are taken directly from the JSON Schema definition and follow the same specifications:

          @@ -2305,7 +2305,7 @@ required: - packSize -

          XML Object

          +

          XML Object

          A metadata object that allows for more fine-tuned XML model definitions.

          When using arrays, XML element names are not inferred (for singular/plural forms) and the name property should be used to add that information. See examples for expected behavior.

          Fixed Fields

          @@ -2651,7 +2651,7 @@ <aliens>value</aliens> </aliens> -

          Definitions Object

          +

          Definitions Object

          An object to hold data types that can be consumed and produced by operations. These data types can be primitives, arrays or models.

          Patterned Fields

          @@ -2717,7 +2717,7 @@ name:type:string -

          Parameters Definitions Object

          +

          Parameters Definitions Object

          An object to hold parameters to be reused across operations. Parameter definitions can be referenced to the ones defined here.

          This does not define global operation parameters.

          Patterned Fields

          @@ -2774,7 +2774,7 @@ type: integer format: int32 -

          Responses Definitions Object

          +

          Responses Definitions Object

          An object to hold responses to be reused across operations. Response definitions can be referenced to the ones defined here.

          This does not define global operation responses.

          Patterned Fields

          @@ -2821,7 +2821,7 @@ schema: $ref: '#/definitions/GeneralError' -

          Security Definitions Object

          +

          Security Definitions Object

          A declaration of the security schemes available to be used in the specification. This does not enforce the security schemes on the operations and only serves to provide the relevant details for each scheme.

          Patterned Fields

          @@ -2872,7 +2872,7 @@ write:pets:modifypetsinyouraccountread:pets:readyourpets -

          Security Scheme Object

          +

          Security Scheme Object

          Allows the definition of a security scheme that can be used by the operations. Supported schemes are basic authentication, an API key (either as a header or as a query parameter) and OAuth2’s common flows (implicit, password, application and access code).

          Fixed Fields

          @@ -2995,7 +2995,7 @@ write:pets:modifypetsinyouraccountread:pets:readyourpets -

          Scopes Object

          +

          Scopes Object

          Lists the available scopes for an OAuth2 security scheme.

          Patterned Fields

          @@ -3042,7 +3042,7 @@ write:pets:modifypetsinyouraccountread:pets:readyourpets -

          Security Requirement Object

          +

          Security Requirement Object

          Lists the required security schemes to execute this operation. The object can have multiple security schemes declared in it which are all required (that is, there is a logical AND between the schemes).

          The name used for each property MUST correspond to a security scheme declared in the Security Definitions.

          Patterned Fields

          @@ -3086,11 +3086,11 @@ - write:pets - read:pets -

          Specification Extensions

          +

          Specification Extensions

          While the Swagger Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          The extensions properties are always prefixed by "x-" and can have any valid JSON format value.

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          -

          Security Filtering

          +

          Security Filtering

          Some objects in the Swagger specification may be declared and remain empty, or completely be removed, even though they are inherently the core of the API documentation.

          The reasoning behind it is to allow an additional layer of access control over the documentation itself. While not part of the specification itself, certain libraries may choose to allow access to parts of the documentation based on some form of authentication/authorization.

          Two examples for this:

          diff --git a/oas/v3.0.0.html b/oas/v3.0.0.html index 166c317e1a..a0026543b5 100644 --- a/oas/v3.0.0.html +++ b/oas/v3.0.0.html @@ -16,11 +16,11 @@

          An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

          Definitions

          -

          OpenAPI Document

          +

          OpenAPI Document

          A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

          -

          Path Templating

          +

          Path Templating

          Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

          -

          Media Types

          +

          Media Types

          Media type definitions are spread across several resources. The media type definitions SHOULD be in compliance with [[!RFC6838]].

          Some examples of possible media type definitions:

          @@ -36,7 +36,7 @@ application/vnd.github.v3.diff application/vnd.github.v3.patch -

          HTTP Status Codes

          +

          HTTP Status Codes

          The HTTP Status Codes are used to indicate the status of the executed operation. The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

          Specification

          @@ -62,10 +62,10 @@
        7. Keys used in YAML maps MUST be limited to a scalar string, as defined by the YAML Failsafe schema ruleset.
        8. Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

          -

          Document Structure

          +

          Document Structure

          An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

          It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

          -

          Data Types

          +

          Data Types

          Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. null is not supported as a type (see nullable for an alternative solution). @@ -154,16 +154,16 @@

          -

          Rich Text Formatting

          +

          Rich Text Formatting

          Throughout the specification description fields are noted as supporting CommonMark markdown formatting. Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

          -

          Relative References in URLs

          +

          Relative References in URLs

          Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. Relative references are resolved using the URLs defined in the Server Object as a Base URI.

          Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

          Schema

          In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

          -

          OpenAPI Object

          +

          OpenAPI Object

          This is the root document object of the OpenAPI document.

          Fixed Fields

          @@ -218,7 +218,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Info Object

          +

          Info Object

          The object provides metadata about the API. The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

          Fixed Fields

          @@ -295,7 +295,7 @@ url: http://www.apache.org/licenses/LICENSE-2.0.html version: 1.0.1 -

          Contact Object

          +

          Contact Object

          Contact information for the exposed API.

          Fixed Fields

          @@ -338,7 +338,7 @@ url:http://www.example.com/supportemail:support@example.com -

          License Object

          +

          License Object

          License information for the exposed API.

          Fixed Fields

          @@ -374,7 +374,7 @@ name:Apache2.0url:http://www.apache.org/licenses/LICENSE-2.0.html -

          Server Object

          +

          Server Object

          An object representing a Server.

          Fixed Fields

          @@ -489,7 +489,7 @@ # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`default:v2 -

          Server Variable Object

          +

          Server Variable Object

          An object representing a Server Variable for server URL template substitution.

          Fixed Fields

          @@ -519,7 +519,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Components Object

          +

          Components Object

          Holds a set of reusable objects for different aspects of the OAS. All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

          Fixed Fields

          @@ -740,7 +740,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          Paths Object

          +

          Paths Object

          Holds the relative paths to the individual endpoints and their operations. The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

          Patterned Fields

          @@ -816,7 +816,7 @@ items: $ref: '#/components/schemas/pet' -

          Path Item Object

          +

          Path Item Object

          Describes the operations available on a single path. A Path Item MAY be empty, due to ACL constraints. The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

          @@ -979,7 +979,7 @@ items: type: string -

          Operation Object

          +

          Operation Object

          Describes a single API operation on a path.

          Fixed Fields

          @@ -1160,7 +1160,7 @@ -write:pets-read:pets -

          External Documentation Object

          +

          External Documentation Object

          Allows referencing an external resource for extended documentation.

          Fixed Fields

          @@ -1196,7 +1196,7 @@ description:Findmoreinfohereurl:https://example.com -

          Parameter Object

          +

          Parameter Object

          Describes a single operation parameter.

          A unique parameter is defined by a combination of a name and location.

          Parameter Locations

          @@ -1622,7 +1622,7 @@ long: type: number -

          Request Body Object

          +

          Request Body Object

          Describes a single request body.

          Fixed Fields

          @@ -1753,7 +1753,7 @@ items:type:string -

          Media Type Object

          +

          Media Type Object

          Each Media Type Object provides schema and examples for the media type identified by its key.

          Fixed Fields

          @@ -1963,7 +1963,7 @@ type:'#/components/schemas/Address'

          An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

          -

          Encoding Object

          +

          Encoding Object

          A single encoding definition applied to a single schema property.

          Fixed Fields

          @@ -2041,7 +2041,7 @@ schema:type:integer -

          Responses Object

          +

          Responses Object

          A container for the expected responses of an operation. The container maps a HTTP response code to the expected response.

          The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. @@ -2125,7 +2125,7 @@ schema: $ref: '#/components/schemas/ErrorModel' -

          Response Object

          +

          Response Object

          Describes a single response from an API Operation, including design-time, static links to operations based on the response.

          Fixed Fields

          @@ -2271,7 +2271,7 @@
          
           description: object created
           
          -

          Callback Object

          +

          Callback Object

          A map of possible out-of band callbacks related to the parent operation. Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

          @@ -2376,7 +2376,7 @@ '200': description: webhook successfully processed and no retries will be performed -

          Example Object

          +

          Example Object

          Fixed Fields

          @@ -2472,7 +2472,7 @@ confirmation-success:$ref:'#/components/examples/confirmation-success' -

          Link Object

          +

          Link Object

          The Link object represents a possible design-time link for a response. The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

          Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

          @@ -2606,7 +2606,7 @@

          Note that in the use of operationRef, the escaped forward-slash is necessary when using JSON references.

          -

          Runtime Expressions

          +

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          The runtime expression is defined by the following ABNF syntax

          @@ -2624,7 +2624,7 @@

          The name identifier is case-sensitive, whereas token is not.

          The table below provides examples of runtime expressions and examples of their use in a value:

          -

          Examples

          +

          Examples

          @@ -2673,7 +2673,7 @@

          Runtime expressions preserve the type of the referenced value. Expressions can be embedded into string values by surrounding the expression with {} curly braces.

          -

          Header Object

          +

          Header Object

          The Header Object follows the structure of the Parameter Object with the following changes:

          1. name MUST NOT be specified, it is given in the corresponding headers map.
          2. @@ -2695,7 +2695,7 @@ schema: type: integer -

          Tag Object

          +

          Tag Object

          Adds metadata to a single tag that is used by the Operation Object. It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

          Fixed Fields

          @@ -2737,7 +2737,7 @@ name: pet description: Pets operations -

          Examples Object

          +

          Examples Object

          In an example, a JSON Reference MAY be used, with the explicit restriction that examples having a JSON format with object named $ref are not allowed. Therefore, that example, structurally, can be @@ -2796,7 +2796,7 @@ example: $ref: http://foo.bar#/examples/address-example.json -

          Reference Object

          +

          Reference Object

          A simple object to allow referencing other components in the specification, internally and externally.

          The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

          For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

          @@ -2845,7 +2845,7 @@
          
           $ref: definitions.yaml#/Pet
           
          -

          Schema Object

          +

          Schema Object

          The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is an extended subset of the JSON Schema Specification Wright Draft 00.

          @@ -2941,7 +2941,7 @@

          This object MAY be extended with Specification Extensions.

          -
          Composition and Inheritance (Polymorphism)
          +

          Composition and Inheritance (Polymorphism)

          The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. allOf takes an array of object definitions that are validated independently but together compose a single object.

          While composition offers model extensibility, it does not imply a hierarchy between the models. @@ -3262,7 +3262,7 @@ required: - packSize -

          Discriminator Object

          +

          Discriminator Object

          When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

          When using the discriminator, inline schemas will not be considered.

          Fixed Fields

          @@ -3386,7 +3386,7 @@ }

          will map to Dog because of the definition in the mappings element.

          -

          XML Object

          +

          XML Object

          A metadata object that allows for more fine-tuned XML model definitions.

          When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. See examples for expected behavior.

          @@ -3717,7 +3717,7 @@ <aliens>value</aliens> </aliens> -

          Security Scheme Object

          +

          Security Scheme Object

          Defines a security scheme that can be used by the operations. Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

          Fixed Fields

          @@ -3844,7 +3844,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          OAuth Flows Object

          +

          OAuth Flows Object

          Allows configuration of the supported OAuth Flows.

          Fixed Fields

          @@ -3879,7 +3879,7 @@

          This object MAY be extended with Specification Extensions.

          -

          OAuth Flow Object

          +

          OAuth Flow Object

          Configuration details for a supported OAuth Flow

          Fixed Fields

          @@ -3957,7 +3957,7 @@ write:pets:modifypetsinyouraccountread:pets:readyourpets -

          Security Requirement Object

          +

          Security Requirement Object

          Lists the required security schemes to execute this operation. The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

          Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. @@ -4004,7 +4004,7 @@ - write:pets - read:pets -

          Specification Extensions

          +

          Specification Extensions

          While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          The extensions properties are implemented as patterned fields that are always prefixed by "x-".

          @@ -4024,7 +4024,7 @@

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          -

          Security Filtering

          +

          Security Filtering

          Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

          The reasoning is to allow an additional layer of access control over the documentation. While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

          @@ -4033,7 +4033,7 @@
        9. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
        10. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the Paths Object, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
        11. -

          Appendix A: Revision History

          +

          Appendix A: Revision History

          diff --git a/oas/v3.0.1.html b/oas/v3.0.1.html index 10c2fadc87..48a4354fd3 100644 --- a/oas/v3.0.1.html +++ b/oas/v3.0.1.html @@ -16,11 +16,11 @@

          An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

          Definitions

          -

          OpenAPI Document

          +

          OpenAPI Document

          A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

          -

          Path Templating

          +

          Path Templating

          Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

          -

          Media Types

          +

          Media Types

          Media type definitions are spread across several resources. The media type definitions SHOULD be in compliance with [[!RFC6838]].

          Some examples of possible media type definitions:

          @@ -36,7 +36,7 @@ application/vnd.github.v3.diff application/vnd.github.v3.patch -

          HTTP Status Codes

          +

          HTTP Status Codes

          The HTTP Status Codes are used to indicate the status of the executed operation. The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

          Specification

          @@ -62,10 +62,10 @@
        12. Keys used in YAML maps MUST be limited to a scalar string, as defined by the YAML Failsafe schema ruleset.
        13. Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

          -

          Document Structure

          +

          Document Structure

          An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

          It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

          -

          Data Types

          +

          Data Types

          Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. null is not supported as a type (see nullable for an alternative solution). @@ -154,16 +154,16 @@

          -

          Rich Text Formatting

          +

          Rich Text Formatting

          Throughout the specification description fields are noted as supporting CommonMark markdown formatting. Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

          -

          Relative References in URLs

          +

          Relative References in URLs

          Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. Relative references are resolved using the URLs defined in the Server Object as a Base URI.

          Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

          Schema

          In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

          -

          OpenAPI Object

          +

          OpenAPI Object

          This is the root document object of the OpenAPI document.

          Fixed Fields

          @@ -218,7 +218,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Info Object

          +

          Info Object

          The object provides metadata about the API. The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

          Fixed Fields

          @@ -295,7 +295,7 @@ url: https://www.apache.org/licenses/LICENSE-2.0.html version: 1.0.1 -

          Contact Object

          +

          Contact Object

          Contact information for the exposed API.

          Fixed Fields

          @@ -338,7 +338,7 @@ url:http://www.example.com/supportemail:support@example.com -

          License Object

          +

          License Object

          License information for the exposed API.

          Fixed Fields

          @@ -374,7 +374,7 @@ name:Apache2.0url:https://www.apache.org/licenses/LICENSE-2.0.html -

          Server Object

          +

          Server Object

          An object representing a Server.

          Fixed Fields

          @@ -489,7 +489,7 @@ # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`default:v2 -

          Server Variable Object

          +

          Server Variable Object

          An object representing a Server Variable for server URL template substitution.

          Fixed Fields

          @@ -519,7 +519,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Components Object

          +

          Components Object

          Holds a set of reusable objects for different aspects of the OAS. All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

          Fixed Fields

          @@ -740,7 +740,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          Paths Object

          +

          Paths Object

          Holds the relative paths to the individual endpoints and their operations. The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

          Patterned Fields

          @@ -816,7 +816,7 @@ items: $ref: '#/components/schemas/pet' -

          Path Item Object

          +

          Path Item Object

          Describes the operations available on a single path. A Path Item MAY be empty, due to ACL constraints. The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

          @@ -979,7 +979,7 @@ items: type: string -

          Operation Object

          +

          Operation Object

          Describes a single API operation on a path.

          Fixed Fields

          @@ -1160,7 +1160,7 @@ -write:pets-read:pets -

          External Documentation Object

          +

          External Documentation Object

          Allows referencing an external resource for extended documentation.

          Fixed Fields

          @@ -1196,7 +1196,7 @@ description:Findmoreinfohereurl:https://example.com -

          Parameter Object

          +

          Parameter Object

          Describes a single operation parameter.

          A unique parameter is defined by a combination of a name and location.

          Parameter Locations

          @@ -1622,7 +1622,7 @@ long: type: number -

          Request Body Object

          +

          Request Body Object

          Describes a single request body.

          Fixed Fields

          @@ -1753,7 +1753,7 @@ items:type:string -

          Media Type Object

          +

          Media Type Object

          Each Media Type Object provides schema and examples for the media type identified by its key.

          Fixed Fields

          @@ -1963,7 +1963,7 @@ type:'#/components/schemas/Address'

          An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

          -

          Encoding Object

          +

          Encoding Object

          A single encoding definition applied to a single schema property.

          Fixed Fields

          @@ -2041,7 +2041,7 @@ schema:type:integer -

          Responses Object

          +

          Responses Object

          A container for the expected responses of an operation. The container maps a HTTP response code to the expected response.

          The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. @@ -2125,7 +2125,7 @@ schema: $ref: '#/components/schemas/ErrorModel' -

          Response Object

          +

          Response Object

          Describes a single response from an API Operation, including design-time, static links to operations based on the response.

          Fixed Fields

          @@ -2271,7 +2271,7 @@
          
           description: object created
           
          -

          Callback Object

          +

          Callback Object

          A map of possible out-of band callbacks related to the parent operation. Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

          @@ -2376,7 +2376,7 @@ '200': description: webhook successfully processed and no retries will be performed -

          Example Object

          +

          Example Object

          Fixed Fields

          @@ -2472,7 +2472,7 @@ confirmation-success:$ref:'#/components/examples/confirmation-success' -

          Link Object

          +

          Link Object

          The Link object represents a possible design-time link for a response. The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

          Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

          @@ -2606,7 +2606,7 @@

          Note that in the use of operationRef, the escaped forward-slash is necessary when using JSON references.

          -

          Runtime Expressions

          +

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          The runtime expression is defined by the following ABNF syntax

          @@ -2624,7 +2624,7 @@

          The name identifier is case-sensitive, whereas token is not.

          The table below provides examples of runtime expressions and examples of their use in a value:

          -

          Examples

          +

          Examples

          @@ -2673,7 +2673,7 @@

          Runtime expressions preserve the type of the referenced value. Expressions can be embedded into string values by surrounding the expression with {} curly braces.

          -

          Header Object

          +

          Header Object

          The Header Object follows the structure of the Parameter Object with the following changes:

          1. name MUST NOT be specified, it is given in the corresponding headers map.
          2. @@ -2695,7 +2695,7 @@ schema: type: integer -

          Tag Object

          +

          Tag Object

          Adds metadata to a single tag that is used by the Operation Object. It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

          Fixed Fields

          @@ -2737,7 +2737,7 @@ name: pet description: Pets operations -

          Reference Object

          +

          Reference Object

          A simple object to allow referencing other components in the specification, internally and externally.

          The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

          For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

          @@ -2786,7 +2786,7 @@
          
           $ref: definitions.yaml#/Pet
           
          -

          Schema Object

          +

          Schema Object

          The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is an extended subset of the JSON Schema Specification Wright Draft 00.

          @@ -2882,7 +2882,7 @@

          This object MAY be extended with Specification Extensions.

          -
          Composition and Inheritance (Polymorphism)
          +

          Composition and Inheritance (Polymorphism)

          The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. allOf takes an array of object definitions that are validated independently but together compose a single object.

          While composition offers model extensibility, it does not imply a hierarchy between the models. @@ -3203,7 +3203,7 @@ required: - packSize -

          Discriminator Object

          +

          Discriminator Object

          When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

          When using the discriminator, inline schemas will not be considered.

          Fixed Fields

          @@ -3327,7 +3327,7 @@ }

          will map to Dog because of the definition in the mappings element.

          -

          XML Object

          +

          XML Object

          A metadata object that allows for more fine-tuned XML model definitions.

          When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. See examples for expected behavior.

          @@ -3658,7 +3658,7 @@ <aliens>value</aliens> </aliens> -

          Security Scheme Object

          +

          Security Scheme Object

          Defines a security scheme that can be used by the operations. Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

          Fixed Fields

          @@ -3785,7 +3785,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          OAuth Flows Object

          +

          OAuth Flows Object

          Allows configuration of the supported OAuth Flows.

          Fixed Fields

          @@ -3820,7 +3820,7 @@

          This object MAY be extended with Specification Extensions.

          -

          OAuth Flow Object

          +

          OAuth Flow Object

          Configuration details for a supported OAuth Flow

          Fixed Fields

          @@ -3898,7 +3898,7 @@ write:pets:modifypetsinyouraccountread:pets:readyourpets -

          Security Requirement Object

          +

          Security Requirement Object

          Lists the required security schemes to execute this operation. The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

          Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. @@ -3945,7 +3945,7 @@ - write:pets - read:pets -

          Specification Extensions

          +

          Specification Extensions

          While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          The extensions properties are implemented as patterned fields that are always prefixed by "x-".

          @@ -3965,7 +3965,7 @@

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          -

          Security Filtering

          +

          Security Filtering

          Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

          The reasoning is to allow an additional layer of access control over the documentation. While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

          @@ -3974,7 +3974,7 @@
        14. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
        15. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the Paths Object, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
        16. -

          Appendix A: Revision History

          +

          Appendix A: Revision History

          diff --git a/oas/v3.0.2.html b/oas/v3.0.2.html index b460bc63f8..c6734bd417 100644 --- a/oas/v3.0.2.html +++ b/oas/v3.0.2.html @@ -16,11 +16,11 @@

          An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

          Definitions

          -

          OpenAPI Document

          +

          OpenAPI Document

          A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

          -

          Path Templating

          +

          Path Templating

          Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

          -

          Media Types

          +

          Media Types

          Media type definitions are spread across several resources. The media type definitions SHOULD be in compliance with [[!RFC6838]].

          Some examples of possible media type definitions:

          @@ -36,7 +36,7 @@ application/vnd.github.v3.diff application/vnd.github.v3.patch -

          HTTP Status Codes

          +

          HTTP Status Codes

          The HTTP Status Codes are used to indicate the status of the executed operation. The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

          Specification

          @@ -63,10 +63,10 @@
        17. Keys used in YAML maps MUST be limited to a scalar string, as defined by the YAML Failsafe schema ruleset.
        18. Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

          -

          Document Structure

          +

          Document Structure

          An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

          It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

          -

          Data Types

          +

          Data Types

          Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. null is not supported as a type (see nullable for an alternative solution). @@ -143,16 +143,16 @@

          -

          Rich Text Formatting

          +

          Rich Text Formatting

          Throughout the specification description fields are noted as supporting CommonMark markdown formatting. Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

          -

          Relative References in URLs

          +

          Relative References in URLs

          Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. Relative references are resolved using the URLs defined in the Server Object as a Base URI.

          Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

          Schema

          In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

          -

          OpenAPI Object

          +

          OpenAPI Object

          This is the root document object of the OpenAPI document.

          Fixed Fields

          @@ -207,7 +207,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Info Object

          +

          Info Object

          The object provides metadata about the API. The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

          Fixed Fields

          @@ -284,7 +284,7 @@ url: https://www.apache.org/licenses/LICENSE-2.0.html version: 1.0.1 -

          Contact Object

          +

          Contact Object

          Contact information for the exposed API.

          Fixed Fields

          @@ -327,7 +327,7 @@ url:http://www.example.com/supportemail:support@example.com -

          License Object

          +

          License Object

          License information for the exposed API.

          Fixed Fields

          @@ -363,7 +363,7 @@ name:Apache2.0url:https://www.apache.org/licenses/LICENSE-2.0.html -

          Server Object

          +

          Server Object

          An object representing a Server.

          Fixed Fields

          @@ -478,7 +478,7 @@ # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`default:v2 -

          Server Variable Object

          +

          Server Variable Object

          An object representing a Server Variable for server URL template substitution.

          Fixed Fields

          @@ -508,7 +508,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Components Object

          +

          Components Object

          Holds a set of reusable objects for different aspects of the OAS. All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

          Fixed Fields

          @@ -749,7 +749,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          Paths Object

          +

          Paths Object

          Holds the relative paths to the individual endpoints and their operations. The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

          Patterned Fields

          @@ -825,7 +825,7 @@ items: $ref: '#/components/schemas/pet' -

          Path Item Object

          +

          Path Item Object

          Describes the operations available on a single path. A Path Item MAY be empty, due to ACL constraints. The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

          @@ -988,7 +988,7 @@ items: type: string -

          Operation Object

          +

          Operation Object

          Describes a single API operation on a path.

          Fixed Fields

          @@ -1169,7 +1169,7 @@ -write:pets-read:pets -

          External Documentation Object

          +

          External Documentation Object

          Allows referencing an external resource for extended documentation.

          Fixed Fields

          @@ -1205,7 +1205,7 @@ description:Findmoreinfohereurl:https://example.com -

          Parameter Object

          +

          Parameter Object

          Describes a single operation parameter.

          A unique parameter is defined by a combination of a name and location.

          Parameter Locations

          @@ -1631,7 +1631,7 @@ long: type: number -

          Request Body Object

          +

          Request Body Object

          Describes a single request body.

          Fixed Fields

          @@ -1762,7 +1762,7 @@ items:type:string -

          Media Type Object

          +

          Media Type Object

          Each Media Type Object provides schema and examples for the media type identified by its key.

          Fixed Fields

          @@ -1972,7 +1972,7 @@ type:'#/components/schemas/Address'

          An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

          -

          Encoding Object

          +

          Encoding Object

          A single encoding definition applied to a single schema property.

          Fixed Fields

          @@ -2050,7 +2050,7 @@ schema:type:integer -

          Responses Object

          +

          Responses Object

          A container for the expected responses of an operation. The container maps a HTTP response code to the expected response.

          The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. @@ -2134,7 +2134,7 @@ schema: $ref: '#/components/schemas/ErrorModel' -

          Response Object

          +

          Response Object

          Describes a single response from an API Operation, including design-time, static links to operations based on the response.

          Fixed Fields

          @@ -2280,7 +2280,7 @@
          
           description: object created
           
          -

          Callback Object

          +

          Callback Object

          A map of possible out-of band callbacks related to the parent operation. Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

          @@ -2385,7 +2385,7 @@ '200': description: webhook successfully processed and no retries will be performed -

          Example Object

          +

          Example Object

          Fixed Fields

          @@ -2483,7 +2483,7 @@ confirmation-success:$ref:'#/components/examples/confirmation-success' -

          Link Object

          +

          Link Object

          The Link object represents a possible design-time link for a response. The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

          Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

          @@ -2617,7 +2617,7 @@

          Note that in the use of operationRef, the escaped forward-slash is necessary when using JSON references.

          -

          Runtime Expressions

          +

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          The runtime expression is defined by the following ABNF syntax

          @@ -2635,7 +2635,7 @@

          The name identifier is case-sensitive, whereas token is not.

          The table below provides examples of runtime expressions and examples of their use in a value:

          -

          Examples

          +

          Examples

          @@ -2684,7 +2684,7 @@

          Runtime expressions preserve the type of the referenced value. Expressions can be embedded into string values by surrounding the expression with {} curly braces.

          -

          Header Object

          +

          Header Object

          The Header Object follows the structure of the Parameter Object with the following changes:

          1. name MUST NOT be specified, it is given in the corresponding headers map.
          2. @@ -2706,7 +2706,7 @@ schema: type: integer -

          Tag Object

          +

          Tag Object

          Adds metadata to a single tag that is used by the Operation Object. It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

          Fixed Fields

          @@ -2748,7 +2748,7 @@ name: pet description: Pets operations -

          Reference Object

          +

          Reference Object

          A simple object to allow referencing other components in the specification, internally and externally.

          The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

          For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

          @@ -2797,7 +2797,7 @@
          
           $ref: definitions.yaml#/Pet
           
          -

          Schema Object

          +

          Schema Object

          The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is an extended subset of the JSON Schema Specification Wright Draft 00.

          @@ -2893,7 +2893,7 @@

          This object MAY be extended with Specification Extensions.

          -
          Composition and Inheritance (Polymorphism)
          +

          Composition and Inheritance (Polymorphism)

          The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. allOf takes an array of object definitions that are validated independently but together compose a single object.

          While composition offers model extensibility, it does not imply a hierarchy between the models. @@ -3214,7 +3214,7 @@ required: - packSize -

          Discriminator Object

          +

          Discriminator Object

          When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

          When using the discriminator, inline schemas will not be considered.

          Fixed Fields

          @@ -3338,7 +3338,7 @@ }

          will map to Dog because of the definition in the mappings element.

          -

          XML Object

          +

          XML Object

          A metadata object that allows for more fine-tuned XML model definitions.

          When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. See examples for expected behavior.

          @@ -3669,7 +3669,7 @@ <aliens>value</aliens> </aliens> -

          Security Scheme Object

          +

          Security Scheme Object

          Defines a security scheme that can be used by the operations. Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

          Fixed Fields

          @@ -3796,7 +3796,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          OAuth Flows Object

          +

          OAuth Flows Object

          Allows configuration of the supported OAuth Flows.

          Fixed Fields

          @@ -3831,7 +3831,7 @@

          This object MAY be extended with Specification Extensions.

          -

          OAuth Flow Object

          +

          OAuth Flow Object

          Configuration details for a supported OAuth Flow

          Fixed Fields

          @@ -3909,7 +3909,7 @@ write:pets:modifypetsinyouraccountread:pets:readyourpets -

          Security Requirement Object

          +

          Security Requirement Object

          Lists the required security schemes to execute this operation. The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

          Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. @@ -3956,7 +3956,7 @@ - write:pets - read:pets -

          Specification Extensions

          +

          Specification Extensions

          While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          The extensions properties are implemented as patterned fields that are always prefixed by "x-".

          @@ -3976,7 +3976,7 @@

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          -

          Security Filtering

          +

          Security Filtering

          Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

          The reasoning is to allow an additional layer of access control over the documentation. While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

          @@ -3985,7 +3985,7 @@
        19. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
        20. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the Paths Object, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
        21. -

          Appendix A: Revision History

          +

          Appendix A: Revision History

          diff --git a/oas/v3.0.3.html b/oas/v3.0.3.html index 3a87e84fc6..1c4da742ce 100644 --- a/oas/v3.0.3.html +++ b/oas/v3.0.3.html @@ -16,12 +16,12 @@

          An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

          Definitions

          -

          OpenAPI Document

          +

          OpenAPI Document

          A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

          -

          Path Templating

          +

          Path Templating

          Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.

          Each template expression in the path MUST correspond to a path parameter that is included in the Path Item itself and/or in each of the Path Item’s Operations.

          -

          Media Types

          +

          Media Types

          Media type definitions are spread across several resources. The media type definitions SHOULD be in compliance with [[!RFC6838]].

          Some examples of possible media type definitions:

          @@ -37,7 +37,7 @@ application/vnd.github.v3.diff application/vnd.github.v3.patch -

          HTTP Status Codes

          +

          HTTP Status Codes

          The HTTP Status Codes are used to indicate the status of the executed operation. The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

          Specification

          @@ -65,10 +65,10 @@
        22. Keys used in YAML maps MUST be limited to a scalar string, as defined by the YAML Failsafe schema ruleset.
        23. Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

          -

          Document Structure

          +

          Document Structure

          An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

          It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

          -

          Data Types

          +

          Data Types

          Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. null is not supported as a type (see nullable for an alternative solution). @@ -145,16 +145,16 @@

          -

          Rich Text Formatting

          +

          Rich Text Formatting

          Throughout the specification description fields are noted as supporting CommonMark markdown formatting. Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

          -

          Relative References in URLs

          +

          Relative References in URLs

          Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. Relative references are resolved using the URLs defined in the Server Object as a Base URI.

          Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

          Schema

          In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

          -

          OpenAPI Object

          +

          OpenAPI Object

          This is the root document object of the OpenAPI document.

          Fixed Fields

          @@ -209,7 +209,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Info Object

          +

          Info Object

          The object provides metadata about the API. The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

          Fixed Fields

          @@ -286,7 +286,7 @@ url: https://www.apache.org/licenses/LICENSE-2.0.html version: 1.0.1 -

          Contact Object

          +

          Contact Object

          Contact information for the exposed API.

          Fixed Fields

          @@ -329,7 +329,7 @@ url:http://www.example.com/supportemail:support@example.com -

          License Object

          +

          License Object

          License information for the exposed API.

          Fixed Fields

          @@ -365,7 +365,7 @@ name:Apache2.0url:https://www.apache.org/licenses/LICENSE-2.0.html -

          Server Object

          +

          Server Object

          An object representing a Server.

          Fixed Fields

          @@ -480,7 +480,7 @@ # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`default:v2 -

          Server Variable Object

          +

          Server Variable Object

          An object representing a Server Variable for server URL template substitution.

          Fixed Fields

          @@ -510,7 +510,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Components Object

          +

          Components Object

          Holds a set of reusable objects for different aspects of the OAS. All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

          Fixed Fields

          @@ -751,7 +751,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          Paths Object

          +

          Paths Object

          Holds the relative paths to the individual endpoints and their operations. The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

          Patterned Fields

          @@ -827,7 +827,7 @@ items: $ref: '#/components/schemas/pet' -

          Path Item Object

          +

          Path Item Object

          Describes the operations available on a single path. A Path Item MAY be empty, due to ACL constraints. The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

          @@ -990,7 +990,7 @@ type: string style: simple -

          Operation Object

          +

          Operation Object

          Describes a single API operation on a path.

          Fixed Fields

          @@ -1171,7 +1171,7 @@ -write:pets-read:pets -

          External Documentation Object

          +

          External Documentation Object

          Allows referencing an external resource for extended documentation.

          Fixed Fields

          @@ -1207,7 +1207,7 @@ description:Findmoreinfohereurl:https://example.com -

          Parameter Object

          +

          Parameter Object

          Describes a single operation parameter.

          A unique parameter is defined by a combination of a name and location.

          Parameter Locations

          @@ -1633,7 +1633,7 @@ long: type: number -

          Request Body Object

          +

          Request Body Object

          Describes a single request body.

          Fixed Fields

          @@ -1764,7 +1764,7 @@ items:type:string -

          Media Type Object

          +

          Media Type Object

          Each Media Type Object provides schema and examples for the media type identified by its key.

          Fixed Fields

          @@ -1973,7 +1973,7 @@ type:'#/components/schemas/Address'

          An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

          -

          Encoding Object

          +

          Encoding Object

          A single encoding definition applied to a single schema property.

          Fixed Fields

          @@ -2051,7 +2051,7 @@ schema:type:integer -

          Responses Object

          +

          Responses Object

          A container for the expected responses of an operation. The container maps a HTTP response code to the expected response.

          The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. @@ -2135,7 +2135,7 @@ schema: $ref: '#/components/schemas/ErrorModel' -

          Response Object

          +

          Response Object

          Describes a single response from an API Operation, including design-time, static links to operations based on the response.

          Fixed Fields

          @@ -2282,7 +2282,7 @@
          
           description: object created
           
          -

          Callback Object

          +

          Callback Object

          A map of possible out-of band callbacks related to the parent operation. Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

          @@ -2402,7 +2402,7 @@ '200': description: callback successfully processed -

          Example Object

          +

          Example Object

          Fixed Fields

          @@ -2490,7 +2490,7 @@ confirmation-success:$ref:'#/components/examples/confirmation-success' -

          Link Object

          +

          Link Object

          The Link object represents a possible design-time link for a response. The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

          Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

          @@ -2624,7 +2624,7 @@

          Note that in the use of operationRef, the escaped forward-slash is necessary when using JSON references.

          -

          Runtime Expressions

          +

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          The runtime expression is defined by the following ABNF syntax

          @@ -2649,7 +2649,7 @@

          Here, json-pointer is taken from [[!RFC6901]], char from [[!RFC7159]] and token from [[!RFC7230]].

          The name identifier is case-sensitive, whereas token is not.

          The table below provides examples of runtime expressions and examples of their use in a value:

          -

          Examples

          +

          Examples

          @@ -2698,7 +2698,7 @@

          Runtime expressions preserve the type of the referenced value. Expressions can be embedded into string values by surrounding the expression with {} curly braces.

          -

          Header Object

          +

          Header Object

          The Header Object follows the structure of the Parameter Object with the following changes:

          1. name MUST NOT be specified, it is given in the corresponding headers map.
          2. @@ -2720,7 +2720,7 @@ schema: type: integer -

          Tag Object

          +

          Tag Object

          Adds metadata to a single tag that is used by the Operation Object. It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

          Fixed Fields

          @@ -2762,7 +2762,7 @@ name: pet description: Pets operations -

          Reference Object

          +

          Reference Object

          A simple object to allow referencing other components in the specification, internally and externally.

          The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

          For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

          @@ -2811,7 +2811,7 @@
          
           $ref: definitions.yaml#/Pet
           
          -

          Schema Object

          +

          Schema Object

          The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is an extended subset of the JSON Schema Specification Wright Draft 00.

          @@ -2907,7 +2907,7 @@

          This object MAY be extended with Specification Extensions.

          -
          Composition and Inheritance (Polymorphism)
          +

          Composition and Inheritance (Polymorphism)

          The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. allOf takes an array of object definitions that are validated independently but together compose a single object.

          While composition offers model extensibility, it does not imply a hierarchy between the models. @@ -3228,7 +3228,7 @@ required: - packSize -

          Discriminator Object

          +

          Discriminator Object

          When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

          When using the discriminator, inline schemas will not be considered.

          Fixed Fields

          @@ -3352,7 +3352,7 @@ }

          will map to Dog because of the definition in the mappings element.

          -

          XML Object

          +

          XML Object

          A metadata object that allows for more fine-tuned XML model definitions.

          When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. See examples for expected behavior.

          @@ -3683,7 +3683,7 @@ <aliens>value</aliens> </aliens> -

          Security Scheme Object

          +

          Security Scheme Object

          Defines a security scheme that can be used by the operations. Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

          Fixed Fields

          @@ -3810,7 +3810,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          OAuth Flows Object

          +

          OAuth Flows Object

          Allows configuration of the supported OAuth Flows.

          Fixed Fields

          @@ -3845,7 +3845,7 @@

          This object MAY be extended with Specification Extensions.

          -

          OAuth Flow Object

          +

          OAuth Flow Object

          Configuration details for a supported OAuth Flow

          Fixed Fields

          @@ -3923,7 +3923,7 @@ write:pets:modifypetsinyouraccountread:pets:readyourpets -

          Security Requirement Object

          +

          Security Requirement Object

          Lists the required security schemes to execute this operation. The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

          Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. @@ -3992,7 +3992,7 @@ - write:pets - read:pets -

          Specification Extensions

          +

          Specification Extensions

          While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          The extensions properties are implemented as patterned fields that are always prefixed by "x-".

          @@ -4012,7 +4012,7 @@

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          -

          Security Filtering

          +

          Security Filtering

          Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

          The reasoning is to allow an additional layer of access control over the documentation. While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

          @@ -4021,7 +4021,7 @@
        24. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
        25. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the Paths Object, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
        26. -

          Appendix A: Revision History

          +

          Appendix A: Revision History

          diff --git a/oas/v3.1.0.html b/oas/v3.1.0.html index 81eeaf5158..cac1eb2671 100644 --- a/oas/v3.1.0.html +++ b/oas/v3.1.0.html @@ -16,13 +16,13 @@

          An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

          Definitions

          -

          OpenAPI Document

          +

          OpenAPI Document

          A self-contained or composite resource which defines or describes an API or elements of an API. The OpenAPI document MUST contain at least one paths field, a components field or a webhooks field. An OpenAPI document uses and conforms to the OpenAPI Specification.

          -

          Path Templating

          +

          Path Templating

          Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.

          Each template expression in the path MUST correspond to a path parameter that is included in the Path Item itself and/or in each of the Path Item’s Operations. An exception is if the path item is empty, for example due to ACL constraints, matching path parameters are not required.

          The value for these path parameters MUST NOT contain any unescaped “generic syntax” characters described by [[!RFC3986]]: forward slashes (/), question marks (?), or hashes (#).

          -

          Media Types

          +

          Media Types

          Media type definitions are spread across several resources. The media type definitions SHOULD be in compliance with [[!RFC6838]].

          Some examples of possible media type definitions:

          @@ -38,7 +38,7 @@ application/vnd.github.v3.diff application/vnd.github.v3.patch -

          HTTP Status Codes

          +

          HTTP Status Codes

          The HTTP Status Codes are used to indicate the status of the executed operation. The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

          Specification

          @@ -64,10 +64,10 @@
        27. Keys used in YAML maps MUST be limited to a scalar string, as defined by the YAML Failsafe schema ruleset.
        28. Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

          -

          Document Structure

          +

          Document Structure

          An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. In the latter case, Reference Objects and Schema Object $ref keywords are used.

          It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

          -

          Data Types

          +

          Data Types

          Data types in the OAS are based on the types supported by the JSON Schema Specification Draft 2020-12. Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. Models are defined using the Schema Object, which is a superset of JSON Schema Specification Draft 2020-12.

          @@ -110,20 +110,20 @@
          -

          Rich Text Formatting

          +

          Rich Text Formatting

          Throughout the specification description fields are noted as supporting CommonMark markdown formatting. Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

          -

          Relative References in URIs

          +

          Relative References in URIs

          Unless specified otherwise, all properties that are URIs MAY be relative references as defined by [[!RFC3986]].

          Relative references, including those in Reference Objects, PathItem Object $ref fields, Link Object operationRef fields and Example Object externalValue fields, are resolved using the referring document as the Base URI according to [[!RFC3986]].

          If a URI contains a fragment identifier, then the fragment should be resolved per the fragment resolution mechanism of the referenced document. If the representation of the referenced document is JSON or YAML, then the fragment identifier SHOULD be interpreted as a JSON-Pointer as per [[!RFC6901]].

          Relative references in Schema Objects, including any that appear as $id values, use the nearest parent $id as a Base URI, as described by JSON Schema Specification Draft 2020-12. If no parent schema contains an $id, then the Base URI MUST be determined according to [[!RFC3986]].

          -

          Relative References in URLs

          +

          Relative References in URLs

          Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. Unless specified otherwise, relative references are resolved using the URLs defined in the Server Object as a Base URL. Note that these themselves MAY be relative to the referring document.

          Schema

          In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

          -

          OpenAPI Object

          +

          OpenAPI Object

          This is the root object of the OpenAPI document.

          Fixed Fields

          @@ -188,7 +188,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Info Object

          +

          Info Object

          The object provides metadata about the API. The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

          Fixed Fields

          @@ -272,7 +272,7 @@ url: https://www.apache.org/licenses/LICENSE-2.0.html version: 1.0.1 -

          Contact Object

          +

          Contact Object

          Contact information for the exposed API.

          Fixed Fields

          @@ -315,7 +315,7 @@ url:https://www.example.com/supportemail:support@example.com -

          License Object

          +

          License Object

          License information for the exposed API.

          Fixed Fields

          @@ -356,7 +356,7 @@ name:Apache2.0identifier:Apache-2.0 -

          Server Object

          +

          Server Object

          An object representing a Server.

          Fixed Fields

          @@ -471,7 +471,7 @@ # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`default:v2 -

          Server Variable Object

          +

          Server Variable Object

          An object representing a Server Variable for server URL template substitution.

          Fixed Fields

          @@ -501,7 +501,7 @@

          This object MAY be extended with Specification Extensions.

          -

          Components Object

          +

          Components Object

          Holds a set of reusable objects for different aspects of the OAS. All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

          Fixed Fields

          @@ -747,7 +747,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          Paths Object

          +

          Paths Object

          Holds the relative paths to the individual endpoints and their operations. The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to Access Control List (ACL) constraints.

          Patterned Fields

          @@ -823,7 +823,7 @@ items: $ref: '#/components/schemas/pet' -

          Path Item Object

          +

          Path Item Object

          Describes the operations available on a single path. A Path Item MAY be empty, due to ACL constraints. The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

          @@ -986,7 +986,7 @@ type: string style: simple -

          Operation Object

          +

          Operation Object

          Describes a single API operation on a path.

          Fixed Fields

          @@ -1168,7 +1168,7 @@ -write:pets-read:pets -

          External Documentation Object

          +

          External Documentation Object

          Allows referencing an external resource for extended documentation.

          Fixed Fields

          @@ -1204,7 +1204,7 @@ description:Findmoreinfohereurl:https://example.com -

          Parameter Object

          +

          Parameter Object

          Describes a single operation parameter.

          A unique parameter is defined by a combination of a name and location.

          Parameter Locations

          @@ -1319,7 +1319,7 @@
          -

          Style Values

          +

          Style Values

          In order to support common ways of serializing simple parameters, a set of style values are defined.

          @@ -1630,7 +1630,7 @@ long:type:number -

          Request Body Object

          +

          Request Body Object

          Describes a single request body.

          Fixed Fields

          @@ -1762,7 +1762,7 @@ items:type:string -

          Media Type Object

          +

          Media Type Object

          Each Media Type Object provides schema and examples for the media type identified by its key.

          Fixed Fields

          @@ -1975,7 +1975,7 @@ $ref:'#/components/schemas/Address'

          An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

          -

          Encoding Object

          +

          Encoding Object

          A single encoding definition applied to a single schema property.

          Fixed Fields

          @@ -2050,7 +2050,7 @@ schema:type:integer -

          Responses Object

          +

          Responses Object

          A container for the expected responses of an operation. The container maps a HTTP response code to the expected response.

          The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. @@ -2135,7 +2135,7 @@ schema: $ref: '#/components/schemas/ErrorModel' -

          Response Object

          +

          Response Object

          Describes a single response from an API Operation, including design-time, static links to operations based on the response.

          Fixed Fields

          @@ -2282,7 +2282,7 @@
          
           description: object created
           
          -

          Callback Object

          +

          Callback Object

          A map of possible out-of band callbacks related to the parent operation. Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

          @@ -2403,7 +2403,7 @@ '200': description: callback successfully processed -

          Example Object

          +

          Example Object

          Fixed Fields

          @@ -2491,7 +2491,7 @@ confirmation-success:$ref:'#/components/examples/confirmation-success' -

          Link Object

          +

          Link Object

          The Link object represents a possible design-time link for a response. The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

          Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

          @@ -2625,7 +2625,7 @@

          Note that in the use of operationRef, the escaped forward-slash is necessary when using JSON references.

          -

          Runtime Expressions

          +

          Runtime Expressions

          Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. This mechanism is used by Link Objects and Callback Objects.

          The runtime expression is defined by the following ABNF syntax

          @@ -2650,7 +2650,7 @@

          Here, json-pointer is taken from [[!RFC6901]], char from [[!RFC7159]] and token from [[!RFC7230]].

          The name identifier is case-sensitive, whereas token is not.

          The table below provides examples of runtime expressions and examples of their use in a value:

          -

          Examples

          +

          Examples

          @@ -2699,7 +2699,7 @@

          Runtime expressions preserve the type of the referenced value. Expressions can be embedded into string values by surrounding the expression with {} curly braces.

          -

          Header Object

          +

          Header Object

          The Header Object follows the structure of the Parameter Object with the following changes:

          1. name MUST NOT be specified, it is given in the corresponding headers map.
          2. @@ -2721,7 +2721,7 @@ schema: type: integer -

          Tag Object

          +

          Tag Object

          Adds metadata to a single tag that is used by the Operation Object. It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

          Fixed Fields

          @@ -2763,7 +2763,7 @@ name: pet description: Pets operations -

          Reference Object

          +

          Reference Object

          A simple object to allow referencing other components in the OpenAPI document, internally and externally.

          The $ref string value contains a URI [[!RFC3986]], which identifies the location of the value being referenced.

          See the rules for resolving Relative References.

          @@ -2823,7 +2823,7 @@
          
           $ref: definitions.yaml#/Pet
           
          -

          Schema Object

          +

          Schema Object

          The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is a superset of the JSON Schema Specification Draft 2020-12.

          For more information about the properties, see JSON Schema Core and JSON Schema Validation.

          @@ -2839,7 +2839,7 @@

          In addition to the JSON Schema properties comprising the OAS dialect, the Schema Object supports keywords from any other vocabularies, or entirely arbitrary properties.

          The OpenAPI Specification’s base vocabulary is comprised of the following keywords:

          -

          Fixed Fields

          +

          Fixed Fields

          @@ -2872,7 +2872,7 @@

          This object MAY be extended with Specification Extensions, though as noted, additional properties MAY omit the x- prefix within this object.

          -
          Composition and Inheritance (Polymorphism)
          +

          Composition and Inheritance (Polymorphism)

          The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. allOf takes an array of object definitions that are validated independently but together compose a single object.

          While composition offers model extensibility, it does not imply a hierarchy between the models. @@ -3198,7 +3198,7 @@ required: - packSize -

          Discriminator Object

          +

          Discriminator Object

          When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the document of an alternative schema based on the value associated with it.

          When using the discriminator, inline schemas will not be considered.

          Fixed Fields

          @@ -3323,7 +3323,7 @@ }

          will map to Dog because of the definition in the mapping element.

          -

          XML Object

          +

          XML Object

          A metadata object that allows for more fine-tuned XML model definitions.

          When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. See examples for expected behavior.

          @@ -3654,7 +3654,7 @@ <aliens>value</aliens> </aliens> -

          Security Scheme Object

          +

          Security Scheme Object

          Defines a security scheme that can be used by the operations.

          Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), mutual TLS (use of a client certificate), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and OpenID Connect Discovery. Please note that as of 2020, the implicit flow is about to be deprecated by OAuth 2.0 Security Best Current Practice. Recommended for most use case is Authorization Code Grant flow with PKCE.

          @@ -3782,7 +3782,7 @@ write:pets: modify pets in your account read:pets: read your pets -

          OAuth Flows Object

          +

          OAuth Flows Object

          Allows configuration of the supported OAuth Flows.

          Fixed Fields

          @@ -3817,7 +3817,7 @@

          This object MAY be extended with Specification Extensions.

          -

          OAuth Flow Object

          +

          OAuth Flow Object

          Configuration details for a supported OAuth Flow

          Fixed Fields

          @@ -3895,7 +3895,7 @@ write:pets:modifypetsinyouraccountread:pets:readyourpets -

          Security Requirement Object

          +

          Security Requirement Object

          Lists the required security schemes to execute this operation. The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

          Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. @@ -3964,7 +3964,7 @@ - write:pets - read:pets -

          Specification Extensions

          +

          Specification Extensions

          While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          The extensions properties are implemented as patterned fields that are always prefixed by "x-".

          @@ -3984,7 +3984,7 @@

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          -

          Security Filtering

          +

          Security Filtering

          Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

          The reasoning is to allow an additional layer of access control over the documentation. While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

          @@ -3993,7 +3993,7 @@
        29. The Paths Object MAY be present but empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They would still have access to at least the Info Object which may contain additional information regarding authentication.
        30. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the Paths Object, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
        31. -

          Appendix A: Revision History

          +

          Appendix A: Revision History

          From 1232ed677fd6b596d7c98bb7633d2c917c62f9a2 Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Sat, 18 Mar 2023 15:17:42 +0000 Subject: [PATCH 036/152] gh-pages: add Dockerfile for local dev/testing (#3201) Signed-off-by: Mike Ralphson --- .gitignore | 5 +++ CONTRIBUTING.md | 43 +++++++++++++++++++++++ Dockerfile | 13 +++++++ Gemfile | 12 +++++++ Gemfile.lock | 87 +++++++++++++++++++++++++++++++++++++++++++++++ index.md | 3 +- registry/index.md | 2 +- 7 files changed, 163 insertions(+), 2 deletions(-) create mode 100644 .gitignore create mode 100644 CONTRIBUTING.md create mode 100644 Dockerfile create mode 100644 Gemfile create mode 100644 Gemfile.lock diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000000..fec7c79e0b --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +_site/ +deploy/ +node_modules/ +scripts/ +package-lock.json diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000000..d450c89763 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,43 @@ +# Contributing + +## Building the site + +The registy site uses [jekyll](https://jekyllrb.com/), a Ruby based static site generator, with the Dinky theme. + +### Docker dev + +You can use the following Docker command to build and serve the site: + +```shell +docker build . -t oas-spec/latest +docker run -v $(pwd):/site -p 4000:4000 oas-spec/latest +``` + +### Local Ruby dev + +You will need to set up Ruby locally to run the server and see your changes. + +``` bash +gem install bundler +bundle install +``` + +With all the gems (dependencies) installed, you can launch the jekyll server. + +``` bash +bundle exec jekyll serve +``` + +It will show output like this, and you can grab the Server address and open it in your browser. + +``` +Configuration file: /site/_config.yml + Source: /site + Destination: /site/_site + Incremental build: disabled. Enable with --incremental + Generating... + done in 3.609 seconds. + Auto-regeneration: enabled for '/site' + Server address: http://0.0.0.0:4000 +``` + diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000000..36a55be08b --- /dev/null +++ b/Dockerfile @@ -0,0 +1,13 @@ +FROM bretfisher/jekyll-serve + +WORKDIR /site + +# install dependencies +COPY Gemfile Gemfile.lock . +RUN bundle install + +# install the site +COPY . . + +EXPOSE 4000 +CMD [ "bundle", "exec", "jekyll", "serve", "--host", "0.0.0.0" ] diff --git a/Gemfile b/Gemfile new file mode 100644 index 0000000000..5733772cd9 --- /dev/null +++ b/Gemfile @@ -0,0 +1,12 @@ +# frozen_string_literal: true + +source "https://rubygems.org" + +gem "jekyll", "~> 4.2" +gem "webrick", "~> 1.7" +gem "jekyll-remote-theme" +gem "jekyll-theme-dinky" + +group :jekyll_plugins do + gem "jekyll-sitemap", "~> 1.4" +end diff --git a/Gemfile.lock b/Gemfile.lock new file mode 100644 index 0000000000..559392bcb6 --- /dev/null +++ b/Gemfile.lock @@ -0,0 +1,87 @@ +GEM + remote: https://rubygems.org/ + specs: + addressable (2.8.1) + public_suffix (>= 2.0.2, < 6.0) + colorator (1.1.0) + concurrent-ruby (1.2.2) + em-websocket (0.5.3) + eventmachine (>= 0.12.9) + http_parser.rb (~> 0) + eventmachine (1.2.7) + ffi (1.15.5) + forwardable-extended (2.6.0) + google-protobuf (3.22.2-x86_64-linux) + http_parser.rb (0.8.0) + i18n (1.12.0) + concurrent-ruby (~> 1.0) + jekyll (4.3.2) + addressable (~> 2.4) + colorator (~> 1.0) + em-websocket (~> 0.5) + i18n (~> 1.0) + jekyll-sass-converter (>= 2.0, < 4.0) + jekyll-watch (~> 2.0) + kramdown (~> 2.3, >= 2.3.1) + kramdown-parser-gfm (~> 1.0) + liquid (~> 4.0) + mercenary (>= 0.3.6, < 0.5) + pathutil (~> 0.9) + rouge (>= 3.0, < 5.0) + safe_yaml (~> 1.0) + terminal-table (>= 1.8, < 4.0) + webrick (~> 1.7) + jekyll-remote-theme (0.4.3) + addressable (~> 2.0) + jekyll (>= 3.5, < 5.0) + jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0) + rubyzip (>= 1.3.0, < 3.0) + jekyll-sass-converter (3.0.0) + sass-embedded (~> 1.54) + jekyll-seo-tag (2.8.0) + jekyll (>= 3.8, < 5.0) + jekyll-sitemap (1.4.0) + jekyll (>= 3.7, < 5.0) + jekyll-theme-dinky (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-watch (2.2.1) + listen (~> 3.0) + kramdown (2.4.0) + rexml + kramdown-parser-gfm (1.1.0) + kramdown (~> 2.0) + liquid (4.0.4) + listen (3.8.0) + rb-fsevent (~> 0.10, >= 0.10.3) + rb-inotify (~> 0.9, >= 0.9.10) + mercenary (0.4.0) + pathutil (0.16.2) + forwardable-extended (~> 2.6) + public_suffix (5.0.1) + rb-fsevent (0.11.2) + rb-inotify (0.10.1) + ffi (~> 1.0) + rexml (3.2.5) + rouge (4.1.0) + rubyzip (2.3.2) + safe_yaml (1.0.5) + sass-embedded (1.59.2-x86_64-linux-gnu) + google-protobuf (~> 3.21) + terminal-table (3.0.2) + unicode-display_width (>= 1.1.1, < 3) + unicode-display_width (2.4.2) + webrick (1.8.1) + +PLATFORMS + x86_64-linux + +DEPENDENCIES + jekyll (~> 4.2) + jekyll-remote-theme + jekyll-sitemap (~> 1.4) + jekyll-theme-dinky + webrick (~> 1.7) + +BUNDLED WITH + 2.4.7 diff --git a/index.md b/index.md index f949d157ca..76139e38f5 100644 --- a/index.md +++ b/index.md @@ -1,6 +1,7 @@ --- title: OpenAPI Initiative gh-pages repository description: HTML Spec. and extensible registry +layout: default --- # OpenAPI Initiative Registry @@ -13,4 +14,4 @@ This site contains the OpenAPI Initiative Registry and content for the HTML vers ## The Specification * [Markdown source-of-truth](https://github.com/OAI/OpenAPI-Specification) -* [HTML Specification version](oas/v3.1.0.html) +* [HTML Specification version](oas/latest.html) diff --git a/registry/index.md b/registry/index.md index 2575b7b1bc..5e3baef022 100644 --- a/registry/index.md +++ b/registry/index.md @@ -14,7 +14,7 @@ Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls #### API access -* [registries.json](./api/registries.json) - Registries meta-registry +* [registries.json](../api/registries.json) - Registries meta-registry {% for registry in site.collections %}{% unless registry.hidden %}* {{ registry.slug }}.json{% endunless %} {% endfor %} From 1b880875adf1ad0d4cea3715b53fed21ffe9453c Mon Sep 17 00:00:00 2001 From: Vincent Biret Date: Tue, 21 Mar 2023 09:43:08 -0400 Subject: [PATCH 037/152] - adds decimal format (#3190) * - adds decimal format * Update registries/_format/decimal.md Co-authored-by: Mike Ralphson * - adds warnings about the lack of precision Signed-off-by: Vincent Biret * - removes the repetition of the remarks Signed-off-by: Vincent Biret * - adds PR feedback Signed-off-by: Vincent Biret --------- Signed-off-by: Vincent Biret Co-authored-by: Mike Ralphson --- registries/_format/decimal.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 registries/_format/decimal.md diff --git a/registries/_format/decimal.md b/registries/_format/decimal.md new file mode 100644 index 0000000000..3d9e6f257c --- /dev/null +++ b/registries/_format/decimal.md @@ -0,0 +1,28 @@ +--- +owner: baywet +issue: 889 +description: A fixed point decimal number of unspecified precision and range +base_type: string|number +layout: default +remarks: This format is used in a variety of conflicting ways and is not interoperable. +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a fixed point decimal number of unspecified precision and range. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + +{% if page.remarks %} +### Remarks + +{{ page.issue }} +{% endif %} \ No newline at end of file From f915f09732ad4a16a1f5c391a7e1694866e365dc Mon Sep 17 00:00:00 2001 From: Ralf Handl Date: Tue, 21 Mar 2023 18:30:09 +0100 Subject: [PATCH 038/152] Update decimal.md (#3208) --- registries/_format/decimal.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/registries/_format/decimal.md b/registries/_format/decimal.md index 3d9e6f257c..2a3eaf57ca 100644 --- a/registries/_format/decimal.md +++ b/registries/_format/decimal.md @@ -2,7 +2,7 @@ owner: baywet issue: 889 description: A fixed point decimal number of unspecified precision and range -base_type: string|number +base_type: string number layout: default remarks: This format is used in a variety of conflicting ways and is not interoperable. --- @@ -25,4 +25,4 @@ The `{{page.slug}}` format represents a fixed point decimal number of unspecifie ### Remarks {{ page.issue }} -{% endif %} \ No newline at end of file +{% endif %} From 2a862a700e26bf594f33227d1259cc0a3f00519c Mon Sep 17 00:00:00 2001 From: Ralf Handl Date: Thu, 23 Mar 2023 17:21:32 +0100 Subject: [PATCH 039/152] Comma-separated base_type list (#3210) --- registries/_format/decimal.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/registries/_format/decimal.md b/registries/_format/decimal.md index 2a3eaf57ca..4454a996f1 100644 --- a/registries/_format/decimal.md +++ b/registries/_format/decimal.md @@ -2,7 +2,7 @@ owner: baywet issue: 889 description: A fixed point decimal number of unspecified precision and range -base_type: string number +base_type: string, number layout: default remarks: This format is used in a variety of conflicting ways and is not interoperable. --- From ee33a0fa230509a2e25b1ae99fe85dda59938e34 Mon Sep 17 00:00:00 2001 From: Mike Ralphson Date: Thu, 23 Mar 2023 17:59:05 +0000 Subject: [PATCH 040/152] [gh-pages] reskin registry site and prep for release (#3212) Signed-off-by: Mike Ralphson --- Dockerfile | 2 +- Gemfile | 2 +- Gemfile.lock | 21 ++++++++++--------- _config.yml | 36 ++++++++++++++++++++++++++++++--- _sass/color_schemes/oai.scss | 3 +++ _sass/custom/custom.scss | 12 +++++++++++ api/alternative-schema.json | 3 +++ api/draft-feature.json | 3 +++ api/extension.json | 2 ++ api/format.json | 3 +++ api/namespace.json | 3 +++ api/registries.json | 2 ++ assets/css/style.scss | 26 ------------------------ favicon.ico | Bin 0 -> 3723 bytes index.md | 3 ++- registries/_format/byte.md | 2 +- registry/alternative-schema.md | 2 ++ registry/draft-feature.md | 2 ++ registry/extension.md | 2 ++ registry/format.md | 2 ++ registry/index.md | 17 +++++++++++----- registry/namespace.md | 2 ++ 22 files changed, 103 insertions(+), 47 deletions(-) create mode 100644 _sass/color_schemes/oai.scss create mode 100644 _sass/custom/custom.scss delete mode 100644 assets/css/style.scss create mode 100644 favicon.ico diff --git a/Dockerfile b/Dockerfile index 36a55be08b..27986617ca 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ FROM bretfisher/jekyll-serve WORKDIR /site # install dependencies -COPY Gemfile Gemfile.lock . +COPY Gemfile Gemfile.lock ./ RUN bundle install # install the site diff --git a/Gemfile b/Gemfile index 5733772cd9..dc5ce93dba 100644 --- a/Gemfile +++ b/Gemfile @@ -5,7 +5,7 @@ source "https://rubygems.org" gem "jekyll", "~> 4.2" gem "webrick", "~> 1.7" gem "jekyll-remote-theme" -gem "jekyll-theme-dinky" +gem "just-the-docs", "~> 0.4.2" group :jekyll_plugins do gem "jekyll-sitemap", "~> 1.4" diff --git a/Gemfile.lock b/Gemfile.lock index 559392bcb6..92a7e29239 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -11,7 +11,7 @@ GEM eventmachine (1.2.7) ffi (1.15.5) forwardable-extended (2.6.0) - google-protobuf (3.22.2-x86_64-linux) + google-protobuf (3.22.2) http_parser.rb (0.8.0) i18n (1.12.0) concurrent-ruby (~> 1.0) @@ -42,11 +42,12 @@ GEM jekyll (>= 3.8, < 5.0) jekyll-sitemap (1.4.0) jekyll (>= 3.7, < 5.0) - jekyll-theme-dinky (0.2.0) - jekyll (> 3.5, < 5.0) - jekyll-seo-tag (~> 2.0) jekyll-watch (2.2.1) listen (~> 3.0) + just-the-docs (0.4.2) + jekyll (>= 3.8.5) + jekyll-seo-tag (>= 2.0) + rake (>= 12.3.1) kramdown (2.4.0) rexml kramdown-parser-gfm (1.1.0) @@ -59,29 +60,31 @@ GEM pathutil (0.16.2) forwardable-extended (~> 2.6) public_suffix (5.0.1) + rake (13.0.6) rb-fsevent (0.11.2) rb-inotify (0.10.1) ffi (~> 1.0) rexml (3.2.5) - rouge (4.1.0) + rouge (3.30.0) rubyzip (2.3.2) safe_yaml (1.0.5) - sass-embedded (1.59.2-x86_64-linux-gnu) + sass-embedded (1.58.3) google-protobuf (~> 3.21) + rake (>= 10.0.0) terminal-table (3.0.2) unicode-display_width (>= 1.1.1, < 3) unicode-display_width (2.4.2) webrick (1.8.1) PLATFORMS - x86_64-linux + ruby DEPENDENCIES jekyll (~> 4.2) jekyll-remote-theme jekyll-sitemap (~> 1.4) - jekyll-theme-dinky + just-the-docs (~> 0.4.2) webrick (~> 1.7) BUNDLED WITH - 2.4.7 + 1.17.2 diff --git a/_config.yml b/_config.yml index 3f265bad6a..a3e3ba7771 100644 --- a/_config.yml +++ b/_config.yml @@ -1,5 +1,7 @@ -theme: jekyll-theme-dinky -title: OpenAPI Initiative Registry - DRAFT CONTENT +# theme: just-the-docs +remote_theme: just-the-docs/just-the-docs +color_scheme: oai +title: OpenAPI Initiative Registry description: Extensible data value repository show_downloads: true collections_dir: /registries @@ -18,7 +20,8 @@ collections: extension: slug: extension name: Specification Extension Registry - output: true + output: false + hidden: true permalink: /registry/:collection/:title draft-feature: slug: draft-feature @@ -35,3 +38,30 @@ collections: name: Extension Namespace Registry output: true permalink: /registry/:collection/:title +exclude: + - Gemfile + - Gemfile.lock + - tmp + - vendor/bundle +#just_the_docs: +# collections: +# draft-feature: +# name: Draft features +# alternative-schema: +# name: Alternative schemas +# namespace: +# name: Extension namespaces +# draft-feature: +# name: Draft features +# format: +# name: Formats +plugins: + - jekyll-remote-theme + - jekyll-sitemap +aux_links: + "Latest Specification": + - "https://spec.openapis.org/oas/latest.html" +footer_content: "\xA9 2023 OpenAPI Initiative. +
          This work is licensed under the Apache 2.0 License. This site is\ + \ maintained at https://github.com/OAI/OpenAPI-Specification/." diff --git a/_sass/color_schemes/oai.scss b/_sass/color_schemes/oai.scss new file mode 100644 index 0000000000..425767eedd --- /dev/null +++ b/_sass/color_schemes/oai.scss @@ -0,0 +1,3 @@ +@import "./color_schemes/light"; + +$link-color: #629b34; diff --git a/_sass/custom/custom.scss b/_sass/custom/custom.scss new file mode 100644 index 0000000000..d767e86c99 --- /dev/null +++ b/_sass/custom/custom.scss @@ -0,0 +1,12 @@ +h1,h2,h3,h4,h5,h6 { color: #4E5B31; } + +a[href] { color: #6BA539; } + +/*.nav-list-link { + text-transform: lowercase; +}*/ + +/* OAI greens +6BA539 +4E5B31 +97D700 */ diff --git a/api/alternative-schema.json b/api/alternative-schema.json index 813043a66a..5dd6faffda 100644 --- a/api/alternative-schema.json +++ b/api/alternative-schema.json @@ -1,4 +1,6 @@ --- +title: Alternative Schema API +parent: API --- { {% for page in site.alternative-schema %}"{{ page.slug }}": { @@ -6,6 +8,7 @@ "title": "{{ page.title }}", "issue": "{{ page.issue }}", "description": "{{ page.description }}", + "url": "{{ site.baseurl }}{{ page.url }}", "owner": "{{ page.owner }}" }{% unless forloop.last %},{% endunless %} {% endfor %} diff --git a/api/draft-feature.json b/api/draft-feature.json index 7ee771d60e..d432f9b5bb 100644 --- a/api/draft-feature.json +++ b/api/draft-feature.json @@ -1,4 +1,6 @@ --- +title: Draft Feature API +parent: API --- { {% for page in site.draft-feature %}"{{ page.slug }}": { @@ -6,6 +8,7 @@ "title": "{{ page.title }}", "issue": "{{ page.issue }}", "description": "{{ page.description }}", + "url": "{{ site.baseurl }}{{ page.url }}", "owner": "{{ page.owner }}" }{% unless forloop.last %},{% endunless %} {% endfor %} diff --git a/api/extension.json b/api/extension.json index 45b948fdc2..972b82583c 100644 --- a/api/extension.json +++ b/api/extension.json @@ -1,4 +1,5 @@ --- +parent: API --- { {% for page in site.extension %}"{{ page.slug }}": { @@ -7,6 +8,7 @@ "issue": "{{ page.issue }}", "description": "{{ page.description }}", "owner": "{{ page.owner }}", + "url": "{{ site.baseurl }}{{ page.url }}", "objects": {{ page.objects | jsonify }}, "schema": {{ page.schema | jsonify }} }{% unless forloop.last %},{% endunless %} diff --git a/api/format.json b/api/format.json index 3f57f3ae6f..beebb92501 100644 --- a/api/format.json +++ b/api/format.json @@ -1,4 +1,6 @@ --- +title: Format API +parent: API --- { {% for page in site.format %}"{{ page.slug }}": { @@ -6,6 +8,7 @@ "title": "{{ page.title }}", "issue": "{{ page.issue }}", "description": "{{ page.description }}", + "url": "{{ site.baseurl }}{{ page.url }}", "owner": "{{ page.owner }}", "base_type": "{{ page.base_type" }}" }{% unless forloop.last %},{% endunless %} diff --git a/api/namespace.json b/api/namespace.json index c86d6f590e..423f3a64a6 100644 --- a/api/namespace.json +++ b/api/namespace.json @@ -1,10 +1,13 @@ --- +title: Namespace API +parent: API --- { {% for page in site.namespace %}"{{ page.slug }}": { "slug": "{{ page.slug }}", "issue": "{{ page.issue }}", "description": "{{ page.description }}", + "url": "{{ site.baseurl }}{{ page.url }}", "owner": "{{ page.owner }}" }{% unless forloop.last %},{% endunless %} {% endfor %} diff --git a/api/registries.json b/api/registries.json index aae5e7149c..335dee0425 100644 --- a/api/registries.json +++ b/api/registries.json @@ -1,4 +1,6 @@ --- +title: Registries API +parent: API --- [ {% for collection in site.collections %}"{{ collection.slug }}"{% unless forloop.last %},{% endunless %} diff --git a/assets/css/style.scss b/assets/css/style.scss deleted file mode 100644 index 72c5761ef1..0000000000 --- a/assets/css/style.scss +++ /dev/null @@ -1,26 +0,0 @@ ---- ---- - -@import "{{ site.theme }}"; - -h1,h2,h3 { color: #629b34; } - -a[href] { color: #45512c; } - -footer { display: none; } - -header > ul > li { - background: #629b34; - box-shadow: inset 0px 1px 1px 0 rgba(33,2,38, 1); -} - -header > ul > li:hover { - background: #45512c; -} - -section:first-of-type { - background-image: url("../img/draft.png"); - background-size: 30%; - background-repeat: repeat; -} - diff --git a/favicon.ico b/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..e90fcebcb378e980fcd7a06c133c597334b27436 GIT binary patch literal 3723 zcmV;64s`K}P)Gnk-?PaWce3 zkeN+3=PzI`bHR*ETy&brusEhb$JWXZtB8glCsYch+;jJQe8+H!xqRh%&+~km!`wG{ z{Y$vdyU+7|zW2k*ul&ld{L)_ylNv1yz=fEE8*nqO!(|wb0xQ4tLtq$g#|FHQ6Nn>$ zQ#gt?tipJdSox(ABY-Gg#VJSz4h~@{&b9K(*BAx32LFcx$wDul#b^Yq{PG+lh?&?A zaVd$dh``D(Z+k{9c0)XJ@DEg2`QC8@qvx|^G{&zH}U(BfcWS=eBH{gtb>%} z-w>ZAu{giMXCLHBd;(GM5=yQ7$|}eLBq0iRqsq#~b=TTP3k4X63Va2%n275!1tr(q z5~;>FQG?Mq4+9WX3i4Bkl7om?E|yk+5UMc^i}4IzM+ZK{5gf-!Y(+VP{}H+o!+!i1 zFXOlPKI(Bkir`0(hagH~xWdY?G$RC1hA0+c1Kvds9LO2$I31(~0+S?;p&jcmA7fDp zw?TgPrMp5HWDzdGz1W1qNJ0$U1u;wDAU0wls!)(+kok&x$S#bsSp5|uge$Qc9~dI& z1TnMGfd_FZ3i}vjJh~tXHsYNA2vLa3@DyTjAb@g^%#zrL<@g$c8G;POn@Z=9A45Gx z0h;mQ=R@RBkd!2LqXm@+oZ%hb6$(K*)lTZa-coO2Feb0qJR!{BzKdQ+4hKnz<89o4 zBEvhp)A1g}M>c+r0*x2}jKz8!#T|G5v2h5)d+{s@l8W*uLWUTf5Fa^s1r=H`u0jVK z2)3h=;Z4TTvml6#H7HMeyM3ZkjCMredyGQNz-|aq;%I69b3>Q`u7i`qLE`uWD$-)q zV5`C={yORr)VMNk!U2fEUR=rm$Kit<4HCx_C^y7-6HXrnY-jPA`bv!S{mS446wdli zw3vZULnp+*!4toH^;-iO;u6?77Q|}|8_!_@)}s^Mh{HxNKE`&eL>-DPmftaoaTgw# z{k__A8T#}yMCrn{4Dozy$)O;A#8`{run+u+y2Q3&ECMi5tH=h+k^ zfLVw^fUKf)VhqEq#Xj92nPa#-XPm^-xe&v`ShPbR8KO+YRyb)J{FBRG`)q^%32cQR znlXCt0LrY4OFu{$&%=Rai1OgfdC?HVk6pUF#Y%E7<+8^m4 z7&dGDTh&~2L;9c#_sm)t4Kw_!4Y#lLD>v7dG1Mj;g?5lQp2i55hdvu?F)S^{#dr>v zLoa|K$OYH|$-;><>?u8Hy5~;~AqKlj;R7m_M_WUTO-N!r%K9rt5q^avB!g@=`W>iZ zuot0SA&6Ft04~8MI1uz;9s>Olq%Q3d*RLoEta#*KhPUXw1ksPtfVT{L={AhejuFDM za3Bg%j-%=HTl5=!3}Qa?d5_VET@V8sixJceQjd=zfJ&4$T)==EaoBZ`%#XHHu}vvP z%1(^b+&g{`0o0--uzbniCYCbf6)b%6xb{fC&tFH2w#Hjd!pbO^BibVU!?n`j$Epb(oL){5bTvjFHlcp&F<1dy#}F zMR{mOQ}i4{)ZlHrz-RD-81$WJ!`-MtL7)H6NZT`}_A$mOEHxbZCSaF~$NlMk2N{T$ zA&R=OXvXc4Ffpd04c8H1FfKyC(21q}N z;U)yXAVMLkF&B^FCA4BQ{)%O|79$Wg;| zu6AIT!a2jOy%^=k?P@l9Aj)hk$3R1j5;S2i97tc~NDRRVOz|3|08hbzD0>T)rWj~e z_?G!8tWk+!=AhYYkTSGFl*Mr;0*2dElR}IhEX5GD7-ml*=q1P~bV8JMV5H&dxEOmN zF1SAQDS8d1UV=mrgD86jg@&*C{{l&cAHobZJW2iqqO1+WyabsH?G4?=ZHB9(3hzJ^ zf|RDc&LAFzDBFh%y#$#98=~kiY79YcMqDAtAw&(Y^%iKq))*pQf-HmsQPhqK!wLK` zh=K&>8D8rZIE0gmVyN>HWD!K!8wjTb3E}S$CCf}-YeEC2DVl=8UV_|)9m;-(lC&U$ z&1*5YPW&p3i1uveX^4>BO!paemB1kxMVAarmaX_y*&ZoHRVPDn;M1ZuDk z<_2B^u?%NW0Bb$-jN3Sc*{VK6-I4D{4TKw9#S?l2(gsH%Twp~uR-=c~3h)kY!DeSR zyB3c%@Zg&nqY#N5IDiCfMmUDT6Q+8?@WKJyhj0TMK1Lh8YL~2m6~YM>IEJAcPEKqi zTg9mc{xdCjYf1e0*4myLmz_T}uFrWyB~3E(9f_!daDy_0!K6nZ9tcE%6BE8Gh+tQg z(oYORjH*?rm0`lkP|?neF|ntD%<@6Jbc~ETT-#FKH8>O- zcEUr?Kom<+t>N-?9OE{AG0{sFK~B|hX(&MC!tKHB>%xGLZ1`|hTtGWMcQ87kmByCs zjafK}e9R47;NMd|{gH(!OA{t^FgTQd5o|<-xc<1_z~w0m3%ERW;spEWU1#tqy=KFVNi;2$R@ za?=>Iyi;j4IFw4vgUP50qr;G=p4?H<=W$s_@f%b@=oCf`R>q}=D1oHwxNfFYS{Q^3 z2m?b&S1l$QQcH0g&SC1d)Y_sk0Z2k2gkE7te?qw=O+&ekOE$;iGD6Hs2q-ovlu9gw zvBd*q4c@MDa<|2aqR2&ve0AeEFS!v&hGEyf^#{g!@_mOPbX1OTr63O9kpLU&LV0QV z!HH%WN+pDoQqjfaj)O1ii!Ys6cCcX6;`c(7A7ZY9$5bn1XZ|E|A#|1jUpb`CSM4qL zXY$yYb3NqbT|^7QVRBa>zPJLRiF(qf9@^S>DQv!fcYd@egKi^Rv1eVvSf!=zKn(pP0AEY&U(&yMmYxV{xo%ulsgWW^)>}8`m$z>X$qIL9TMWTaApy7ci0+0inlS5mz zQcPCnH^_r4?{iM1X4 zR@5{ylx$FYrJ1}`Sa$N0k?Ud@)mXmgyO18rx)X#O6=4b;ysvy`h|my91ulWBL^FFU zr)()NBHWoUq|5M?E3_5}H#@sKJ)}G55P=E}p)ALUX45k4wUmg>K^}5%doe^KSg~UJ z=^&+;{~?Gba1RSu%ml?PV zp<+WeMw=d#LlzvEforg79qP`FdbX{+e_sR9M5^)j;*I|=(c4t5I1QuFy!s4{EyW)x zsMa{t^~U!QP3$iyYg|K-1px~ZL8sq5UQz2zC<<@HqEN$7cMYl_nwSkoKe!OwfpeRV zEW8f0sU;lpWiOL(0+wbp)NM#PUY;@Eza8h-7apdTbkr59$0GcQY6#?DK;2NcnS^1% zX#~L3q7T`(_+Tx5!OocEKrjCAWQZnKiHnFp=N2D^opKgF@Rmc}Kbo+=D8g5G1>Nvq zji3y;E$oSKoX6j=x@mZukCT`TuZOBdXncma14bYkC-6JUVbf^=u>{#j!XgZV=c6DT zhofi*UxZ>65^)|^k%vN*!GcQ3f>Qj0oA?{{ registry.name }}{% endunless %} -{% endfor %} +{% for registry in site.collections %}{% unless registry.hidden %} +* {{ registry.name }}{% endunless %}{% endfor %} #### API access -* [registries.json](../api/registries.json) - Registries meta-registry -{% for registry in site.collections %}{% unless registry.hidden %}* {{ registry.slug }}.json{% endunless %} -{% endfor %} +* [registries.json](../api/registries.json) - Registries meta-registry{% for registry in site.collections %}{% unless registry.hidden %} +* {{ registry.slug }}.json{% endunless %} {% endfor %} #### RSS feed diff --git a/registry/namespace.md b/registry/namespace.md index 24cb4430c6..6b05c8c1b7 100644 --- a/registry/namespace.md +++ b/registry/namespace.md @@ -1,6 +1,8 @@ --- +title: Namespace Registry layout: default permalink: /registry/namespace/index.html +parent: Registry --- # Namespace Registry From dace7d0e06b5a66e3865ddcf68f9a3c4adff727a Mon Sep 17 00:00:00 2001 From: Ralf Handl Date: Fri, 31 Mar 2023 00:55:02 +0200 Subject: [PATCH 041/152] Register format decimal128 (#3209) * Register format decimal128 * Update decimal128.md * Apply Darrel's suggestions --- registries/_format/decimal128.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 registries/_format/decimal128.md diff --git a/registries/_format/decimal128.md b/registries/_format/decimal128.md new file mode 100644 index 0000000000..b04d92fb5c --- /dev/null +++ b/registries/_format/decimal128.md @@ -0,0 +1,31 @@ +--- +owner: +issue: +description: A decimal floating-point number with 34 significant decimal digits +base_type: string, number +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a [128-bit decimal floating-point number](https://en.wikipedia.org/wiki/Decimal128_floating-point_format) as defined by IEEE 754 2008 and ISO/IEC/IEEE 60559:2011. + +Representation as a JSON string is preferred as this avoids problems with recipients that parse JSON numbers into [binary64](https://en.wikipedia.org/wiki/Double-precision_floating-point_format) memory representation. + +String representation allows expressing the special values `NaN`, `-INF`, and `INF` that cannot be expressed as JSON numbers. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + +{% if page.remarks %} +### Remarks + +{{ page.issue }} +{% endif %} From cacc23958891ed1d443cc9ec19919bb6f0123142 Mon Sep 17 00:00:00 2001 From: Jason Desrosiers Date: Thu, 13 Apr 2023 09:46:09 -0700 Subject: [PATCH 042/152] Add media-range format to registry (#3238) --- registries/_format/media-range.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 registries/_format/media-range.md diff --git a/registries/_format/media-range.md b/registries/_format/media-range.md new file mode 100644 index 0000000000..e15eb7ca4d --- /dev/null +++ b/registries/_format/media-range.md @@ -0,0 +1,30 @@ +--- +owner: jdesrosiers +issue: +description: A media type as defined by the `media-range` ABNF production in RFC9110. +base_type: string +layout: default +source_label: OpenAPI +source: https://www.rfc-editor.org/rfc/rfc9110#field.accept +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format is a media type as defined by the `media-range` ABNF +production in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110). + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + +{% if page.remarks %} +### Remarks + +{{ page.remarks }} +{% endif %} From f8f3d25fcc5761cd5b5326b499e7447ddf191002 Mon Sep 17 00:00:00 2001 From: Ralf Handl Date: Thu, 13 Apr 2023 18:52:29 +0200 Subject: [PATCH 043/152] Update int64.md (#3232) --- registries/_format/int64.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/registries/_format/int64.md b/registries/_format/int64.md index 9430c7ce4e..435a4ad472 100644 --- a/registries/_format/int64.md +++ b/registries/_format/int64.md @@ -2,7 +2,7 @@ owner: DarrelMiller issue: description: signed 64-bit integer -base_type: number +base_type: number, string layout: default source: https://spec.openapis.org/oas/latest.html#data-types source_label: OAS @@ -16,6 +16,8 @@ Base type: `{{ page.base_type }}`. The `{{page.slug}}` format represents a signed 64-bit integer, with the range -9223372036854775808 through 9223372036854775807. This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). +Representation as a JSON string is recommended for values outside the 53-bit range (-9007199254740991 through 9007199254740991) as this avoids problems with recipients that parse JSON numbers into [binary64](https://en.wikipedia.org/wiki/Double-precision_floating-point_format) memory representation. + {% if page.issue %} ### GitHub Issue @@ -26,4 +28,4 @@ The `{{page.slug}}` format represents a signed 64-bit integer, with the range -9 ### Remarks {{ page.remarks }} -{% endif %} \ No newline at end of file +{% endif %} From 4c5c4be8e6171dd3422a62b04bf4928146b3edba Mon Sep 17 00:00:00 2001 From: Mike Kistler Date: Mon, 29 May 2023 00:40:21 -0600 Subject: [PATCH 044/152] Add format for imf-fixdate used in HTTP headers (#3285) * Add format for imf-fixdate used in HTTP headers * Add example --- registries/_format/imf-fixdate.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 registries/_format/imf-fixdate.md diff --git a/registries/_format/imf-fixdate.md b/registries/_format/imf-fixdate.md new file mode 100644 index 0000000000..db8e7911fb --- /dev/null +++ b/registries/_format/imf-fixdate.md @@ -0,0 +1,31 @@ +--- +owner: mikekistler +issue: +description: date and time as defined by IMF-fixdate - [RFC7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1) +base_type: string +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a date and time as defined by IMF-fixdate - [RFC7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1). + +Example: "Sun, 06 Nov 1994 08:49:37 GMT" + +This is the preferred format for dates passed in HTTP headers. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + +{% if page.remarks %} +### Remarks + +{{ page.remarks }} +{% endif %} From 6f1aebfd2d24f14de820624d2bb9b34cc43a87b1 Mon Sep 17 00:00:00 2001 From: Mike Kistler Date: Fri, 2 Jun 2023 11:11:27 -0500 Subject: [PATCH 045/152] Replace imf-fixdate with the more general and useful http-date (#3290) --- registries/_format/{imf-fixdate.md => http-date.md} | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) rename registries/_format/{imf-fixdate.md => http-date.md} (64%) diff --git a/registries/_format/imf-fixdate.md b/registries/_format/http-date.md similarity index 64% rename from registries/_format/imf-fixdate.md rename to registries/_format/http-date.md index db8e7911fb..28ff0d33a9 100644 --- a/registries/_format/imf-fixdate.md +++ b/registries/_format/http-date.md @@ -1,7 +1,7 @@ --- owner: mikekistler issue: -description: date and time as defined by IMF-fixdate - [RFC7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1) +description: date and time as defined by HTTP-date - [RFC7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1) base_type: string layout: default --- @@ -12,11 +12,11 @@ layout: default Base type: `{{ page.base_type }}`. -The `{{page.slug}}` format represents a date and time as defined by IMF-fixdate - [RFC7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1). +The `{{page.slug}}` format represents a date and time as defined by HTTP-date - [RFC7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1). Example: "Sun, 06 Nov 1994 08:49:37 GMT" -This is the preferred format for dates passed in HTTP headers. +This is the format for dates passed in HTTP headers. {% if page.issue %} ### GitHub Issue From 44cf3d7f2ccdc9082d1e54c1ec2945bde294a909 Mon Sep 17 00:00:00 2001 From: Vincent Biret Date: Tue, 25 Jul 2023 10:12:39 -0400 Subject: [PATCH 046/152] adds formats registry considerations (#3204) * - adds considerations to formats registry Signed-off-by: Vincent Biret * Apply suggestions from code review Co-authored-by: Mike Ralphson * Apply suggestions from code review Co-authored-by: Darrel --------- Signed-off-by: Vincent Biret Co-authored-by: Mike Ralphson Co-authored-by: Darrel --- registry/format.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/registry/format.md b/registry/format.md index 4441b232da..e091b34f97 100644 --- a/registry/format.md +++ b/registry/format.md @@ -7,6 +7,15 @@ parent: Registry # Formats Registry +## Considerations + +The existence of a format in this registry DOES NOT require tools to implement it. + +If tools choose to implement any format present in this registry, they SHOULD implement the format following the provided behavior. + +The registry SHOULD NOT contain two entries that have the same meaning, unless all but one have been deprecated. + + ## Contributing Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value. From 8cb215cbc4379db8539cd66e4f1ece44c5d211af Mon Sep 17 00:00:00 2001 From: Mike Kistler Date: Tue, 3 Oct 2023 10:49:11 -0700 Subject: [PATCH 047/152] Add structured fields primitive types to format registry --- registries/_format/sf-binary.md | 37 ++++++++++++++++++++++++++++ registries/_format/sf-boolean.md | 36 ++++++++++++++++++++++++++++ registries/_format/sf-decimal.md | 36 ++++++++++++++++++++++++++++ registries/_format/sf-integer.md | 37 ++++++++++++++++++++++++++++ registries/_format/sf-string.md | 41 ++++++++++++++++++++++++++++++++ registries/_format/sf-token.md | 35 +++++++++++++++++++++++++++ 6 files changed, 222 insertions(+) create mode 100644 registries/_format/sf-binary.md create mode 100644 registries/_format/sf-boolean.md create mode 100644 registries/_format/sf-decimal.md create mode 100644 registries/_format/sf-integer.md create mode 100644 registries/_format/sf-string.md create mode 100644 registries/_format/sf-token.md diff --git a/registries/_format/sf-binary.md b/registries/_format/sf-binary.md new file mode 100644 index 0000000000..9604c3201d --- /dev/null +++ b/registries/_format/sf-binary.md @@ -0,0 +1,37 @@ +--- +owner: mikekistler +issue: +description: structured fields byte sequence as defined by `sf-binary` in [RFC 8941] +base_type: string +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a structured fields byte sequence as defined by `sf-binary` in [RFC 8941]. + +```abnf +sf-binary = ":" *(base64) ":" +base64 = ALPHA / DIGIT / "+" / "/" / "=" +``` + +A Byte Sequence is delimited with colons and encoded using base64 ([RFC 4648], Section 4). + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + +{% if page.remarks %} +### Remarks + +{{ page.remarks }} +{% endif %} + +[RFC 8941]: https://www.rfc-editor.org/rfc/rfc8941#name-byte-sequences +[RFC 4648]: https://www.rfc-editor.org/rfc/rfc4648#section-4 diff --git a/registries/_format/sf-boolean.md b/registries/_format/sf-boolean.md new file mode 100644 index 0000000000..19d02bcccf --- /dev/null +++ b/registries/_format/sf-boolean.md @@ -0,0 +1,36 @@ +--- +owner: mikekistler +issue: +description: structured fields boolean as defined by `sf-boolean` in [RFC 8941] +base_type: string +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a structured fields boolean as defined by `sf-boolean` in [RFC 8941]. + +```abnf +sf-boolean = "?" boolean +boolean = "0" / "1" +``` + +A Boolean is indicated with a leading "?" character followed by a "1" for a true value or "0" for false. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + +{% if page.remarks %} +### Remarks + +{{ page.remarks }} +{% endif %} + +[RFC 8941]: https://www.rfc-editor.org/rfc/rfc8941#name-booleans diff --git a/registries/_format/sf-decimal.md b/registries/_format/sf-decimal.md new file mode 100644 index 0000000000..581fc97737 --- /dev/null +++ b/registries/_format/sf-decimal.md @@ -0,0 +1,36 @@ +--- +owner: mikekistler +issue: +description: structured fields decimal as defined by `sf-decimal` in [RFC 8941] +base_type: integer +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a structured fields decimal as defined by `sf-decimal` in [RFC 8941]. + +```abnf +sf-decimal = ["-"] 1*12DIGIT "." 1*3DIGIT +``` + +Decimals are numbers with an integer and a fractional component. +The integer component has at most 12 digits; the fractional component has at most three digits. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + +{% if page.remarks %} +### Remarks + +{{ page.remarks }} +{% endif %} + +[RFC 8941]: https://www.rfc-editor.org/rfc/rfc8941#name-decimals diff --git a/registries/_format/sf-integer.md b/registries/_format/sf-integer.md new file mode 100644 index 0000000000..9689d3f282 --- /dev/null +++ b/registries/_format/sf-integer.md @@ -0,0 +1,37 @@ +--- +owner: mikekistler +issue: +description: structured fields integer as defined by `sf-integer` in [RFC 8941] +base_type: integer +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a structured fields integer as defined by `sf-integer` in [RFC 8941]. + +```abnf +sf-integer = ["-"] 1*15DIGIT +``` + +Integers have a range of -999,999,999,999,999 to 999,999,999,999,999 inclusive (i.e., up to fifteen digits, signed), +for IEEE 754 compatibility [IEEE754]. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + +{% if page.remarks %} +### Remarks + +{{ page.remarks }} +{% endif %} + +[RFC 8941]: https://www.rfc-editor.org/rfc/rfc8941#name-integers +[IEEE754]: https://ieeexplore.ieee.org/document/8766229 \ No newline at end of file diff --git a/registries/_format/sf-string.md b/registries/_format/sf-string.md new file mode 100644 index 0000000000..91a8336932 --- /dev/null +++ b/registries/_format/sf-string.md @@ -0,0 +1,41 @@ +--- +owner: mikekistler +issue: +description: structured fields string as defined by `sf-string` in [RFC 8941] +base_type: string +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a structured fields string as defined by `sf-string` in [RFC 8941]. + +```abnf +sf-string = DQUOTE *chr DQUOTE +chr = unescaped / escaped +unescaped = %x20-21 / %x23-5B / %x5D-7E +escaped = "\" ( DQUOTE / "\" ) +``` + +Strings are zero or more printable ASCII [RFC0020] characters (i.e., the range %x20 to %x7E). +Note that this excludes tabs, newlines, carriage returns, etc. + +Strings are delimited with double quotes, using a backslash ("\") to escape double quotes and backslashes. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + +{% if page.remarks %} +### Remarks + +{{ page.remarks }} +{% endif %} + +[RFC 8941]: https://www.rfc-editor.org/rfc/rfc8941#name-strings diff --git a/registries/_format/sf-token.md b/registries/_format/sf-token.md new file mode 100644 index 0000000000..c4753c9269 --- /dev/null +++ b/registries/_format/sf-token.md @@ -0,0 +1,35 @@ +--- +owner: mikekistler +issue: +description: structured fields token as defined by `sf-token` in [RFC 8941] +base_type: string +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents a structured fields token as defined by `sf-token` in [RFC 8941]. + +```abnf +sf-token = ( ALPHA / "*" ) *( tchar / ":" / "/" ) +``` + +Tokens are short textual words; their abstract model is identical to their expression in the HTTP field value serialization. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + +{% if page.remarks %} +### Remarks + +{{ page.remarks }} +{% endif %} + +[RFC 8941]: https://www.rfc-editor.org/rfc/rfc8941#name-tokens From 515bbc37b17353a6d3eadf35890d99866f101774 Mon Sep 17 00:00:00 2001 From: Mike Kistler Date: Wed, 4 Oct 2023 17:25:09 -0700 Subject: [PATCH 048/152] De-emphasize the ABNF --- registries/_format/sf-binary.md | 4 ++-- registries/_format/sf-boolean.md | 4 ++-- registries/_format/sf-decimal.md | 4 ++-- registries/_format/sf-integer.md | 4 ++-- registries/_format/sf-string.md | 4 ++-- registries/_format/sf-token.md | 4 ++-- 6 files changed, 12 insertions(+), 12 deletions(-) diff --git a/registries/_format/sf-binary.md b/registries/_format/sf-binary.md index 9604c3201d..97f105aa37 100644 --- a/registries/_format/sf-binary.md +++ b/registries/_format/sf-binary.md @@ -1,7 +1,7 @@ --- owner: mikekistler issue: -description: structured fields byte sequence as defined by `sf-binary` in [RFC 8941] +description: structured fields byte sequence as defined in [RFC 8941] base_type: string layout: default --- @@ -12,7 +12,7 @@ layout: default Base type: `{{ page.base_type }}`. -The `{{page.slug}}` format represents a structured fields byte sequence as defined by `sf-binary` in [RFC 8941]. +The `{{page.slug}}` format represents a structured fields byte sequence as defined in [RFC 8941]. ```abnf sf-binary = ":" *(base64) ":" diff --git a/registries/_format/sf-boolean.md b/registries/_format/sf-boolean.md index 19d02bcccf..6327ac1454 100644 --- a/registries/_format/sf-boolean.md +++ b/registries/_format/sf-boolean.md @@ -1,7 +1,7 @@ --- owner: mikekistler issue: -description: structured fields boolean as defined by `sf-boolean` in [RFC 8941] +description: structured fields boolean as defined in [RFC 8941] base_type: string layout: default --- @@ -12,7 +12,7 @@ layout: default Base type: `{{ page.base_type }}`. -The `{{page.slug}}` format represents a structured fields boolean as defined by `sf-boolean` in [RFC 8941]. +The `{{page.slug}}` format represents a structured fields boolean as defined in [RFC 8941]. ```abnf sf-boolean = "?" boolean diff --git a/registries/_format/sf-decimal.md b/registries/_format/sf-decimal.md index 581fc97737..e2789f784d 100644 --- a/registries/_format/sf-decimal.md +++ b/registries/_format/sf-decimal.md @@ -1,7 +1,7 @@ --- owner: mikekistler issue: -description: structured fields decimal as defined by `sf-decimal` in [RFC 8941] +description: structured fields decimal as defined in [RFC 8941] base_type: integer layout: default --- @@ -12,7 +12,7 @@ layout: default Base type: `{{ page.base_type }}`. -The `{{page.slug}}` format represents a structured fields decimal as defined by `sf-decimal` in [RFC 8941]. +The `{{page.slug}}` format represents a structured fields decimal as defined in [RFC 8941]. ```abnf sf-decimal = ["-"] 1*12DIGIT "." 1*3DIGIT diff --git a/registries/_format/sf-integer.md b/registries/_format/sf-integer.md index 9689d3f282..73ea95b021 100644 --- a/registries/_format/sf-integer.md +++ b/registries/_format/sf-integer.md @@ -1,7 +1,7 @@ --- owner: mikekistler issue: -description: structured fields integer as defined by `sf-integer` in [RFC 8941] +description: structured fields integer as defined in [RFC 8941] base_type: integer layout: default --- @@ -12,7 +12,7 @@ layout: default Base type: `{{ page.base_type }}`. -The `{{page.slug}}` format represents a structured fields integer as defined by `sf-integer` in [RFC 8941]. +The `{{page.slug}}` format represents a structured fields integer as defined in [RFC 8941]. ```abnf sf-integer = ["-"] 1*15DIGIT diff --git a/registries/_format/sf-string.md b/registries/_format/sf-string.md index 91a8336932..77e1b20bdb 100644 --- a/registries/_format/sf-string.md +++ b/registries/_format/sf-string.md @@ -1,7 +1,7 @@ --- owner: mikekistler issue: -description: structured fields string as defined by `sf-string` in [RFC 8941] +description: structured fields string as defined in [RFC 8941] base_type: string layout: default --- @@ -12,7 +12,7 @@ layout: default Base type: `{{ page.base_type }}`. -The `{{page.slug}}` format represents a structured fields string as defined by `sf-string` in [RFC 8941]. +The `{{page.slug}}` format represents a structured fields string as defined in [RFC 8941]. ```abnf sf-string = DQUOTE *chr DQUOTE diff --git a/registries/_format/sf-token.md b/registries/_format/sf-token.md index c4753c9269..9dd7af5783 100644 --- a/registries/_format/sf-token.md +++ b/registries/_format/sf-token.md @@ -1,7 +1,7 @@ --- owner: mikekistler issue: -description: structured fields token as defined by `sf-token` in [RFC 8941] +description: structured fields token as defined in [RFC 8941] base_type: string layout: default --- @@ -12,7 +12,7 @@ layout: default Base type: `{{ page.base_type }}`. -The `{{page.slug}}` format represents a structured fields token as defined by `sf-token` in [RFC 8941]. +The `{{page.slug}}` format represents a structured fields token as defined in [RFC 8941]. ```abnf sf-token = ( ALPHA / "*" ) *( tchar / ":" / "/" ) From 6b74070995b228553bc95068f117205404335521 Mon Sep 17 00:00:00 2001 From: Mike Kistler Date: Fri, 13 Oct 2023 10:52:26 -0500 Subject: [PATCH 049/152] Add source info and address PR comments --- registries/_format/sf-binary.md | 2 ++ registries/_format/sf-boolean.md | 2 ++ registries/_format/sf-decimal.md | 4 +++- registries/_format/sf-integer.md | 4 +++- registries/_format/sf-string.md | 2 ++ registries/_format/sf-token.md | 2 ++ 6 files changed, 14 insertions(+), 2 deletions(-) diff --git a/registries/_format/sf-binary.md b/registries/_format/sf-binary.md index 97f105aa37..fb935b0958 100644 --- a/registries/_format/sf-binary.md +++ b/registries/_format/sf-binary.md @@ -2,6 +2,8 @@ owner: mikekistler issue: description: structured fields byte sequence as defined in [RFC 8941] +source: https://www.rfc-editor.org/rfc/rfc8941#name-byte-sequences +source_label: RFC 8941 base_type: string layout: default --- diff --git a/registries/_format/sf-boolean.md b/registries/_format/sf-boolean.md index 6327ac1454..0a1ac9b983 100644 --- a/registries/_format/sf-boolean.md +++ b/registries/_format/sf-boolean.md @@ -2,6 +2,8 @@ owner: mikekistler issue: description: structured fields boolean as defined in [RFC 8941] +source: https://www.rfc-editor.org/rfc/rfc8941#name-booleans +source_label: RFC 8941 base_type: string layout: default --- diff --git a/registries/_format/sf-decimal.md b/registries/_format/sf-decimal.md index e2789f784d..eddc2451cd 100644 --- a/registries/_format/sf-decimal.md +++ b/registries/_format/sf-decimal.md @@ -2,7 +2,9 @@ owner: mikekistler issue: description: structured fields decimal as defined in [RFC 8941] -base_type: integer +source: https://www.rfc-editor.org/rfc/rfc8941#name-decimals +source_label: RFC 8941 +base_type: number layout: default --- diff --git a/registries/_format/sf-integer.md b/registries/_format/sf-integer.md index 73ea95b021..3118f7823d 100644 --- a/registries/_format/sf-integer.md +++ b/registries/_format/sf-integer.md @@ -2,7 +2,9 @@ owner: mikekistler issue: description: structured fields integer as defined in [RFC 8941] -base_type: integer +source: https://www.rfc-editor.org/rfc/rfc8941#name-integers +source_label: RFC 8941 +base_type: integer, number layout: default --- diff --git a/registries/_format/sf-string.md b/registries/_format/sf-string.md index 77e1b20bdb..78264b14ef 100644 --- a/registries/_format/sf-string.md +++ b/registries/_format/sf-string.md @@ -2,6 +2,8 @@ owner: mikekistler issue: description: structured fields string as defined in [RFC 8941] +source: https://www.rfc-editor.org/rfc/rfc8941#name-strings +source_label: RFC 8941 base_type: string layout: default --- diff --git a/registries/_format/sf-token.md b/registries/_format/sf-token.md index 9dd7af5783..0d71dae486 100644 --- a/registries/_format/sf-token.md +++ b/registries/_format/sf-token.md @@ -2,6 +2,8 @@ owner: mikekistler issue: description: structured fields token as defined in [RFC 8941] +source: https://www.rfc-editor.org/rfc/rfc8941#name-tokens +source_label: RFC 8941 base_type: string layout: default --- From e2aeb00f691b504cdfd2348c27fd15514ba4a62e Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 25 Oct 2023 12:45:30 -0700 Subject: [PATCH 050/152] Update ReSpec versions (#3410) Signed-off-by: GitHub Co-authored-by: darrelmiller --- oas/v2.0.html | 4 ++-- oas/v3.0.0.html | 4 ++-- oas/v3.0.1.html | 4 ++-- oas/v3.0.2.html | 4 ++-- oas/v3.0.3.html | 4 ++-- 5 files changed, 10 insertions(+), 10 deletions(-) diff --git a/oas/v2.0.html b/oas/v2.0.html index a9773948e3..cb4fd77877 100644 --- a/oas/v2.0.html +++ b/oas/v2.0.html @@ -149,13 +149,13 @@
          - + - + diff --git a/oas/v3.0.0.html b/oas/v3.0.0.html index a0026543b5..072509edc9 100644 --- a/oas/v3.0.0.html +++ b/oas/v3.0.0.html @@ -138,13 +138,13 @@ - + - + diff --git a/oas/v3.0.1.html b/oas/v3.0.1.html index 48a4354fd3..cea246987c 100644 --- a/oas/v3.0.1.html +++ b/oas/v3.0.1.html @@ -138,13 +138,13 @@ - + - + diff --git a/oas/v3.0.2.html b/oas/v3.0.2.html index c6734bd417..178efacc29 100644 --- a/oas/v3.0.2.html +++ b/oas/v3.0.2.html @@ -129,12 +129,12 @@ - + - + diff --git a/oas/v3.0.3.html b/oas/v3.0.3.html index 1c4da742ce..02d52dc5c8 100644 --- a/oas/v3.0.3.html +++ b/oas/v3.0.3.html @@ -131,12 +131,12 @@ - + - + From 1d8ce4258e2d2f5663af1e92914ee8cc648a8cfa Mon Sep 17 00:00:00 2001 From: Mike Kistler Date: Thu, 16 Nov 2023 12:00:24 -0600 Subject: [PATCH 051/152] Add double-int to format registry (#3381) --- registries/_format/double-int.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 registries/_format/double-int.md diff --git a/registries/_format/double-int.md b/registries/_format/double-int.md new file mode 100644 index 0000000000..c930f888f8 --- /dev/null +++ b/registries/_format/double-int.md @@ -0,0 +1,29 @@ +--- +owner: mikekistler +issue: +description: an integer that can be stored in an IEEE 754 double-precision number without loss of precision +base_type: integer +layout: default +--- + +# {{ page.collection }} + +## {{ page.slug }} - {{ page.description }} + +Base type: `{{ page.base_type }}`. + +The `{{page.slug}}` format represents an integer that can be stored in an IEEE 754 double-precision number without loss of precision. The range of values is -(253)+1 to (253)-1. + +This format is useful for systems that need to support languages (such as JavaScript) that store all numeric values as IEEE 754 double-precision numbers. + +{% if page.issue %} +### GitHub Issue + +* [#{{ page.issue }}](https://github.com/OAI/OpenAPI-Specification/issues/{{ page.issue }}) +{% endif %} + +{% if page.remarks %} +### Remarks + +{{ page.remarks }} +{% endif %} From 3c5991b78bdbe15bbb673cfe99c6306617055696 Mon Sep 17 00:00:00 2001 From: Karen Etheridge Date: Sat, 6 Jan 2024 17:22:36 -0800 Subject: [PATCH 052/152] fix types to use an array rather than a string when multiple types are valid --- registries/_format/decimal.md | 2 +- registries/_format/decimal128.md | 2 +- registries/_format/int64.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/registries/_format/decimal.md b/registries/_format/decimal.md index 4454a996f1..9637eacdd2 100644 --- a/registries/_format/decimal.md +++ b/registries/_format/decimal.md @@ -2,7 +2,7 @@ owner: baywet issue: 889 description: A fixed point decimal number of unspecified precision and range -base_type: string, number +base_type: [string, number] layout: default remarks: This format is used in a variety of conflicting ways and is not interoperable. --- diff --git a/registries/_format/decimal128.md b/registries/_format/decimal128.md index b04d92fb5c..218f81209a 100644 --- a/registries/_format/decimal128.md +++ b/registries/_format/decimal128.md @@ -2,7 +2,7 @@ owner: issue: description: A decimal floating-point number with 34 significant decimal digits -base_type: string, number +base_type: [string, number] layout: default --- diff --git a/registries/_format/int64.md b/registries/_format/int64.md index 435a4ad472..4f98582121 100644 --- a/registries/_format/int64.md +++ b/registries/_format/int64.md @@ -2,7 +2,7 @@ owner: DarrelMiller issue: description: signed 64-bit integer -base_type: number, string +base_type: [number, string] layout: default source: https://spec.openapis.org/oas/latest.html#data-types source_label: OAS From 530015ee8d8a97a604473e8e11a191353a6c435b Mon Sep 17 00:00:00 2001 From: mgrafl Date: Sat, 27 Jan 2024 18:30:41 +0100 Subject: [PATCH 053/152] Generalize description of password data type Addition to #3413 to fix #3404. --- registries/_format/password.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/registries/_format/password.md b/registries/_format/password.md index 26216ca175..687500e0a7 100644 --- a/registries/_format/password.md +++ b/registries/_format/password.md @@ -1,7 +1,7 @@ --- owner: baywet issue: -description: a string that hints to UIs to obscure input. +description: a string that hints to obscure the value. base_type: string layout: default source: https://spec.openapis.org/oas/latest.html#data-types @@ -14,7 +14,7 @@ source_label: OAS Base type: `{{ page.base_type }}`. -The `{{page.slug}}` format is a string that hints to UIs to obscure input. +The `{{page.slug}}` format is a string that hints to obscure the value. {% if page.issue %} ### GitHub Issue @@ -26,4 +26,4 @@ The `{{page.slug}}` format is a string that hints to UIs to obscure input. ### Remarks {{ page.remarks }} -{% endif %} \ No newline at end of file +{% endif %} From 5022402c59d3ccadba1390cee989781c9f743973 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 14 Feb 2024 14:20:37 -0500 Subject: [PATCH 054/152] Update ReSpec versions (#3520) Signed-off-by: GitHub Co-authored-by: darrelmiller --- oas/latest.html | 2320 +++++++++++++++++++++++------------------------ oas/v2.0.html | 240 ++--- oas/v3.0.0.html | 2150 +++++++++++++++++++++---------------------- oas/v3.0.1.html | 2142 +++++++++++++++++++++---------------------- oas/v3.0.2.html | 2254 ++++++++++++++++++++++----------------------- oas/v3.0.3.html | 2300 +++++++++++++++++++++++----------------------- oas/v3.1.0.html | 2320 +++++++++++++++++++++++------------------------ 7 files changed, 6863 insertions(+), 6863 deletions(-) diff --git a/oas/latest.html b/oas/latest.html index cac1eb2671..e1e1c4398b 100644 --- a/oas/latest.html +++ b/oas/latest.html @@ -1,4 +1,4 @@ -OpenAPI Specification v3.1.0 | Introduction, Definitions, & More +OpenAPI Specification v3.1.0 | Introduction, Definitions, & More +OpenAPI Specification v3.0.0 | Introduction, Definitions, & More +OpenAPI Specification v3.0.1 | Introduction, Definitions, & More +OpenAPI Specification v3.0.2 | Introduction, Definitions, & More +OpenAPI Specification v3.0.3 | Introduction, Definitions, & More +OpenAPI Specification v3.1.0 | Introduction, Definitions, & More +OpenAPI Specification v3.1.0 | Introduction, Definitions, & More +OpenAPI Specification v3.0.0 | Introduction, Definitions, & More +OpenAPI Specification v3.0.1 | Introduction, Definitions, & More +OpenAPI Specification v3.0.2 | Introduction, Definitions, & More +OpenAPI Specification v3.0.3 | Introduction, Definitions, & More +OpenAPI Specification v3.1.0 | Introduction, Definitions, & More +OpenAPI Specification v3.1.0 | Introduction, Definitions, & More +OpenAPI Specification v2.0 | Introduction, Definitions, & More +OpenAPI Specification v3.0.0 | Introduction, Definitions, & More +OpenAPI Specification v3.0.1 | Introduction, Definitions, & More +OpenAPI Specification v3.0.2 | Introduction, Definitions, & More +OpenAPI Specification v3.0.3 | Introduction, Definitions, & More +OpenAPI Specification v3.1.0 | Introduction, Definitions, & More + + +

          The Arazzo Specification v1.0.0

          The Arazzo Specification provides a mechanism that can define sequences of calls and their dependencies to be woven together and expressed in the context of delivering a particular outcome or set of outcomes when dealing with API descriptions (such as OpenAPI descriptions).

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.
          +

          Arazzo Specification

          +

          Version 1.0.0

          +

          The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

          +

          This document is licensed under The Apache License, Version 2.0.

          +

          Introduction

          +

          Being able to express specific sequences of calls and articulate the dependencies between them to achieve a particular goal is desirable in the context of API descriptions. The aim of the Arazzo Specification is to provide a mechanism that can define sequences of calls and their dependencies to be woven together and expressed in the context of delivering a particular outcome or set of outcomes when dealing with API descriptions (such as OpenAPI descriptions).

          +

          The Arazzo Specification can articulate these workflows in a human-readable and machine-readable manner, thus improving the capability of API specifications to tell the story of the API in a manner that can improve the consuming developer experience.

          + + +

          Definitions

          +

          Arazzo Description

          +

          A self-contained document (or set of documents) which defines or describes API workflows (specific sequence of calls to achieve a particular goal in the context of an API definition). An Arazzo Description uses and conforms to the Arazzo Specification, and MUST contain a valid Arazzo Specification version field (arazzo), an Info field, a sourceDescriptions field with at least one defined Source, and there MUST be at least one Workflow defined in the workflows fixed field.

          +

          Specification

          +

          Versions

          +

          The Arazzo Specification is versioned using a major.minor.patch versioning scheme. The major.minor portion of the version string (for example 1.0) SHALL designate the Arazzo feature set. .patch versions address errors in, or provide clarifications to, this document, not the feature set. The patch version SHOULD NOT be considered by tooling, making no distinction between 1.0.0 and 1.0.1 for example.

          +

          Format

          +

          An Arazzo Description that conforms to the Arazzo Specification is itself a JSON object, which may be represented either in JSON or YAML format.

          +

          All field names in the specification are case sensitive. +This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

          +

          In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

          + +

          Arazzo Description Structure

          +

          It is RECOMMENDED that the entry Arazzo document be named: arazzo.json or arazzo.yaml.

          +

          An Arazzo Description MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. If workflows from other documents are being referenced, they must by included as a Source Description Object. In a multi-document description, the document containing the Arazzo Specification Object is known as the entry Arazzo document.

          +

          Data Types

          +

          Data types in the Arazzo Specification are based on the types supported by the JSON Schema Specification Draft 2020-12. Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part.

          +

          As defined by the JSON Schema Validation vocabulary, data types can have an optional modifier property: format. Arazzo additionally supports the formats (similar to the OpenAPI specification) to provide fine detail for primitive data types.

          +

          The formats defined are:

          +
          date string dateAs defined by full-date - [!RFC3339]As defined by full-date - [!RFC3339]
          dateTime string date-timeAs defined by date-time - [!RFC3339]As defined by date-time - [!RFC3339]
          passworddate string dateAs defined by full-date - [!RFC3339]As defined by full-date - [!RFC3339]
          dateTime string date-timeAs defined by date-time - [!RFC3339]As defined by date-time - [!RFC3339]
          passworddate string dateAs defined by full-date - [[!RFC3339]]As defined by full-date - [!RFC3339]
          dateTime string date-timeAs defined by date-time - [[!RFC3339]]As defined by date-time - [!RFC3339]
          password
          string dateAs defined by full-date - [[!RFC3339]]As defined by full-date - [!RFC3339]
          string date-timeAs defined by date-time - [[!RFC3339]]As defined by date-time - [!RFC3339]
          string
          string dateAs defined by full-date - [[!RFC3339]]As defined by full-date - [!RFC3339]
          string date-timeAs defined by date-time - [[!RFC3339]]As defined by date-time - [!RFC3339]
          string
          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          typeformatComments
          integerint32signed 32 bits
          integerint64signed 64 bits (a.k.a long)
          numberfloat
          numberdouble
          stringpasswordA hint to UIs to obscure input.
          +

          Relative References in URLs

          +

          Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. +Unless specified otherwise, relative references are resolved using the URL of the referring document.

          +

          Schema

          +

          In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

          +

          Arazzo Specification Object

          +

          This is the root object of the Arazzo Description.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          arazzostringREQUIRED. This string MUST be the version number of the Arazzo Specification that the Arazzo Description uses. The arazzo field MUST be used by tooling to interpret the Arazzo Description.
          infoInfo ObjectREQUIRED. Provides metadata about the workflows contain within the Arazzo Description. The metadata MAY be used by tooling as required.
          sourceDescriptions[Source Description Object]REQUIRED. A list of source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. The list MUST have at least one entry.
          workflows[Workflow Object]REQUIRED. A list of workflows. The list MUST have at least one entry.
          componentsComponents ObjectAn element to hold various schemas for the Arazzo Description.
          +

          This object MAY be extended with Specification Extensions.

          +

          Arazzo Specification Object Example

          +
          
          +arazzo: 1.0.0
          +info:
          +  title: A pet purchasing workflow
          +  summary: This Arazzo Description showcases the workflow for how to purchase a pet through a sequence of API calls
          +  description: |
          +      This Arazzo Description walks you through the workflow and steps of `searching` for, `selecting`, and `purchasing` an available pet.
          +  version: 1.0.1
          +sourceDescriptions:
          +- name: petStoreDescription
          +  url: https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml
          +  type: openapi
          +
          +workflows:
          +- workflowId: loginUserAndRetrievePet
          +  summary: Login User and then retrieve pets
          +  description: This workflow lays out the steps to login a user and then retrieve pets
          +  inputs:
          +      type: object
          +      properties:
          +          username:
          +              type: string
          +          password:
          +              type: string
          +  steps:
          +  - stepId: loginStep
          +    description: This step demonstrates the user login step
          +    operationId: loginUser
          +    parameters:
          +      # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          +      - name: username
          +        in: query
          +        value: $inputs.username
          +      - name: password
          +        in: query
          +        value: $inputs.password
          +    successCriteria:
          +      # assertions to determine step was successful
          +      - condition: $statusCode == 200
          +    outputs:
          +      # outputs from this step
          +      tokenExpires: $response.header.X-Expires-After
          +      rateLimit: $response.header.X-Rate-Limit
          +      sessionToken: $response.body
          +  - stepId: getPetStep
          +    description: retrieve a pet by status from the GET pets endpoint
          +    operationPath: '{$sourceDescriptions.petstoreDescription.url}#/paths/~1pet~1findByStatus/get'
          +    parameters:
          +      - name: status
          +        in: query
          +        value: 'available'
          +      - name: Authorization
          +        in: header
          +        value: $steps.loginUser.outputs.sessionToken
          +    successCriteria:
          +      - condition: $statusCode == 200
          +    outputs:
          +      # outputs from this step
          +      availablePets: $response.body
          +  outputs:
          +      available: $steps.getPetStep.availablePets
          +
          +

          Info Object

          +

          The object provides metadata about API workflows defined in this Arazzo document. +The metadata MAY be used by the clients if needed.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          titlestringREQUIRED. A human readable title of the Arazzo Description.
          summarystringA short summary of the Arazzo Description.
          descriptionstringA description of the purpose of the workflows defined. CommonMark syntax MAY be used for rich text representation.
          versionstringREQUIRED. The version identifier of the Arazzo document (which is distinct from the Arazzo Specification version).
          +

          This object MAY be extended with Specification Extensions.

          +

          Info Object Example

          +
          
          +title: A pet purchasing workflow
          +summary: This workflow showcases how to purchase a pet through a sequence of API calls
          +description: |
          +    This workflow walks you through the steps of searching for, selecting, and purchasing an available pet.
          +version: 1.0.1
          +
          +

          Source Description Object

          +

          Describes a source description (such as an OpenAPI description) that will be referenced by one or more workflows described within an Arazzo Description.

          +

          An object storing a map between named description keys and location URLs to the source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. Each source location string MUST be in the form of a URI-reference as defined by RFC3986 section 4.1.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringREQUIRED. A unique name for the source description. Tools and libraries MAY use the name to uniquely identify a source description, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          urlstringREQUIRED. A URL to a source description to be used by a workflow. If a relative reference is used, it MUST be in the form of a URI-reference as defined by RFC3986 section 4.2.
          typestringThe type of source description. Possible values are "openapi" or "arazzo".
          +

          This object MAY be extended with Specification Extensions.

          +

          Source Description Object Example

          +
          
          +name: petStoreDescription
          +url: https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml
          +type: openapi
          +
          +

          Workflow Object

          +

          Describes the steps to be taken across one or more APIs to achieve an objective. The workflow object MAY define inputs needed in order to execute workflow steps, where the defined steps represent a call to an API operation or another workflow, and a set of outputs.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          workflowIdstringREQUIRED. Unique string to represent the workflow. The id MUST be unique amongst all workflows describe in the Arazzo Description. The workflowId value is case-sensitive. Tools and libraries MAY use the workflowId to uniquely identify a workflow, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          summarystringA summary of the purpose or objective of the workflow.
          descriptionstringA description of the workflow. CommonMark syntax MAY be used for rich text representation.
          inputsJSON SchemaA JSON Schema 2020-12 object representing the input parameters used by this workflow.
          dependsOn[string]A list of workflows that MUST be completed before this workflow can be processed. The values provided MUST be a workflowId. If the workflow depended on is defined within the current Workflow Document, then specify the workflowId of the relevant local workflow. If the workflow is defined in a separate Arazzo Document then the workflow MUST be defined in the sourceDescriptions and the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes.
          steps[Step Object]REQUIRED. An ordered list of steps where each step represents a call to an API operation or to another workflow.
          successActions[Success Action Object | Reusable Object]A list of success actions that are applicable for all steps described under this workflow. These success actions can be overridden at the step level but cannot be removed there. If a Reusable Object is provided, it MUST link to success actions defined in the components/successActions of the current Arazzo document. The list MUST NOT include duplicate success actions.
          failureActions[Failure Action Object | Reusable Object]A list of failure actions that are applicable for all steps described under this workflow. These failure actions can be overridden at the step level but cannot be removed there. If a Reusable Object is provided, it MUST link to failure actions defined in the components/failureActions of the current Arazzo document. The list MUST NOT include duplicate failure actions.
          outputsMap[string, {expression}]A map between a friendly name and a dynamic output value. The name MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.
          parameters[Parameter Object | Reusable Object]A list of parameters that are applicable for all steps described under this workflow. These parameters can be overridden at the step level but cannot be removed there. Each parameter MUST be passed to an operation or workflow as referenced by operationId, operationPath, or workflowId as specified within each step. If a Reusable Object is provided, it MUST link to a parameter defined in the components/parameters of the current Arazzo document. The list MUST NOT include duplicate parameters.
          +

          This object MAY be extended with Specification Extensions.

          +

          Workflow Object Example

          +
          
          +workflowId: loginUser
          +summary: Login User
          +description: This workflow lays out the steps to login a user
          +inputs:
          +    type: object
          +    properties:
          +        username:
          +            type: string
          +        password:
          +            type: string
          +steps:
          +  - stepId: loginStep
          +    description: This step demonstrates the user login step
          +    operationId: loginUser
          +    parameters:
          +      # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          +      - name: username
          +        in: query
          +        value: $inputs.username
          +      - name: password
          +        in: query
          +        value: $inputs.password
          +    successCriteria:
          +        # assertions to determine step was successful 
          +        - condition: $statusCode == 200
          +    outputs:
          +        # outputs from this step
          +        tokenExpires: $response.header.X-Expires-After
          +        rateLimit: $response.header.X-Rate-Limit
          +outputs:
          +    tokenExpires: $steps.loginStep.outputs.tokenExpires
          +
          +

          Step Object

          +

          Describes a single workflow step which MAY be a call to an API operation (OpenAPI Operation Object or another Workflow Object.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          descriptionstringA description of the step. CommonMark syntax MAY be used for rich text representation.
          stepIdstringREQUIRED. Unique string to represent the step. The stepId MUST be unique amongst all steps described in the workflow. The stepId value is case-sensitive. Tools and libraries MAY use the stepId to uniquely identify a workflow step, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          operationIdstringThe name of an existing, resolvable operation, as defined with a unique operationId and existing within one of the sourceDescriptions. The referenced operation will be invoked by this workflow step. If multiple (non arazzo type) sourceDescriptions are defined, then the operationId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<operationId>) to avoid ambiguity or potential clashes. This field is mutually exclusive of the operationPath and workflowId fields respectively.
          operationPathstringA reference to a Source combined with a JSON Pointer to reference an operation. This field is mutually exclusive of the operationId and workflowId fields respectively. The operation being referenced MUST be described within one of the sourceDescriptions descriptions. A runtime expression syntax MUST be used to identify the source description document. If the referenced operation has an operationId defined then the operationId SHOULD be preferred over the operationPath.
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description. If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. The field is mutually exclusive of the operationId and operationPath fields respectively.
          parameters[Parameter Object | Reusable Object]A list of parameters that MUST be passed to an operation or workflow as referenced by operationId, operationPath, or workflowId. If a parameter is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a parameter defined in the components/parameters of the current Arazzo document. The list MUST NOT include duplicate parameters.
          requestBodyRequest Body ObjectThe request body to pass to an operation as referenced by operationId or operationPath. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as GET, HEAD and DELETE), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.
          successCriteria[Criterion Object]A list of assertions to determine the success of the step. Each assertion is described using a Criterion Object. All assertions MUST be satisfied for the step to be deemed successful.
          onSuccess[Success Action Object | Reusable Object]An array of success action objects that specify what to do upon step success. If omitted, the next sequential step shall be executed as the default behavior. If multiple success actions have similar criteria, the first sequential action matching the criteria SHALL be the action executed. If a success action is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a success action defined in the components of the current Arazzo document. The list MUST NOT include duplicate success actions.
          onFailure[Failure Action Object | Reusable Object]An array of failure action objects that specify what to do upon step failure. If omitted, the default behavior is to break and return. If multiple failure actions have similar criteria, the first sequential action matching the criteria SHALL be the action executed. If a failure action is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a failure action defined in the components of the current Arazzo document. The list MUST NOT include duplicate failure actions.
          outputsMap[string, {expression}]A map between a friendly name and a dynamic output value defined using a runtime expression. The name MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.
          +

          This object MAY be extended with Specification Extensions.

          +

          Step Object Example

          +

          Single step

          +
          
          +stepId: loginStep
          +description: This step demonstrates the user login step
          +operationId: loginUser
          +parameters:
          +    # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          +    - name: username
          +      in: query
          +      value: $inputs.username
          +    - name: password
          +      in: query
          +      value: $inputs.password
          +successCriteria:
          +    # assertions to determine step was successful
          +    - condition: $statusCode == 200
          +outputs:
          +    # outputs from this step
          +    tokenExpires: $response.header.X-Expires-After
          +    rateLimit: $response.header.X-Rate-Limit
          +
          +

          Multiple steps

          +
          
          +steps:
          +  - stepId: loginStep
          +    description: This step demonstrates the user login step
          +    operationId: loginUser
          +    parameters:
          +        # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          +      - name: username
          +        in: query
          +        value: $inputs.username
          +      - name: password
          +        in: query
          +        value: $inputs.password
          +    successCriteria:
          +        # assertions to determine step was successful
          +      - condition: $statusCode == 200
          +    outputs:
          +        # outputs from this step
          +        tokenExpires: $response.header.X-Expires-After
          +        rateLimit: $response.header.X-Rate-Limit
          +        sessionToken: $response.body
          +  - stepId: getPetStep
          +    description: retrieve a pet by status from the GET pets endpoint
          +    operationPath: '{$sourceDescriptions.petStoreDescription.url}#/paths/~1pet~1findByStatus/get'
          +    parameters:
          +      - name: status
          +        in: query
          +        value: 'available'
          +      - name: Authorization
          +        in: header
          +        value: $steps.loginUser.outputs.sessionToken
          +    successCriteria:
          +      - condition: $statusCode == 200
          +    outputs:
          +        # outputs from this step
          +        availablePets: $response.body
          +
          +

          Parameter Object

          +

          Describes a single step parameter. A unique parameter is defined by the combination of a name and in fields. There are four possible locations specified by the in field:

          +
            +
          • path - Used together with OpenAPI style Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
          • +
          • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
          • +
          • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
          • +
          • cookie - Used to pass a specific cookie value to the source API.
          • +
          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
          instringThe name location of the parameter. Possible values are "path", "query", "header", "cookie", or "body". When the step in context specifies a workflowId, then all parameters map to workflow inputs. In all other scenarios (e.g., a step specifies an operationId), the in field MUST be specified.
          valueAny | {expression}REQUIRED. The value to pass in the parameter. The value can be a constant or an Runtime Expression to be evaluated and passed to the referenced operation or workflow.
          +

          This object MAY be extended with Specification Extensions.

          +

          Parameter Object Example

          +

          Query Example

          +
          
          +- name: username
          +  in: query
          +  value: $inputs.username
          +
          +

          Header Example

          +
          
          +- name: X-Api-Key
          +  in: header
          +  value: $inputs.x-api-key
          +
          +

          Success Action Object

          +

          A single success action which describes an action to take upon success of a workflow step. There are two possible values for the type field.

          +
            +
          • end - The workflow ends, and context returns to the caller with applicable outputs
          • +
          • goto - A one-way transfer of workflow control to the specified label (either a workflowId or stepId)
          • +
          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringREQUIRED. The name of the success action. Names are case sensitive.
          typestringREQUIRED. The type of action to take. Possible values are "end" or "goto".
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description to transfer to upon success of the step. This field is only relevant when the type field value is "goto". If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. This field is mutually exclusive to stepId.
          stepIdstringThe stepId to transfer to upon success of the step. This field is only relevant when the type field value is "goto". The referenced stepId MUST be within the current workflow. This field is mutually exclusive to workflowId.
          criteria[Criterion Object]A list of assertions to determine if this action SHALL be executed. Each assertion is described using a Criterion Object. All criteria assertions MUST be satisfied for the action to be executed.
          +

          This object MAY be extended with Specification Extensions.

          +

          Success Action Object Example

          +
          
          +name: JoinWaitingList
          +type: goto
          +stepId: joinWaitingListStep
          +criteria:
          +    # assertions to determine if this success action should be executed
          +    - context: $response.body
          +      condition: $[?count(@.pets) > 0]
          +      type: JSONPath
          +
          +

          Failure Action Object

          +

          A single failure action which describes an action to take upon failure of a workflow step. There are three possible values for the type field.

          +
            +
          • end - The workflow ends, and context returns to the caller with applicable outputs
          • +
          • retry - The current step will be retried. The retry will be constrained by the retryAfter and retryLimit fields. If a stepId or workflowId are specified, then the reference is executed and the context is returned, after which the current step is retried.
          • +
          • goto - A one-way transfer of workflow control to the specified label (either a workflowId or stepId)
          • +
          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringREQUIRED. The name of the failure action. Names are case sensitive.
          typestringREQUIRED. The type of action to take. Possible values are "end", "retry", or "goto".
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description to transfer to upon failure of the step. This field is only relevant when the type field value is "goto" or "retry". If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. This field is mutually exclusive to stepId. When used with "retry", context transfers back upon completion of the specified workflow.
          stepIdstringThe stepId to transfer to upon failure of the step. This field is only relevant when the type field value is "goto" or "retry". The referenced stepId MUST be within the current workflow. This field is mutually exclusive to workflowId. When used with "retry", context transfers back upon completion of the specified step.
          retryAfternumberA non-negative decimal indicating the seconds to delay after the step failure before another attempt SHALL be made. Note: if an HTTP Retry-After response header was returned to a step from a targeted operation, then it SHOULD overrule this particular field value. This field only applies when the type field value is "retry" or "function".
          retryLimitintegerA non-negative integer indicating how many attempts to retry the step MAY be attempted before failing the overall step. If not specified then a single retry SHALL be attempted. This field only applies when the type field value is "retry". The retryLimit MUST be exhausted prior to executing subsequent failure actions.
          criteria[Criterion Object]A list of assertions to determine if this action SHALL be executed. Each assertion is described using a Criterion Object.
          +

          This object MAY be extended with Specification Extensions.

          +

          Failure Action Object Example

          +
          
          +name: retryStep
          +type: retry
          +retryAfter: 1
          +retryLimit: 5
          +criteria:
          +    # assertions to determine if this action should be executed
          +    - condition: $statusCode == 503
          +
          +

          Components Object

          +

          Holds a set of reusable objects for different aspects of the Arazzo Specification. All objects defined within the components object will have no effect on the Arazzo Description unless they are explicitly referenced from properties outside the components object.

          +

          Components are scoped to the Arazzo document they are defined in. For example, if a step defined in Arazzo document “A” references a workflow defined in Arazzo document “B”, the components in “A” are not considered when evaluating the workflow referenced in “B”.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          inputsMap[string, JSON Schema]An object to hold reusable JSON Schema objects to be referenced from workflow inputs.
          parametersMap[string, Parameter Object]An object to hold reusable Parameter Objects
          successActionsMap[string, Success Action Object]An object to hold reusable Success Actions Objects.
          failureActionsMap[string, Failure Action Object]An object to hold reusable Failure Actions Objects.
          +

          This object MAY be extended with Specification Extensions.

          +

          All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$. The key is used to refer to the input or parameter in other parts of the Workflow Description.

          +

          Field Name Examples:

          +
          
          +User
          +User_1
          +User_Name
          +user-name
          +my.org.User
          +
          +

          Components Object Example

          +
          
          +components:
          +  parameters:
          +    storeId:
          +      name: storeId
          +      in: header
          +      value: $inputs.x-store-id
          +  inputs:
          +    pagination:
          +      type: object
          +      properties:
          +        page:
          +          type: integer
          +          format: int32
          +        pageSize:
          +          type: integer
          +          format: int32
          +  failureActions:
          +    refreshToken:
          +      name: refreshExpiredToken
          +      type: retry
          +      retryAfter: 1
          +      retryLimit: 5
          +      workflowId: refreshTokenWorkflowId
          +      criteria:
          +          # assertions to determine if this action should be executed
          +          - condition: $statusCode == 401       
          +
          +
          
          +"components": {
          +  "parameters": {
          +    "storeId": {
          +      "name": "storeId",
          +      "in": "header",
          +      "value": "$inputs.x-store-id"
          +    }
          +  },
          +  "inputs": {
          +    "pagination": {
          +      "type": "object",
          +      "properties": {
          +        "page": {
          +          "type": "integer",
          +          "format": "int32"
          +        },
          +        "pageSize": {
          +          "type": "integer",
          +          "format": "int32"
          +        }
          +      }
          +    }
          +  },
          +  "failureActions": {
          +    "refreshToken": {
          +      "name": "refreshExpiredToken",
          +      "type": "retry",
          +      "retryAfter": 1,
          +      "retryLimit": 5,
          +      "workflowId": "refreshTokenWorkflowId",
          +      "criteria": [
          +        {
          +          "condition": "{$statusCode == 401}"
          +        }
          +      ]
          +    }
          +  }
          +}
          +
          +

          Reusable Object

          +

          A simple object to allow referencing of objects contained within the Components Object. It can be used from locations within steps or workflows in the Arazzo Description. Note - Input Objects MUST use standard JSON Schema referencing via the $ref keyword while all non JSON Schema objects use this object and its expression based referencing mechanism.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          valuestringSets a value of the referenced parameter. This is only applicable for parameter object references.
          +

          This object cannot be extended with additional properties and any properties added MUST be ignored.

          +

          Reusable Object Example

          +
          
          +  reference: $components.successActions.notify
          +
          +
          
          +  {
          +    "reference": "$components.successActions.notify"
          +  }
          +
          +
          
          +  reference: $components.parameters.page
          +  value: 1
          +
          +
          
          +  {
          +    "reference": "$components.parameters.page",
          +    "value": 1
          +  }
          +
          +

          Criterion Object

          +

          An object used to specify the context, conditions, and condition types that can be used to prove or satisfy assertions specified in Step Object successCriteria, Success Action Object criteria, and Failure Action Object criteria.

          +

          There are four flavors of conditions supported:

          +
            +
          • simple - where basic literals, operators, and loose comparisons are used in combination with Runtime Expressions.
          • +
          • regex - where a regex pattern is applied on the supplied context. The context is defined by a Runtime Expression.
          • +
          • jsonpath - where a JSON Path expression is applied. The root node context is defined by a Runtime Expression.
          • +
          • xpath - where an XPath expression is applied. The root node context is defined by a Runtime Expression.
          • +
          +

          Literals

          +

          As part of a condition expression, you can use boolean, null, number, or string data types.

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          TypeLiteral value
          booleantrue or false
          nullnull
          numberAny number format supported in Data Types
          stringStrings MUST use single quotes (‘) around the string. To use a literal single quote, escape the literal single quote using an additional single quote (’').
          +

          Operators

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          OperatorDescription
          <Less than
          <=Less than or equal
          >Greater than
          >=Greater than or equal
          ==Equal
          !=Not equal
          !Not
          &&And
          &#124;&#124;Or
          ()Logical Grouping
          []Index (0-based)
          .Property de-reference
          +

          String comparisons MUST be case insensitive.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          context{expression}A runtime expression used to set the context for the condition to be applied on. If type is specified, then the context MUST be provided (e.g. $response.body would set the context that a JSONPath query expression could be applied to).
          conditionstringREQUIRED. The condition to apply. Conditions can be simple (e.g. $statusCode == 200 which applies a operator on a value obtained from a runtime expression), or a regex, or a JSONPath expression. For regex and JSONPath, the type and context MUST be specified.
          typestring | Criterion Expression Type ObjectThe type of condition to be applied. If specified, the options allowed are simple, regex, jsonpath or xpath. If omitted, then the condition is assumed to be simple, which at most combines literals, operators and Runtime Expressions. If jsonpath, then the expression MUST conform to JSON Path. If xpath the expression MUST conform to XML Path Language 3.1. Should other variants of JSON Path or XPath be required, then a Criterion Expression Type Object MUST be specified.
          +

          This object MAY be extended with Specification Extensions.

          +

          Criterion Object Example

          +

          Simple Condition Example

          +
          
          +- condition: $statusCode == 200
          +
          +

          Regex Condition Example

          +
          
          +- context: $statusCode
          +  condition: '^200$'
          +  type: regex
          +
          +

          JSONPath Condition Example

          +
          
          +- context: $response.body
          +  condition: $[?count(@.pets) > 0]
          +  type: jsonpath
          +
          +

          Criterion Expression Type Object

          +

          An object used to describe the type and version of an expression used within a Criterion Object. If this object is not defined, then the following defaults apply:

          + +

          Defining this object gives the ability to utilize tooling compatible with older versions of either JSON Path or XPath.

          +
          Fixed Fields
          + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          typestringREQUIRED. The type of condition to be applied. The options allowed are jsonpath or xpath.
          versionstringREQUIRED. A short hand string representing the version of the expression type being used. The allowed values for JSON Path are draft-goessner-dispatch-jsonpath-00. The allowed values for XPath are xpath-30, xpath-20, or xpath-10.
          +

          This object MAY be extended with Specification Extensions.

          +

          Criterion Expression Type Example

          +

          JSON Path Example

          +
          
          +  type: jsonpath
          +  version: draft-goessner-dispatch-jsonpath-00
          +
          +

          XPath Example

          +
          
          +  type: xpath
          +  version: xpath-30
          +
          +

          Request Body Object

          +

          A single request body describing the Content-Type and request body content to be passed by a step to an operation.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          contentTypestringThe Content-Type for the request content. If omitted then refer to Content-Type specified at the targeted operation to understand serialization requirements.
          payloadAnyA value representing the request body payload. The value can be a literal value or can contain Runtime Expressions which MUST be evaluated prior to calling the referenced operation. To represent examples of media types that cannot be naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
          +

          replacements | [Payload Replacement Object] | A list of locations and values to set within a payload.

          +

          This object MAY be extended with Specification Extensions.

          +

          RequestBody Object Example

          +

          JSON Templated Example

          +
           contentType: application/json
          + payload: |
          +   {
          +     "petOrder": {
          +       "petId": "{$inputs.pet_id}",
          +       "couponCode": "{$inputs.coupon_code}",
          +       "quantity": "{$inputs.quantity}",
          +       "status": "placed",
          +       "complete": false
          +     }
          +   }
          +
          +

          JSON Object Example

          +
           contentType: application/json
          + payload: 
          +   petOrder:
          +     petId: $inputs.pet_id
          +     couponCode: $inputs.coupon_code
          +     quantity: $inputs.quantity
          +     status: placed
          +     complete: false
          +
          +

          Complete Runtime Expression

          +
           contentType: application/json
          + payload: $inputs.petOrderRequest
          +
          +

          XML Templated Example

          +
           contentType: application/xml
          + payload: |
          +   <petOrder>
          +     <petId>{$inputs.pet_id}</petId>
          +     <couponCode>{$inputs.coupon_code}</couponCode>
          +     <quantity>{$inputs.quantity}</quantity>
          +     <status>placed</status>
          +     <complete>false</complete>
          +   </petOrder>
          +
          +

          Form Data Example

          +
           contentType: application/x-www-form-urlencoded
          + payload: 
          +   client_id: $inputs.clientId
          +   grant_type: $inputs.grantType
          +   redirect_uri: $inputs.redirectUri
          +   client_secret: $inputs.clientSecret
          +   code: $steps.browser-authorize.outputs.code
          +   scope: $inputs.scope  
          +
          +

          Form Data String Example

          +
           contentType: application/x-www-form-urlencoded
          + payload: "client_id={$inputs.clientId}&grant_type={$inputs.grantType}&redirect_uri={$inputs.redirectUri}&client_secret={$inputs.clientSecret}&code{$steps.browser-authorize.outputs.code}&scope=$inputs.scope}"
          +
          +

          Payload Replacement Object

          +

          Describes a location within a payload (e.g., a request body) and a value to set within the location.

          +
          Fixed Fields
          + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          targetstringREQUIRED. A JSON Pointer or XPath Expression which MUST be resolved against the request body. Used to identify the location to inject the value.
          valueAny | {expression}REQUIRED. The value set within the target location. The value can be a constant or a Runtime Expression to be evaluated and passed to the referenced operation or workflow.
          +

          This object MAY be extended with Specification Extensions.

          +
          Payload Replacement Object Example
          +

          Runtime Expression Example

          +
          
          +    target: /petId
          +    value: $inputs.pet_id
          +
          +

          Literal Example

          +
          
          +    target: /quantity
          +    value: 10
          +
          +

          Runtime Expressions

          +

          A runtime expression allows values to be defined based on information that will be available within an HTTP message, an event message, and within objects serialized from the Arazzo document such as workflows or steps.

          +

          The runtime expression is defined by the following ABNF syntax:

          +
          
          +      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source / "$message." source / "$inputs." name / "$outputs." name / "$steps." name / "$workflows." name / "$sourceDescriptions." name / "$components." name / "$components.parameters." parameter-name)
          +      parameter-name = name ; Reuses 'name' rule for parameter names
          +      source = ( header-reference / query-reference / path-reference / body-reference )
          +      header-reference = "header." token
          +      query-reference = "query." name
          +      path-reference = "path." name
          +      body-reference = "body" ["#" json-pointer ]
          +      json-pointer    = *( "/" reference-token )
          +      reference-token = *( unescaped / escaped )
          +      unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
          +         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
          +      escaped         = "~" ( "0" / "1" )
          +        ; representing '~' and '/', respectively
          +      name = *( CHAR )
          +      token = 1*tchar
          +      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
          +        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
          +
          +
          Examples
          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Source Locationexample expressionnotes
          HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
          Requested media type$request.header.accept
          Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
          Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
          Request URL$url
          Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
          Response header$response.header.ServerSingle header values only are available
          workflow input$inputs.username or $workflows.foo.inputs.usernameSingle input values only are available
          Step output value$steps.someStep.petsIn situations where the output named property return payloads, references may be made to portions of the response body or the entire body.
          Workflow output value$outputs.bar or $workflows.foo.outputs.barSingle input values only are available
          Components parameter$components.parameters.fooAccesses a foo parameter defined within the Components Object.
          +

          Runtime expressions preserve the type of the referenced value. +Expressions can be embedded into string values by surrounding the expression with {} curly braces.

          +

          Specification Extensions

          +

          While the Arazzo Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          +

          The extension properties are implemented as patterned fields that are always prefixed by "x-".

          + + + + + + + + + + + + + + + +
          Field PatternTypeDescription
          ^x-AnyAllows extensions to the Arazzo Specification. The field name MUST begin with x-, for example, x-internal-id. Field names beginning x-oai-, x-oas-, and x-arazzo are reserved for uses defined by the OpenAPI Initiative. The value MAY be null, a primitive, an array or an object.
          +

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          +

          Security Considerations

          +

          The Arazzo Specification does not enforce a security mechanism. Security is left to the implementer, though TLS, specifically HTTPS may be recommended for exchanging sensitive workflows.

          +

          Arazzo Descriptions can be JSON or YAML values. As such, all security considerations defined in RFC 8259 and within YAML version 1.2 apply.

          +

          Arazzo Descriptions are frequently written by untrusted third parties, to be deployed on public Internet servers. Processing an Arazzo Description can cause both safe and unsafe operations to be performed on arbitrary network resources. It is the responsibility of the description consumer to ensure that the operations performed are not harmful.

          +

          IANA Considerations

          +

          The proposed MIME media types for the Arazzo Specification are described below.

          +

          application/vnd.oai.workflows

          +

          The default (or general) MIME type for Arazzo documents (e.g. workflows) is defined as follows:

          +

            Media type name: application

          +

            Media subtype name: vnd.oai.workflows

          +

            Required parameters: N/A

          +

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of workflow conforms to version 1.0.0 of the Arazzo Specification).

          +

            Encoding considerations: Encoding considerations are identical to those specified for the application/json and application/yaml media types, respectively.

          +

            Security considerations: See security considerations above.

          +

            Interoperability considerations: N/A

          +

          Note: When using the application/vnd.oai.workflows media type the consumer should be prepared to receive YAML formatted content

          +

          application/vnd.oai.workflows+json

          +

          The proposed MIME media type for Arazzo documents (e.g. workflows) that require a JSON-specific media type is defined as follows:

          +

            Media type name: application

          +

            Media subtype name: vnd.oai.workflows+json

          +

            Required parameters: N/A

          +

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of Arazzo document conforms to version 1.0.0 of the Arazzo Specification).

          +

            Encoding considerations: Encoding considerations are identical to those specified for the application/json media type.

          +

            Security considerations: See security considerations above.

          +

            Interoperability considerations: N/A

          +

          application/vnd.oai.workflows+yaml

          +

          The proposed MIME media type for Arazzo documents (e.g. workflows) that require a YAML-specific media type is defined as follows:

          +

            Media type name: application

          +

            Media subtype name: vnd.oai.workflows+yaml

          +

            Required parameters: N/A

          +

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of Arazzo document conforms to version 1.0.0 of the Arazzo Specification).

          +

            Encoding considerations: Encoding considerations are identical to those specified for the application/yaml media type.

          +

            Security considerations: See security considerations above.

          +

            Interoperability considerations: N/A

          +

          Appendix A: Revision History

          + + + + + + + + + + + + + + + +
          VersionDateNotes
          1.0.02024-05-29First release of the Arazzo Specification
          + From 5d35d010269c3f577e710f9586f315487e03641f Mon Sep 17 00:00:00 2001 From: frankkilcommins Date: Thu, 23 May 2024 11:26:30 +0000 Subject: [PATCH 124/152] Update ReSpec versions Signed-off-by: GitHub --- arazzo/latest.html | 1277 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 1277 insertions(+) create mode 100644 arazzo/latest.html diff --git a/arazzo/latest.html b/arazzo/latest.html new file mode 100644 index 0000000000..96aa78e744 --- /dev/null +++ b/arazzo/latest.html @@ -0,0 +1,1277 @@ +The Arazzo Specification v1.0.0 | Introduction, Definitions, & More + + +

          The Arazzo Specification v1.0.0

          The Arazzo Specification provides a mechanism that can define sequences of calls and their dependencies to be woven together and expressed in the context of delivering a particular outcome or set of outcomes when dealing with API descriptions (such as OpenAPI descriptions).

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.
          +

          Arazzo Specification

          +

          Version 1.0.0

          +

          The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

          +

          This document is licensed under The Apache License, Version 2.0.

          +

          Introduction

          +

          Being able to express specific sequences of calls and articulate the dependencies between them to achieve a particular goal is desirable in the context of API descriptions. The aim of the Arazzo Specification is to provide a mechanism that can define sequences of calls and their dependencies to be woven together and expressed in the context of delivering a particular outcome or set of outcomes when dealing with API descriptions (such as OpenAPI descriptions).

          +

          The Arazzo Specification can articulate these workflows in a human-readable and machine-readable manner, thus improving the capability of API specifications to tell the story of the API in a manner that can improve the consuming developer experience.

          + + +

          Definitions

          +

          Arazzo Description

          +

          A self-contained document (or set of documents) which defines or describes API workflows (specific sequence of calls to achieve a particular goal in the context of an API definition). An Arazzo Description uses and conforms to the Arazzo Specification, and MUST contain a valid Arazzo Specification version field (arazzo), an Info field, a sourceDescriptions field with at least one defined Source, and there MUST be at least one Workflow defined in the workflows fixed field.

          +

          Specification

          +

          Versions

          +

          The Arazzo Specification is versioned using a major.minor.patch versioning scheme. The major.minor portion of the version string (for example 1.0) SHALL designate the Arazzo feature set. .patch versions address errors in, or provide clarifications to, this document, not the feature set. The patch version SHOULD NOT be considered by tooling, making no distinction between 1.0.0 and 1.0.1 for example.

          +

          Format

          +

          An Arazzo Description that conforms to the Arazzo Specification is itself a JSON object, which may be represented either in JSON or YAML format.

          +

          All field names in the specification are case sensitive. +This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

          +

          In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

          + +

          Arazzo Description Structure

          +

          It is RECOMMENDED that the entry Arazzo document be named: arazzo.json or arazzo.yaml.

          +

          An Arazzo Description MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. If workflows from other documents are being referenced, they must by included as a Source Description Object. In a multi-document description, the document containing the Arazzo Specification Object is known as the entry Arazzo document.

          +

          Data Types

          +

          Data types in the Arazzo Specification are based on the types supported by the JSON Schema Specification Draft 2020-12. Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part.

          +

          As defined by the JSON Schema Validation vocabulary, data types can have an optional modifier property: format. Arazzo additionally supports the formats (similar to the OpenAPI specification) to provide fine detail for primitive data types.

          +

          The formats defined are:

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          typeformatComments
          integerint32signed 32 bits
          integerint64signed 64 bits (a.k.a long)
          numberfloat
          numberdouble
          stringpasswordA hint to UIs to obscure input.
          +

          Relative References in URLs

          +

          Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. +Unless specified otherwise, relative references are resolved using the URL of the referring document.

          +

          Schema

          +

          In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

          +

          Arazzo Specification Object

          +

          This is the root object of the Arazzo Description.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          arazzostringREQUIRED. This string MUST be the version number of the Arazzo Specification that the Arazzo Description uses. The arazzo field MUST be used by tooling to interpret the Arazzo Description.
          infoInfo ObjectREQUIRED. Provides metadata about the workflows contain within the Arazzo Description. The metadata MAY be used by tooling as required.
          sourceDescriptions[Source Description Object]REQUIRED. A list of source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. The list MUST have at least one entry.
          workflows[Workflow Object]REQUIRED. A list of workflows. The list MUST have at least one entry.
          componentsComponents ObjectAn element to hold various schemas for the Arazzo Description.
          +

          This object MAY be extended with Specification Extensions.

          +

          Arazzo Specification Object Example

          +
          
          +arazzo: 1.0.0
          +info:
          +  title: A pet purchasing workflow
          +  summary: This Arazzo Description showcases the workflow for how to purchase a pet through a sequence of API calls
          +  description: |
          +      This Arazzo Description walks you through the workflow and steps of `searching` for, `selecting`, and `purchasing` an available pet.
          +  version: 1.0.1
          +sourceDescriptions:
          +- name: petStoreDescription
          +  url: https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml
          +  type: openapi
          +
          +workflows:
          +- workflowId: loginUserAndRetrievePet
          +  summary: Login User and then retrieve pets
          +  description: This workflow lays out the steps to login a user and then retrieve pets
          +  inputs:
          +      type: object
          +      properties:
          +          username:
          +              type: string
          +          password:
          +              type: string
          +  steps:
          +  - stepId: loginStep
          +    description: This step demonstrates the user login step
          +    operationId: loginUser
          +    parameters:
          +      # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          +      - name: username
          +        in: query
          +        value: $inputs.username
          +      - name: password
          +        in: query
          +        value: $inputs.password
          +    successCriteria:
          +      # assertions to determine step was successful
          +      - condition: $statusCode == 200
          +    outputs:
          +      # outputs from this step
          +      tokenExpires: $response.header.X-Expires-After
          +      rateLimit: $response.header.X-Rate-Limit
          +      sessionToken: $response.body
          +  - stepId: getPetStep
          +    description: retrieve a pet by status from the GET pets endpoint
          +    operationPath: '{$sourceDescriptions.petstoreDescription.url}#/paths/~1pet~1findByStatus/get'
          +    parameters:
          +      - name: status
          +        in: query
          +        value: 'available'
          +      - name: Authorization
          +        in: header
          +        value: $steps.loginUser.outputs.sessionToken
          +    successCriteria:
          +      - condition: $statusCode == 200
          +    outputs:
          +      # outputs from this step
          +      availablePets: $response.body
          +  outputs:
          +      available: $steps.getPetStep.availablePets
          +
          +

          Info Object

          +

          The object provides metadata about API workflows defined in this Arazzo document. +The metadata MAY be used by the clients if needed.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          titlestringREQUIRED. A human readable title of the Arazzo Description.
          summarystringA short summary of the Arazzo Description.
          descriptionstringA description of the purpose of the workflows defined. CommonMark syntax MAY be used for rich text representation.
          versionstringREQUIRED. The version identifier of the Arazzo document (which is distinct from the Arazzo Specification version).
          +

          This object MAY be extended with Specification Extensions.

          +

          Info Object Example

          +
          
          +title: A pet purchasing workflow
          +summary: This workflow showcases how to purchase a pet through a sequence of API calls
          +description: |
          +    This workflow walks you through the steps of searching for, selecting, and purchasing an available pet.
          +version: 1.0.1
          +
          +

          Source Description Object

          +

          Describes a source description (such as an OpenAPI description) that will be referenced by one or more workflows described within an Arazzo Description.

          +

          An object storing a map between named description keys and location URLs to the source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. Each source location string MUST be in the form of a URI-reference as defined by RFC3986 section 4.1.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringREQUIRED. A unique name for the source description. Tools and libraries MAY use the name to uniquely identify a source description, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          urlstringREQUIRED. A URL to a source description to be used by a workflow. If a relative reference is used, it MUST be in the form of a URI-reference as defined by RFC3986 section 4.2.
          typestringThe type of source description. Possible values are "openapi" or "arazzo".
          +

          This object MAY be extended with Specification Extensions.

          +

          Source Description Object Example

          +
          
          +name: petStoreDescription
          +url: https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml
          +type: openapi
          +
          +

          Workflow Object

          +

          Describes the steps to be taken across one or more APIs to achieve an objective. The workflow object MAY define inputs needed in order to execute workflow steps, where the defined steps represent a call to an API operation or another workflow, and a set of outputs.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          workflowIdstringREQUIRED. Unique string to represent the workflow. The id MUST be unique amongst all workflows describe in the Arazzo Description. The workflowId value is case-sensitive. Tools and libraries MAY use the workflowId to uniquely identify a workflow, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          summarystringA summary of the purpose or objective of the workflow.
          descriptionstringA description of the workflow. CommonMark syntax MAY be used for rich text representation.
          inputsJSON SchemaA JSON Schema 2020-12 object representing the input parameters used by this workflow.
          dependsOn[string]A list of workflows that MUST be completed before this workflow can be processed. The values provided MUST be a workflowId. If the workflow depended on is defined within the current Workflow Document, then specify the workflowId of the relevant local workflow. If the workflow is defined in a separate Arazzo Document then the workflow MUST be defined in the sourceDescriptions and the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes.
          steps[Step Object]REQUIRED. An ordered list of steps where each step represents a call to an API operation or to another workflow.
          successActions[Success Action Object | Reusable Object]A list of success actions that are applicable for all steps described under this workflow. These success actions can be overridden at the step level but cannot be removed there. If a Reusable Object is provided, it MUST link to success actions defined in the components/successActions of the current Arazzo document. The list MUST NOT include duplicate success actions.
          failureActions[Failure Action Object | Reusable Object]A list of failure actions that are applicable for all steps described under this workflow. These failure actions can be overridden at the step level but cannot be removed there. If a Reusable Object is provided, it MUST link to failure actions defined in the components/failureActions of the current Arazzo document. The list MUST NOT include duplicate failure actions.
          outputsMap[string, {expression}]A map between a friendly name and a dynamic output value. The name MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.
          parameters[Parameter Object | Reusable Object]A list of parameters that are applicable for all steps described under this workflow. These parameters can be overridden at the step level but cannot be removed there. Each parameter MUST be passed to an operation or workflow as referenced by operationId, operationPath, or workflowId as specified within each step. If a Reusable Object is provided, it MUST link to a parameter defined in the components/parameters of the current Arazzo document. The list MUST NOT include duplicate parameters.
          +

          This object MAY be extended with Specification Extensions.

          +

          Workflow Object Example

          +
          
          +workflowId: loginUser
          +summary: Login User
          +description: This workflow lays out the steps to login a user
          +inputs:
          +    type: object
          +    properties:
          +        username:
          +            type: string
          +        password:
          +            type: string
          +steps:
          +  - stepId: loginStep
          +    description: This step demonstrates the user login step
          +    operationId: loginUser
          +    parameters:
          +      # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          +      - name: username
          +        in: query
          +        value: $inputs.username
          +      - name: password
          +        in: query
          +        value: $inputs.password
          +    successCriteria:
          +        # assertions to determine step was successful 
          +        - condition: $statusCode == 200
          +    outputs:
          +        # outputs from this step
          +        tokenExpires: $response.header.X-Expires-After
          +        rateLimit: $response.header.X-Rate-Limit
          +outputs:
          +    tokenExpires: $steps.loginStep.outputs.tokenExpires
          +
          +

          Step Object

          +

          Describes a single workflow step which MAY be a call to an API operation (OpenAPI Operation Object or another Workflow Object.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          descriptionstringA description of the step. CommonMark syntax MAY be used for rich text representation.
          stepIdstringREQUIRED. Unique string to represent the step. The stepId MUST be unique amongst all steps described in the workflow. The stepId value is case-sensitive. Tools and libraries MAY use the stepId to uniquely identify a workflow step, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          operationIdstringThe name of an existing, resolvable operation, as defined with a unique operationId and existing within one of the sourceDescriptions. The referenced operation will be invoked by this workflow step. If multiple (non arazzo type) sourceDescriptions are defined, then the operationId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<operationId>) to avoid ambiguity or potential clashes. This field is mutually exclusive of the operationPath and workflowId fields respectively.
          operationPathstringA reference to a Source combined with a JSON Pointer to reference an operation. This field is mutually exclusive of the operationId and workflowId fields respectively. The operation being referenced MUST be described within one of the sourceDescriptions descriptions. A runtime expression syntax MUST be used to identify the source description document. If the referenced operation has an operationId defined then the operationId SHOULD be preferred over the operationPath.
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description. If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. The field is mutually exclusive of the operationId and operationPath fields respectively.
          parameters[Parameter Object | Reusable Object]A list of parameters that MUST be passed to an operation or workflow as referenced by operationId, operationPath, or workflowId. If a parameter is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a parameter defined in the components/parameters of the current Arazzo document. The list MUST NOT include duplicate parameters.
          requestBodyRequest Body ObjectThe request body to pass to an operation as referenced by operationId or operationPath. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as GET, HEAD and DELETE), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.
          successCriteria[Criterion Object]A list of assertions to determine the success of the step. Each assertion is described using a Criterion Object. All assertions MUST be satisfied for the step to be deemed successful.
          onSuccess[Success Action Object | Reusable Object]An array of success action objects that specify what to do upon step success. If omitted, the next sequential step shall be executed as the default behavior. If multiple success actions have similar criteria, the first sequential action matching the criteria SHALL be the action executed. If a success action is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a success action defined in the components of the current Arazzo document. The list MUST NOT include duplicate success actions.
          onFailure[Failure Action Object | Reusable Object]An array of failure action objects that specify what to do upon step failure. If omitted, the default behavior is to break and return. If multiple failure actions have similar criteria, the first sequential action matching the criteria SHALL be the action executed. If a failure action is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a failure action defined in the components of the current Arazzo document. The list MUST NOT include duplicate failure actions.
          outputsMap[string, {expression}]A map between a friendly name and a dynamic output value defined using a runtime expression. The name MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.
          +

          This object MAY be extended with Specification Extensions.

          +

          Step Object Example

          +

          Single step

          +
          
          +stepId: loginStep
          +description: This step demonstrates the user login step
          +operationId: loginUser
          +parameters:
          +    # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          +    - name: username
          +      in: query
          +      value: $inputs.username
          +    - name: password
          +      in: query
          +      value: $inputs.password
          +successCriteria:
          +    # assertions to determine step was successful
          +    - condition: $statusCode == 200
          +outputs:
          +    # outputs from this step
          +    tokenExpires: $response.header.X-Expires-After
          +    rateLimit: $response.header.X-Rate-Limit
          +
          +

          Multiple steps

          +
          
          +steps:
          +  - stepId: loginStep
          +    description: This step demonstrates the user login step
          +    operationId: loginUser
          +    parameters:
          +        # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          +      - name: username
          +        in: query
          +        value: $inputs.username
          +      - name: password
          +        in: query
          +        value: $inputs.password
          +    successCriteria:
          +        # assertions to determine step was successful
          +      - condition: $statusCode == 200
          +    outputs:
          +        # outputs from this step
          +        tokenExpires: $response.header.X-Expires-After
          +        rateLimit: $response.header.X-Rate-Limit
          +        sessionToken: $response.body
          +  - stepId: getPetStep
          +    description: retrieve a pet by status from the GET pets endpoint
          +    operationPath: '{$sourceDescriptions.petStoreDescription.url}#/paths/~1pet~1findByStatus/get'
          +    parameters:
          +      - name: status
          +        in: query
          +        value: 'available'
          +      - name: Authorization
          +        in: header
          +        value: $steps.loginUser.outputs.sessionToken
          +    successCriteria:
          +      - condition: $statusCode == 200
          +    outputs:
          +        # outputs from this step
          +        availablePets: $response.body
          +
          +

          Parameter Object

          +

          Describes a single step parameter. A unique parameter is defined by the combination of a name and in fields. There are four possible locations specified by the in field:

          +
            +
          • path - Used together with OpenAPI style Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
          • +
          • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
          • +
          • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
          • +
          • cookie - Used to pass a specific cookie value to the source API.
          • +
          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
          instringThe name location of the parameter. Possible values are "path", "query", "header", "cookie", or "body". When the step in context specifies a workflowId, then all parameters map to workflow inputs. In all other scenarios (e.g., a step specifies an operationId), the in field MUST be specified.
          valueAny | {expression}REQUIRED. The value to pass in the parameter. The value can be a constant or an Runtime Expression to be evaluated and passed to the referenced operation or workflow.
          +

          This object MAY be extended with Specification Extensions.

          +

          Parameter Object Example

          +

          Query Example

          +
          
          +- name: username
          +  in: query
          +  value: $inputs.username
          +
          +

          Header Example

          +
          
          +- name: X-Api-Key
          +  in: header
          +  value: $inputs.x-api-key
          +
          +

          Success Action Object

          +

          A single success action which describes an action to take upon success of a workflow step. There are two possible values for the type field.

          +
            +
          • end - The workflow ends, and context returns to the caller with applicable outputs
          • +
          • goto - A one-way transfer of workflow control to the specified label (either a workflowId or stepId)
          • +
          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringREQUIRED. The name of the success action. Names are case sensitive.
          typestringREQUIRED. The type of action to take. Possible values are "end" or "goto".
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description to transfer to upon success of the step. This field is only relevant when the type field value is "goto". If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. This field is mutually exclusive to stepId.
          stepIdstringThe stepId to transfer to upon success of the step. This field is only relevant when the type field value is "goto". The referenced stepId MUST be within the current workflow. This field is mutually exclusive to workflowId.
          criteria[Criterion Object]A list of assertions to determine if this action SHALL be executed. Each assertion is described using a Criterion Object. All criteria assertions MUST be satisfied for the action to be executed.
          +

          This object MAY be extended with Specification Extensions.

          +

          Success Action Object Example

          +
          
          +name: JoinWaitingList
          +type: goto
          +stepId: joinWaitingListStep
          +criteria:
          +    # assertions to determine if this success action should be executed
          +    - context: $response.body
          +      condition: $[?count(@.pets) > 0]
          +      type: JSONPath
          +
          +

          Failure Action Object

          +

          A single failure action which describes an action to take upon failure of a workflow step. There are three possible values for the type field.

          +
            +
          • end - The workflow ends, and context returns to the caller with applicable outputs
          • +
          • retry - The current step will be retried. The retry will be constrained by the retryAfter and retryLimit fields. If a stepId or workflowId are specified, then the reference is executed and the context is returned, after which the current step is retried.
          • +
          • goto - A one-way transfer of workflow control to the specified label (either a workflowId or stepId)
          • +
          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          namestringREQUIRED. The name of the failure action. Names are case sensitive.
          typestringREQUIRED. The type of action to take. Possible values are "end", "retry", or "goto".
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description to transfer to upon failure of the step. This field is only relevant when the type field value is "goto" or "retry". If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. This field is mutually exclusive to stepId. When used with "retry", context transfers back upon completion of the specified workflow.
          stepIdstringThe stepId to transfer to upon failure of the step. This field is only relevant when the type field value is "goto" or "retry". The referenced stepId MUST be within the current workflow. This field is mutually exclusive to workflowId. When used with "retry", context transfers back upon completion of the specified step.
          retryAfternumberA non-negative decimal indicating the seconds to delay after the step failure before another attempt SHALL be made. Note: if an HTTP Retry-After response header was returned to a step from a targeted operation, then it SHOULD overrule this particular field value. This field only applies when the type field value is "retry" or "function".
          retryLimitintegerA non-negative integer indicating how many attempts to retry the step MAY be attempted before failing the overall step. If not specified then a single retry SHALL be attempted. This field only applies when the type field value is "retry". The retryLimit MUST be exhausted prior to executing subsequent failure actions.
          criteria[Criterion Object]A list of assertions to determine if this action SHALL be executed. Each assertion is described using a Criterion Object.
          +

          This object MAY be extended with Specification Extensions.

          +

          Failure Action Object Example

          +
          
          +name: retryStep
          +type: retry
          +retryAfter: 1
          +retryLimit: 5
          +criteria:
          +    # assertions to determine if this action should be executed
          +    - condition: $statusCode == 503
          +
          +

          Components Object

          +

          Holds a set of reusable objects for different aspects of the Arazzo Specification. All objects defined within the components object will have no effect on the Arazzo Description unless they are explicitly referenced from properties outside the components object.

          +

          Components are scoped to the Arazzo document they are defined in. For example, if a step defined in Arazzo document “A” references a workflow defined in Arazzo document “B”, the components in “A” are not considered when evaluating the workflow referenced in “B”.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          inputsMap[string, JSON Schema]An object to hold reusable JSON Schema objects to be referenced from workflow inputs.
          parametersMap[string, Parameter Object]An object to hold reusable Parameter Objects
          successActionsMap[string, Success Action Object]An object to hold reusable Success Actions Objects.
          failureActionsMap[string, Failure Action Object]An object to hold reusable Failure Actions Objects.
          +

          This object MAY be extended with Specification Extensions.

          +

          All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$. The key is used to refer to the input or parameter in other parts of the Workflow Description.

          +

          Field Name Examples:

          +
          
          +User
          +User_1
          +User_Name
          +user-name
          +my.org.User
          +
          +

          Components Object Example

          +
          
          +components:
          +  parameters:
          +    storeId:
          +      name: storeId
          +      in: header
          +      value: $inputs.x-store-id
          +  inputs:
          +    pagination:
          +      type: object
          +      properties:
          +        page:
          +          type: integer
          +          format: int32
          +        pageSize:
          +          type: integer
          +          format: int32
          +  failureActions:
          +    refreshToken:
          +      name: refreshExpiredToken
          +      type: retry
          +      retryAfter: 1
          +      retryLimit: 5
          +      workflowId: refreshTokenWorkflowId
          +      criteria:
          +          # assertions to determine if this action should be executed
          +          - condition: $statusCode == 401       
          +
          +
          
          +"components": {
          +  "parameters": {
          +    "storeId": {
          +      "name": "storeId",
          +      "in": "header",
          +      "value": "$inputs.x-store-id"
          +    }
          +  },
          +  "inputs": {
          +    "pagination": {
          +      "type": "object",
          +      "properties": {
          +        "page": {
          +          "type": "integer",
          +          "format": "int32"
          +        },
          +        "pageSize": {
          +          "type": "integer",
          +          "format": "int32"
          +        }
          +      }
          +    }
          +  },
          +  "failureActions": {
          +    "refreshToken": {
          +      "name": "refreshExpiredToken",
          +      "type": "retry",
          +      "retryAfter": 1,
          +      "retryLimit": 5,
          +      "workflowId": "refreshTokenWorkflowId",
          +      "criteria": [
          +        {
          +          "condition": "{$statusCode == 401}"
          +        }
          +      ]
          +    }
          +  }
          +}
          +
          +

          Reusable Object

          +

          A simple object to allow referencing of objects contained within the Components Object. It can be used from locations within steps or workflows in the Arazzo Description. Note - Input Objects MUST use standard JSON Schema referencing via the $ref keyword while all non JSON Schema objects use this object and its expression based referencing mechanism.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          valuestringSets a value of the referenced parameter. This is only applicable for parameter object references.
          +

          This object cannot be extended with additional properties and any properties added MUST be ignored.

          +

          Reusable Object Example

          +
          
          +  reference: $components.successActions.notify
          +
          +
          
          +  {
          +    "reference": "$components.successActions.notify"
          +  }
          +
          +
          
          +  reference: $components.parameters.page
          +  value: 1
          +
          +
          
          +  {
          +    "reference": "$components.parameters.page",
          +    "value": 1
          +  }
          +
          +

          Criterion Object

          +

          An object used to specify the context, conditions, and condition types that can be used to prove or satisfy assertions specified in Step Object successCriteria, Success Action Object criteria, and Failure Action Object criteria.

          +

          There are four flavors of conditions supported:

          +
            +
          • simple - where basic literals, operators, and loose comparisons are used in combination with Runtime Expressions.
          • +
          • regex - where a regex pattern is applied on the supplied context. The context is defined by a Runtime Expression.
          • +
          • jsonpath - where a JSON Path expression is applied. The root node context is defined by a Runtime Expression.
          • +
          • xpath - where an XPath expression is applied. The root node context is defined by a Runtime Expression.
          • +
          +

          Literals

          +

          As part of a condition expression, you can use boolean, null, number, or string data types.

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          TypeLiteral value
          booleantrue or false
          nullnull
          numberAny number format supported in Data Types
          stringStrings MUST use single quotes (‘) around the string. To use a literal single quote, escape the literal single quote using an additional single quote (’').
          +

          Operators

          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          OperatorDescription
          <Less than
          <=Less than or equal
          >Greater than
          >=Greater than or equal
          ==Equal
          !=Not equal
          !Not
          &&And
          &#124;&#124;Or
          ()Logical Grouping
          []Index (0-based)
          .Property de-reference
          +

          String comparisons MUST be case insensitive.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          context{expression}A runtime expression used to set the context for the condition to be applied on. If type is specified, then the context MUST be provided (e.g. $response.body would set the context that a JSONPath query expression could be applied to).
          conditionstringREQUIRED. The condition to apply. Conditions can be simple (e.g. $statusCode == 200 which applies a operator on a value obtained from a runtime expression), or a regex, or a JSONPath expression. For regex and JSONPath, the type and context MUST be specified.
          typestring | Criterion Expression Type ObjectThe type of condition to be applied. If specified, the options allowed are simple, regex, jsonpath or xpath. If omitted, then the condition is assumed to be simple, which at most combines literals, operators and Runtime Expressions. If jsonpath, then the expression MUST conform to JSON Path. If xpath the expression MUST conform to XML Path Language 3.1. Should other variants of JSON Path or XPath be required, then a Criterion Expression Type Object MUST be specified.
          +

          This object MAY be extended with Specification Extensions.

          +

          Criterion Object Example

          +

          Simple Condition Example

          +
          
          +- condition: $statusCode == 200
          +
          +

          Regex Condition Example

          +
          
          +- context: $statusCode
          +  condition: '^200$'
          +  type: regex
          +
          +

          JSONPath Condition Example

          +
          
          +- context: $response.body
          +  condition: $[?count(@.pets) > 0]
          +  type: jsonpath
          +
          +

          Criterion Expression Type Object

          +

          An object used to describe the type and version of an expression used within a Criterion Object. If this object is not defined, then the following defaults apply:

          + +

          Defining this object gives the ability to utilize tooling compatible with older versions of either JSON Path or XPath.

          +
          Fixed Fields
          + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          typestringREQUIRED. The type of condition to be applied. The options allowed are jsonpath or xpath.
          versionstringREQUIRED. A short hand string representing the version of the expression type being used. The allowed values for JSON Path are draft-goessner-dispatch-jsonpath-00. The allowed values for XPath are xpath-30, xpath-20, or xpath-10.
          +

          This object MAY be extended with Specification Extensions.

          +

          Criterion Expression Type Example

          +

          JSON Path Example

          +
          
          +  type: jsonpath
          +  version: draft-goessner-dispatch-jsonpath-00
          +
          +

          XPath Example

          +
          
          +  type: xpath
          +  version: xpath-30
          +
          +

          Request Body Object

          +

          A single request body describing the Content-Type and request body content to be passed by a step to an operation.

          +

          Fixed Fields

          + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          contentTypestringThe Content-Type for the request content. If omitted then refer to Content-Type specified at the targeted operation to understand serialization requirements.
          payloadAnyA value representing the request body payload. The value can be a literal value or can contain Runtime Expressions which MUST be evaluated prior to calling the referenced operation. To represent examples of media types that cannot be naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
          +

          replacements | [Payload Replacement Object] | A list of locations and values to set within a payload.

          +

          This object MAY be extended with Specification Extensions.

          +

          RequestBody Object Example

          +

          JSON Templated Example

          +
           contentType: application/json
          + payload: |
          +   {
          +     "petOrder": {
          +       "petId": "{$inputs.pet_id}",
          +       "couponCode": "{$inputs.coupon_code}",
          +       "quantity": "{$inputs.quantity}",
          +       "status": "placed",
          +       "complete": false
          +     }
          +   }
          +
          +

          JSON Object Example

          +
           contentType: application/json
          + payload: 
          +   petOrder:
          +     petId: $inputs.pet_id
          +     couponCode: $inputs.coupon_code
          +     quantity: $inputs.quantity
          +     status: placed
          +     complete: false
          +
          +

          Complete Runtime Expression

          +
           contentType: application/json
          + payload: $inputs.petOrderRequest
          +
          +

          XML Templated Example

          +
           contentType: application/xml
          + payload: |
          +   <petOrder>
          +     <petId>{$inputs.pet_id}</petId>
          +     <couponCode>{$inputs.coupon_code}</couponCode>
          +     <quantity>{$inputs.quantity}</quantity>
          +     <status>placed</status>
          +     <complete>false</complete>
          +   </petOrder>
          +
          +

          Form Data Example

          +
           contentType: application/x-www-form-urlencoded
          + payload: 
          +   client_id: $inputs.clientId
          +   grant_type: $inputs.grantType
          +   redirect_uri: $inputs.redirectUri
          +   client_secret: $inputs.clientSecret
          +   code: $steps.browser-authorize.outputs.code
          +   scope: $inputs.scope  
          +
          +

          Form Data String Example

          +
           contentType: application/x-www-form-urlencoded
          + payload: "client_id={$inputs.clientId}&grant_type={$inputs.grantType}&redirect_uri={$inputs.redirectUri}&client_secret={$inputs.clientSecret}&code{$steps.browser-authorize.outputs.code}&scope=$inputs.scope}"
          +
          +

          Payload Replacement Object

          +

          Describes a location within a payload (e.g., a request body) and a value to set within the location.

          +
          Fixed Fields
          + + + + + + + + + + + + + + + + + + + + +
          Field NameTypeDescription
          targetstringREQUIRED. A JSON Pointer or XPath Expression which MUST be resolved against the request body. Used to identify the location to inject the value.
          valueAny | {expression}REQUIRED. The value set within the target location. The value can be a constant or a Runtime Expression to be evaluated and passed to the referenced operation or workflow.
          +

          This object MAY be extended with Specification Extensions.

          +
          Payload Replacement Object Example
          +

          Runtime Expression Example

          +
          
          +    target: /petId
          +    value: $inputs.pet_id
          +
          +

          Literal Example

          +
          
          +    target: /quantity
          +    value: 10
          +
          +

          Runtime Expressions

          +

          A runtime expression allows values to be defined based on information that will be available within an HTTP message, an event message, and within objects serialized from the Arazzo document such as workflows or steps.

          +

          The runtime expression is defined by the following ABNF syntax:

          +
          
          +      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source / "$message." source / "$inputs." name / "$outputs." name / "$steps." name / "$workflows." name / "$sourceDescriptions." name / "$components." name / "$components.parameters." parameter-name)
          +      parameter-name = name ; Reuses 'name' rule for parameter names
          +      source = ( header-reference / query-reference / path-reference / body-reference )
          +      header-reference = "header." token
          +      query-reference = "query." name
          +      path-reference = "path." name
          +      body-reference = "body" ["#" json-pointer ]
          +      json-pointer    = *( "/" reference-token )
          +      reference-token = *( unescaped / escaped )
          +      unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
          +         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
          +      escaped         = "~" ( "0" / "1" )
          +        ; representing '~' and '/', respectively
          +      name = *( CHAR )
          +      token = 1*tchar
          +      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
          +        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
          +
          +
          Examples
          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Source Locationexample expressionnotes
          HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
          Requested media type$request.header.accept
          Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
          Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
          Request URL$url
          Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
          Response header$response.header.ServerSingle header values only are available
          workflow input$inputs.username or $workflows.foo.inputs.usernameSingle input values only are available
          Step output value$steps.someStep.petsIn situations where the output named property return payloads, references may be made to portions of the response body or the entire body.
          Workflow output value$outputs.bar or $workflows.foo.outputs.barSingle input values only are available
          Components parameter$components.parameters.fooAccesses a foo parameter defined within the Components Object.
          +

          Runtime expressions preserve the type of the referenced value. +Expressions can be embedded into string values by surrounding the expression with {} curly braces.

          +

          Specification Extensions

          +

          While the Arazzo Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          +

          The extension properties are implemented as patterned fields that are always prefixed by "x-".

          + + + + + + + + + + + + + + + +
          Field PatternTypeDescription
          ^x-AnyAllows extensions to the Arazzo Specification. The field name MUST begin with x-, for example, x-internal-id. Field names beginning x-oai-, x-oas-, and x-arazzo are reserved for uses defined by the OpenAPI Initiative. The value MAY be null, a primitive, an array or an object.
          +

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          +

          Security Considerations

          +

          The Arazzo Specification does not enforce a security mechanism. Security is left to the implementer, though TLS, specifically HTTPS may be recommended for exchanging sensitive workflows.

          +

          Arazzo Descriptions can be JSON or YAML values. As such, all security considerations defined in RFC 8259 and within YAML version 1.2 apply.

          +

          Arazzo Descriptions are frequently written by untrusted third parties, to be deployed on public Internet servers. Processing an Arazzo Description can cause both safe and unsafe operations to be performed on arbitrary network resources. It is the responsibility of the description consumer to ensure that the operations performed are not harmful.

          +

          IANA Considerations

          +

          The proposed MIME media types for the Arazzo Specification are described below.

          +

          application/vnd.oai.workflows

          +

          The default (or general) MIME type for Arazzo documents (e.g. workflows) is defined as follows:

          +

            Media type name: application

          +

            Media subtype name: vnd.oai.workflows

          +

            Required parameters: N/A

          +

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of workflow conforms to version 1.0.0 of the Arazzo Specification).

          +

            Encoding considerations: Encoding considerations are identical to those specified for the application/json and application/yaml media types, respectively.

          +

            Security considerations: See security considerations above.

          +

            Interoperability considerations: N/A

          +

          Note: When using the application/vnd.oai.workflows media type the consumer should be prepared to receive YAML formatted content

          +

          application/vnd.oai.workflows+json

          +

          The proposed MIME media type for Arazzo documents (e.g. workflows) that require a JSON-specific media type is defined as follows:

          +

            Media type name: application

          +

            Media subtype name: vnd.oai.workflows+json

          +

            Required parameters: N/A

          +

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of Arazzo document conforms to version 1.0.0 of the Arazzo Specification).

          +

            Encoding considerations: Encoding considerations are identical to those specified for the application/json media type.

          +

            Security considerations: See security considerations above.

          +

            Interoperability considerations: N/A

          +

          application/vnd.oai.workflows+yaml

          +

          The proposed MIME media type for Arazzo documents (e.g. workflows) that require a YAML-specific media type is defined as follows:

          +

            Media type name: application

          +

            Media subtype name: vnd.oai.workflows+yaml

          +

            Required parameters: N/A

          +

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of Arazzo document conforms to version 1.0.0 of the Arazzo Specification).

          +

            Encoding considerations: Encoding considerations are identical to those specified for the application/yaml media type.

          +

            Security considerations: See security considerations above.

          +

            Interoperability considerations: N/A

          +

          Appendix A: Revision History

          + + + + + + + + + + + + + + + +
          VersionDateNotes
          1.0.02024-05-29First release of the Arazzo Specification
          + From aecf331ce4755d8ff254717ed67f0c090af1c504 Mon Sep 17 00:00:00 2001 From: Frank Kilcommins Date: Thu, 23 May 2024 12:47:52 +0100 Subject: [PATCH 125/152] Update ReSpec versions (#6) Signed-off-by: GitHub Co-authored-by: frankkilcommins --- arazzo/latest.html | 2 +- arazzo/v1.0.0.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/arazzo/latest.html b/arazzo/latest.html index 96aa78e744..a5064ddfc0 100644 --- a/arazzo/latest.html +++ b/arazzo/latest.html @@ -1,4 +1,4 @@ -The Arazzo Specification v1.0.0 | Introduction, Definitions, & More +The Arazzo Specification v1.0.0 | Introduction, Definitions, & More +The Arazzo Specification v1.0.0 | Introduction, Definitions, & More +The Arazzo Specification v1.0.0 | Introduction, Definitions, & More +The Arazzo Specification v1.0.0 | Introduction, Definitions, & More +The Arazzo Specification v1.0.0 | Introduction, Definitions, & More - - -

          The Arazzo Specification v1.0.0

          The Arazzo Specification provides a mechanism that can define sequences of calls and their dependencies to be woven together and expressed in the context of delivering a particular outcome or set of outcomes when dealing with API descriptions (such as OpenAPI descriptions).

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.
          -

          Arazzo Specification

          -

          Version 1.0.0

          -

          The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

          -

          This document is licensed under The Apache License, Version 2.0.

          -

          Introduction

          -

          Being able to express specific sequences of calls and articulate the dependencies between them to achieve a particular goal is desirable in the context of API descriptions. The aim of the Arazzo Specification is to provide a mechanism that can define sequences of calls and their dependencies to be woven together and expressed in the context of delivering a particular outcome or set of outcomes when dealing with API descriptions (such as OpenAPI descriptions).

          -

          The Arazzo Specification can articulate these workflows in a human-readable and machine-readable manner, thus improving the capability of API specifications to tell the story of the API in a manner that can improve the consuming developer experience.

          - - -

          Definitions

          -

          Arazzo Description

          -

          A self-contained document (or set of documents) which defines or describes API workflows (specific sequence of calls to achieve a particular goal in the context of an API definition). An Arazzo Description uses and conforms to the Arazzo Specification, and MUST contain a valid Arazzo Specification version field (arazzo), an Info field, a sourceDescriptions field with at least one defined Source, and there MUST be at least one Workflow defined in the workflows fixed field.

          -

          Specification

          -

          Versions

          -

          The Arazzo Specification is versioned using a major.minor.patch versioning scheme. The major.minor portion of the version string (for example 1.0) SHALL designate the Arazzo feature set. .patch versions address errors in, or provide clarifications to, this document, not the feature set. The patch version SHOULD NOT be considered by tooling, making no distinction between 1.0.0 and 1.0.1 for example.

          -

          Format

          -

          An Arazzo Description that conforms to the Arazzo Specification is itself a JSON object, which may be represented either in JSON or YAML format.

          -

          All field names in the specification are case sensitive. -This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

          -

          In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

          - -

          Arazzo Description Structure

          -

          It is RECOMMENDED that the entry Arazzo document be named: arazzo.json or arazzo.yaml.

          -

          An Arazzo Description MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. If workflows from other documents are being referenced, they must by included as a Source Description Object. In a multi-document description, the document containing the Arazzo Specification Object is known as the entry Arazzo document.

          -

          Data Types

          -

          Data types in the Arazzo Specification are based on the types supported by the JSON Schema Specification Draft 2020-12. Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part.

          -

          As defined by the JSON Schema Validation vocabulary, data types can have an optional modifier property: format. Arazzo additionally supports the formats (similar to the OpenAPI specification) to provide fine detail for primitive data types.

          -

          The formats defined are:

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          typeformatComments
          integerint32signed 32 bits
          integerint64signed 64 bits (a.k.a long)
          numberfloat
          numberdouble
          stringpasswordA hint to UIs to obscure input.
          -

          Relative References in URLs

          -

          Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. -Unless specified otherwise, relative references are resolved using the URL of the referring document.

          -

          Schema

          -

          In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

          -

          Arazzo Specification Object

          -

          This is the root object of the Arazzo Description.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          arazzostringREQUIRED. This string MUST be the version number of the Arazzo Specification that the Arazzo Description uses. The arazzo field MUST be used by tooling to interpret the Arazzo Description.
          infoInfo ObjectREQUIRED. Provides metadata about the workflows contain within the Arazzo Description. The metadata MAY be used by tooling as required.
          sourceDescriptions[Source Description Object]REQUIRED. A list of source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. The list MUST have at least one entry.
          workflows[Workflow Object]REQUIRED. A list of workflows. The list MUST have at least one entry.
          componentsComponents ObjectAn element to hold various schemas for the Arazzo Description.
          -

          This object MAY be extended with Specification Extensions.

          -

          Arazzo Specification Object Example

          -
          
          -arazzo: 1.0.0
          -info:
          -  title: A pet purchasing workflow
          -  summary: This Arazzo Description showcases the workflow for how to purchase a pet through a sequence of API calls
          -  description: |
          -      This Arazzo Description walks you through the workflow and steps of `searching` for, `selecting`, and `purchasing` an available pet.
          -  version: 1.0.1
          -sourceDescriptions:
          -- name: petStoreDescription
          -  url: https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml
          -  type: openapi
          -
          -workflows:
          -- workflowId: loginUserAndRetrievePet
          -  summary: Login User and then retrieve pets
          -  description: This workflow lays out the steps to login a user and then retrieve pets
          -  inputs:
          -      type: object
          -      properties:
          -          username:
          -              type: string
          -          password:
          -              type: string
          -  steps:
          -  - stepId: loginStep
          -    description: This step demonstrates the user login step
          -    operationId: loginUser
          -    parameters:
          -      # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          -      - name: username
          -        in: query
          -        value: $inputs.username
          -      - name: password
          -        in: query
          -        value: $inputs.password
          -    successCriteria:
          -      # assertions to determine step was successful
          -      - condition: $statusCode == 200
          -    outputs:
          -      # outputs from this step
          -      tokenExpires: $response.header.X-Expires-After
          -      rateLimit: $response.header.X-Rate-Limit
          -      sessionToken: $response.body
          -  - stepId: getPetStep
          -    description: retrieve a pet by status from the GET pets endpoint
          -    operationPath: '{$sourceDescriptions.petstoreDescription.url}#/paths/~1pet~1findByStatus/get'
          -    parameters:
          -      - name: status
          -        in: query
          -        value: 'available'
          -      - name: Authorization
          -        in: header
          -        value: $steps.loginUser.outputs.sessionToken
          -    successCriteria:
          -      - condition: $statusCode == 200
          -    outputs:
          -      # outputs from this step
          -      availablePets: $response.body
          -  outputs:
          -      available: $steps.getPetStep.availablePets
          -
          -

          Info Object

          -

          The object provides metadata about API workflows defined in this Arazzo document. -The metadata MAY be used by the clients if needed.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          titlestringREQUIRED. A human readable title of the Arazzo Description.
          summarystringA short summary of the Arazzo Description.
          descriptionstringA description of the purpose of the workflows defined. CommonMark syntax MAY be used for rich text representation.
          versionstringREQUIRED. The version identifier of the Arazzo document (which is distinct from the Arazzo Specification version).
          -

          This object MAY be extended with Specification Extensions.

          -

          Info Object Example

          -
          
          -title: A pet purchasing workflow
          -summary: This workflow showcases how to purchase a pet through a sequence of API calls
          -description: |
          -    This workflow walks you through the steps of searching for, selecting, and purchasing an available pet.
          -version: 1.0.1
          -
          -

          Source Description Object

          -

          Describes a source description (such as an OpenAPI description) that will be referenced by one or more workflows described within an Arazzo Description.

          -

          An object storing a map between named description keys and location URLs to the source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. Each source location string MUST be in the form of a URI-reference as defined by RFC3986 section 4.1.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          namestringREQUIRED. A unique name for the source description. Tools and libraries MAY use the name to uniquely identify a source description, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          urlstringREQUIRED. A URL to a source description to be used by a workflow. If a relative reference is used, it MUST be in the form of a URI-reference as defined by RFC3986 section 4.2.
          typestringThe type of source description. Possible values are "openapi" or "arazzo".
          -

          This object MAY be extended with Specification Extensions.

          -

          Source Description Object Example

          -
          
          -name: petStoreDescription
          -url: https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml
          -type: openapi
          -
          -

          Workflow Object

          -

          Describes the steps to be taken across one or more APIs to achieve an objective. The workflow object MAY define inputs needed in order to execute workflow steps, where the defined steps represent a call to an API operation or another workflow, and a set of outputs.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          workflowIdstringREQUIRED. Unique string to represent the workflow. The id MUST be unique amongst all workflows describe in the Arazzo Description. The workflowId value is case-sensitive. Tools and libraries MAY use the workflowId to uniquely identify a workflow, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          summarystringA summary of the purpose or objective of the workflow.
          descriptionstringA description of the workflow. CommonMark syntax MAY be used for rich text representation.
          inputsJSON SchemaA JSON Schema 2020-12 object representing the input parameters used by this workflow.
          dependsOn[string]A list of workflows that MUST be completed before this workflow can be processed. The values provided MUST be a workflowId. If the workflow depended on is defined within the current Workflow Document, then specify the workflowId of the relevant local workflow. If the workflow is defined in a separate Arazzo Document then the workflow MUST be defined in the sourceDescriptions and the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes.
          steps[Step Object]REQUIRED. An ordered list of steps where each step represents a call to an API operation or to another workflow.
          successActions[Success Action Object | Reusable Object]A list of success actions that are applicable for all steps described under this workflow. These success actions can be overridden at the step level but cannot be removed there. If a Reusable Object is provided, it MUST link to success actions defined in the components/successActions of the current Arazzo document. The list MUST NOT include duplicate success actions.
          failureActions[Failure Action Object | Reusable Object]A list of failure actions that are applicable for all steps described under this workflow. These failure actions can be overridden at the step level but cannot be removed there. If a Reusable Object is provided, it MUST link to failure actions defined in the components/failureActions of the current Arazzo document. The list MUST NOT include duplicate failure actions.
          outputsMap[string, {expression}]A map between a friendly name and a dynamic output value. The name MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.
          parameters[Parameter Object | Reusable Object]A list of parameters that are applicable for all steps described under this workflow. These parameters can be overridden at the step level but cannot be removed there. Each parameter MUST be passed to an operation or workflow as referenced by operationId, operationPath, or workflowId as specified within each step. If a Reusable Object is provided, it MUST link to a parameter defined in the components/parameters of the current Arazzo document. The list MUST NOT include duplicate parameters.
          -

          This object MAY be extended with Specification Extensions.

          -

          Workflow Object Example

          -
          
          -workflowId: loginUser
          -summary: Login User
          -description: This workflow lays out the steps to login a user
          -inputs:
          -    type: object
          -    properties:
          -        username:
          -            type: string
          -        password:
          -            type: string
          -steps:
          -  - stepId: loginStep
          -    description: This step demonstrates the user login step
          -    operationId: loginUser
          -    parameters:
          -      # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          -      - name: username
          -        in: query
          -        value: $inputs.username
          -      - name: password
          -        in: query
          -        value: $inputs.password
          -    successCriteria:
          -        # assertions to determine step was successful 
          -        - condition: $statusCode == 200
          -    outputs:
          -        # outputs from this step
          -        tokenExpires: $response.header.X-Expires-After
          -        rateLimit: $response.header.X-Rate-Limit
          -outputs:
          -    tokenExpires: $steps.loginStep.outputs.tokenExpires
          -
          -

          Step Object

          -

          Describes a single workflow step which MAY be a call to an API operation (OpenAPI Operation Object or another Workflow Object.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          descriptionstringA description of the step. CommonMark syntax MAY be used for rich text representation.
          stepIdstringREQUIRED. Unique string to represent the step. The stepId MUST be unique amongst all steps described in the workflow. The stepId value is case-sensitive. Tools and libraries MAY use the stepId to uniquely identify a workflow step, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          operationIdstringThe name of an existing, resolvable operation, as defined with a unique operationId and existing within one of the sourceDescriptions. The referenced operation will be invoked by this workflow step. If multiple (non arazzo type) sourceDescriptions are defined, then the operationId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<operationId>) to avoid ambiguity or potential clashes. This field is mutually exclusive of the operationPath and workflowId fields respectively.
          operationPathstringA reference to a Source combined with a JSON Pointer to reference an operation. This field is mutually exclusive of the operationId and workflowId fields respectively. The operation being referenced MUST be described within one of the sourceDescriptions descriptions. A runtime expression syntax MUST be used to identify the source description document. If the referenced operation has an operationId defined then the operationId SHOULD be preferred over the operationPath.
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description. If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. The field is mutually exclusive of the operationId and operationPath fields respectively.
          parameters[Parameter Object | Reusable Object]A list of parameters that MUST be passed to an operation or workflow as referenced by operationId, operationPath, or workflowId. If a parameter is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a parameter defined in the components/parameters of the current Arazzo document. The list MUST NOT include duplicate parameters.
          requestBodyRequest Body ObjectThe request body to pass to an operation as referenced by operationId or operationPath. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as GET, HEAD and DELETE), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.
          successCriteria[Criterion Object]A list of assertions to determine the success of the step. Each assertion is described using a Criterion Object. All assertions MUST be satisfied for the step to be deemed successful.
          onSuccess[Success Action Object | Reusable Object]An array of success action objects that specify what to do upon step success. If omitted, the next sequential step shall be executed as the default behavior. If multiple success actions have similar criteria, the first sequential action matching the criteria SHALL be the action executed. If a success action is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a success action defined in the components of the current Arazzo document. The list MUST NOT include duplicate success actions.
          onFailure[Failure Action Object | Reusable Object]An array of failure action objects that specify what to do upon step failure. If omitted, the default behavior is to break and return. If multiple failure actions have similar criteria, the first sequential action matching the criteria SHALL be the action executed. If a failure action is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a failure action defined in the components of the current Arazzo document. The list MUST NOT include duplicate failure actions.
          outputsMap[string, {expression}]A map between a friendly name and a dynamic output value defined using a runtime expression. The name MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.
          -

          This object MAY be extended with Specification Extensions.

          -

          Step Object Example

          -

          Single step

          -
          
          -stepId: loginStep
          -description: This step demonstrates the user login step
          -operationId: loginUser
          -parameters:
          -    # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          -    - name: username
          -      in: query
          -      value: $inputs.username
          -    - name: password
          -      in: query
          -      value: $inputs.password
          -successCriteria:
          -    # assertions to determine step was successful
          -    - condition: $statusCode == 200
          -outputs:
          -    # outputs from this step
          -    tokenExpires: $response.header.X-Expires-After
          -    rateLimit: $response.header.X-Rate-Limit
          -
          -

          Multiple steps

          -
          
          -steps:
          -  - stepId: loginStep
          -    description: This step demonstrates the user login step
          -    operationId: loginUser
          -    parameters:
          -        # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          -      - name: username
          -        in: query
          -        value: $inputs.username
          -      - name: password
          -        in: query
          -        value: $inputs.password
          -    successCriteria:
          -        # assertions to determine step was successful
          -      - condition: $statusCode == 200
          -    outputs:
          -        # outputs from this step
          -        tokenExpires: $response.header.X-Expires-After
          -        rateLimit: $response.header.X-Rate-Limit
          -        sessionToken: $response.body
          -  - stepId: getPetStep
          -    description: retrieve a pet by status from the GET pets endpoint
          -    operationPath: '{$sourceDescriptions.petStoreDescription.url}#/paths/~1pet~1findByStatus/get'
          -    parameters:
          -      - name: status
          -        in: query
          -        value: 'available'
          -      - name: Authorization
          -        in: header
          -        value: $steps.loginUser.outputs.sessionToken
          -    successCriteria:
          -      - condition: $statusCode == 200
          -    outputs:
          -        # outputs from this step
          -        availablePets: $response.body
          -
          -

          Parameter Object

          -

          Describes a single step parameter. A unique parameter is defined by the combination of a name and in fields. There are four possible locations specified by the in field:

          -
            -
          • path - Used together with OpenAPI style Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
          • -
          • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
          • -
          • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
          • -
          • cookie - Used to pass a specific cookie value to the source API.
          • -
          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
          instringThe name location of the parameter. Possible values are "path", "query", "header", "cookie", or "body". When the step in context specifies a workflowId, then all parameters map to workflow inputs. In all other scenarios (e.g., a step specifies an operationId), the in field MUST be specified.
          valueAny | {expression}REQUIRED. The value to pass in the parameter. The value can be a constant or an Runtime Expression to be evaluated and passed to the referenced operation or workflow.
          -

          This object MAY be extended with Specification Extensions.

          -

          Parameter Object Example

          -

          Query Example

          -
          
          -- name: username
          -  in: query
          -  value: $inputs.username
          -
          -

          Header Example

          -
          
          -- name: X-Api-Key
          -  in: header
          -  value: $inputs.x-api-key
          -
          -

          Success Action Object

          -

          A single success action which describes an action to take upon success of a workflow step. There are two possible values for the type field.

          -
            -
          • end - The workflow ends, and context returns to the caller with applicable outputs
          • -
          • goto - A one-way transfer of workflow control to the specified label (either a workflowId or stepId)
          • -
          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          namestringREQUIRED. The name of the success action. Names are case sensitive.
          typestringREQUIRED. The type of action to take. Possible values are "end" or "goto".
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description to transfer to upon success of the step. This field is only relevant when the type field value is "goto". If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. This field is mutually exclusive to stepId.
          stepIdstringThe stepId to transfer to upon success of the step. This field is only relevant when the type field value is "goto". The referenced stepId MUST be within the current workflow. This field is mutually exclusive to workflowId.
          criteria[Criterion Object]A list of assertions to determine if this action SHALL be executed. Each assertion is described using a Criterion Object. All criteria assertions MUST be satisfied for the action to be executed.
          -

          This object MAY be extended with Specification Extensions.

          -

          Success Action Object Example

          -
          
          -name: JoinWaitingList
          -type: goto
          -stepId: joinWaitingListStep
          -criteria:
          -    # assertions to determine if this success action should be executed
          -    - context: $response.body
          -      condition: $[?count(@.pets) > 0]
          -      type: JSONPath
          -
          -

          Failure Action Object

          -

          A single failure action which describes an action to take upon failure of a workflow step. There are three possible values for the type field.

          -
            -
          • end - The workflow ends, and context returns to the caller with applicable outputs
          • -
          • retry - The current step will be retried. The retry will be constrained by the retryAfter and retryLimit fields. If a stepId or workflowId are specified, then the reference is executed and the context is returned, after which the current step is retried.
          • -
          • goto - A one-way transfer of workflow control to the specified label (either a workflowId or stepId)
          • -
          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          namestringREQUIRED. The name of the failure action. Names are case sensitive.
          typestringREQUIRED. The type of action to take. Possible values are "end", "retry", or "goto".
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description to transfer to upon failure of the step. This field is only relevant when the type field value is "goto" or "retry". If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. This field is mutually exclusive to stepId. When used with "retry", context transfers back upon completion of the specified workflow.
          stepIdstringThe stepId to transfer to upon failure of the step. This field is only relevant when the type field value is "goto" or "retry". The referenced stepId MUST be within the current workflow. This field is mutually exclusive to workflowId. When used with "retry", context transfers back upon completion of the specified step.
          retryAfternumberA non-negative decimal indicating the seconds to delay after the step failure before another attempt SHALL be made. Note: if an HTTP Retry-After response header was returned to a step from a targeted operation, then it SHOULD overrule this particular field value. This field only applies when the type field value is "retry" or "function".
          retryLimitintegerA non-negative integer indicating how many attempts to retry the step MAY be attempted before failing the overall step. If not specified then a single retry SHALL be attempted. This field only applies when the type field value is "retry". The retryLimit MUST be exhausted prior to executing subsequent failure actions.
          criteria[Criterion Object]A list of assertions to determine if this action SHALL be executed. Each assertion is described using a Criterion Object.
          -

          This object MAY be extended with Specification Extensions.

          -

          Failure Action Object Example

          -
          
          -name: retryStep
          -type: retry
          -retryAfter: 1
          -retryLimit: 5
          -criteria:
          -    # assertions to determine if this action should be executed
          -    - condition: $statusCode == 503
          -
          -

          Components Object

          -

          Holds a set of reusable objects for different aspects of the Arazzo Specification. All objects defined within the components object will have no effect on the Arazzo Description unless they are explicitly referenced from properties outside the components object.

          -

          Components are scoped to the Arazzo document they are defined in. For example, if a step defined in Arazzo document “A” references a workflow defined in Arazzo document “B”, the components in “A” are not considered when evaluating the workflow referenced in “B”.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          inputsMap[string, JSON Schema]An object to hold reusable JSON Schema objects to be referenced from workflow inputs.
          parametersMap[string, Parameter Object]An object to hold reusable Parameter Objects
          successActionsMap[string, Success Action Object]An object to hold reusable Success Actions Objects.
          failureActionsMap[string, Failure Action Object]An object to hold reusable Failure Actions Objects.
          -

          This object MAY be extended with Specification Extensions.

          -

          All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$. The key is used to refer to the input or parameter in other parts of the Workflow Description.

          -

          Field Name Examples:

          -
          
          -User
          -User_1
          -User_Name
          -user-name
          -my.org.User
          -
          -

          Components Object Example

          -
          
          -components:
          -  parameters:
          -    storeId:
          -      name: storeId
          -      in: header
          -      value: $inputs.x-store-id
          -  inputs:
          -    pagination:
          -      type: object
          -      properties:
          -        page:
          -          type: integer
          -          format: int32
          -        pageSize:
          -          type: integer
          -          format: int32
          -  failureActions:
          -    refreshToken:
          -      name: refreshExpiredToken
          -      type: retry
          -      retryAfter: 1
          -      retryLimit: 5
          -      workflowId: refreshTokenWorkflowId
          -      criteria:
          -          # assertions to determine if this action should be executed
          -          - condition: $statusCode == 401       
          -
          -
          
          -"components": {
          -  "parameters": {
          -    "storeId": {
          -      "name": "storeId",
          -      "in": "header",
          -      "value": "$inputs.x-store-id"
          -    }
          -  },
          -  "inputs": {
          -    "pagination": {
          -      "type": "object",
          -      "properties": {
          -        "page": {
          -          "type": "integer",
          -          "format": "int32"
          -        },
          -        "pageSize": {
          -          "type": "integer",
          -          "format": "int32"
          -        }
          -      }
          -    }
          -  },
          -  "failureActions": {
          -    "refreshToken": {
          -      "name": "refreshExpiredToken",
          -      "type": "retry",
          -      "retryAfter": 1,
          -      "retryLimit": 5,
          -      "workflowId": "refreshTokenWorkflowId",
          -      "criteria": [
          -        {
          -          "condition": "{$statusCode == 401}"
          -        }
          -      ]
          -    }
          -  }
          -}
          -
          -

          Reusable Object

          -

          A simple object to allow referencing of objects contained within the Components Object. It can be used from locations within steps or workflows in the Arazzo Description. Note - Input Objects MUST use standard JSON Schema referencing via the $ref keyword while all non JSON Schema objects use this object and its expression based referencing mechanism.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          valuestringSets a value of the referenced parameter. This is only applicable for parameter object references.
          -

          This object cannot be extended with additional properties and any properties added MUST be ignored.

          -

          Reusable Object Example

          -
          
          -  reference: $components.successActions.notify
          -
          -
          
          -  {
          -    "reference": "$components.successActions.notify"
          -  }
          -
          -
          
          -  reference: $components.parameters.page
          -  value: 1
          -
          -
          
          -  {
          -    "reference": "$components.parameters.page",
          -    "value": 1
          -  }
          -
          -

          Criterion Object

          -

          An object used to specify the context, conditions, and condition types that can be used to prove or satisfy assertions specified in Step Object successCriteria, Success Action Object criteria, and Failure Action Object criteria.

          -

          There are four flavors of conditions supported:

          -
            -
          • simple - where basic literals, operators, and loose comparisons are used in combination with Runtime Expressions.
          • -
          • regex - where a regex pattern is applied on the supplied context. The context is defined by a Runtime Expression.
          • -
          • jsonpath - where a JSON Path expression is applied. The root node context is defined by a Runtime Expression.
          • -
          • xpath - where an XPath expression is applied. The root node context is defined by a Runtime Expression.
          • -
          -

          Literals

          -

          As part of a condition expression, you can use boolean, null, number, or string data types.

          - - - - - - - - - - - - - - - - - - - - - - - - - -
          TypeLiteral value
          booleantrue or false
          nullnull
          numberAny number format supported in Data Types
          stringStrings MUST use single quotes (‘) around the string. To use a literal single quote, escape the literal single quote using an additional single quote (’').
          -

          Operators

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          OperatorDescription
          <Less than
          <=Less than or equal
          >Greater than
          >=Greater than or equal
          ==Equal
          !=Not equal
          !Not
          &&And
          &#124;&#124;Or
          ()Logical Grouping
          []Index (0-based)
          .Property de-reference
          -

          String comparisons MUST be case insensitive.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          context{expression}A runtime expression used to set the context for the condition to be applied on. If type is specified, then the context MUST be provided (e.g. $response.body would set the context that a JSONPath query expression could be applied to).
          conditionstringREQUIRED. The condition to apply. Conditions can be simple (e.g. $statusCode == 200 which applies a operator on a value obtained from a runtime expression), or a regex, or a JSONPath expression. For regex and JSONPath, the type and context MUST be specified.
          typestring | Criterion Expression Type ObjectThe type of condition to be applied. If specified, the options allowed are simple, regex, jsonpath or xpath. If omitted, then the condition is assumed to be simple, which at most combines literals, operators and Runtime Expressions. If jsonpath, then the expression MUST conform to JSON Path. If xpath the expression MUST conform to XML Path Language 3.1. Should other variants of JSON Path or XPath be required, then a Criterion Expression Type Object MUST be specified.
          -

          This object MAY be extended with Specification Extensions.

          -

          Criterion Object Example

          -

          Simple Condition Example

          -
          
          -- condition: $statusCode == 200
          -
          -

          Regex Condition Example

          -
          
          -- context: $statusCode
          -  condition: '^200$'
          -  type: regex
          -
          -

          JSONPath Condition Example

          -
          
          -- context: $response.body
          -  condition: $[?count(@.pets) > 0]
          -  type: jsonpath
          -
          -

          Criterion Expression Type Object

          -

          An object used to describe the type and version of an expression used within a Criterion Object. If this object is not defined, then the following defaults apply:

          - -

          Defining this object gives the ability to utilize tooling compatible with older versions of either JSON Path or XPath.

          -
          Fixed Fields
          - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          typestringREQUIRED. The type of condition to be applied. The options allowed are jsonpath or xpath.
          versionstringREQUIRED. A short hand string representing the version of the expression type being used. The allowed values for JSON Path are draft-goessner-dispatch-jsonpath-00. The allowed values for XPath are xpath-30, xpath-20, or xpath-10.
          -

          This object MAY be extended with Specification Extensions.

          -

          Criterion Expression Type Example

          -

          JSON Path Example

          -
          
          -  type: jsonpath
          -  version: draft-goessner-dispatch-jsonpath-00
          -
          -

          XPath Example

          -
          
          -  type: xpath
          -  version: xpath-30
          -
          -

          Request Body Object

          -

          A single request body describing the Content-Type and request body content to be passed by a step to an operation.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          contentTypestringThe Content-Type for the request content. If omitted then refer to Content-Type specified at the targeted operation to understand serialization requirements.
          payloadAnyA value representing the request body payload. The value can be a literal value or can contain Runtime Expressions which MUST be evaluated prior to calling the referenced operation. To represent examples of media types that cannot be naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
          -

          replacements | [Payload Replacement Object] | A list of locations and values to set within a payload.

          -

          This object MAY be extended with Specification Extensions.

          -

          RequestBody Object Example

          -

          JSON Templated Example

          -
           contentType: application/json
          - payload: |
          -   {
          -     "petOrder": {
          -       "petId": "{$inputs.pet_id}",
          -       "couponCode": "{$inputs.coupon_code}",
          -       "quantity": "{$inputs.quantity}",
          -       "status": "placed",
          -       "complete": false
          -     }
          -   }
          -
          -

          JSON Object Example

          -
           contentType: application/json
          - payload: 
          -   petOrder:
          -     petId: $inputs.pet_id
          -     couponCode: $inputs.coupon_code
          -     quantity: $inputs.quantity
          -     status: placed
          -     complete: false
          -
          -

          Complete Runtime Expression

          -
           contentType: application/json
          - payload: $inputs.petOrderRequest
          -
          -

          XML Templated Example

          -
           contentType: application/xml
          - payload: |
          -   <petOrder>
          -     <petId>{$inputs.pet_id}</petId>
          -     <couponCode>{$inputs.coupon_code}</couponCode>
          -     <quantity>{$inputs.quantity}</quantity>
          -     <status>placed</status>
          -     <complete>false</complete>
          -   </petOrder>
          -
          -

          Form Data Example

          -
           contentType: application/x-www-form-urlencoded
          - payload: 
          -   client_id: $inputs.clientId
          -   grant_type: $inputs.grantType
          -   redirect_uri: $inputs.redirectUri
          -   client_secret: $inputs.clientSecret
          -   code: $steps.browser-authorize.outputs.code
          -   scope: $inputs.scope  
          -
          -

          Form Data String Example

          -
           contentType: application/x-www-form-urlencoded
          - payload: "client_id={$inputs.clientId}&grant_type={$inputs.grantType}&redirect_uri={$inputs.redirectUri}&client_secret={$inputs.clientSecret}&code{$steps.browser-authorize.outputs.code}&scope=$inputs.scope}"
          -
          -

          Payload Replacement Object

          -

          Describes a location within a payload (e.g., a request body) and a value to set within the location.

          -
          Fixed Fields
          - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          targetstringREQUIRED. A JSON Pointer or XPath Expression which MUST be resolved against the request body. Used to identify the location to inject the value.
          valueAny | {expression}REQUIRED. The value set within the target location. The value can be a constant or a Runtime Expression to be evaluated and passed to the referenced operation or workflow.
          -

          This object MAY be extended with Specification Extensions.

          -
          Payload Replacement Object Example
          -

          Runtime Expression Example

          -
          
          -    target: /petId
          -    value: $inputs.pet_id
          -
          -

          Literal Example

          -
          
          -    target: /quantity
          -    value: 10
          -
          -

          Runtime Expressions

          -

          A runtime expression allows values to be defined based on information that will be available within an HTTP message, an event message, and within objects serialized from the Arazzo document such as workflows or steps.

          -

          The runtime expression is defined by the following ABNF syntax:

          -
          
          -      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source / "$message." source / "$inputs." name / "$outputs." name / "$steps." name / "$workflows." name / "$sourceDescriptions." name / "$components." name / "$components.parameters." parameter-name)
          -      parameter-name = name ; Reuses 'name' rule for parameter names
          -      source = ( header-reference / query-reference / path-reference / body-reference )
          -      header-reference = "header." token
          -      query-reference = "query." name
          -      path-reference = "path." name
          -      body-reference = "body" ["#" json-pointer ]
          -      json-pointer    = *( "/" reference-token )
          -      reference-token = *( unescaped / escaped )
          -      unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
          -         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
          -      escaped         = "~" ( "0" / "1" )
          -        ; representing '~' and '/', respectively
          -      name = *( CHAR )
          -      token = 1*tchar
          -      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
          -        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
          -
          -
          Examples
          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Source Locationexample expressionnotes
          HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
          Requested media type$request.header.accept
          Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
          Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
          Request URL$url
          Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
          Response header$response.header.ServerSingle header values only are available
          workflow input$inputs.username or $workflows.foo.inputs.usernameSingle input values only are available
          Step output value$steps.someStep.petsIn situations where the output named property return payloads, references may be made to portions of the response body or the entire body.
          Workflow output value$outputs.bar or $workflows.foo.outputs.barSingle input values only are available
          Components parameter$components.parameters.fooAccesses a foo parameter defined within the Components Object.
          -

          Runtime expressions preserve the type of the referenced value. -Expressions can be embedded into string values by surrounding the expression with {} curly braces.

          -

          Specification Extensions

          -

          While the Arazzo Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          -

          The extension properties are implemented as patterned fields that are always prefixed by "x-".

          - - - - - - - - - - - - - - - -
          Field PatternTypeDescription
          ^x-AnyAllows extensions to the Arazzo Specification. The field name MUST begin with x-, for example, x-internal-id. Field names beginning x-oai-, x-oas-, and x-arazzo are reserved for uses defined by the OpenAPI Initiative. The value MAY be null, a primitive, an array or an object.
          -

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          -

          Security Considerations

          -

          The Arazzo Specification does not enforce a security mechanism. Security is left to the implementer, though TLS, specifically HTTPS may be recommended for exchanging sensitive workflows.

          -

          Arazzo Descriptions can be JSON or YAML values. As such, all security considerations defined in RFC 8259 and within YAML version 1.2 apply.

          -

          Arazzo Descriptions are frequently written by untrusted third parties, to be deployed on public Internet servers. Processing an Arazzo Description can cause both safe and unsafe operations to be performed on arbitrary network resources. It is the responsibility of the description consumer to ensure that the operations performed are not harmful.

          -

          IANA Considerations

          -

          The proposed MIME media types for the Arazzo Specification are described below.

          -

          application/vnd.oai.workflows

          -

          The default (or general) MIME type for Arazzo documents (e.g. workflows) is defined as follows:

          -

            Media type name: application

          -

            Media subtype name: vnd.oai.workflows

          -

            Required parameters: N/A

          -

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of workflow conforms to version 1.0.0 of the Arazzo Specification).

          -

            Encoding considerations: Encoding considerations are identical to those specified for the application/json and application/yaml media types, respectively.

          -

            Security considerations: See security considerations above.

          -

            Interoperability considerations: N/A

          -

          Note: When using the application/vnd.oai.workflows media type the consumer should be prepared to receive YAML formatted content

          -

          application/vnd.oai.workflows+json

          -

          The proposed MIME media type for Arazzo documents (e.g. workflows) that require a JSON-specific media type is defined as follows:

          -

            Media type name: application

          -

            Media subtype name: vnd.oai.workflows+json

          -

            Required parameters: N/A

          -

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of Arazzo document conforms to version 1.0.0 of the Arazzo Specification).

          -

            Encoding considerations: Encoding considerations are identical to those specified for the application/json media type.

          -

            Security considerations: See security considerations above.

          -

            Interoperability considerations: N/A

          -

          application/vnd.oai.workflows+yaml

          -

          The proposed MIME media type for Arazzo documents (e.g. workflows) that require a YAML-specific media type is defined as follows:

          -

            Media type name: application

          -

            Media subtype name: vnd.oai.workflows+yaml

          -

            Required parameters: N/A

          -

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of Arazzo document conforms to version 1.0.0 of the Arazzo Specification).

          -

            Encoding considerations: Encoding considerations are identical to those specified for the application/yaml media type.

          -

            Security considerations: See security considerations above.

          -

            Interoperability considerations: N/A

          -

          Appendix A: Revision History

          - - - - - - - - - - - - - - - -
          VersionDateNotes
          1.0.02024-05-29First release of the Arazzo Specification
          - diff --git a/docs/arazzo/v1.0.0.html b/docs/arazzo/v1.0.0.html deleted file mode 100644 index 71ef025701..0000000000 --- a/docs/arazzo/v1.0.0.html +++ /dev/null @@ -1,1277 +0,0 @@ -The Arazzo Specification v1.0.0 | Introduction, Definitions, & More - - -

          The Arazzo Specification v1.0.0

          The Arazzo Specification provides a mechanism that can define sequences of calls and their dependencies to be woven together and expressed in the context of delivering a particular outcome or set of outcomes when dealing with API descriptions (such as OpenAPI descriptions).

          Status of This Document

          The source-of-truth for the specification is the GitHub markdown file referenced above.
          -

          Arazzo Specification

          -

          Version 1.0.0

          -

          The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

          -

          This document is licensed under The Apache License, Version 2.0.

          -

          Introduction

          -

          Being able to express specific sequences of calls and articulate the dependencies between them to achieve a particular goal is desirable in the context of API descriptions. The aim of the Arazzo Specification is to provide a mechanism that can define sequences of calls and their dependencies to be woven together and expressed in the context of delivering a particular outcome or set of outcomes when dealing with API descriptions (such as OpenAPI descriptions).

          -

          The Arazzo Specification can articulate these workflows in a human-readable and machine-readable manner, thus improving the capability of API specifications to tell the story of the API in a manner that can improve the consuming developer experience.

          - - -

          Definitions

          -

          Arazzo Description

          -

          A self-contained document (or set of documents) which defines or describes API workflows (specific sequence of calls to achieve a particular goal in the context of an API definition). An Arazzo Description uses and conforms to the Arazzo Specification, and MUST contain a valid Arazzo Specification version field (arazzo), an Info field, a sourceDescriptions field with at least one defined Source, and there MUST be at least one Workflow defined in the workflows fixed field.

          -

          Specification

          -

          Versions

          -

          The Arazzo Specification is versioned using a major.minor.patch versioning scheme. The major.minor portion of the version string (for example 1.0) SHALL designate the Arazzo feature set. .patch versions address errors in, or provide clarifications to, this document, not the feature set. The patch version SHOULD NOT be considered by tooling, making no distinction between 1.0.0 and 1.0.1 for example.

          -

          Format

          -

          An Arazzo Description that conforms to the Arazzo Specification is itself a JSON object, which may be represented either in JSON or YAML format.

          -

          All field names in the specification are case sensitive. -This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

          -

          In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

          - -

          Arazzo Description Structure

          -

          It is RECOMMENDED that the entry Arazzo document be named: arazzo.json or arazzo.yaml.

          -

          An Arazzo Description MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. If workflows from other documents are being referenced, they must by included as a Source Description Object. In a multi-document description, the document containing the Arazzo Specification Object is known as the entry Arazzo document.

          -

          Data Types

          -

          Data types in the Arazzo Specification are based on the types supported by the JSON Schema Specification Draft 2020-12. Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part.

          -

          As defined by the JSON Schema Validation vocabulary, data types can have an optional modifier property: format. Arazzo additionally supports the formats (similar to the OpenAPI specification) to provide fine detail for primitive data types.

          -

          The formats defined are:

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          typeformatComments
          integerint32signed 32 bits
          integerint64signed 64 bits (a.k.a long)
          numberfloat
          numberdouble
          stringpasswordA hint to UIs to obscure input.
          -

          Relative References in URLs

          -

          Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. -Unless specified otherwise, relative references are resolved using the URL of the referring document.

          -

          Schema

          -

          In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

          -

          Arazzo Specification Object

          -

          This is the root object of the Arazzo Description.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          arazzostringREQUIRED. This string MUST be the version number of the Arazzo Specification that the Arazzo Description uses. The arazzo field MUST be used by tooling to interpret the Arazzo Description.
          infoInfo ObjectREQUIRED. Provides metadata about the workflows contain within the Arazzo Description. The metadata MAY be used by tooling as required.
          sourceDescriptions[Source Description Object]REQUIRED. A list of source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. The list MUST have at least one entry.
          workflows[Workflow Object]REQUIRED. A list of workflows. The list MUST have at least one entry.
          componentsComponents ObjectAn element to hold various schemas for the Arazzo Description.
          -

          This object MAY be extended with Specification Extensions.

          -

          Arazzo Specification Object Example

          -
          
          -arazzo: 1.0.0
          -info:
          -  title: A pet purchasing workflow
          -  summary: This Arazzo Description showcases the workflow for how to purchase a pet through a sequence of API calls
          -  description: |
          -      This Arazzo Description walks you through the workflow and steps of `searching` for, `selecting`, and `purchasing` an available pet.
          -  version: 1.0.1
          -sourceDescriptions:
          -- name: petStoreDescription
          -  url: https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml
          -  type: openapi
          -
          -workflows:
          -- workflowId: loginUserAndRetrievePet
          -  summary: Login User and then retrieve pets
          -  description: This workflow lays out the steps to login a user and then retrieve pets
          -  inputs:
          -      type: object
          -      properties:
          -          username:
          -              type: string
          -          password:
          -              type: string
          -  steps:
          -  - stepId: loginStep
          -    description: This step demonstrates the user login step
          -    operationId: loginUser
          -    parameters:
          -      # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          -      - name: username
          -        in: query
          -        value: $inputs.username
          -      - name: password
          -        in: query
          -        value: $inputs.password
          -    successCriteria:
          -      # assertions to determine step was successful
          -      - condition: $statusCode == 200
          -    outputs:
          -      # outputs from this step
          -      tokenExpires: $response.header.X-Expires-After
          -      rateLimit: $response.header.X-Rate-Limit
          -      sessionToken: $response.body
          -  - stepId: getPetStep
          -    description: retrieve a pet by status from the GET pets endpoint
          -    operationPath: '{$sourceDescriptions.petstoreDescription.url}#/paths/~1pet~1findByStatus/get'
          -    parameters:
          -      - name: status
          -        in: query
          -        value: 'available'
          -      - name: Authorization
          -        in: header
          -        value: $steps.loginUser.outputs.sessionToken
          -    successCriteria:
          -      - condition: $statusCode == 200
          -    outputs:
          -      # outputs from this step
          -      availablePets: $response.body
          -  outputs:
          -      available: $steps.getPetStep.availablePets
          -
          -

          Info Object

          -

          The object provides metadata about API workflows defined in this Arazzo document. -The metadata MAY be used by the clients if needed.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          titlestringREQUIRED. A human readable title of the Arazzo Description.
          summarystringA short summary of the Arazzo Description.
          descriptionstringA description of the purpose of the workflows defined. CommonMark syntax MAY be used for rich text representation.
          versionstringREQUIRED. The version identifier of the Arazzo document (which is distinct from the Arazzo Specification version).
          -

          This object MAY be extended with Specification Extensions.

          -

          Info Object Example

          -
          
          -title: A pet purchasing workflow
          -summary: This workflow showcases how to purchase a pet through a sequence of API calls
          -description: |
          -    This workflow walks you through the steps of searching for, selecting, and purchasing an available pet.
          -version: 1.0.1
          -
          -

          Source Description Object

          -

          Describes a source description (such as an OpenAPI description) that will be referenced by one or more workflows described within an Arazzo Description.

          -

          An object storing a map between named description keys and location URLs to the source descriptions (such as an OpenAPI description) this Arazzo Description SHALL apply to. Each source location string MUST be in the form of a URI-reference as defined by RFC3986 section 4.1.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          namestringREQUIRED. A unique name for the source description. Tools and libraries MAY use the name to uniquely identify a source description, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          urlstringREQUIRED. A URL to a source description to be used by a workflow. If a relative reference is used, it MUST be in the form of a URI-reference as defined by RFC3986 section 4.2.
          typestringThe type of source description. Possible values are "openapi" or "arazzo".
          -

          This object MAY be extended with Specification Extensions.

          -

          Source Description Object Example

          -
          
          -name: petStoreDescription
          -url: https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml
          -type: openapi
          -
          -

          Workflow Object

          -

          Describes the steps to be taken across one or more APIs to achieve an objective. The workflow object MAY define inputs needed in order to execute workflow steps, where the defined steps represent a call to an API operation or another workflow, and a set of outputs.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          workflowIdstringREQUIRED. Unique string to represent the workflow. The id MUST be unique amongst all workflows describe in the Arazzo Description. The workflowId value is case-sensitive. Tools and libraries MAY use the workflowId to uniquely identify a workflow, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          summarystringA summary of the purpose or objective of the workflow.
          descriptionstringA description of the workflow. CommonMark syntax MAY be used for rich text representation.
          inputsJSON SchemaA JSON Schema 2020-12 object representing the input parameters used by this workflow.
          dependsOn[string]A list of workflows that MUST be completed before this workflow can be processed. The values provided MUST be a workflowId. If the workflow depended on is defined within the current Workflow Document, then specify the workflowId of the relevant local workflow. If the workflow is defined in a separate Arazzo Document then the workflow MUST be defined in the sourceDescriptions and the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes.
          steps[Step Object]REQUIRED. An ordered list of steps where each step represents a call to an API operation or to another workflow.
          successActions[Success Action Object | Reusable Object]A list of success actions that are applicable for all steps described under this workflow. These success actions can be overridden at the step level but cannot be removed there. If a Reusable Object is provided, it MUST link to success actions defined in the components/successActions of the current Arazzo document. The list MUST NOT include duplicate success actions.
          failureActions[Failure Action Object | Reusable Object]A list of failure actions that are applicable for all steps described under this workflow. These failure actions can be overridden at the step level but cannot be removed there. If a Reusable Object is provided, it MUST link to failure actions defined in the components/failureActions of the current Arazzo document. The list MUST NOT include duplicate failure actions.
          outputsMap[string, {expression}]A map between a friendly name and a dynamic output value. The name MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.
          parameters[Parameter Object | Reusable Object]A list of parameters that are applicable for all steps described under this workflow. These parameters can be overridden at the step level but cannot be removed there. Each parameter MUST be passed to an operation or workflow as referenced by operationId, operationPath, or workflowId as specified within each step. If a Reusable Object is provided, it MUST link to a parameter defined in the components/parameters of the current Arazzo document. The list MUST NOT include duplicate parameters.
          -

          This object MAY be extended with Specification Extensions.

          -

          Workflow Object Example

          -
          
          -workflowId: loginUser
          -summary: Login User
          -description: This workflow lays out the steps to login a user
          -inputs:
          -    type: object
          -    properties:
          -        username:
          -            type: string
          -        password:
          -            type: string
          -steps:
          -  - stepId: loginStep
          -    description: This step demonstrates the user login step
          -    operationId: loginUser
          -    parameters:
          -      # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          -      - name: username
          -        in: query
          -        value: $inputs.username
          -      - name: password
          -        in: query
          -        value: $inputs.password
          -    successCriteria:
          -        # assertions to determine step was successful 
          -        - condition: $statusCode == 200
          -    outputs:
          -        # outputs from this step
          -        tokenExpires: $response.header.X-Expires-After
          -        rateLimit: $response.header.X-Rate-Limit
          -outputs:
          -    tokenExpires: $steps.loginStep.outputs.tokenExpires
          -
          -

          Step Object

          -

          Describes a single workflow step which MAY be a call to an API operation (OpenAPI Operation Object or another Workflow Object.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          descriptionstringA description of the step. CommonMark syntax MAY be used for rich text representation.
          stepIdstringREQUIRED. Unique string to represent the step. The stepId MUST be unique amongst all steps described in the workflow. The stepId value is case-sensitive. Tools and libraries MAY use the stepId to uniquely identify a workflow step, therefore, it is RECOMMENDED to follow common programming naming conventions. SHOULD conform to the regular expression [A-Za-z0-9_\-]+.
          operationIdstringThe name of an existing, resolvable operation, as defined with a unique operationId and existing within one of the sourceDescriptions. The referenced operation will be invoked by this workflow step. If multiple (non arazzo type) sourceDescriptions are defined, then the operationId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<operationId>) to avoid ambiguity or potential clashes. This field is mutually exclusive of the operationPath and workflowId fields respectively.
          operationPathstringA reference to a Source combined with a JSON Pointer to reference an operation. This field is mutually exclusive of the operationId and workflowId fields respectively. The operation being referenced MUST be described within one of the sourceDescriptions descriptions. A runtime expression syntax MUST be used to identify the source description document. If the referenced operation has an operationId defined then the operationId SHOULD be preferred over the operationPath.
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description. If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. The field is mutually exclusive of the operationId and operationPath fields respectively.
          parameters[Parameter Object | Reusable Object]A list of parameters that MUST be passed to an operation or workflow as referenced by operationId, operationPath, or workflowId. If a parameter is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a parameter defined in the components/parameters of the current Arazzo document. The list MUST NOT include duplicate parameters.
          requestBodyRequest Body ObjectThe request body to pass to an operation as referenced by operationId or operationPath. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as GET, HEAD and DELETE), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.
          successCriteria[Criterion Object]A list of assertions to determine the success of the step. Each assertion is described using a Criterion Object. All assertions MUST be satisfied for the step to be deemed successful.
          onSuccess[Success Action Object | Reusable Object]An array of success action objects that specify what to do upon step success. If omitted, the next sequential step shall be executed as the default behavior. If multiple success actions have similar criteria, the first sequential action matching the criteria SHALL be the action executed. If a success action is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a success action defined in the components of the current Arazzo document. The list MUST NOT include duplicate success actions.
          onFailure[Failure Action Object | Reusable Object]An array of failure action objects that specify what to do upon step failure. If omitted, the default behavior is to break and return. If multiple failure actions have similar criteria, the first sequential action matching the criteria SHALL be the action executed. If a failure action is already defined at the Workflow, the new definition will override it but can never remove it. If a Reusable Object is provided, it MUST link to a failure action defined in the components of the current Arazzo document. The list MUST NOT include duplicate failure actions.
          outputsMap[string, {expression}]A map between a friendly name and a dynamic output value defined using a runtime expression. The name MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.
          -

          This object MAY be extended with Specification Extensions.

          -

          Step Object Example

          -

          Single step

          -
          
          -stepId: loginStep
          -description: This step demonstrates the user login step
          -operationId: loginUser
          -parameters:
          -    # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          -    - name: username
          -      in: query
          -      value: $inputs.username
          -    - name: password
          -      in: query
          -      value: $inputs.password
          -successCriteria:
          -    # assertions to determine step was successful
          -    - condition: $statusCode == 200
          -outputs:
          -    # outputs from this step
          -    tokenExpires: $response.header.X-Expires-After
          -    rateLimit: $response.header.X-Rate-Limit
          -
          -

          Multiple steps

          -
          
          -steps:
          -  - stepId: loginStep
          -    description: This step demonstrates the user login step
          -    operationId: loginUser
          -    parameters:
          -        # parameters to inject into the loginUser operation (parameter name must be resolvable at the referenced operation and the value is determined using {expression} syntax)
          -      - name: username
          -        in: query
          -        value: $inputs.username
          -      - name: password
          -        in: query
          -        value: $inputs.password
          -    successCriteria:
          -        # assertions to determine step was successful
          -      - condition: $statusCode == 200
          -    outputs:
          -        # outputs from this step
          -        tokenExpires: $response.header.X-Expires-After
          -        rateLimit: $response.header.X-Rate-Limit
          -        sessionToken: $response.body
          -  - stepId: getPetStep
          -    description: retrieve a pet by status from the GET pets endpoint
          -    operationPath: '{$sourceDescriptions.petStoreDescription.url}#/paths/~1pet~1findByStatus/get'
          -    parameters:
          -      - name: status
          -        in: query
          -        value: 'available'
          -      - name: Authorization
          -        in: header
          -        value: $steps.loginUser.outputs.sessionToken
          -    successCriteria:
          -      - condition: $statusCode == 200
          -    outputs:
          -        # outputs from this step
          -        availablePets: $response.body
          -
          -

          Parameter Object

          -

          Describes a single step parameter. A unique parameter is defined by the combination of a name and in fields. There are four possible locations specified by the in field:

          -
            -
          • path - Used together with OpenAPI style Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
          • -
          • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
          • -
          • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
          • -
          • cookie - Used to pass a specific cookie value to the source API.
          • -
          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
          instringThe name location of the parameter. Possible values are "path", "query", "header", "cookie", or "body". When the step in context specifies a workflowId, then all parameters map to workflow inputs. In all other scenarios (e.g., a step specifies an operationId), the in field MUST be specified.
          valueAny | {expression}REQUIRED. The value to pass in the parameter. The value can be a constant or an Runtime Expression to be evaluated and passed to the referenced operation or workflow.
          -

          This object MAY be extended with Specification Extensions.

          -

          Parameter Object Example

          -

          Query Example

          -
          
          -- name: username
          -  in: query
          -  value: $inputs.username
          -
          -

          Header Example

          -
          
          -- name: X-Api-Key
          -  in: header
          -  value: $inputs.x-api-key
          -
          -

          Success Action Object

          -

          A single success action which describes an action to take upon success of a workflow step. There are two possible values for the type field.

          -
            -
          • end - The workflow ends, and context returns to the caller with applicable outputs
          • -
          • goto - A one-way transfer of workflow control to the specified label (either a workflowId or stepId)
          • -
          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          namestringREQUIRED. The name of the success action. Names are case sensitive.
          typestringREQUIRED. The type of action to take. Possible values are "end" or "goto".
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description to transfer to upon success of the step. This field is only relevant when the type field value is "goto". If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. This field is mutually exclusive to stepId.
          stepIdstringThe stepId to transfer to upon success of the step. This field is only relevant when the type field value is "goto". The referenced stepId MUST be within the current workflow. This field is mutually exclusive to workflowId.
          criteria[Criterion Object]A list of assertions to determine if this action SHALL be executed. Each assertion is described using a Criterion Object. All criteria assertions MUST be satisfied for the action to be executed.
          -

          This object MAY be extended with Specification Extensions.

          -

          Success Action Object Example

          -
          
          -name: JoinWaitingList
          -type: goto
          -stepId: joinWaitingListStep
          -criteria:
          -    # assertions to determine if this success action should be executed
          -    - context: $response.body
          -      condition: $[?count(@.pets) > 0]
          -      type: JSONPath
          -
          -

          Failure Action Object

          -

          A single failure action which describes an action to take upon failure of a workflow step. There are three possible values for the type field.

          -
            -
          • end - The workflow ends, and context returns to the caller with applicable outputs
          • -
          • retry - The current step will be retried. The retry will be constrained by the retryAfter and retryLimit fields. If a stepId or workflowId are specified, then the reference is executed and the context is returned, after which the current step is retried.
          • -
          • goto - A one-way transfer of workflow control to the specified label (either a workflowId or stepId)
          • -
          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          namestringREQUIRED. The name of the failure action. Names are case sensitive.
          typestringREQUIRED. The type of action to take. Possible values are "end", "retry", or "goto".
          workflowIdstringThe workflowId referencing an existing workflow within the Arazzo Description to transfer to upon failure of the step. This field is only relevant when the type field value is "goto" or "retry". If multiple arazzo type sourceDescriptions are defined, then the workflowId MUST be specified using a runtime expression (e.g., $sourceDescriptions.<name>.<workflowId>) to avoid ambiguity or potential clashes. This field is mutually exclusive to stepId. When used with "retry", context transfers back upon completion of the specified workflow.
          stepIdstringThe stepId to transfer to upon failure of the step. This field is only relevant when the type field value is "goto" or "retry". The referenced stepId MUST be within the current workflow. This field is mutually exclusive to workflowId. When used with "retry", context transfers back upon completion of the specified step.
          retryAfternumberA non-negative decimal indicating the seconds to delay after the step failure before another attempt SHALL be made. Note: if an HTTP Retry-After response header was returned to a step from a targeted operation, then it SHOULD overrule this particular field value. This field only applies when the type field value is "retry" or "function".
          retryLimitintegerA non-negative integer indicating how many attempts to retry the step MAY be attempted before failing the overall step. If not specified then a single retry SHALL be attempted. This field only applies when the type field value is "retry". The retryLimit MUST be exhausted prior to executing subsequent failure actions.
          criteria[Criterion Object]A list of assertions to determine if this action SHALL be executed. Each assertion is described using a Criterion Object.
          -

          This object MAY be extended with Specification Extensions.

          -

          Failure Action Object Example

          -
          
          -name: retryStep
          -type: retry
          -retryAfter: 1
          -retryLimit: 5
          -criteria:
          -    # assertions to determine if this action should be executed
          -    - condition: $statusCode == 503
          -
          -

          Components Object

          -

          Holds a set of reusable objects for different aspects of the Arazzo Specification. All objects defined within the components object will have no effect on the Arazzo Description unless they are explicitly referenced from properties outside the components object.

          -

          Components are scoped to the Arazzo document they are defined in. For example, if a step defined in Arazzo document “A” references a workflow defined in Arazzo document “B”, the components in “A” are not considered when evaluating the workflow referenced in “B”.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          inputsMap[string, JSON Schema]An object to hold reusable JSON Schema objects to be referenced from workflow inputs.
          parametersMap[string, Parameter Object]An object to hold reusable Parameter Objects
          successActionsMap[string, Success Action Object]An object to hold reusable Success Actions Objects.
          failureActionsMap[string, Failure Action Object]An object to hold reusable Failure Actions Objects.
          -

          This object MAY be extended with Specification Extensions.

          -

          All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$. The key is used to refer to the input or parameter in other parts of the Workflow Description.

          -

          Field Name Examples:

          -
          
          -User
          -User_1
          -User_Name
          -user-name
          -my.org.User
          -
          -

          Components Object Example

          -
          
          -components:
          -  parameters:
          -    storeId:
          -      name: storeId
          -      in: header
          -      value: $inputs.x-store-id
          -  inputs:
          -    pagination:
          -      type: object
          -      properties:
          -        page:
          -          type: integer
          -          format: int32
          -        pageSize:
          -          type: integer
          -          format: int32
          -  failureActions:
          -    refreshToken:
          -      name: refreshExpiredToken
          -      type: retry
          -      retryAfter: 1
          -      retryLimit: 5
          -      workflowId: refreshTokenWorkflowId
          -      criteria:
          -          # assertions to determine if this action should be executed
          -          - condition: $statusCode == 401       
          -
          -
          
          -"components": {
          -  "parameters": {
          -    "storeId": {
          -      "name": "storeId",
          -      "in": "header",
          -      "value": "$inputs.x-store-id"
          -    }
          -  },
          -  "inputs": {
          -    "pagination": {
          -      "type": "object",
          -      "properties": {
          -        "page": {
          -          "type": "integer",
          -          "format": "int32"
          -        },
          -        "pageSize": {
          -          "type": "integer",
          -          "format": "int32"
          -        }
          -      }
          -    }
          -  },
          -  "failureActions": {
          -    "refreshToken": {
          -      "name": "refreshExpiredToken",
          -      "type": "retry",
          -      "retryAfter": 1,
          -      "retryLimit": 5,
          -      "workflowId": "refreshTokenWorkflowId",
          -      "criteria": [
          -        {
          -          "condition": "{$statusCode == 401}"
          -        }
          -      ]
          -    }
          -  }
          -}
          -
          -

          Reusable Object

          -

          A simple object to allow referencing of objects contained within the Components Object. It can be used from locations within steps or workflows in the Arazzo Description. Note - Input Objects MUST use standard JSON Schema referencing via the $ref keyword while all non JSON Schema objects use this object and its expression based referencing mechanism.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          valuestringSets a value of the referenced parameter. This is only applicable for parameter object references.
          -

          This object cannot be extended with additional properties and any properties added MUST be ignored.

          -

          Reusable Object Example

          -
          
          -  reference: $components.successActions.notify
          -
          -
          
          -  {
          -    "reference": "$components.successActions.notify"
          -  }
          -
          -
          
          -  reference: $components.parameters.page
          -  value: 1
          -
          -
          
          -  {
          -    "reference": "$components.parameters.page",
          -    "value": 1
          -  }
          -
          -

          Criterion Object

          -

          An object used to specify the context, conditions, and condition types that can be used to prove or satisfy assertions specified in Step Object successCriteria, Success Action Object criteria, and Failure Action Object criteria.

          -

          There are four flavors of conditions supported:

          -
            -
          • simple - where basic literals, operators, and loose comparisons are used in combination with Runtime Expressions.
          • -
          • regex - where a regex pattern is applied on the supplied context. The context is defined by a Runtime Expression.
          • -
          • jsonpath - where a JSON Path expression is applied. The root node context is defined by a Runtime Expression.
          • -
          • xpath - where an XPath expression is applied. The root node context is defined by a Runtime Expression.
          • -
          -

          Literals

          -

          As part of a condition expression, you can use boolean, null, number, or string data types.

          - - - - - - - - - - - - - - - - - - - - - - - - - -
          TypeLiteral value
          booleantrue or false
          nullnull
          numberAny number format supported in Data Types
          stringStrings MUST use single quotes (‘) around the string. To use a literal single quote, escape the literal single quote using an additional single quote (’').
          -

          Operators

          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          OperatorDescription
          <Less than
          <=Less than or equal
          >Greater than
          >=Greater than or equal
          ==Equal
          !=Not equal
          !Not
          &&And
          &#124;&#124;Or
          ()Logical Grouping
          []Index (0-based)
          .Property de-reference
          -

          String comparisons MUST be case insensitive.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          context{expression}A runtime expression used to set the context for the condition to be applied on. If type is specified, then the context MUST be provided (e.g. $response.body would set the context that a JSONPath query expression could be applied to).
          conditionstringREQUIRED. The condition to apply. Conditions can be simple (e.g. $statusCode == 200 which applies a operator on a value obtained from a runtime expression), or a regex, or a JSONPath expression. For regex and JSONPath, the type and context MUST be specified.
          typestring | Criterion Expression Type ObjectThe type of condition to be applied. If specified, the options allowed are simple, regex, jsonpath or xpath. If omitted, then the condition is assumed to be simple, which at most combines literals, operators and Runtime Expressions. If jsonpath, then the expression MUST conform to JSON Path. If xpath the expression MUST conform to XML Path Language 3.1. Should other variants of JSON Path or XPath be required, then a Criterion Expression Type Object MUST be specified.
          -

          This object MAY be extended with Specification Extensions.

          -

          Criterion Object Example

          -

          Simple Condition Example

          -
          
          -- condition: $statusCode == 200
          -
          -

          Regex Condition Example

          -
          
          -- context: $statusCode
          -  condition: '^200$'
          -  type: regex
          -
          -

          JSONPath Condition Example

          -
          
          -- context: $response.body
          -  condition: $[?count(@.pets) > 0]
          -  type: jsonpath
          -
          -

          Criterion Expression Type Object

          -

          An object used to describe the type and version of an expression used within a Criterion Object. If this object is not defined, then the following defaults apply:

          - -

          Defining this object gives the ability to utilize tooling compatible with older versions of either JSON Path or XPath.

          -
          Fixed Fields
          - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          typestringREQUIRED. The type of condition to be applied. The options allowed are jsonpath or xpath.
          versionstringREQUIRED. A short hand string representing the version of the expression type being used. The allowed values for JSON Path are draft-goessner-dispatch-jsonpath-00. The allowed values for XPath are xpath-30, xpath-20, or xpath-10.
          -

          This object MAY be extended with Specification Extensions.

          -

          Criterion Expression Type Example

          -

          JSON Path Example

          -
          
          -  type: jsonpath
          -  version: draft-goessner-dispatch-jsonpath-00
          -
          -

          XPath Example

          -
          
          -  type: xpath
          -  version: xpath-30
          -
          -

          Request Body Object

          -

          A single request body describing the Content-Type and request body content to be passed by a step to an operation.

          -

          Fixed Fields

          - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          contentTypestringThe Content-Type for the request content. If omitted then refer to Content-Type specified at the targeted operation to understand serialization requirements.
          payloadAnyA value representing the request body payload. The value can be a literal value or can contain Runtime Expressions which MUST be evaluated prior to calling the referenced operation. To represent examples of media types that cannot be naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
          -

          replacements | [Payload Replacement Object] | A list of locations and values to set within a payload.

          -

          This object MAY be extended with Specification Extensions.

          -

          RequestBody Object Example

          -

          JSON Templated Example

          -
           contentType: application/json
          - payload: |
          -   {
          -     "petOrder": {
          -       "petId": "{$inputs.pet_id}",
          -       "couponCode": "{$inputs.coupon_code}",
          -       "quantity": "{$inputs.quantity}",
          -       "status": "placed",
          -       "complete": false
          -     }
          -   }
          -
          -

          JSON Object Example

          -
           contentType: application/json
          - payload: 
          -   petOrder:
          -     petId: $inputs.pet_id
          -     couponCode: $inputs.coupon_code
          -     quantity: $inputs.quantity
          -     status: placed
          -     complete: false
          -
          -

          Complete Runtime Expression

          -
           contentType: application/json
          - payload: $inputs.petOrderRequest
          -
          -

          XML Templated Example

          -
           contentType: application/xml
          - payload: |
          -   <petOrder>
          -     <petId>{$inputs.pet_id}</petId>
          -     <couponCode>{$inputs.coupon_code}</couponCode>
          -     <quantity>{$inputs.quantity}</quantity>
          -     <status>placed</status>
          -     <complete>false</complete>
          -   </petOrder>
          -
          -

          Form Data Example

          -
           contentType: application/x-www-form-urlencoded
          - payload: 
          -   client_id: $inputs.clientId
          -   grant_type: $inputs.grantType
          -   redirect_uri: $inputs.redirectUri
          -   client_secret: $inputs.clientSecret
          -   code: $steps.browser-authorize.outputs.code
          -   scope: $inputs.scope  
          -
          -

          Form Data String Example

          -
           contentType: application/x-www-form-urlencoded
          - payload: "client_id={$inputs.clientId}&grant_type={$inputs.grantType}&redirect_uri={$inputs.redirectUri}&client_secret={$inputs.clientSecret}&code{$steps.browser-authorize.outputs.code}&scope=$inputs.scope}"
          -
          -

          Payload Replacement Object

          -

          Describes a location within a payload (e.g., a request body) and a value to set within the location.

          -
          Fixed Fields
          - - - - - - - - - - - - - - - - - - - - -
          Field NameTypeDescription
          targetstringREQUIRED. A JSON Pointer or XPath Expression which MUST be resolved against the request body. Used to identify the location to inject the value.
          valueAny | {expression}REQUIRED. The value set within the target location. The value can be a constant or a Runtime Expression to be evaluated and passed to the referenced operation or workflow.
          -

          This object MAY be extended with Specification Extensions.

          -
          Payload Replacement Object Example
          -

          Runtime Expression Example

          -
          
          -    target: /petId
          -    value: $inputs.pet_id
          -
          -

          Literal Example

          -
          
          -    target: /quantity
          -    value: 10
          -
          -

          Runtime Expressions

          -

          A runtime expression allows values to be defined based on information that will be available within an HTTP message, an event message, and within objects serialized from the Arazzo document such as workflows or steps.

          -

          The runtime expression is defined by the following ABNF syntax:

          -
          
          -      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source / "$message." source / "$inputs." name / "$outputs." name / "$steps." name / "$workflows." name / "$sourceDescriptions." name / "$components." name / "$components.parameters." parameter-name)
          -      parameter-name = name ; Reuses 'name' rule for parameter names
          -      source = ( header-reference / query-reference / path-reference / body-reference )
          -      header-reference = "header." token
          -      query-reference = "query." name
          -      path-reference = "path." name
          -      body-reference = "body" ["#" json-pointer ]
          -      json-pointer    = *( "/" reference-token )
          -      reference-token = *( unescaped / escaped )
          -      unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
          -         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
          -      escaped         = "~" ( "0" / "1" )
          -        ; representing '~' and '/', respectively
          -      name = *( CHAR )
          -      token = 1*tchar
          -      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
          -        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
          -
          -
          Examples
          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Source Locationexample expressionnotes
          HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
          Requested media type$request.header.accept
          Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
          Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
          Request URL$url
          Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
          Response header$response.header.ServerSingle header values only are available
          workflow input$inputs.username or $workflows.foo.inputs.usernameSingle input values only are available
          Step output value$steps.someStep.petsIn situations where the output named property return payloads, references may be made to portions of the response body or the entire body.
          Workflow output value$outputs.bar or $workflows.foo.outputs.barSingle input values only are available
          Components parameter$components.parameters.fooAccesses a foo parameter defined within the Components Object.
          -

          Runtime expressions preserve the type of the referenced value. -Expressions can be embedded into string values by surrounding the expression with {} curly braces.

          -

          Specification Extensions

          -

          While the Arazzo Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

          -

          The extension properties are implemented as patterned fields that are always prefixed by "x-".

          - - - - - - - - - - - - - - - -
          Field PatternTypeDescription
          ^x-AnyAllows extensions to the Arazzo Specification. The field name MUST begin with x-, for example, x-internal-id. Field names beginning x-oai-, x-oas-, and x-arazzo are reserved for uses defined by the OpenAPI Initiative. The value MAY be null, a primitive, an array or an object.
          -

          The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

          -

          Security Considerations

          -

          The Arazzo Specification does not enforce a security mechanism. Security is left to the implementer, though TLS, specifically HTTPS may be recommended for exchanging sensitive workflows.

          -

          Arazzo Descriptions can be JSON or YAML values. As such, all security considerations defined in RFC 8259 and within YAML version 1.2 apply.

          -

          Arazzo Descriptions are frequently written by untrusted third parties, to be deployed on public Internet servers. Processing an Arazzo Description can cause both safe and unsafe operations to be performed on arbitrary network resources. It is the responsibility of the description consumer to ensure that the operations performed are not harmful.

          -

          IANA Considerations

          -

          The proposed MIME media types for the Arazzo Specification are described below.

          -

          application/vnd.oai.workflows

          -

          The default (or general) MIME type for Arazzo documents (e.g. workflows) is defined as follows:

          -

            Media type name: application

          -

            Media subtype name: vnd.oai.workflows

          -

            Required parameters: N/A

          -

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of workflow conforms to version 1.0.0 of the Arazzo Specification).

          -

            Encoding considerations: Encoding considerations are identical to those specified for the application/json and application/yaml media types, respectively.

          -

            Security considerations: See security considerations above.

          -

            Interoperability considerations: N/A

          -

          Note: When using the application/vnd.oai.workflows media type the consumer should be prepared to receive YAML formatted content

          -

          application/vnd.oai.workflows+json

          -

          The proposed MIME media type for Arazzo documents (e.g. workflows) that require a JSON-specific media type is defined as follows:

          -

            Media type name: application

          -

            Media subtype name: vnd.oai.workflows+json

          -

            Required parameters: N/A

          -

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of Arazzo document conforms to version 1.0.0 of the Arazzo Specification).

          -

            Encoding considerations: Encoding considerations are identical to those specified for the application/json media type.

          -

            Security considerations: See security considerations above.

          -

            Interoperability considerations: N/A

          -

          application/vnd.oai.workflows+yaml

          -

          The proposed MIME media type for Arazzo documents (e.g. workflows) that require a YAML-specific media type is defined as follows:

          -

            Media type name: application

          -

            Media subtype name: vnd.oai.workflows+yaml

          -

            Required parameters: N/A

          -

            Optional parameters: version (e.g. version=1.0.0 to indicate that the type of Arazzo document conforms to version 1.0.0 of the Arazzo Specification).

          -

            Encoding considerations: Encoding considerations are identical to those specified for the application/yaml media type.

          -

            Security considerations: See security considerations above.

          -

            Interoperability considerations: N/A

          -

          Appendix A: Revision History

          - - - - - - - - - - - - - - - -
          VersionDateNotes
          1.0.02024-05-29First release of the Arazzo Specification
          - diff --git a/docs/assets/img/draft.png b/docs/assets/img/draft.png deleted file mode 100644 index 2141470ae717b9eed1d5176aa9a8e212e0f9f9c5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 46269 zcmYIv2Q*yY8!gdW^xiwsLv$mAkZ4Ini{6RRqxarhh+cj~h+Z>#@12M`M(+$p@80GA z-g=f<%e`}P=A7@GZ}0u>FXDr$0v5Y@Q z@i%ib1~=<(RtyU7R6dyTnqwd#F(AE@llkmEzu#gTtvBPbb>%hMaG|Lol98nNF^MxG zfz(=(%#<>~dbm3ckxFb@!__W`f&$YvdS*(7$;1+MN8mSmwF=Y3N5{ETaz*Cr{Xoz@ z*WUgN*3K=APO~2^{LhSi)XcQ3*YyjXJl$WSvrh5^ra72~i{Yr)%}Vy9Pt&Z~i9Acw zz?K3@q(1Ov@AGgbz2%YJ7EJJgME)bm#;DOL=hIK5Uw}*bkGUF;x8*}LA1^*zk^cV+ zlK(x?pk;PV!V#IbuPWF53>ninDi@Q9N%u}~92tA}@$n=$7Gpg@U|T4rQaI9gRN;vI zKXTe16-t0#0k3@c>5$G+oKWCQ>QeQhHZqT6aD;(L2a_?P2(2K12^-AGWUVu2&pLXI zTRi>(cpDmJ>r{z09<`-IVu1Xj-L0H!=8K)?)3B08%4-P|B(cHhqW|UV%Z~nRXX9}N z8)*LDcWoC+W1d6k(QA{vZ2GIue z>%rfTA5D^h8?&7|Dr@zZ*a>z@WSF&+zgo9aPV|<->Xka;7OVS0V1zNSdGzbyp5&Zb z9W|y^P8oI?FkvX8x7VOuB83yb;fSIO4lh%03&vU3m;czP0) zBFtXm?tn}*I%9slO>aus-!eDgLz4N$pB$0ZK{_U*-f_}DABPPEYGd7q(n+3wGi1mcW;H) zDRLm#cyL6BS9kM_3hs2Hf^o6nGKR9T?m_ibIku@b@R}BND}f|no}O>;@SgJu9#o8< z(sZnc=X8qu|G`UW<|V@-!@`s4b)O{2=ZPOI9>)f&N*pm+o)AIK=bnOY-)S>;Q&<0% zsju2_bz+Ar2}Pk&M^|itgd&GAHw-bETA-`ntfL40YDTSJ%G|#`K%5^|_5~%{+*I{t zC1~;E4Okle+m1FcUj|j8ZW=O);r%BxFL?Q>Fo|$4r5qb5jG{#bir5IVzE$e#`_g)U ztA2Kx7n@8h^(Qofj6wg4=Hp(e#z{4#e?H+7$vP_JXg$m1%cmn4<6^r}De_LPgriaS zWA`1Dy1j>ZVoG&_m(^_or2Du#lVF3L*Pjc%wdVLvvU8!xJnN^h@0}r-swG))sU4VF zWH9cWvY41tjR+?ttohMjeDuE$Or<5k`6XxN!wK$97&;=>hH& z{Ge+w__-nplr4L!mhsp}T>j&Pdx_ms81I7=prkcj!@)}{CubxcKNv@Yl2G@=eaeN& z?PZ;;k8Z@`iluYY+!=<%N-*$HE=81JoI zf8@=$@Nv2n#$m|&LIql*Pj*sXtBI(ACDf)0^+Xw-qTsD#NT&kH_r;8q~@DObO|%>N^1uIgP0 zjJ~i&AwAh~@-VV)5~eWnGkojgKh{M9lzKh{!3bH1IxHb3#rpWWkyp4^Xopn-U(ELA z8v18Bh)hZ>u-^^{bi=_;D8w`gafjeAaHLOfu6W6qUqCygZPhjj_hI= zT3f$374=_@Q$t0S#f*v(B4Vpv;ev{yYFR#6Z5(Vk^-swnDQnp-YTN9F*6rQ5RBJ1_ z@V*T?enp?s8L9w^wmRSRZ_QayIux7sueWU&`|{}q8SBJm=zA8G<#C8u1|R}Q)E5;r z@%hWUGjb|5n|m+5`JJgNmeN%9oF$9Qn~- z2V7cGB*ijt3AHeSaylCy5)3K2u*mPKu@7RJF={E^1E+vy+rz0^tyq{8Cul1t2W-7SOx9>6lO(kkqi5FE{Hc0P}QkO`{y8aASugw zYJtMEnd7n_NlhwbO(m!<)(A{8BSpe2(;4r1B%(L#oT+yH*Osq}+Zbn-0z{ZcY|ys2 zPIq|WQF8qvhZmp!_dMt4USy%m(oWKn&t9~PqaUJM+Y`CkhAKW+GAIqFp&4l0eRw>q zoJ45gf%zoa<%vFtIClanbUYS{yb!MP5tqMiNZ6&+pUCk*BnA}bUi{&)E@cnz%AnJ64&T{zyZZ4J0-c_`HYbgzejSwyfDya2 z5~v=TsGXWqks_0q#HFxk`;B&zP{DxVma_J*7Xbw|7)^Az4mL&NC&q;7tjRFyOmhDV zorJcPK&k#D`;Zo{YMkos>f!3&Z@B(9S=I_o9X2#WtpgG*iP1N2^gux>EhT#a`-#X% z(7Q;XE_b|~DR&#f2Z|oit@g{Cm9lE)+6AkGf40*5u2(t-(}z&_HdPalYx>$B^Kl3C zu8#8JeX|OahlGGDXFy>X;!ay`19S74OV#jI5t>+bPqVh4h&&(O*tnKH?PD_6cdV^& z0iC3;snbf&MvOsf9kLUuJtEfu!|`0BP3ZKHnLfpy$U%s1B^`rIekORUxX z|E4PNF>xv~fY&~CxyXH%*LXrJi88#u>icYBiR7$!Mo4C$>uWgoY!n%KZE6S=Hcj;rdSqEU$F z_Igdyo@yy^y2dK22Qetzy<6HM;XV+&MT1&oUCmnLY2y_QyPESoq+Z25RlD4@35J^nv9f$KV#?5b2Wg`aSVs8TM*kj7_<%+ z4zbTk>>4W}g^dlmYKH{te`sh@KLOJVeT&oln1peO8QvbqUB!)5!|mE_A@lvxH-P=7 zu)emiV+-ApvezTfo2cd|PSk}%AA()oP{^7R^T zuOr4T8Hu&}4f3ipJBM1dRWAT98sk}NIb7XbO7>}5>d+#0kyMah*nAATLF6hu&SNFF z!@@nrA`i%9p-oooj__wuj&qS;rZl%Oc0ST(m&oPnCHZWfrko=TPpJ=Wl_xmK5?b5y zQDAIZGfNW6Nw^agK4ot96c%+GMp(iBrcZR}G8+4Tixligcv}#pn3njQ_TB7=NH3qd z2duef^Ifew_(dob^6^uN2EvU?*xio0RFF?A1%evFM_v69(s{g#mOZ7^%hPk3*KeP; zV?-k*${;&CzwK@uY}Q7_JIXRjdQN-K3@0T~0Q>xXy0x_&FT_ zK1|6V+KWCger@TAYruP3j)h__dt)3M0GwV@a4^M`p>4%&7!)9tQj8!yQQE4 zf2@(z=z40eiFZKo*QoJ}?n&jLchd(AincSB8IfJdse(WlG>#fP(NFRD689L>IpC0V z`|ju$K4e*`!BtIN6Tw5Ix?)?*@B6)ls{$c|RcXLaQt{AS$|rR(-_Qv;Fy1Rn82=WC zMrX4{cqppil`hmPpcpeovq;r_m`mXoiL!QhqWL43jIE?vhPF)n5uLasi>CXfIJXEU z$L5wApxOi9{PE|1GX|ik;$HZ%>1b^B76JWBAyQs9cc{hRG>ekb`K-6N z?;R+6F#=D*5vYRT8}P`pKA1BNt`=75)7E&oW0u$-izRFi)n9l!td9w5Ty18K4-5`c zW=+6iVuIcOB?u%>V6^3iEfW@aKF`TQby7ZA4|Z-zu4zdTZAM;$vfA&48c};sFP})S zD%@k<49=-$!`JKIn|sx^D11!1Nk@x?+8>WL_P-T43*rD+!=^2&0Yy)X260q|W>Gm; zY_2(Kw8@^@5$Yto4mN;FKriU(Wu_8qjk_wapQeeyJJ(;%gScZ@|(w*2Pi9! zq;BT=r>d}OEyzt=Zd`q>-h!=PTI5{yn@kr}Q`3MCVI<|gJcAcHg#WpPOEs{kPC6zZ zsk%VW5djPWqB5)IjD13Z!LQ>PT@d=d!w>QqmJ(xFF>~sV=;QCPI*6w9!+B`^LJ-Rg zHnn=<_vPm%e%31d$Shs;&!Cb6ttA)iDVw-BeP!XZqy4gKP2FEC!cP$AZV)8Jcy}jv z^|idUI=fJlOk=&l8lSiy_lC#iQ*J*V^BF!>*|Isz-+uviS}D81$RyY10v)ENK_Z{+J!cyPrrju z9$mDxCp%(J;^R0E(P$;nflH4-EnJG)wS`nqEgs#zS4bzPG6s-N1XDs7?p-iKR0Pr%B^9B-jH~rY)(i7sO-ri(JmY@+sVPnVSi3)lnB!~~!)tEB zv0xPu7=yG=2L@xO80OM64}{#ix%>S6ZJqrjS6t8zZ7Dk?F_{F=edxabU{7E#!35Q3 za@7@`El?+5sXE$`w4roR_ex|$CAUORd97nKU6NqqoqVvQ>gPELa-If-@$&K%f}ln9 z3S}OU$Gp8zH%#Y3tB{5|!J_5KERyh+PgQ)LCD`WQ48c5FMB85Rnw904u$-mDZTw1O zjS5_-X@%3(eUg`v+R*4LluXh5%`P%Otrnp$UDLtDBLQ}j#)20_$OpJO1S{DM6GwMt z6c7`ql!Mt9Y_-5>Snn`RS<82<6uqdGM5dMIi{8?mRsLWAos}Pi7G8S#K&;Ui%h|qx zEdP@&0g~6?og9fYMzp_Uto1WRnoIlQ*jd%c{rp)7MsLiowE|iv$Fr*An3HD}@3*w) z4J@rkmB|!YtEAfh)st^=Y1Mmg;mGMKCtrgTmp28*gt3b^pF{~Kdalx37j?FSsOfgA z*9J-p#4)687EWr@uGl}H^SA71yR$UTuSZMt4UVYV?ijLmoFo2WAN{QcvqBy<9FXUa z*AADoOJ`O3IkvYBrUA&~TWlBA^r>}4WD%Tz*gy*=%OZ&yPOjm;wtIaO1z_SaT|vCX zP}epg?d~mY%lTa$uW+MJ24E3LIdsVr+g_?;J#|y(d1)4AVXqd9Jl-MZZn-|cv1sF$ z^HPmMYWgCuShgFdKO$YP>J@HiqWu{^gb{R}oqwgz$2NaVSo^{WDpNfzLCS}BhgWri zd`Dme4aS=n(bq54ZVXo^@}NtZs@xxb_)b75Z& zcHg$%c{{LF9D{a*+RRL7)I&*9VPjfF1-_jPJ29=JXlWZ(+GY*+BpAKw>l%7*Aubv3 zO_4ku9Z=ifO?PU_>|0k%6A!=8;A_~G78-8PHsDg9TI$3%y0%6HIlS{s3(1A=J<= z+uW}qWs#%nA98-@1}QJs&t-$SZQm>z@5zIr^R>T+F-7}iokVz9IE??6mZR40a0j=+ zJ{gvK$J7n>5&^0k-<)>3X9~i{e*90$s#dB*ENAsSVEmWHRB>(gOXfDb;8I;xzA8jS zln)?bOIu~TeycOnbmpF^rd0GP)-xsopJr%P#rxl&o_v5O|XQvc*hP z*s6eyPqITu4cheCK=JE%uB0F>QL!_orJ9pW2b|`wNESM$(yMg}f~W7JtdT$rsqk(t zF$m2bSb3fD6Zz8m(gh^d(OYSMS`x~R4CQSrywi$cf_6It3L_Mw^bzkZG%=5#;ny23 z58TW5&QWPBc1z9)RdFigrZ~8(uQ>ZtMoy%7c)F*ijgP2hty$fhj-F|9c;PMHn{a_= zSn%!-jlCm8*bzDmiaDj8nP~|8&YcNcZ~yp+uV!!bsHD5IB?(xt4?VMOnMlDfn-nk4 zRhNGL#k!l3-k#}V+_i%Kk|1UMEK6#422{mIQYVpop}kY_;ry>d817ni%qjIGvrT$^ zg|$GdKGnHv$k(I7Oe!P*_(7`dDgjwaGA>zteJW;{ikE+pFu$9cIwcb`1j#O&#z}tyG0`jF!Fsz;ts_urWz9X-1J! zKx~e9eW2^6b5ZG%`DOjaY>j3TwasjWZ+dF}iUUvdVR2zagUih`%XjQIgOXn{(wc z)}Exi(jj$)B0fkBof3KtTSFDrsc5xB`*@2&j>1ksBDx!Mt?f1PB4e(9Hw^hWi%xu+ zG)ksa0x1q514I6_7&RA8dzFFoEp*kP$FTZx%dNGiG%5SEhN@TAYT}nu{o>S4| z_6m8t|3~>uU3&&{f5{_gY74!15yq%|augk28bXj>k4w{N(g>&Zw)=VEmiTf1bgoz6 z`}A6Lmym5-S@74C&uoQ~x@!D3|5`*E+JWRGIW!?2Vd>ra=|+tpf%{-2?BHbL>b`t_ zYwA&3Iw)e@ZG^It)f_sNyM}8`gPc{^Nt|t+nY9s}Tgy*pFwe?!g z%-?mO>6qvMVf=W8k&%08abRQ{;jLnW@09hjRc(bG=R|4D;;b=W_NEDzI#K2L^&h>* zG(MZAyAN#mVnvSX!AVN7@%oUk;5xwQB^cH<$zp~>G$LvOLw-xeN<#?I=w)iwR%(|X)*v<$U4$2_eW4_M@0Tfd`->}fkB z^g&+LN5347r3ccyp8fe!84nCF4EXr?9lN_ivi<-acdcQ)My)KWN&z~dG1qj z?r{FeQx-B)VhTb(quI09qGRDLPFGn9YcRI~0|gj5jS^^d9gh7488ymLjbTyNJ+sBk z_N&Togi|o*iAd?OmR^Ejsc<4wyxzR)P+#@R`t2W7kwr~<3dzpT_ykebj{x|&pGTj2 z26O8yhf(4yZ_PEhSfEGn4wwD0ao1a}afZgZNC-c7gI+{A1a%N5d@K7XI5mWE_dk|+ zhclIzW&z7v!01Ptk8iRXNGc>k%Y<+ zBi3A%#3K3pD9bRNKA(R(ko z=;JD=!assK|8b~v&f~$Q6DuO*JCW83pn2uuzOUaG){i0lc6Y?RfMP^0^ z{T%fQNwll@Cy!b2-=iCr}KBo5h;se{|Kjk50Qw(NC@mP0FP=;XMTT0BMo;X=7&-Y2fZ zxdu<>m%Wa6?P`YMg|7*fu~S6VBYWHl;cM`n{22Xy90;BWDt!#Bpk8nHptU`WTY%Q^ zIQxE8R?c*b_pgr2jQ%)>xg9q#_ce;X8|)tAV{Gl6 zUJ;b>4s}$kth)x;Yh-9CC7ZjZ+>&n7Jx-10*ENDGa$v8itKz-aJHQh52Wx38v}6qo zHEksx{PFUFnG~P4xHf)AIC>jVMaL^7{D{p0=cSfEO9@ay++tS}wQ1FOe3|HDvx9ET z9mnv+&Pgj?Fv1--M|cNoRAdN=Qevr_W8^3epE4MOG`#tFpF_1GN{^m#`R)~jil5ms-Vrs+_TuCNN5lRr+?K8&{ z>3p#0w7H+RrO+moXB+V@mM@B#)y?}x>B}N-CGVMJUlN^{J_7XD~ScgumJjiYe4?i5k<>|7R5H@orynL0`1DAA|o!*$nz9ff%NFKX2Bm5Gc zk>8mqs7uOBje?O=nJQu{D{hI@UX3|A%xLXDQJ=oclv^FYA1|mU*8>=Y=`N)JwbD&u zfUouE=OPhEEHmLRQXPASZy29aT~q#0x&p4VH5U#Th)q8>2$zCYLq^-oV z^DPFc_1^k^O({zQSZ|q_z^x_b&3uat9wcS7Jhhw(q8l@B-E`?q8pS(`M17r&XTrMo z{#HHi3#I5Nt|WC<6}5T7P!*E5)OJREf`5vFDdJL|kM8{I@{HQyMM?Z3_t&g2rZQlp zZjx}0TURszvy(3DB?q;NLGx|k(c=ejhh${^vWShD1A&<38yikxUMo}Jkq2V0j)L6DJtTH%9 zTURF78$hxb`!HG=IySG<2NxZwb;~}VLh1N-$xV>oJ{`yZ>KfgU#!!Fz+n?Ejizl)E z;uXNwfcyxkL-39&l^$f#j-q4oIq5ICoonz^w&(QxbXJ|c*~QlLSW0pV>gNOLoK6>j z3|uJH7!#O!Amg^uD2qV5H*!yK6wVvX3s>UW?kJct6#i~fjFk(!@(P;iugPM&cz)O` z^dm0lmMf6bNUu$>drftz#dkl^C5x;i>6b(=barx|r&ldOD`)j}mciD6ebrDo;`3DKamC(y-&|ypQ>ve{O$v?}d$#JNToYz+27v6S;a6~*Mg~9-JVv|vKoxR#V3MIZ>`jyjcZK)TD2MmRzc+ILTYH&D0~c;=sKM1;Cl(|>w7JE zeop&KYzS5SOxv*O8i2Y-4u8U>72(N*(O+<-_< z@wQ~28YHKQjEk6~;-!X#q_(^`A5b;TlJBIjA4>h`vGST0WN447#yxa*>6Z7XX)U~TcB*yH61)SLA$m@qNdZD|pFVr}vlu0Z z15lv!9sSiR(@FS*eGvsHpDY==As7|Z6pQqUcFW>Y)x@g@_M7L2SID=GN_~k#mq3Zn z(n|n%&INq=}_*(y$|XR6JfSvxsReY$hUFSM5eXJ?c|}GzfCz&x7$*nR^m)CUAP{m z+x}&xFyzj&1v7YW(=3ACt)}=*`O_&|cx-DL1AQuoQZJobNBAhc~{cM*kE>JpdefXX| zB#)I#_5J%DR!@{u*4x2o{kz*$+OXSN{eD;R&E)d2rgzWCI2V*G`=&}Cj~{DDK&`pb`rY-K@D8vQ`T zdXT`O7tQbJk={4!_mHMg;4iM49LmQ^{kLW{x#!S%N0viD%TS?Q_}jWE=bTnX^_|kQ zTs2L4H~~FKE)jmy>n?5 z2+O-T)=ltEF^U^fri`9Q=vd#c{clT7-CF|h?G*KIISbMIuFULzR@A^0njZ{TVgf64 zHq*!W^+$}TaaP`b_nDXd%|Oa)6GSzyGp#VIb??8#Z7H_fNZLz1_N04b1M2y?W|1ee z_vTNl&2TpcbCNH0*_}c49Cka^ue>c1D&tB=38Z^TQ>@UXP5ZhrK!(~ zU@{f}*$~_4QDw#-jG2;{23=C+lzli`T5&ogRV`mC#OU%F37ejR(0krT_ zGTMu3t$Mcl`zWoO;|g+F3YFa z!sM{NWtch&fd(OC`CNaCy|Jvqd)n5uml5562eWKqa9Hq-I^5K*lF3{^T=2OQ;h_&F3zgwySGpRS$CQ2 zGjd81=C4%EWtbKO`X$hPs~8!*P(;A8q{*j%e=oQ2xc_Bj?ccqjr*9LXD@S%)V^sTG!jXIC$7aUHi^Q{KW2zS*q8fH7;k^m7b zn0Q-A6C&BYB*DxS6x+3Ue_31W((!j`1* zKowBjPIx6&AP|0m>ilpqXZIP+PtG*-5|B-7R=@p@DLy{;s3D+ZEAi8~F?&*%kYj1- zj;_;uNgBRMVuGHBsL4uPnZh))bs3}TxTw2WKT&ug504)}?GD2i4d=em3kO2Cy0{f! z2A+Ff(Zou|*eq|l&TaL}A>_)w30rYU^hn0Ze05n^Q+ znj2nu&9gsMf5?>AtB&U}(4?ER$9ZXoj4e9XhJ%q-#Zfpxyw$2Um*d$AZ6M`J%>`mwR#a`VIp3#RV+Ce*X7s&YWK9jK8avOabVGYS!*|kE-z;fqu%7RcRwyO%;Xk3iiCc`!Y->!{ z*P1fA)|ssj>%!8~F)rl4qZmPT;nKOSJU3}3%v+HoALdieaa{3)>YT?-bJ^(crG<` z0|}Hj(AJga5L)bwoBsL;up2DA@1(-8+Yc2{(Cz*g+R-Ffn*6%HUlGYI;UnHw2G6}Zd-ZrdX4uzFses_aUnG`n%FXPu@96f$zhOZ{J9IU15k*PiCn&|j;&Vl8!u6T-L>_f5bsRBtT+A!3&C`1lU=l(+E zZJk1^m8N6ZyMM6!W<*^QLnGCB^zD{+xq4Ken*vByA2{#Pfbs!Vl)D0d$>r_C=Fg59 zkLsm@5pel+R_U`=S!?QM70RNrS4~%aNvmfsS@v0N{`$Q4fxK3ebG2<5it*)$=NWG+ zr+x$It{b3DiZF~6&KjSI0fI>ncWMcQMda~oM`n*|iM_;!w>E^eU3-O<2S^@MZ}jB*c_&ZR z1b7Wh<;!P==9g98A0}v$*n52cAuk&u(lu)-F||_@6Kd|X-8a44szhVgSN47@n3s8J z)wy^qEpLBS+Q=l^%F76sv+vB~IbP^L*N|d9f>?&u@VUwXPVsmdcIR4`>I|Ikk*e1t zE&pZs%$F&uUf8FHX@a_PH-{wQ#wSM)rZjY!mb1=qx{@El>QgvG&j53`vzg1Acp+}- zyHUDcOU27@HhQB4-03M)ovyhTn>*R^vZ0QL4wS;ZTF>8LYPlx<)HvwHPy{L*7>yX; z1oI)Jqn?2Y5WZKUfh@>7&-1sjZLlv@XLO^U+p!zxN&F#DbvCbjtKT}T_12o9kH~ow zZ*&OX!|xO=8`n~Yi|Q+NqNi-E{$S{pgAP zBmpL=j`^AtfJJ#NCiUi6$O<~=uv0ct*}CdKU;ZO7qbad!QqNgSU*ci6~t*4uWz>+uf3{M%urp!mq(1QVI+LJdDS5r z-!khNT*tad#d1ohC0FP7@_g++Qz;;3+eFB5pZZ+zA4{hy30tj9Z>M8|^M=Uc6HuiXQI*ZFk4315qbT6~`g zLj5b^UH0Eg74&f;UkopwmmOQEALgRBp}d5*cV zV6-~6&vQdKCxxS?CS#43Ry$8EuON3#k{?@!wZt{1PFBMB4NP?Aug0jY-@-kkJ2##VKtTgq3BR9d2Vd3Lg_WqYKwP=)nzA%w6@ZbP0U{@7dO6B$QwS z=%J~;yZL}#O)P=*@BlF-*Ho$p3mP6c&OIfAN3%*PW#Xbo}(5WdF*PbAS2$HpK8L`ZyrUD47Bs#ktKPtfFKn&vSOf{%08^;1R8YyejIMi>95pBEhLZS|uCp2}AUg*&Su-xzr|@mq>wG;oEN~msN^E$+Y9_^P$y-JeNgy zR^c^btA&++0*)A64grhT-K$n9?dAF@w-_g_dtn#At$IM6t4}^kouya{XqFzW>+Fg4 zjVZKiN6S*01+*Pxsf`NLm#+J{4KrS~8tlWq)k|c{G%kMl1&d14-g1eC1v@DF?9?ib zMsU=^_pqP;8*7k)KRnrw+$=zA1h7Gij#Y{ja6VHcS^%2Sthz9`i2z}hz%0DxRmbU} zV-Ea{nF=jeVg}^C-5VxCQW zpe6Q6H9^ZGGj3toR#<>cAfnW^PzfF$aIJebmwvYFHG^{fx`L~6JJaN`O);ryWXQYc z?qysIeS!3-fC^H>YyDd1?-kh*`>wBV)QIK^PLThjrlYS&Mp1ulD7QZaSBw1LNb~Vj z?YX{@>y$sFKe)Pw?*NvqX@{N{Ao>+}ejF2MF{n z^E77*YpJ((Any=04Zx+$nO)uujWiPG18hkkT^ZTTjm+eF!Fks8MOWfKBpVjvl23Rk zP_nOMobadSSFx3BQ@iHwl4D-;s?f2oft-i}p4TrIS6rL5r$njgbzxNco`{9W{(`S& z@=pdzTH|DSY5Facw*IPp`B?Kx20;0jA1(6<-Kh#0Cm7CmUf_&%J$8x;E{y*GI9>`p z>X8?G(b4$bGt-dc%e2f5_w+v6A=w@R-6+Db4E=UvHFtp2DWkeFV#;txG%ORCiE@wS zrS<%z=gKE;y40?zFSLQaRF)%okn`0Q`-L?`^13WDVPTY@uuV20gqZj8P%(+3SDFu+MR@@n;LKK@zY=Kq}g z3(l_2*>IM3Ryfgo{01lB$3C)#nSR^*Cbe1M>6z8H$KZD!kn3wMC@tHg)!RSnM1f zsezZ(vAW>=3d}btQV^>>X1Vdc_!EZak#IOSsVB_d@YzgJ(W~RhnJqGOwpTp$SA? zio0wJvHknX%_JM{D(i*b>EG-d*fMo^bVapnh|s!f(&K#luYs8&>hiO>z7Y(N(%ZVW z_H=07pF9RJw`e@6ca^xUvNvcgh;fwlkX3_ew1>&LnKXD-i|RYLC=K_?98 zviNJ*-Ejz48rT8|{HOQ7TOi-xfhrmZI@v6V-}I|s<~A4x3rE=2jh#CJjiHBc_gHgb zczh4oc2L(GO0aDLeT76-Els7SRkWUFLPEK)NXnjrD zi^s1rUkFnP%s{Q}hNc@KJ9VGU_pQ^&&@tH{@qXBP)v?c9@_>vV6H=J&p(;u`e?uQL zpq>O>2fA*T*0UC&(O&uqaMMhA*$5Hy%)_Rf(r*B4w`48nfO0fY^~>c)KDar?orAPB z_2Pjd1jvM?ChK=g#qo|)ggF+jv(*W>gFnbxIGC*Jq8`nvL@2NP(o)e%nj!VWWcmAb z1j?IYqjId5y%~-qCjMMP)xD9Bi^qLf-J&b;WKExpzG3aK2tQ;l_u?-Hx_4O=yz$p+ zTn{HG4Yy0BzvcqisNd(g61jR}PqVZ%#`$x{@WYqK>JH7-5PwVK!Q&vd0b|7}xyJ2u}Ne9HA<7$=O5tmeV_tE_G$`Tx8Cq;mjL zp?5A9i3S?lv{`5(@^0m#EhKOm6>d!xFGch+#Yc)drcPYi*5i(U8=66GWEk5$8K=sD zbnrm={MF62h7{OZK;=y(5S4C#Lou|Tr81j=Yz+^v;zwIM&5XL8qd{VQ{@FfoQ_Gt? zo~R!G(E`cMC&6^?QCl$Yy+hBDiYaT%o0C$Db&<%08&r7tV7%PeDpql>?~N=x>6slQUCf`a=Vu>uAK z{b35Bwi??D$A&ITbVsp*xi=M_*$P8|wGSvY0f56>bYh!+Rfp5fTg*`0Wgg1c3~UJ_O-}{y^^l%5fv<+=l1L+TC~6kWWBm zWYZHQ&WL9u|JH z6=h3v_%OEE)Z6c|v6a>4JnB`nyK9k{S-4(zeerCop1Ouzq!{2c@HtUCrVg%JvJAaZYN&wk|je02+RPxiov zvZjs=6=$Rgt3SnD+NBXX(nE1=;%Q6X9i%w+G&+Y#6`7QdrcMwQ>j6t1hhp1R6z9{l zG;1)`K*MYitDYjkt{N>mzR#%@wPUF{@p{ZcJ+Yk==bJE=LtxEo&fSFiBryo?PwdE> zz~MR7py2a2AajeN;J zix=d7D|`84#pfx>wV?jwb^Gp-xP=&fP<_=G5IpfZ?sVO|!D1xZ&;vfp91ub%u4Npv zl@DjH$4QFW^{ot_JV(LbS9@3`p1V-ONy3m=yG~nEa`W#V`QV(+S6{DxQ9bhjp_Y>_ zFyh0ev|#{JWPIPjdz{j)NkbR8YWkUQEMYZx81NT-=21;gLnECL>*QIpg{PD1#>Qyt z*7Pd&Yu7;^do9$~?cvh9`yB>7@j2B-Y!tGyY1e%%7W=`yI9=ZkemA0aMWiyN^c1-w z3@?Ka+#x^jo7geUpIdwuf!}O0(ZrXYV4!e-s->l4@k1b3V#UU_E`xRr7N?^x5SUB?IXML^Wg$GovClfXq&jAIsvf@+?fU6PxaORR84J4ZVVx_Y^m z_jXJrI!2uA>Mb*25Ah|sKAxy~pgx;N^@YQ!A0RBEzfEr`oGa-#C92E(5M{Jf9bnR3 zi1i9qFJD@FvgF~C)fMaSDHEc5W=#3KtN!Etd*O_8@9Qg~&ezndXTNIlar%zD;ggKl zzxjGESM3&Kf4&7_vnZ!4YhOT=qO0*1^MBze^jrI|)Lv%ZFMCd6h$Gh5O}}|?q8P;x zlXGGNM>zstwfYxN;W;6MDsJp+1t-5Z>ipfXo=V+pIUL_Bbg7%45k*ooHWt({t8>xf z2i?Yg(YB0_eC(aiooT8!e%Vdj{NAwTMBtYUKb03K6>g*LSY6ZXh{Eyn^O&^{m9USe zV4F9NZ#31a%N8qH;w@MvH_BNoc4u6jgxos16z32Yj1~Gl=9QD!P3^-(pQbO&a$;QP z{AhkC$w>ikS&TCJN@|d98#hmlGzf-32(y*v!*1od-?~DTHb-6W$OV}N-T+8~I~&s4 z`9`Vi?R_}-2K`S>YpLn9^RU>^0Kyo*1N#ry+DA@lCog* zP421Iu2fJ`b2`M_jya~_s97Pz7Ua#r?bu>9rx|b~ZinW(WcCsgR4X7D2T?lYuLj@R zx)(VVmS!SO7-dev2Q4L}$bUf;a)EA}Yv*({cju&6cA%?9v$t|ys#1e!@7 zzUKGzC7kKGX5o7+usRR;XYQXms^V%-Nk^%BBN#oVbvJh*#OGd@_Ke8Yxt2WCqof~t z=V#e@$&afb&Th&gB0h3VxCrRw4!aXf4`CFkYz*)>oxlC5&aKysw51&>;DB~Vvluu* zYtE=xR$8EUYM<(duXy-=qf5pF!Z2;HYFn=MB&f|D!d_}2A=bRm_I7k1QuIgMX7#|a z;@w`jciy&2#VlVM!)~oY-K6)NMgk|;H+0%A( zG6q8e^23yGY#Nz(cp15I(cf4T#8bY?%zjIgh+iYh^x}%}w(Pp>w3Mvt!Ut}TWM z=wPCBEUbS~?hLzzzI*6$tm_jG#FCPhC$Z6mdmiZ|=r4C3iOFLEpV)xnb2EQV_JPHD z(y|TWGs&!czMdR6lq3HSFGILGmcTQJdUFJ9C7A{4m1a6{(O${ulKgHZZj#gzNhv(e zIi?5Sw~XRDx#6~84MydEd#|P^>5K3r-Kf}BP>;J^7Uh{?9h@<4{v2=3Q#-NwS0_{0 zjQJ(S9~qK7@C+I6!73UmT!+HLWampX4s?02@KyPCfFT$uLS3Zp#8RqVEvrI&32Hey z>CBbXEa5!&2>ah-+4<%LOJ9$^+`f705Nf1$gxbOnJyXTD_m(ZOYnttADw;TbrnC!Z z7b)-t2fS(qR1uXgBgSmlOEj=EQsc+4^QoJSM1?(MGK@Rm(V2Zw4Yaiy$~bndLuO5i z!sZQ{LrHQn>Jy@6X#sGz&-Xbzso-IzGyhymR}c?Brj_!uoJf!z7l?-F%t?nAvJ8)hHwyGY|2_>q=AnwCIrqHdZI-#0^}HSBJWy-ZHL=i8r`IkIcOo z1(l`<(>OC*JzP3a>_p!iRd$uH`T2mjeZ4T=gE_u5)iNmN zenYWv7xes$UBllt#p?1UAd?&?MTdo05iZt#3g!L??b~1IMBSbeOY=Y9PurA|wl`!Jo2%gjXW@5nCm z_=UU9>-6+${7?ceS742e#oPNsZ)c32_R?a5RJ2z=i8AWEB-0l+WxBN|Ty$nE*DbIC zjxI!}@yEER6uv;OsJP*MoDZRT$H2)MlYVxqe5XB%ah`9hbTioKLNhux! z3*_CfM&IYVCs)j9W)hYu1j;e%Nw<~DjcAvZ>(Y_>k|_Z%K02W~%ZB`|2Lg;OCo0(! z-I0UAWus!@WsnrGWO^TICu}G|s4(%+u(3ww(&tvO5uy?B~2i~jkOC*J<0toJG6 za3ti`gAbety0x8`2aU#h;LrSpfCJ#hSlmDiTawa9f>O(@oG%9Owh>kk-A}Kg#L9o& z2jL{~c}xK(-bS2WrS3!|eWNqLrGd{6V_P_Ff{G@q+29xR29er&=}~9+b0gF?2|`rT z8^NShxpDoIF5G;=+1IYI!xe`tJD*XywYMar6G3IUr88LYrx^n**@zFUxK^b;JRas_ zj^fr}@FqxTTDf1K!(h9eS=Q7&(5+o|L#^JPpF77{;=yo0q=in~_y4w%6R{}ub=V$9uk%DhaZAe$l$g(axgK2# zM`3?>r}=%SpD7tEO)r#iFBoR8Z;U})cnl1&W_Csflpc)g-s!zP;D>s=Tf?0v1i~CoiRmP|1oYd+4TT#dq98{av>HLC#I? zT_H^sC&p)1{Lyj^k#kw2q1ZO@W2fzuT=f(c7*77*tQ{-ye0~I>#Aml%gEz_FzE8r= zWIni)YrSH4A*4Rsi&Pn%m#vB?Ukm6BSRAY2nqXI_Aju2zT1Jhm40_M7UYB{a;2^}t zh5^?n# zbOcXMo5COnm+6S-`R8hywPT1Sv}dJ)+%2y*j|okQo^o`QHTmxSi58`PXoJDliQBZo zf5~S&j2GJS`$yGA=jv&Z$@)>1y2;A*Lp>b2r#8VsP48fNL*qi7LKYNdL?_)PJ~s-{ z$&O5odKN7WN=@2TV?57x>~k3}R0AZjRojDO&FjxMbii6j;n+sAXN)^OH;e zXLT@|vIbS0-T$sCT~oI@{8cTFnMi!}$KoR=jj8*4;-}<2?Q^hLzA`qHw_wbi!)s zqTcN>X$#mFEii4sqcf)bCS)BUzxwz_*;hA!<6CnA0WG9Z^r(8I%Srrb%~a8`82(^~ zpgS3>WoE(sCk3G#gBOm!CH(bdN%etsRGMOiQdQtk5rrE8nF_iz5&YlY5yG}t+zhuE z6Ah@=f;y-4Fme8DmIO_S$t!yTDJ`VnV0f^;U9dWZMYkumyZVIQnl-5!rN~0l%iuH} zgWutKqb&N381tN1hXF&G3fzwvij4+BozydP{WUx#l}xD=(m*)FSnv#aIk|J_a_ZE; zF$R&XQa;~wGW z1VooL|6pJaBQdd5JtwPsFpOS?Zu!p1BRI&mPHnw(RooiwwavabetA7s#72Ah&9U9i(y}IWBR+C~O|B zfvFJBxCiDGt83CNo`CG8W9FacR5SlwQ7FM0`K3kW8#%N#g=h>F1B9MmDOM11=@{!WBPeP@^{`co*`=a>lZdzgkFFy@ zWjTdk`<2em#VgUj9Qx-el8vomt;FiAPN4)>tW*ox%tI`1G`vz-m+x`MsqvngiFr^G z8lB}3@ymwYDg*ZB)~C$>MKn6Y$J{uCQ>VQCfo0`fXhf-*c^#gDah2PH#FxWkrO#|v zb#HLhJVtxr`_L#_@*3C*GpMu?^#zZAKSfh3izJT6I^b4@5NJ}IljwHFq$Ml2@|Q0C z_d*_{%Ni#H)~UaWEK}vxkzVHR>_k=$ls311$=b5M(5yhG)bXv3Fb&6c3CHGqJA*Y` z*xc@%e-A0HCNqEV31NpTCQ_`b9bpn?${+4;5E;*`GNpSrpg7MTn^WOx|Er5;J&>=B zxh}j00uR};%iuaEoibvyvBd~^E}#iWPD zMUkZi|9;QEx_GSD&KeQtyHBcsxAhNI5298FkC-O3{T z!}0twb|7lSIbOO%lX#R`heZb@`cspg7W>m$H&(6q|90Ym3~udgkcdaKLs$`(O}|x$ zV?ZH^PHeuD;cJTy_LaNhB;6TIl=a}CTAFuNL#K`8H1zX+ZX*Y|-h>z>hCRMO{pt!% zz!elD$3xdvJr}l6zZNGBBEtF~jbs$IFuFo=83=|xV87L((vMJs+9vA{&Cvs=(tZ6F z2OnyL=%6;Mv0U_sFQQft#0n+DNw%8L6;sJX2|}?*z_|z~>oKrk!n}xMA%pyD!oD45 zs~dpiH15)1(%(#RTi0}Z zW2wUFYX5`xE;u*`#9t`3^na&IHo*P~!*x-i?#uVa9+MFzN{x1<13L>VM-64xeD}~ox{e!Yg;qf+ z&QJM9@gUr{r*mxhgwj$Q9;bZu^{&6JiKyJ(#)(rh9c%uq&`4~!>i{-OfhOZ${MqjM zea-V6JngzTP||$=AjwqW6NNtNc;iDh;34`ZxmDtuDzLcTUNKeIW6sGfqvT8CLVPwq z0Q-r*py$)2S5hN<8tL2Qi@tmPT|Vf4M>DwW{==3rqzi_t-6zFwK=6 zC?;6;&yDIkYYuP4l26M_dSV&Rgm1@V@F>ryMPqS3ov+L1;td?f^nzazokZ#$*l+JQ z53NpjZ9sJYC7Rc0*ufb>Tyup-1qEDV|2KP?V*Ox7NUzA%;zQTLvnIU7jg!Jh|QPda}0qS z%mcSX{Z9wKnHDOPnyXua^^rBsgo_oBasx#eG04)#BO zXFCtGd*qmsbgNg)=TLj*?TNat3pAa93X2@iF4MLA73bqt)A92YWIjq0d zETIw-c;kLcn`{J_aU>IFS=GQR&JKpFG||^^ZGM^t6^bLhW2Z=al0R7F6B~I<09Z0YOQy zGia(sy(74a3p?h~01KB6HoRpZvrdTrukzW>XV6;y1WtRXS42=lpp>VSB73WLaL;mU zXQ9CJTDZuwdku@KfdgI8OLfmA!8y7>24wSY{(c(20!9{aeIA*?p-0`g`)HPgXvVdW z5@Da+;UBHSV-O!)wLQS_EF5!OoLY(gS;KcYgqB-`hhG;K>JoluO}dFvpow(;s}t4R zJ3xzySxjExKe?SBnq&VL!IzkaWi0SC)6rmvx)(*HCm(h-Oe4k<3?+os5icKrwH-1uX>TMQuO!r2*V?tf2{zT<8?^`=DB zTV~aH$NP^%O?qftOB4%>(5`RpUE^7sWIva`7`2(5~kdKYY{FISOG<8 ztRxanTt7l>cLFMcc1!HJCC@vn{TqbxD+V38#1ir^$gN$!*H1ou3U_z!6OgZWMBRES zPCwN865Ee~$-%Cv0B_^@UDrAA^d9p;HNPG&1GdhML)}B%@YOxQy#G><^{2G*D6Anj zfb4cQZ#Fu5%An@|>a?ET#OAl?=r6j7k^*%M_a*DNu~m{E#2}W$zjQLavU=2crWe0v}k;8Jxp{1{F7Th zq4)0AwRa2y+lrA`OT6U^s@cV<<_3}4NCuaJWrYRde!JIZK~Vc|Lg46mv>TO34mYEi zmtPf{A`d~2Svr%@O|;^bJOBcU(T?`1bveQn00<^sEGCRK!)azetN`s@0tJFNT?9@}?Z$M`JV!osvNQL|F`-2@s!JQt8TfqO^2Wb!YkSq|%6dB%W9I6>PDzB(()S7n z7*T+cl@y`2VI~N{WmDd&<>SuLZQ8Bo)w8MS1Wk)Jb$A(?M{#vvie(~euxm5dmkA{j zzSxTXa2=T@Y9p(8K&+HqTBnIuYB7ofL;&7Gb0I0MErl=s6FZS^Pm6op?nLG@*D{b#~A{^q&%eSo>|3Oi53< zxHPskM?F^Q_Y=O%@v0D@>+-I~wS`XH75=T9(;-HZU8?IjbbX-tegGWr1n6&-w$$k% zi{^Q!orT-Szb%8BinTx02z&42Xl03zcSuie^uU<{1DCiQ0#+Fe%RGnGx0gkdO`INN zgK$*a!=p%`S)F?n^v6MiUgV3#r(?_HJiM-1{^UFZVBtyxzo~D83~qi{xzNG;9uY21 z`hhrT4WJv14$SXS4Zp?%t5-cQZyVBfd4Hmm)DPgx?mf1;dVPlE(otRl8ac;OD|DEQ z?y8;+#DcHRrWlGiqO77)DIa?8VvD3!jxzMj=3y~z6U(b_P0qpPLS?>sNipr~lO}2y zOi(8j^|Ug}?q+8s2tf%*CSsHMi!avEe9K}z(=Q(;#^+OS{I%REmXS*6zVlJi7=R~__ESDXn#LIOJHzXITyw7WkWulm}gRncI;*a24& zi&=ROp$6m}$7=w}bgA)BJR_f{?1(TXmAZP9iV_us*d)mMOAjddARCNti zN6Obkkf{Hoj8GrH`16r{)1eo}Nc6&;s2BcacOVm`^7*nzoBYta@mEB~*WdC0`}l8V zU=5lnba1{6Jnis^5=h14u5y#}KKAT7zpJ{vNFxwc8#aH+DWs%aFp$)l?vXm_<@Lki7%IX=Q0h781^ift!&-t z1Q~pFmWdmEI@Wf)KmmW_eh-B#n5@rNN#wZS6H^YwTDCMHF~9&ijcWvWzHWdnwwA)g zcc2Dn2hcMCp!9BbL*rR6%l?zC#rC4!gt$BL%9+D-HG-^ad7f(ml4$ii`wMrWEGArZ zgQfF(Qh3T&g(ZD_mEE0mPu|`!+C7?=#Ra0O!mFVJU<47QfHiEi2y z3KwfGGdQxK;hbXXQyP_2cFV%v+deisGm_G+!OIoyK9gNbcuBnR9!5koNJnTwZOa!t zFybwuzDIYL4jyyqg{ZpB2bv>y%$v}_H;yYmn8&u0sx~mX*|mqecq(qIAyEG^$Yp%z z_%_!bH+CUB3^yA;4R+9<67KIAxg=HbH7bnD0>JZxmE>_2KGb5txrCbb z=nM+_L-vH|SYEYYGp>uyvD!q?D$n#IBR=wZd)k0Ok|-hpmA6~MB86XVy)ypHoX^t> zP3h&0VWI$C^}m9hukYUk?caKxkJclac16F&a}-H(!_9bC@2}xM6IpD+&FjEr$knru z-||Dnu-&!-#c7ea4L%-U*V7oW7RZuq$FFjrY;#8?qH#W~y;~e%Q(;#C5i#5vo45D! zYGO;|q_>+;Y6y*I1m?NV`Pl3k^CCZzBx&xWC2kJ6$;9>}23NB`F^1HZp7&ZNXZHU0 ziCA7D&EKsn1SC^WU5)(C;q$_@f7g`a&si}9eVhJZJw#cYHD;ax(lXm;uDQ-PsOnub zoCmgu;?&Hj%~4DbI15gYUQY>9d7BJUS^Z#16XG!=$d{NOr6U~Mw{}_D>6x%1AoNjd zFtXO;n?@wm%raVi6BKzaANHKLZ>qOd&1XvckOtZB=++TP8TYY&UB@arezi*m#s;FF z|9&05dRicUv0vVvvrjt&^r+dm2kT2`#a6G8t2TUb6LEScfnGeh3`+2Yc|_HsJ<0qz zlI19IG@2*Q1=1D9YJ;V)!3q)>I{PgDYFvNB*nZ=a=!{7f?+U4*%xHpef&h46o61D+ z(9Uao+!CQtVT!oZ6ASp6rnURKqKt{7Q6xT!7Ct}$5$xm-vg!S!%>AT|VC9szAyf81 zri)=i`J0`7I;%&G>TaoFlPy3V6o=p$&il;jh`8l*=-&A;*aN{MYD`0o~qO^OD+rfYnSAgP=ypK|`@RT186L(J7RKEZ$bYVSiwNGLTUVFVjXx~APi zBnno+Ib{@-w%I;U!wJ?`K5k<;3kRM#5lT}f>NvQDzVKMSh)n)>B>jj47GB>Un`y8= z*$-`nkV}cfcrZ$!TqvbzL9yW)*jN|BpO62%smdqF%j}-t)p^zig$4q0ChU&>Knbp5 zQ{=E-$8O$T5v~^1nz^ZpU|(}sA(sRggF|}(B1*!Nr6{bvVRqtHbj$xFfI@8-Je%-b zFA?^KP+M_0p?~uC$x*>R*frb_``?=T!GOGH;${%>cX;*9UBi!zAg)DeM&1hG9m_eUq7b7|iV z{hkby&6so%7aIfnrdT+q<^I7zPiBz`;cSTfO=>iYoX@gBoL>BS(D^^-hEg7W7>`V& z^!zLmAf}h;*%j5c4jf>aa2AB0++&YbS4@o%QGac)<&fV^48~lhT}w~j|AR^`Q>0S$ zHPVAZ0`4k(mEH+<=77K4**2}nDEAh<^aRU7+h#tNH)a5+MZrdLx`9s4ynOo5ic||A zkWgrYtS>r~F6D2CO#@-{vF$@f1KHZt+n3H!__WTdSV4L+-JCmY;hLN7>uiGnKydc- za=d>A+8*IjsL4f7B3i7tybyk0S#|4DIXyK-Ry zh0(q|JYUQZt#*F;@nuW;wFBb-XK;VfEAFu*qI?O91ZnM;C(SC!c2&;hkuP(yYUc_U z;V)Jo`9ee24A~F{4Hb{aIL!U2*W7!ddDaiF!~NWx%hdtFgjsbIdr8;l`iM;Qt}zfn z{4ub>k~^qeF)9g{_N((vUUys<;xsLk@;}fyHO`M(z=4gxGcb5un*+!zxdp;!9@Hus zwH?b{1~iY4zp=-gfv&MaTRW}YIUbcNA2@eyEK46bJrj#4b;4dzsod;c22#ZG+t_sv z%9(MDRaSX*vxXuy7UjRv!8NmjvF%Zx*RvmEJz(?ah+s4yvKoK zCQ3F#Ha4MMZ@|fP{lN@Z!){frf%ZiYvi_Gbwd)U?6UUneqiu!rlqI8YKi^K6%bfXv zx{EdccD}tvWn~@Rqi1g0b?kT-T&DoW92BsKaUH3WB{PLyd(w95Q4-o56gUwbg%nXK zHKY4O6As0#Ll|>0=KA8j!9hHonauzikNXP|6morbUZfEq@$c9@tIab~{$}14S*DG( zef&Wfz8E4eLx}dImSMPnHT^?qBJBZZ5-r=@l0V26($-F+$rEhNqs-0EfKe67E!Nio z>y@OCL5Wh^Q!B0G#C8Qv%Wp6>wOoc#7=W_rbPi5{104%*$d#}tOBtOIG3j0YwK!B8 zcksEl63C$o=Ve&^Z{J|kjPgGf5*S#$_H#u${tltXN8q36nt-VrUr^^TusAIGu7|uUq?(7Eomy+aQ&vbxF zGwUCs`JED)pP)^nDv(~^@4nuS)2pc?fcE{W@Rh7rSh@R6IP?_XOIL+*?w^eWYkFf6 zn34Kp`*in=6k?IA&6zJg?Ncz)Db!~{dvLTu-uV6T{J9YB zV7gABnai#`9Uo0ZO3Pr3dNJCEaiwQL?=HtbJ`qk^yx8+}LgAmL<7+S5<1>NJ7z`&< z2A2W~w3sbvq>QENfdHAc5imDA3SIHTE)dY%mX+soD-XuqUDW7U_Y}af>&_V;q7UA& zFYga*BFLdae|1JU#XwzBtYLzDvAqzOCby~giu~=_TcM}v%HO|ceKB-mJBj`ra$Kg| zn`d_2;D*d*O9^rkW^+Qu3&cPO07G+a?n~5We{_z+bxrjKIDL+47dsrVbG zYHNu8Vdf+pGq(bJvH6FZ_7A!%>@od!K0izTuKjwC4tO64vfWkhf%zNXhG5h}OKeLG zatP7Xn|th%13`<|>OWHV+-#=|ipRWa&NZjMagh$et%Nq&dueCr-sOA+<5a@~#$M}` z(?=8^WcMwYNW;i<+vWAF?TTUnkiI>68-4-^R5eFN_5TH=aBF<&W*fNZ((d8Mzn7{h z*Ft5xWCemJ#lRP;4pA#y0Hg22&`P~Nnc!i1T(9$_C)wbSjEWyETa0@G-b%uHc4H$# zWlJFHjhMeS9_x3gEm&T0TZ;cWAQ`I5DEVz0M@<6__c5y{`Y@{MxqmvDHZ ztX~Duw)}Y$L@NZgZv$jjOLOb zZo>Q54g4z@qiu$Bg}Df7s`HTYYJ&*3Ma{2WV!`IGPlh{@5G`Y>)^;`RBq`C<%O3A6 zLSiunBY;y@L_rO($DZI=t=yH${}+XOzIYa4-|%_0`-Qeu1bt2``Xl<2SUsAPQfE!T z4kb7nQv#)PcCL3EXA#wmQf*$~FcPCznSQC_HY);EkMG0EQ5cS9#YJQd0Y>?fAKtuQ zbgSx$0S+DitdNQU0l36zBw^Z%e0Ei;&E4vAyLF8VT&Y4qY3&KXZs4T+hWGRRBV2qE z9ws!{qUXJ`R+XXJ_Je`6`_29Fc}xM^6YU><%&4_&6G9aFQHQV(ngk)7-M@|&a7FyH zMWEKwE8h(6>uFe!YUqd0H2YLvLuFDoN-X)Ka2h{gG07v;V)YIQp{hpo5^s~c*Er2S zqe!RejIy`wu`*7l-(4(*s0lU?WIPoqW^59c=E zE7Xi+jP>}=IS*Ip4sD87_$=oOn+a?@?Wz83r}?a{l6A>V$RabM8UKsZsNtcUix0bK zSKk|vGfw@K2*jwFxY%bdnG_Z%m+>;vra-iq9_X+0)MpM0@n@#CKJs!c5rA4F6lf|? z6p;39z!x;+C&*@2xl!bef(W%Xkyw(H#fzxQiz+nDo-vawluU=3f5XZq3@~dbKKtYmH|s)F z3aETE(!NGJFtWFoF16s?6X}SL-IGTmcB4}eT&;A(I}v^Rr^C$6w_EwBu+@9h*_^_!pHGtS#YDi;16IzvW$jsE;$?Er4T)SnTNDJ?n_3 zjWsk{9q!Tw8Fh4sjbtm7`&II14J1#SDs-s`TW{laJ9g6!#wh3xnA^GRPJizv@{={sDN9lu{pv_TjQBEBg>9S9%e9Ke~ZZ`-4m2URH=F zve7E>C0UWq5?6#pI`RwIgNe&!ONp?3f`0r%JG#85JRkQ!utlgB_3^^TW!sz%IiXcq zUO=BQOijCwKv0QhQGWP!q=sJ!*i+`0^mjR--Br_Mf?HRPLbz2HWH_S^^9M$JNU03a zVSDj1TUwpXGuhG9QEZ;AS~OmuyLetK0!%-Y$*H8jU7}5w_3UApaA^p!E*~QqNI&0Xtbl~7-xnwK)SoRQ-Q)&J+0AO=H#XMlbye`_J&gu(kUdOPKN2UyIPT- zFKyG8XPKU;hJ`c?r4)Ye9`H~DIPFt*Dd?YXcEPx()tCh1)*R4SiaESxw3MDv{WGBF z(K+cLHq4d-J)@z#gkpOF;L`e&F6+w{#+E&x5TTaaY*0U*jxS%(mS;@mnAhZy%Z-*l z^0U-8F)$|E<4#l+uiYCUfZ@HM=FvKPweT|TOMKpwFT=IHEca;ckx}}MO!slY1mArr z65n`~J5ae($F?*gYEyKQAb?+`p~ZU(6Dbt@uyGYUx>+y~c>&ukvB~jo8ntnV`hRXv z77XPz3GM4jDp|td2B>WbNo8<7@ZAey#XpXCs#BCk(AphBaeyR~ZRrz_p8Ehe zYyy`CjUPBXCNps+*J3Ab)$-=St{02^bH68Sgn|j^J~cdd)|m;kXqLzttj_$ICf5&E z2RaRa35@EK52|Jsm| zZ1B@%SX%s7zPnXL3_1)YjK{6GpWQdf*B-kc*lAn)ejC#39PZq=IpK*v;l>I`r{17XRouwXj?6}^n3`zEdkf>A7`n{X?nka6A>1v zzk1FRlbK9jeF)$g2dvX)5CxVcl>@iM&*GT3=D43N5iFdQsm{!(?>!Ekl9SxoMw}C+ z%`BF%^|`Ekzb~gD>*GrxaM{mUoq$;)u&z6_+k{o3_48Nk*$a=}Uget93T32Q=GitI zESX^^egH)!W6>cKR4?$)%zESd%%Sv!gyvHdkm+e zETXX4PbJqnM8s7L2HH#I>@8V~Qp~b{+-5=2 zArPzXH`}?o{l?LZY|y~Z6JdLx`X#0<;??iGQ@-Kwim(n~H?c143udlK2NK~Zg89za zzEq5KT5P1drIQ@z)$gpQ!@ssH@lPfXZ+X278$GQ@etW%)pln-%b%0xDbaGbVcf0vg zKc4*!s5k)(bzbOzn~6z=JJR1tx|Y!7oMo>)E>mZK^D=N8|ETRdF}U1#Yi_^jQw!0q z1~T~H-+*jrR*}mV?uOis>y4#PKmGjUUTl2p-IRH@(mxx28K81?QFk}KaB4;^-9G#H zua3L$r|Ea{oOBQ0jDThr7_r25&DFemiNf<=ef?xlHTf{`xYS#p+$n;p0cGOvSv6s1 zXJChPTWBU$RKF3op@j&%Eko-<%aZmYYc6BaSbOM((6kgWBCM|`#xoeuox4jz%Bps8 zIFMa2YAn32Jz?8Wi`CHMI?EnIY6#w`PX@ScHT;@6=}?9FDUQGqw3**e=z%e%qvDbL z@UJz_$rnK@@^^M9@;jcRD~}lQzCA^XbIH?$>et!^J(GP4H#ByNYS)5=RFWg;LJSFS z_x6^7%RdOdAy_8u7qW0ndUgxOb=D=_z`dFP_xg_#>SYOR&Cw^yf&ESC5%uEGs8Tch zf+UxUV&h|8>Bw7Gw@bzC65(SWF*=%1DrV4lfT)uK1xz8SBbrM`-8V-h2;HTbG~e7g z8{;`4jADUlA<@Jy@nC!P5qI#Mt*^(qU{0w=C%}_*%jI|?!w@kizO^&^?oV^RfycA~ zIifFV1<^j_7VV_n`_2~3yzHqv5s1{XU{8T9QDQ?&0o)=$ZW5kc^n~=m#t%d2<|2o) zw?0cu%%^rIIj;8y5uLlKqg6Oed{}{?bf3^hEH;Udw+YEVL1-gY%qWWtMbLsTQE^Z zB}ybP&>HQX@Buy9<_5{&H_8lDA@tM8d66|;l08j2Um#w7UR`Fs{*%$u*U`as1}^D& z&QA@srDt$AxMBaQ8`KTf$ijF+fXsR;1Qg@DI6!#9C{;-*yA*>&I z4b3fJ35s5q0Ba+5>FFObG{^wy1z799?0{f&0J%!k@+h+9JuV%|)`uUa^|Dc}+D%+ytqknN^%c<|m2sM}_ zT_&^=n8ihr!o`2bRhkg&LjhwS|6J2?)ru=*kN*dYcuTDdi9akUzI*S*Rk@s&H9KXH zba!Wj!p8f81kfCv37;rjcMza!4d*s2v?2$>`TF$jRCh+U3i`q$Dwwh5i`Q=(s(y4j z6H=RgFb-E=UVNhX7F4FwV-EKlqP6hDGUSMcj*U#dg0cp`h4T(pFR5|O4e8^Cyw}8t zfK^_d3KAdXKOuA6q|-7>u84zIB^bFfL&I^K*Il&-ZIiuV!^E3graq}fH|t!}EsIhg zQ#cM)%Tg|ZGV;F60d6x6tW*k9a{Y2XCp`kn6SED7k{pjs6O>)@thEnK`ttu?0HlF@ znFOOtxV$p5oG}QCFJS$CoB?0qQ`yv6Y?V)nPo6;V1(28LC(?-MIu=Ox)F+R+$ck8A zZsk_Xpqpc@i|Z`t30D?gnE78W8qOS(9$aP02$Up~$ZJ2ODPVq(AO0HiY*jroQ#Ca0 z2RcjqLoEQ(=$co1ozmk|D0cG~%v86Fk)k!D5GPzM!;ko=yrZ!P*ooyaH^bY=9Tm<6 z=qCRqGkd8f!d2z$0pb^9`B|s(E7Oi z(Co-q4+RaYT;4~SGp*0ckoPP(A@5~w;vYGylK8#njI|I2qs zcH)t}Yk}2IJnd@rs>Rh6P+EeI*}=QX^LCyp3tkHSPJalx_l+@IQ!3t=#?Zbc3}OS| z32*}~DKCX78Un@$jC%Lzxj6lEwA5^CpHjBDYwJD|J!pCU^XUI0ldCW?}oo-y(XiJw|EMkrMr@|fiF=i0&c1F!jdLn zUXY9}=fU!X8p=Cjx6>ezV=Eaz%1!Jj z*Cwp(CZXvs;7E@suDyGsLs=~quU~lef`xn?Qbp}aSlgXcUCs%fK7{Q?yDCP|%Q1oRti_>!I{S#ppX;}> z0v7F3?YgT28L{?@Rnrb9xT!bI zyqThjv9V5*)b6C0Ud$Vb)|W}bdQsTzLw6))Y6#B(L-iuVT+4|QW{^YU1)GX#gN@%2 zLntzOh8XK2l*aCXZ4ZF58tfVxWqL7n!Mp`x!>JF-L*E9PZ*TRPLK<3uen}^&wQYM* zC=IGgG_JDgUz@)0LQiDMXL&F0tG=5AtyOm&w~tw_mz5`F4sUT%Ke0YU{f^|En0heR zN@u3^h&QRp_yvsuMQ{WMM=&-ZZVZV`{~a1;B9um>@7V;Ed4ZgkgI)YPDFHN$G4xvv z9L{fIaTjA>4^B?nrjKYON;IgSKH)IDomW+r`CbYD42Zybb9wvnI!#6e-e&fcb?lkt z|F!kiQBg%*`+$gmQqs~PASK-mBZ#zgOAVa@B14LFcc-Et9YZ$^&4@@0sWZSxmvsFu zzVG_h?_2BRzsuZp@44sfv(MhobIyJYmWnr9_WYMm{laC}V8+D2Zl9%;?~OY&O{Bjo zwfObOKp#)|iRVwMXF`()3=E};QETU-koP%N4;@Y3c(*eYWh^GT_h{iUIAT6ujmmuG*6itj#KSMvyTmhM-q z8M6G`On;pJ{f()Zg~qa08Bh|bSfTAy^=;fqj=cn`y<7M^(zaz-tE$!!_7iKLpNq~= zGs{79D;(wt?|Z+PnG0{Qr+6E7%AwI&?aD*2mDRIf$NI#W+#|kcfj2Da^$E}FNtW9aMCs}-q+R1f z>e2$Z?kZtPanMKnrO*04r|wor*~})pT6dkewoQm?@3)=ITxlSnXN^uoC_reJ!_Mk; z-aqW-d2ww6KgDd?RD4^WGBzFj%1YAX-oDoIuh)DR&)p&W2Bv#eT0YV}YON~jmoZzo zKl)k~RRZ$L4PoA{TE0OAn%8(55q=b#PbX}Hx{t2{UJTHgnh)kgKmN)gnC;U_l4K)O z#1UOgz7wF|vY&N(OJJy>`L5sna$`K<|3MiW*jleZg4)J ziPlEt8&*LtLOOz=a$9;I9NZO-9nn-!x9OnpJHn)c5D@oHX!^eUE4E>xxE;nYcMJ3O z|4>8+Nd1kvz&fDBB3ARbOmfk#uXyyb>Zu)Z*xBZ4B4A_ji}EpW@g2nI5S`XA3cvfO<1uU)N9=o`QL6c5c* z=7c_W;|wiBcGkq1g$`@<4;~yTbH8dwP-B(Y$kpzQM-|_hGKIh>_2q*rJ&zP^nc@j9 z2nB9wclw5!jxkoYOh$7XbatH3|EtkAfxk{z?Y#Xo1^92m+uvugi(u!iBz%WX1Wdu_ z#k9F%*rLv<%{SWz$FoShljfHIJ1Q$5M=Gl)@-L^VVSCK*sx9}*s3l#F&`QFz6j`Oq{) z771SBZ>)3|!OM!9Hn#r$Yr6#UQ&w5OV-|OA{`^f`6IZOQ9Casfa1={ZA1!7vu4s?# z+cW018&beB;U!`EE4yoqPPEVy^Ap=#aE5Lkn92f$=hO!EWZeD9{aAuWk&w^)$!kIy z5EO^=EueS+eEE*jNxKjXI|j=whhcx}s!MRhj@sAG$Y~**_TWAY{$`1LX7(>VLb$ot zQ%q@H17#Z-_Vcg;7lslfO0IWw)vOuiW)b@1M1^gmu+Z&K5 zrvW&X_Y3SC78!!RPtZ3PxlF$~u9b}^&EJSOFleeL3XP%UE;8SfEi7p!XLL;n_W4a1 zlsR_2QZs$B?jfmim|nR8nwVqoMBHR@MPR8gs%&F5+c^KmvzzZo-t!5()NX%KP$Phi zR5!;N{Eh&O&S+{L3&g@dni&fV_R-rg92T&NruQEcC^GNm-}OVs25-$)x=-o^&azO-uABXk^l zxwLjZlKaiDXg4LN zlA#$=Q5@~JJH!Q_RjJoBeYMBhn@tL`kd^6yS6M9(cay7_9~h}>2k@pI*oc+<=M zkVD94Nr}qUR!YVt`1Z%Z8mZr~P}{vA_|gV*eF!! z6yBmmT77)28KUBR`mU8~CBeVoWhA=hnA8SE2;)H=X7>~wnFMtKL)b^B2jmDWDgM^Mhs}(Q=7UCj-ylo5_0LbU|@&ZWvvW zu2i}YVOR${ zJ(;CH@a%YvS!W*fzY9^PWEmncy|FM#x_?tCKDbcgqhxA)AKygZ72KB}WLl4(@`%2l z#Isx7Si4keA;L#-Ch|I5+9*QwUb)5*(b7-p!$UIVk-bBLr8Gbsw}}6^5=9)E;3dO$ zBhf(bPmlX!pjpwzDZf{cYBt7Yw$Emo7P@O~Cc^KRi+xfU?d+xaCYL4CK<>GS z?1oyluT=LeGoFh&s#u7S$A5U0c3MN=z1VFeO;X<9{P;8%9KKilfgi!)agA$6(kXWV zoKMc_d18MCYydn>0vsJDaEErEu@8@eIm)vLT*eqh%Z|2m2V6EGkxi2g#k>clvEPJt zG4OYpoTmqVQXE)^1{7!?;H+>#E3cSOkC}xiK0ej*8HQ0DJmsa)MmsPY(d#T)NP>n* zKlLNXybMVzY&g2;@-QfDUx|oC6uXTF4 z-i!>dPv%#Cs*NIfWQ2AGbp1Y_%vMmVsI{E|GNpqjrc@4_yk@^mUHN{hLtG} z;w|ZC_;edWQ%_oI2AajACxIZ$9V$$fZhsi4XG0E}jHU=?IDB&}Fj^0+%9jaOLMx2q z9(zYT%M7;`S05z3$P{DBz(cSCbkww;Mnb+VuQMbiVDy@;OG;+E78nB~4f09(O8bQu zw1QNp*ob$8CaO~>P?pVY97X?XbRB7Wyxq}CJ;zb*QP9Ze$rxH{+wt+3moJqr)$OC4 z>ms+62EUXht5+H9VDgh2fwbwZq|b*=?LVHeH6M)cZMB=WkH$^7z@#Y^=LMb5u?0V@ zAjdY}hmK#I^4413knT|j+i7}=a*tr$LQhHcFQ3Z1s?r(GKPcQqlwSWJA8BEE>lV~q zX`3DOMgdnoney)EsI=B^AKbQFKB;zfjF|A62+Hu??AU#ILq}+!nUv5r$4P8M zUXb=~iURSW6(`ktkYy7nw}S}GUW0o{{}NE_jf5g0B%LTDI19Inptl zqCS&#A7+9J_zsL=KJNlZg@0Xiu^P>5e(&~LiGT%2PQhCsT40i~~3FJF6 zRn5*5^&JzAlV_TuFqVAA5XLQksN~@G5|8GLaGJC9EB+aBdXRQQ@lsOLIQ7lec7jnB z9kQOjw2t__;p|{5FYHdvFCtb_7Fn|V_#w>%!RcFy7Pjx;J}LCK73AmNc+uJqUQ33y z#BmW`V1vtAWz3*)&Y(|Kp{;yWym>t-f13l%3>$InY-_2ZSr_XR^wLV+rSl9 z+KIz-{}ea90@QxtD}C|Mvi&Uf%y;H(TnWF2W0x^yOa|6U*7uT2#wu(9xv=1+MxgY z{dwnt=Hs0c7Jrwm=YZyjBhfY9AqTdmBrh>B6x-=gaW2fLazaG&Q~CgsjfVc2dM*#C zu9vLqMqh){zJ!0-sHFWXz3}K|_-zOkHU`-hLRtLi3&W6?eK=ym%>;CVW5J`zC%K)J zK=b>rNELGX>}ZNWKU+Y9*+1Fpulf?Oeym~a+t2y~qLY(-qs`7#<13Ow^G41u`9Rje zjO0CH#1DaruuOFq99fr4wt-0t;^Wjdc-#@hBTF||Pbt($-*u9M`=0apUvau);T167 zh~paY-RP1<9Vlv)A$T%ocI7Hwk#=UZkZSPdn7si7Gu3#mydJ8vPZxU*q?o>xEg-+N zJ)i0tf!9c{m}Xw1<1xZnw}3x*)Ps&ExJKui;^LWTNTc@Rp1i4dhq88R8Rfj${W#H< zuUk_CF8>sOfFZ=DC)EudjvmM$);c+sLb)xX~;~zZRafUj}mVz}_$G zP3I`jPKP9{eNg-kBJjBezd=PrK3wSjyQ9Hl%y$KQmXLYrMq<0{XEv?^n>U2A?mJFD zt7J}#>KcX66>qK?3J-*rh4i*t{dKo-sO~HXh(L(A-6d}M4O)R1OS$HUBV`lfRok?v zqVO}`@q17hSkdu3EW~J4?Hm;U(P!a(wbJi0C03=PKT5Scs*t6sCtt>Y6|)UJf*E)` zm}V}D@EC2b=qH~wY3316}V&X^T#EA;_MUn6OOGvN*_y=Z$TYS;>5 zA8xOv>K4_5qEE!sLkswd*wj^3mn^2(|Ll&Wk_sX|agOi+*&W3^mm#FLtwp9ne=R#9 z;n3&P6yz@c)iZVJE8>Rsbb(Bl)P77)dw!haz0MDz;iXdm9OKt z$+raDbD<^|+^4d^U+vJ@WLPHMZd}TkHOGK|DrPCw`9A>yrVL7Bk|9#lsimW zPVnsS^E1u*S?UQP{|e|BU!xO_X=ql>%)?1B8L3srDvx4;WyWPj8U0qe!pxy6bz}{g z&^X`4c`HJ{@mZzQesEy_g^`QYO_d_9EpCzHd>;*a%--O@D?ph-kiB78-$QQt06WEc zQ|7$ch)$jj7v8{kemMgEm>>BT)E`cKwQDl`KoSlWev}sG z!_WY^JaI+IRswLPLL1Lr(3HrTkkY~H#0j%RQvWFl44uSgA~OUhCR)vL!+eL!!C6Pa z(i&Y4-UfYygI|XDTyYQmnAbE;JtlgW=cb2lmcVF!3_3xbrBQy_Wa!TRHQL`5@xYsu z%$UTF#`uugYSyGbhdq{^9Rc`1Lguz7;f{!-N&!$x=VPVS`n8fn)-O;&z8Uc|n{6vRr zK4wva+~xkGU0+|o^MDX--(4d$Vwe~1*IC$zG!cKCIeUb6%o`B>1v4h>A3BL!`oTka zxZDD{e@4)$Q|n{iZ22p@ChdBKFr|93;!SudDDNtaj<^$+#KXhEkp3OZbX~)^sjTF? z#I=PYFa|v})=sXT7eY6!G_ujO2Y%m@KdxVS2yj>$QzI)u3X~`bDg%-+?{cJO^OB#- zRQ^t_e1+het^B$SKp8&EhC9*xU)hzuz89BjSQ)C7qc8H)b z#3k1v8PhADP~W7TNR8`W_RV*pK60M=)C> z&f%+34esdIdOmWdi8BCt)SuH3I0ed8w26ejXub+sgI}uCoG%|bvtu_sPD(YOx+hWP zFe?CPfdGKS$aU>P*~It9h@Tpjn7$s&%FzCt7tMqd;x28)JbayU5QFq%5viAe~l3e$buz306}kY<6bFZa;-v?R5n7 z#6D#X=Pm(Djj)*Peedd=ot*~NQqEDto6KG76d}XFAU%DlB(KY)Rz~`RmAuE0^=~b2 zqa&R>eypsjzBiw1Y*Pjm{3>#7*S8t+yp*sv%ps_Og;t32WKyrej;06*3AE`uzvGYR ze=ebptdrA2ZYQ=u_l>WwgYyGDO13Xw6 z{8l*;bHW(6gU#x>>6gvG0!_QFzERN8QjCMbER=^9RlShpFB2Fx?Al{-2(J#vLXbav zL!Oa<3-qmCZijlFFJI^N8xztcA}e=JlNHoBO8LEpBLzSt9AeDXdgrofD&l%O`<9j& z-6Qkne#=w3Yx&LkFAONSeb3YyDCy?Cg$pB5iy94{Z}{;x^Dt^n(dL+Lb8N7`fTZU} zreLCbw0)w@_S?MZvsH+j|5x-H*VuG{PF%H?4#^lN(<`Uf8{ba+hPaQb7E-2-5qG8- zDLR)Ik5poHQvMR9Lh(@~!D`FI?FVY^u}e@;h8^8k(v|OKSHFzb>wr?H>ZqkZ)=TP} zi=?b>b#~*KmIaJ7vVFrn;u8jdydCR9#jY<$>P9sfuX3AK(2nTGCA+u;n<(fs4?>tyk<@b47^H^cOb-o1nZp%4!e?GNL%1;=3m^HMr)mVzzGl#6Gvt#l~ zF_CUa|KU$bV&S$1^_Z3jZ?jlIVt|~v340YmA(q!?95bgbX1{~HFeep5qs1+*on%BM zvjbLkVIfx9U36==cQiuGktbT(eXp2=ah4!CR zmGMp~k$l?)AR+9mK7E|t#PU-`nQi4)BmOqh9qZ)FWkE3+;qWOs;pzIO%RKPHV`IvX z`u73fv&Ll5K%*qc|E#<+*bSlJ9Dw^~vHbni&%>XZY;d8O*kuwR7YE7OFg*CQ7}<&; zLE5MFqxBggWQwNq?y+412L~yuw)8wqr(T@m&K34~`asUjL6p87cpExXqdVV})`shi zcw8v7W~_M$D!0bhet_Z*<6joK8A5zzV`U*?VYZ$zS#5Lfa`nl`MmMx6h+mM59s>#U z5?p$rCa|yGA@UX60hp}xRsi~GcR0r1i8rdRx2JExa4VIEz_Q6Gy}}}JM_^94EfKa_M<$Lb_Zk@R)2KBdP#1ax+QUuFMX`@Qq>_6)zS$=dN z(&B5@*UZm*8%Azl8fU<6!8KkAOlR?T3OV{Oxf!2(elq#(?A(*gG+}l1Q0N;Md**_U zipFHdDOH#Qu`$w`j>K7=uRe3r;GO3_&R$a}?k*2pB>(zJHhGzA`^y8Rqr_@Y`$74N zpN>@~_w>pXe1LF@O9p?3qvJ&_S5f61o_M)h)OOo1y4#?tBRi~?Wo_2rE`-_NFu_<| z)BZWLbI{TeyL&)zQPJbcIfeHrQOl%Lf8)6H8lp7uEZI(PM7ef+ZY``PCacNFYhruK z)ith(U)R#5Nqob9t5FB=OoYkbVWRE~v*DX7s~Llu0~o^zAnBmpom%(#9Nd z02$RE1)MulR%-Io4RM+E;oEd9um1Df$7MM%@*p9E0=Hm>h+S`qC=wm?M zhivU8$$`VzO0oq*LQ`-d4(pefnsnB#AVL*5HjC07XX{aaCfD>e2D9pNHnU}V717xh zknhs$Z=225Vl64kVu!#w)Fa$^@7R{$E&iA@bn(+fQ240-YDvtZd7Pr-20H5u)lhsl z8j<8X`g$gi5(adpgzcyBd%#vCxeG(z$chteBiNc^`wk$+>C+DQ{<6Bt6CJ<#cP}LS zbF{Z9sQM}AY;C@;!+b+ zP>*yw)TZ|x+Wg>2f~u+vh}X#4CZ+rIyX11DKF@un&SQ-&?^}9XTaGaUFBe`Zb0%v; zfT!%i1<)i8BAqjOZ%mdHx81lJ=QgmvXN;pu_H%cME;HELQ<)qVnp-!ij&}OmCXQa3 zHyLT$Z02c-nw7{yT2wwGSCL1ZC-yVEbumA`v~rBhzL{@gfVNU==KQ3^wO3We?%Nj? zz&mJjqkTj_9WxL$w~H%&a`n;Wks~qCEj6Q&}#uuoWOhykQc34?Z)m1(CFU$%$Ye+Tum(s6Z|s&Abr(`qo;Y zcY%#eevvjOj5TIePSQhI1`bS+b)(T1f_F5EUNQy-KDJzWWPc9u z38L?6UAGzU!V)-e^q%*NY00lxP#A4WS~KmB{GGoAQ+7OxF|-HL6<%VPHgeOL?U6q# zGh5%9`9NF^zB*HXyIe;L$#Pw{fO?w|d5t)|OwPx?V(n;hmb=Nb%r*S%J-6F}ot(Xg zBxY59sqAJ_g5YX5E~qYL+j^5a_8Tf#Cxj04Iv(p!l!}4Uw)y;!=+`=up3<~DJKXY? za}`BxmUcQ}v*7(lpks-Z^6WkHpWXn-nF_D_9v(-Y1K#kx_X_>-^U=aCA`k#4;e7su zC(ffBp~^#>kMQo9;_Ns5i5G~yx9xEuU3kd_3Dh(TKixlJX$MG*{_>MP!)f#Qw1Wt2 z6z)1_*z+INqS!Ql920=S?-ZajA5_2fH6XGPfS*uZi+?yHs|F|j!t)f!f2HA{UkU1c zfGr+6DhmTYPmV*s^IWSWSRRUFgblS5E9}>~w_0u}97_4HXFX)7+tw5S%h+V0#mIQQ z2BksOx6i)ah!dt|wA9n$3WwCNKJ<~vojR!n-il&u@PFUEu!?9+Ur3Vg9k!p_$BKYL zLZ{NfIr?s%{RM?oeWWN0)add3s$rvL&y=(;kPW4Rgmj{#4aY;ylS;ymZclKi7{9z+ zr^YNHR=8%2sJx4O+pG!a@8yrxU*p58CK3&bqRQ)qmoH}czBd4}TOG4@DvmC2=n<(* z-nq+7^AX9YNr6$dJ_UnX`F0Mh8>gO#=Gzj%!TVa4#N^<=v3I${N1s=K7s7 z4)YruIQ7dHrAKM4ZYudmR)W!n5|cWfa(=zV5#%)QiD9V&!6iox z2x2yR2G%nv6n44`SAKgIh8ICc>Rk-pAHXH$(5zlY7*U~(z^JJBK@(a>%!n`yMYB~> zhJ=@A&K9jUH4R^)E5?7lhAd%WlMIJsoh_yel~xn&Y)yBjO8`pRcZ3&Pr7bhyc}JjR zth#5;^9A2IWwtD@XlEJ+pxv!lCX{mm*~ViS(lZOaFZlp{IxKxdH&XT_bt_H>Tt}oa z&|MstYCehd+vzTFVzx@!`|cSng4i&?M_Db_OMeW@W;8I=m|kTG(D0gbj1?W0=8STQ zsvm!7qeFv$a?W7HO!o`pb?41U51K6u%q!>vW>VAvmM#^qCS&|Ntn2`v`8`I3n&H7G zkzDJO&u26e6e$Ma>_&huV37-GU8) zFq#)Oe#cgxdO|4I<1Y$6yBGzTo+t6iUj$sUR{`;>ebNURqIxqdt%V=jN)pfAn?*nE zVi@)t^_#@XihoWS&M;Qk!t>0Mi8Cz+Hz!D}A!B zMG4#^ZpqvP zQi)=<=j$H+y(xZB$QnY=?vN9I&$#ePu>$tNO~4^8W>>2$IS$b}!x)%ubtRw~3-{<$ zU6F)~=Vb#XGa2o}IWW@{rXhBe{QHaOqqu=0myu;+f!Kw;VH^2SmoNr-g{XQad^dm^ z(@SWFWU<2l=w9`9_+R7w_up+Xd}+uLqB_<(b(XX_e&lCsMXV47m+mp_XZX@}aX+6{ znAu;XyBOF>WvRUY18knN;lamxCx586GsAGc%ap>22(enYhu2#eP}f)TJ;2O1R5kSb zwR8*L<-!0LwV`NSaqIe;8mi6{tivee550U9si>(~-rfri4SV#O?z7|to2+au`fvD~ z3crc-ddN8Y@4H-A*ZzyDQ&yeS0*21-dj2Z+Gd0G)L!%bRj|YI;jcIqu);}o4Hw6q% z9JlwVnFjZ1UkqNv(@SCVv2^O30*}iY#^2QaCb;5Ap2rdgS0ZaeuF3%aa+SY6yZq^$ zOiUP2Qq5BSHnUq!!-!W?vf(W?*WEy5nTL++RYrzc|CN%$?KheT0m6q4b(9vy2Jjj^4(| z(8HeUX@31y87(GlHJUdELLB2KXwU)OXbx;~y8-4N*Dj($wc`o* zAqVgMI`kkVCXP?m>l%J&{g1K(aT(jD(8e$#p2eTw=;p~0Pi+rhly*B~n=q=3r7n4B z>VMO@i#fO@ydlpe9-jLz3dxD}IICa*jM1RJ=U*O?lD5_1z@#I2(B0z5W&AmyM+v|1 z!D_JVFzvHo#y)@qBhW%R$2C2zvfmpP`Jl;jr|t|;wR$s3`o-N8Lg)nzV(d_PK7P#^ zQ5I$#XszD=%{$b*ms7tB_;pj=RjoZYgFa>-7MlTp4{!oZVY}v zORVshQ$z)~Hupd&Yh(Kpbj#>m>F8^!%{71l%BL(6AAkZit9Ca-)e5$9GC}&(ydk=+t5p z#J9&OSoi+(^3KZjTl}Y=Gt1~V3Xc=(zKTk+vqfK(ZhCtX1Do_fevclCNSAc1a5YoB z=w=3UcO!U6{h;#jyMETSPvhY=9ji2(9ezvSHW+1fr`!sNqmxe`^PSE3@h~%YO>iM@ zd!Ma{eAfC0b?MqO#GZ}JU>@Am*U>{U;@wQ|up!N9A3Elk@=+?W7|NeNVhx$Jk z{}jOg=Z^n80|;;azdQbW@!x0s_m2Pjf#z6u3!C=8cKuUy|L30mv)bL68}NDmF8=o& f|GC}v`4!RfN-%!AAaxZ6@b?m=p;V<{8T$VK15)*3 diff --git a/docs/favicon.ico b/docs/favicon.ico deleted file mode 100644 index e90fcebcb378e980fcd7a06c133c597334b27436..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3723 zcmV;64s`K}P)Gnk-?PaWce3 zkeN+3=PzI`bHR*ETy&brusEhb$JWXZtB8glCsYch+;jJQe8+H!xqRh%&+~km!`wG{ z{Y$vdyU+7|zW2k*ul&ld{L)_ylNv1yz=fEE8*nqO!(|wb0xQ4tLtq$g#|FHQ6Nn>$ zQ#gt?tipJdSox(ABY-Gg#VJSz4h~@{&b9K(*BAx32LFcx$wDul#b^Yq{PG+lh?&?A zaVd$dh``D(Z+k{9c0)XJ@DEg2`QC8@qvx|^G{&zH}U(BfcWS=eBH{gtb>%} z-w>ZAu{giMXCLHBd;(GM5=yQ7$|}eLBq0iRqsq#~b=TTP3k4X63Va2%n275!1tr(q z5~;>FQG?Mq4+9WX3i4Bkl7om?E|yk+5UMc^i}4IzM+ZK{5gf-!Y(+VP{}H+o!+!i1 zFXOlPKI(Bkir`0(hagH~xWdY?G$RC1hA0+c1Kvds9LO2$I31(~0+S?;p&jcmA7fDp zw?TgPrMp5HWDzdGz1W1qNJ0$U1u;wDAU0wls!)(+kok&x$S#bsSp5|uge$Qc9~dI& z1TnMGfd_FZ3i}vjJh~tXHsYNA2vLa3@DyTjAb@g^%#zrL<@g$c8G;POn@Z=9A45Gx z0h;mQ=R@RBkd!2LqXm@+oZ%hb6$(K*)lTZa-coO2Feb0qJR!{BzKdQ+4hKnz<89o4 zBEvhp)A1g}M>c+r0*x2}jKz8!#T|G5v2h5)d+{s@l8W*uLWUTf5Fa^s1r=H`u0jVK z2)3h=;Z4TTvml6#H7HMeyM3ZkjCMredyGQNz-|aq;%I69b3>Q`u7i`qLE`uWD$-)q zV5`C={yORr)VMNk!U2fEUR=rm$Kit<4HCx_C^y7-6HXrnY-jPA`bv!S{mS446wdli zw3vZULnp+*!4toH^;-iO;u6?77Q|}|8_!_@)}s^Mh{HxNKE`&eL>-DPmftaoaTgw# z{k__A8T#}yMCrn{4Dozy$)O;A#8`{run+u+y2Q3&ECMi5tH=h+k^ zfLVw^fUKf)VhqEq#Xj92nPa#-XPm^-xe&v`ShPbR8KO+YRyb)J{FBRG`)q^%32cQR znlXCt0LrY4OFu{$&%=Rai1OgfdC?HVk6pUF#Y%E7<+8^m4 z7&dGDTh&~2L;9c#_sm)t4Kw_!4Y#lLD>v7dG1Mj;g?5lQp2i55hdvu?F)S^{#dr>v zLoa|K$OYH|$-;><>?u8Hy5~;~AqKlj;R7m_M_WUTO-N!r%K9rt5q^avB!g@=`W>iZ zuot0SA&6Ft04~8MI1uz;9s>Olq%Q3d*RLoEta#*KhPUXw1ksPtfVT{L={AhejuFDM za3Bg%j-%=HTl5=!3}Qa?d5_VET@V8sixJceQjd=zfJ&4$T)==EaoBZ`%#XHHu}vvP z%1(^b+&g{`0o0--uzbniCYCbf6)b%6xb{fC&tFH2w#Hjd!pbO^BibVU!?n`j$Epb(oL){5bTvjFHlcp&F<1dy#}F zMR{mOQ}i4{)ZlHrz-RD-81$WJ!`-MtL7)H6NZT`}_A$mOEHxbZCSaF~$NlMk2N{T$ zA&R=OXvXc4Ffpd04c8H1FfKyC(21q}N z;U)yXAVMLkF&B^FCA4BQ{)%O|79$Wg;| zu6AIT!a2jOy%^=k?P@l9Aj)hk$3R1j5;S2i97tc~NDRRVOz|3|08hbzD0>T)rWj~e z_?G!8tWk+!=AhYYkTSGFl*Mr;0*2dElR}IhEX5GD7-ml*=q1P~bV8JMV5H&dxEOmN zF1SAQDS8d1UV=mrgD86jg@&*C{{l&cAHobZJW2iqqO1+WyabsH?G4?=ZHB9(3hzJ^ zf|RDc&LAFzDBFh%y#$#98=~kiY79YcMqDAtAw&(Y^%iKq))*pQf-HmsQPhqK!wLK` zh=K&>8D8rZIE0gmVyN>HWD!K!8wjTb3E}S$CCf}-YeEC2DVl=8UV_|)9m;-(lC&U$ z&1*5YPW&p3i1uveX^4>BO!paemB1kxMVAarmaX_y*&ZoHRVPDn;M1ZuDk z<_2B^u?%NW0Bb$-jN3Sc*{VK6-I4D{4TKw9#S?l2(gsH%Twp~uR-=c~3h)kY!DeSR zyB3c%@Zg&nqY#N5IDiCfMmUDT6Q+8?@WKJyhj0TMK1Lh8YL~2m6~YM>IEJAcPEKqi zTg9mc{xdCjYf1e0*4myLmz_T}uFrWyB~3E(9f_!daDy_0!K6nZ9tcE%6BE8Gh+tQg z(oYORjH*?rm0`lkP|?neF|ntD%<@6Jbc~ETT-#FKH8>O- zcEUr?Kom<+t>N-?9OE{AG0{sFK~B|hX(&MC!tKHB>%xGLZ1`|hTtGWMcQ87kmByCs zjafK}e9R47;NMd|{gH(!OA{t^FgTQd5o|<-xc<1_z~w0m3%ERW;spEWU1#tqy=KFVNi;2$R@ za?=>Iyi;j4IFw4vgUP50qr;G=p4?H<=W$s_@f%b@=oCf`R>q}=D1oHwxNfFYS{Q^3 z2m?b&S1l$QQcH0g&SC1d)Y_sk0Z2k2gkE7te?qw=O+&ekOE$;iGD6Hs2q-ovlu9gw zvBd*q4c@MDa<|2aqR2&ve0AeEFS!v&hGEyf^#{g!@_mOPbX1OTr63O9kpLU&LV0QV z!HH%WN+pDoQqjfaj)O1ii!Ys6cCcX6;`c(7A7ZY9$5bn1XZ|E|A#|1jUpb`CSM4qL zXY$yYb3NqbT|^7QVRBa>zPJLRiF(qf9@^S>DQv!fcYd@egKi^Rv1eVvSf!=zKn(pP0AEY&U(&yMmYxV{xo%ulsgWW^)>}8`m$z>X$qIL9TMWTaApy7ci0+0inlS5mz zQcPCnH^_r4?{iM1X4 zR@5{ylx$FYrJ1}`Sa$N0k?Ud@)mXmgyO18rx)X#O6=4b;ysvy`h|my91ulWBL^FFU zr)()NBHWoUq|5M?E3_5}H#@sKJ)}G55P=E}p)ALUX45k4wUmg>K^}5%doe^KSg~UJ z=^&+;{~?Gba1RSu%ml?PV zp<+WeMw=d#LlzvEforg79qP`FdbX{+e_sR9M5^)j;*I|=(c4t5I1QuFy!s4{EyW)x zsMa{t^~U!QP3$iyYg|K-1px~ZL8sq5UQz2zC<<@HqEN$7cMYl_nwSkoKe!OwfpeRV zEW8f0sU;lpWiOL(0+wbp)NM#PUY;@Eza8h-7apdTbkr59$0GcQY6#?DK;2NcnS^1% zX#~L3q7T`(_+Tx5!OocEKrjCAWQZnKiHnFp=N2D^opKgF@Rmc}Kbo+=D8g5G1>Nvq zji3y;E$oSKoX6j=x@mZukCT`TuZOBdXncma14bYkC-6JUVbf^=u>{#j!XgZV=c6DT zhofi*UxZ>65^)|^k%vN*!GcQ3f>Qj0oA?-1&&(!e[n]||!t(e[n],n,e));n-=1);}function hasProp(e,t){return hasOwn.call(e,t)}function getOwn(e,t){return hasProp(e,t)&&e[t]}function eachProp(e,t){var n;for(n in e)if(hasProp(e,n)&&t(e[n],n))break}function mixin(e,t,n,r){return t&&eachProp(t,function(t,i){!n&&hasProp(e,i)||(!r||"object"!=typeof t||!t||isArray(t)||isFunction(t)||t instanceof RegExp?e[i]=t:(e[i]||(e[i]={}),mixin(e[i],t,n,r)))}),e}function bind(e,t){return function(){return t.apply(e,arguments)}}function scripts(){return document.getElementsByTagName("script")}function defaultOnError(e){throw e}function getGlobal(e){if(!e)return e;var t=global;return each(e.split("."),function(e){t=t[e]}),t}function makeError(e,t,n,r){var i=new Error(t+"\nhttp://requirejs.org/docs/errors.html#"+e);return i.requireType=e,i.requireModules=r,n&&(i.originalError=n),i}if(void 0===define){if(void 0!==requirejs){if(isFunction(requirejs))return;cfg=requirejs,requirejs=void 0}void 0===require||isFunction(require)||(cfg=require,require=void 0),req=requirejs=function(e,t,n,r){var i,o,a=defContextName;return isArray(e)||"string"==typeof e||(o=e,isArray(t)?(e=t,t=n,n=r):e=[]),o&&o.context&&(a=o.context),(i=getOwn(contexts,a))||(i=contexts[a]=req.s.newContext(a)),o&&i.configure(o),i.require(e,t,n)},req.config=function(e){return req(e)},req.nextTick=void 0!==setTimeout?function(e){setTimeout(e,4)}:function(e){e()},require||(require=req),req.version=version,req.jsExtRegExp=/^\/|:|\?|\.js$/,req.isBrowser=isBrowser,s=req.s={contexts:contexts,newContext:newContext},req({}),each(["toUrl","undef","defined","specified"],function(e){req[e]=function(){var t=contexts[defContextName];return t.require[e].apply(t,arguments)}}),isBrowser&&(head=s.head=document.getElementsByTagName("head")[0],baseElement=document.getElementsByTagName("base")[0],baseElement&&(head=s.head=baseElement.parentNode)),req.onError=defaultOnError,req.createNode=function(e,t,n){var r=e.xhtml?document.createElementNS("http://www.w3.org/1999/xhtml","html:script"):document.createElement("script");return r.type=e.scriptType||"text/javascript",r.charset="utf-8",r.async=!0,r},req.load=function(e,t,n){var r,i=e&&e.config||{};if(isBrowser)return(r=req.createNode(i,t,n)).setAttribute("data-requirecontext",e.contextName),r.setAttribute("data-requiremodule",t),!r.attachEvent||r.attachEvent.toString&&r.attachEvent.toString().indexOf("[native code")<0||isOpera?(r.addEventListener("load",e.onScriptLoad,!1),r.addEventListener("error",e.onScriptError,!1)):(useInteractive=!0,r.attachEvent("onreadystatechange",e.onScriptLoad)),r.src=n,i.onNodeCreated&&i.onNodeCreated(r,i,t,n),currentlyAddingScript=r,baseElement?head.insertBefore(r,baseElement):head.appendChild(r),currentlyAddingScript=null,r;if(isWebWorker)try{setTimeout(function(){},0),importScripts(n),e.completeLoad(t)}catch(r){e.onError(makeError("importscripts","importScripts failed for "+t+" at "+n,r,[t]))}},isBrowser&&!cfg.skipDataMain&&eachReverse(scripts(),function(e){if(head||(head=e.parentNode),dataMain=e.getAttribute("data-main"))return mainScript=dataMain,cfg.baseUrl||-1!==mainScript.indexOf("!")||(src=mainScript.split("/"),mainScript=src.pop(),subPath=src.length?src.join("/")+"/":"./",cfg.baseUrl=subPath),mainScript=mainScript.replace(jsSuffixRegExp,""),req.jsExtRegExp.test(mainScript)&&(mainScript=dataMain),cfg.deps=cfg.deps?cfg.deps.concat(mainScript):[mainScript],!0}),define=function(e,t,n){var r,i;"string"!=typeof e&&(n=t,t=e,e=null),isArray(t)||(n=t,t=null),!t&&isFunction(n)&&(t=[],n.length&&(n.toString().replace(commentRegExp,commentReplace).replace(cjsRequireRegExp,function(e,n){t.push(n)}),t=(1===n.length?["require"]:["require","exports","module"]).concat(t))),useInteractive&&(r=currentlyAddingScript||getInteractiveScript())&&(e||(e=r.getAttribute("data-requiremodule")),i=contexts[r.getAttribute("data-requirecontext")]),i?(i.defQueue.push([e,t,n]),i.defQueueMap[e]=!0):globalDefQueue.push([e,t,n])},define.amd={jQuery:!0},req.exec=function(text){return eval(text)},req(cfg)}function newContext(e){var t,n,r,i,o,a={waitSeconds:7,baseUrl:"./",paths:{},bundles:{},pkgs:{},shim:{},config:{}},s={},l={},c={},u=[],d={},p={},f={},h=1,m=1;function g(e,t,n){var r,i,o,s,l,c,u,d,p,f,h=t&&t.split("/"),m=a.map,g=m&&m["*"];if(e&&(c=(e=e.split("/")).length-1,a.nodeIdCompat&&jsSuffixRegExp.test(e[c])&&(e[c]=e[c].replace(jsSuffixRegExp,"")),"."===e[0].charAt(0)&&h&&(e=h.slice(0,h.length-1).concat(e)),function(e){var t,n;for(t=0;t0&&(e.splice(t-1,2),t-=2)}}(e),e=e.join("/")),n&&m&&(h||g)){i=e.split("/");e:for(o=i.length;o>0;o-=1){if(l=i.slice(0,o).join("/"),h)for(s=h.length;s>0;s-=1)if((r=getOwn(m,h.slice(0,s).join("/")))&&(r=getOwn(r,l))){u=r,d=o;break e}!p&&g&&getOwn(g,l)&&(p=getOwn(g,l),f=o)}!u&&p&&(u=p,d=f),u&&(i.splice(0,d,u),e=i.join("/"))}return getOwn(a.pkgs,e)||e}function b(e){isBrowser&&each(scripts(),function(t){if(t.getAttribute("data-requiremodule")===e&&t.getAttribute("data-requirecontext")===r.contextName)return t.parentNode.removeChild(t),!0})}function y(e){var t=getOwn(a.paths,e);if(t&&isArray(t)&&t.length>1)return t.shift(),r.require.undef(e),r.makeRequire(null,{skipMap:!0})([e]),!0}function v(e){var t,n=e?e.indexOf("!"):-1;return n>-1&&(t=e.substring(0,n),e=e.substring(n+1,e.length)),[t,e]}function w(e,t,n,i){var o,a,s,l,c=null,u=t?t.name:null,p=e,f=!0,b="";return e||(f=!1,e="_@r"+(h+=1)),c=(l=v(e))[0],e=l[1],c&&(c=g(c,u,i),a=getOwn(d,c)),e&&(c?b=n?e:a&&a.normalize?a.normalize(e,function(e){return g(e,u,i)}):-1===e.indexOf("!")?g(e,u,i):e:(c=(l=v(b=g(e,u,i)))[0],b=l[1],n=!0,o=r.nameToUrl(b))),{prefix:c,name:b,parentMap:t,unnormalized:!!(s=!c||a||n?"":"_unnormalized"+(m+=1)),url:o,originalName:p,isDefine:f,id:(c?c+"!"+b:b)+s}}function x(e){var t=e.id,n=getOwn(s,t);return n||(n=s[t]=new r.Module(e)),n}function k(e,t,n){var r=e.id,i=getOwn(s,r);!hasProp(d,r)||i&&!i.defineEmitComplete?(i=x(e)).error&&"error"===t?n(i.error):i.on(t,n):"defined"===t&&n(d[r])}function C(e,t){var n=e.requireModules,r=!1;t?t(e):(each(n,function(t){var n=getOwn(s,t);n&&(n.error=e,n.events.error&&(r=!0,n.emit("error",e)))}),r||req.onError(e))}function E(){globalDefQueue.length&&(each(globalDefQueue,function(e){var t=e[0];"string"==typeof t&&(r.defQueueMap[t]=!0),u.push(e)}),globalDefQueue=[])}function $(e){delete s[e],delete l[e]}function T(){var e,n,i=1e3*a.waitSeconds,c=i&&r.startTime+i<(new Date).getTime(),u=[],p=[],f=!1,h=!0;if(!t){if(t=!0,eachProp(l,function(e){var t=e.map,r=t.id;if(e.enabled&&(t.isDefine||p.push(e),!e.error))if(!e.inited&&c)y(r)?(n=!0,f=!0):(u.push(r),b(r));else if(!e.inited&&e.fetched&&t.isDefine&&(f=!0,!t.prefix))return h=!1}),c&&u.length)return(e=makeError("timeout","Load timeout for modules: "+u,null,u)).contextName=r.contextName,C(e);h&&each(p,function(e){!function e(t,n,r){var i=t.map.id;t.error?t.emit("error",t.error):(n[i]=!0,each(t.depMaps,function(i,o){var a=i.id,l=getOwn(s,a);!l||t.depMatched[o]||r[a]||(getOwn(n,a)?(t.defineDep(o,d[a]),t.check()):e(l,n,r))}),r[i]=!0)}(e,{},{})}),c&&!n||!f||!isBrowser&&!isWebWorker||o||(o=setTimeout(function(){o=0,T()},50)),t=!1}}function S(e){hasProp(d,e[0])||x(w(e[0],null,!0)).init(e[1],e[2])}function A(e,t,n,r){e.detachEvent&&!isOpera?r&&e.detachEvent(r,t):e.removeEventListener(n,t,!1)}function L(e){var t=e.currentTarget||e.srcElement;return A(t,r.onScriptLoad,"load","onreadystatechange"),A(t,r.onScriptError,"error"),{node:t,id:t&&t.getAttribute("data-requiremodule")}}function j(){var e;for(E();u.length;){if(null===(e=u.shift())[0])return C(makeError("mismatch","Mismatched anonymous define() module: "+e[e.length-1]));S(e)}r.defQueueMap={}}return i={require:function(e){return e.require?e.require:e.require=r.makeRequire(e.map)},exports:function(e){if(e.usingExports=!0,e.map.isDefine)return e.exports?d[e.map.id]=e.exports:e.exports=d[e.map.id]={}},module:function(e){return e.module?e.module:e.module={id:e.map.id,uri:e.map.url,config:function(){return getOwn(a.config,e.map.id)||{}},exports:e.exports||(e.exports={})}}},(n=function(e){this.events=getOwn(c,e.id)||{},this.map=e,this.shim=getOwn(a.shim,e.id),this.depExports=[],this.depMaps=[],this.depMatched=[],this.pluginMaps={},this.depCount=0}).prototype={init:function(e,t,n,r){r=r||{},this.inited||(this.factory=t,n?this.on("error",n):this.events.error&&(n=bind(this,function(e){this.emit("error",e)})),this.depMaps=e&&e.slice(0),this.errback=n,this.inited=!0,this.ignore=r.ignore,r.enabled||this.enabled?this.enable():this.check())},defineDep:function(e,t){this.depMatched[e]||(this.depMatched[e]=!0,this.depCount-=1,this.depExports[e]=t)},fetch:function(){if(!this.fetched){this.fetched=!0,r.startTime=(new Date).getTime();var e=this.map;if(!this.shim)return e.prefix?this.callPlugin():this.load();r.makeRequire(this.map,{enableBuildCallback:!0})(this.shim.deps||[],bind(this,function(){return e.prefix?this.callPlugin():this.load()}))}},load:function(){var e=this.map.url;p[e]||(p[e]=!0,r.load(this.map.id,e))},check:function(){if(this.enabled&&!this.enabling){var e,t,n=this.map.id,i=this.depExports,o=this.exports,a=this.factory;if(this.inited){if(this.error)this.emit("error",this.error);else if(!this.defining){if(this.defining=!0,this.depCount<1&&!this.defined){if(isFunction(a)){if(this.events.error&&this.map.isDefine||req.onError!==defaultOnError)try{o=r.execCb(n,a,i,o)}catch(t){e=t}else o=r.execCb(n,a,i,o);if(this.map.isDefine&&void 0===o&&((t=this.module)?o=t.exports:this.usingExports&&(o=this.exports)),e)return e.requireMap=this.map,e.requireModules=this.map.isDefine?[this.map.id]:null,e.requireType=this.map.isDefine?"define":"require",C(this.error=e)}else o=a;if(this.exports=o,this.map.isDefine&&!this.ignore&&(d[n]=o,req.onResourceLoad)){var s=[];each(this.depMaps,function(e){s.push(e.normalizedMap||e)}),req.onResourceLoad(r,this.map,s)}$(n),this.defined=!0}this.defining=!1,this.defined&&!this.defineEmitted&&(this.defineEmitted=!0,this.emit("defined",this.exports),this.defineEmitComplete=!0)}}else hasProp(r.defQueueMap,n)||this.fetch()}},callPlugin:function(){var e=this.map,t=e.id,n=w(e.prefix);this.depMaps.push(n),k(n,"defined",bind(this,function(n){var i,o,l,c=getOwn(f,this.map.id),u=this.map.name,d=this.map.parentMap?this.map.parentMap.name:null,p=r.makeRequire(e.parentMap,{enableBuildCallback:!0});return this.map.unnormalized?(n.normalize&&(u=n.normalize(u,function(e){return g(e,d,!0)})||""),k(o=w(e.prefix+"!"+u,this.map.parentMap,!0),"defined",bind(this,function(e){this.map.normalizedMap=o,this.init([],function(){return e},null,{enabled:!0,ignore:!0})})),void((l=getOwn(s,o.id))&&(this.depMaps.push(o),this.events.error&&l.on("error",bind(this,function(e){this.emit("error",e)})),l.enable()))):c?(this.map.url=r.nameToUrl(c),void this.load()):((i=bind(this,function(e){this.init([],function(){return e},null,{enabled:!0})})).error=bind(this,function(e){this.inited=!0,this.error=e,e.requireModules=[t],eachProp(s,function(e){0===e.map.id.indexOf(t+"_unnormalized")&&$(e.map.id)}),C(e)}),i.fromText=bind(this,function(n,o){var s=e.name,l=w(s),c=useInteractive;o&&(n=o),c&&(useInteractive=!1),x(l),hasProp(a.config,t)&&(a.config[s]=a.config[t]);try{req.exec(n)}catch(e){return C(makeError("fromtexteval","fromText eval for "+t+" failed: "+e,e,[t]))}c&&(useInteractive=!0),this.depMaps.push(l),r.completeLoad(s),p([s],i)}),void n.load(e.name,p,i,a))})),r.enable(n,this),this.pluginMaps[n.id]=n},enable:function(){l[this.map.id]=this,this.enabled=!0,this.enabling=!0,each(this.depMaps,bind(this,function(e,t){var n,o,a;if("string"==typeof e){if(e=w(e,this.map.isDefine?this.map:this.map.parentMap,!1,!this.skipMap),this.depMaps[t]=e,a=getOwn(i,e.id))return void(this.depExports[t]=a(this));this.depCount+=1,k(e,"defined",bind(this,function(e){this.undefed||(this.defineDep(t,e),this.check())})),this.errback?k(e,"error",bind(this,this.errback)):this.events.error&&k(e,"error",bind(this,function(e){this.emit("error",e)}))}n=e.id,o=s[n],hasProp(i,n)||!o||o.enabled||r.enable(e,this)})),eachProp(this.pluginMaps,bind(this,function(e){var t=getOwn(s,e.id);t&&!t.enabled&&r.enable(e,this)})),this.enabling=!1,this.check()},on:function(e,t){var n=this.events[e];n||(n=this.events[e]=[]),n.push(t)},emit:function(e,t){each(this.events[e],function(e){e(t)}),"error"===e&&delete this.events[e]}},(r={config:a,contextName:e,registry:s,defined:d,urlFetched:p,defQueue:u,defQueueMap:{},Module:n,makeModuleMap:w,nextTick:req.nextTick,onError:C,configure:function(e){if(e.baseUrl&&"/"!==e.baseUrl.charAt(e.baseUrl.length-1)&&(e.baseUrl+="/"),"string"==typeof e.urlArgs){var t=e.urlArgs;e.urlArgs=function(e,n){return(-1===n.indexOf("?")?"?":"&")+t}}var n=a.shim,i={paths:!0,bundles:!0,config:!0,map:!0};eachProp(e,function(e,t){i[t]?(a[t]||(a[t]={}),mixin(a[t],e,!0,!0)):a[t]=e}),e.bundles&&eachProp(e.bundles,function(e,t){each(e,function(e){e!==t&&(f[e]=t)})}),e.shim&&(eachProp(e.shim,function(e,t){isArray(e)&&(e={deps:e}),!e.exports&&!e.init||e.exportsFn||(e.exportsFn=r.makeShimExports(e)),n[t]=e}),a.shim=n),e.packages&&each(e.packages,function(e){var t;t=(e="string"==typeof e?{name:e}:e).name,e.location&&(a.paths[t]=e.location),a.pkgs[t]=e.name+"/"+(e.main||"main").replace(currDirRegExp,"").replace(jsSuffixRegExp,"")}),eachProp(s,function(e,t){e.inited||e.map.unnormalized||(e.map=w(t,null,!0))}),(e.deps||e.callback)&&r.require(e.deps||[],e.callback)},makeShimExports:function(e){return function(){var t;return e.init&&(t=e.init.apply(global,arguments)),t||e.exports&&getGlobal(e.exports)}},makeRequire:function(t,n){function o(a,l,c){var u,p;return n.enableBuildCallback&&l&&isFunction(l)&&(l.__requireJsBuild=!0),"string"==typeof a?isFunction(l)?C(makeError("requireargs","Invalid require call"),c):t&&hasProp(i,a)?i[a](s[t.id]):req.get?req.get(r,a,t,o):(u=w(a,t,!1,!0).id,hasProp(d,u)?d[u]:C(makeError("notloaded",'Module name "'+u+'" has not been loaded yet for context: '+e+(t?"":". Use require([])")))):(j(),r.nextTick(function(){j(),(p=x(w(null,t))).skipMap=n.skipMap,p.init(a,l,c,{enabled:!0}),T()}),o)}return n=n||{},mixin(o,{isBrowser:isBrowser,toUrl:function(e){var n,i=e.lastIndexOf("."),o=e.split("/")[0];return-1!==i&&(!("."===o||".."===o)||i>1)&&(n=e.substring(i,e.length),e=e.substring(0,i)),r.nameToUrl(g(e,t&&t.id,!0),n,!0)},defined:function(e){return hasProp(d,w(e,t,!1,!0).id)},specified:function(e){return e=w(e,t,!1,!0).id,hasProp(d,e)||hasProp(s,e)}}),t||(o.undef=function(e){E();var n=w(e,t,!0),i=getOwn(s,e);i.undefed=!0,b(e),delete d[e],delete p[n.url],delete c[e],eachReverse(u,function(t,n){t[0]===e&&u.splice(n,1)}),delete r.defQueueMap[e],i&&(i.events.defined&&(c[e]=i.events),$(e))}),o},enable:function(e){getOwn(s,e.id)&&x(e).enable()},completeLoad:function(e){var t,n,i,o=getOwn(a.shim,e)||{},l=o.exports;for(E();u.length;){if(null===(n=u.shift())[0]){if(n[0]=e,t)break;t=!0}else n[0]===e&&(t=!0);S(n)}if(r.defQueueMap={},i=getOwn(s,e),!t&&!hasProp(d,e)&&i&&!i.inited){if(!(!a.enforceDefine||l&&getGlobal(l)))return y(e)?void 0:C(makeError("nodefine","No define call for "+e,null,[e]));S([e,o.deps||[],o.exportsFn])}T()},nameToUrl:function(e,t,n){var i,o,s,l,c,u,d=getOwn(a.pkgs,e);if(d&&(e=d),u=getOwn(f,e))return r.nameToUrl(u,t,n);if(req.jsExtRegExp.test(e))l=e+(t||"");else{for(i=a.paths,s=(o=e.split("/")).length;s>0;s-=1)if(c=getOwn(i,o.slice(0,s).join("/"))){isArray(c)&&(c=c[0]),o.splice(0,s,c);break}l=o.join("/"),l=("/"===(l+=t||(/^data\:|^blob\:|\?/.test(l)||n?"":".js")).charAt(0)||l.match(/^[\w\+\.\-]+:/)?"":a.baseUrl)+l}return a.urlArgs&&!/^blob\:/.test(l)?l+a.urlArgs(e,l):l},load:function(e,t){req.load(r,e,t)},execCb:function(e,t,n,r){return t.apply(r,n)},onScriptLoad:function(e){if("load"===e.type||readyRegExp.test((e.currentTarget||e.srcElement).readyState)){interactiveScript=null;var t=L(e);r.completeLoad(t.id)}},onScriptError:function(e){var t=L(e);if(!y(t.id)){var n=[];return eachProp(s,function(e,r){0!==r.indexOf("_@r")&&each(e.depMaps,function(e){if(e.id===t.id)return n.push(r),!0})}),C(makeError("scripterror",'Script error for "'+t.id+(n.length?'", needed by: '+n.join(", "):'"'),e,[t.id]))}}}).require=r.makeRequire(),r}function getInteractiveScript(){return interactiveScript&&"interactive"===interactiveScript.readyState?interactiveScript:(eachReverse(scripts(),function(e){if("interactive"===e.readyState)return interactiveScript=e}),interactiveScript)}}(this,"undefined"==typeof setTimeout?void 0:setTimeout),define("deps/require",function(){});var hyperHTML=function(e){var t=document.defaultView,n=1,r=/^area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|source|track|wbr$/i,i="ownerSVGElement",o="http://www.w3.org/2000/svg",a="connected",s="dis"+a,l=/^style|textarea$/i,c="_hyper: "+(Math.random()*new Date|0)+";",u="\x3c!--"+c+"--\x3e",d=t.Event;try{new d("Event")}catch(e){d=function(e){var t=document.createEvent("Event");return t.initEvent(e,!1,!1),t}}var p,f=t.Map||function(){var e=[],t=[];return{get:function(n){return t[e.indexOf(n)]},set:function(n,r){t[e.push(n)-1]=r}}},h=0,m=t.WeakMap||function(){var e=c+h++;return{get:function(t){return t[e]},set:function(t,n){Object.defineProperty(t,e,{configurable:!0,value:n})}}},g=t.WeakSet||function(){var e=new m;return{add:function(t){e.set(t,!0)},has:function(t){return!0===e.get(t)}}},b=Array.isArray||(p={}.toString,function(e){return"[object Array]"===p.call(e)}),y=c.trim||function(){return this.replace(/^\s+|\s+$/g,"")};function v(){return this}var w=function(e,t){var n="_"+e+"$";return{get:function(){return this[n]||(this[e]=t.call(this,e))},set:function(e){Object.defineProperty(this,n,{configurable:!0,value:e})}}},x={},k=[],C=x.hasOwnProperty,E=0,$=function(e,t){e in x||(E=k.push(e)),x[e]=t},T=function(e,t){for(var n=0;n\"'=]+",N="[ "+D+"]+"+_,R="<([A-Za-z]+[A-Za-z0-9:_-]*)((?:",P="(?:=(?:'[^']*?'|\"[^\"]*?\"|<[^>]*?>|"+_+"))?)",M=new RegExp(R+N+P+"+)([ "+D+"]*/?>)","g"),O=new RegExp(R+N+P+"*)([ "+D+"]*/>)","g"),I=L(document),q="append"in I,U="content"in S(document,"template");I.appendChild(j(I,"g")),I.appendChild(j(I,""));var W=1===I.cloneNode(!0).childNodes.length,H="importNode"in document,B=q?function(e,t){e.append.apply(e,t)}:function(e,t){for(var n=t.length,r=0;r"+t+"",B(r,Y.call(n.querySelectorAll(i)))}else n.innerHTML=t,B(r,Y.call(n.childNodes));return r},ee=U?function(e,t){var n=L(e),r=A(e).createElementNS(o,"svg");return r.innerHTML=t,B(n,Y.call(r.childNodes)),n}:function(e,t){var n=L(e),r=S(e,"div");return r.innerHTML=''+t+"",B(n,Y.call(r.firstChild.childNodes)),n};function te(e){this.childNodes=e,this.length=e.length,this.first=e[0],this.last=e[this.length-1]}te.prototype.insert=function(){var e=L(this.first);return B(e,this.childNodes),e},te.prototype.remove=function(){var e=this.first,t=this.last;if(2===this.length)t.parentNode.removeChild(t);else{var n=A(e).createRange();n.setStartBefore(this.childNodes[1]),n.setEndAfter(t),n.deleteContents()}return e};var ne=function(e,t,n){e.unshift(e.indexOf.call(t.childNodes,n))},re=function(e,t,r){return{type:e,name:r,node:t,path:function(e){var t=[],r=void 0;switch(e.nodeType){case n:case 11:r=e;break;case 8:r=e.parentNode,ne(t,r,e);break;default:r=e.ownerElement}for(e=r;r=r.parentNode;e=r)ne(t,r,e);return t}(t)}},ie=function(e,t){for(var n=t.length,r=0;rc){var v=n[p+1],w=null==v?a:o(v,0);if(l===p)e.insertBefore(o(n[l],1),w);else{for(var x=e.ownerDocument.createDocumentFragment();l<=p;)x.appendChild(o(n[l++],1));e.insertBefore(x,w)}}else null==t[s]&&s++,s===c?e.removeChild(o(t[s],-1)):de(e,o(t[s],-1),o(t[c],-1));return n},fe=new g;function he(){}he.prototype=Object.create(null);var me=function(e){return{html:e}},ge=function e(t,n){return"ELEMENT_NODE"in t?t:t.constructor===te?1/n<0?n?t.remove():t.last:n?t.insert():t.first:e(t.render(),n)},be=function(e,t,n){for(var r=new he,i=e.attributes,o=Y.call(i),a=[],s=o.length,l=0;l"},Pe=new m,Me=function(e){var t=void 0,n=void 0,r=void 0,i=void 0,a=void 0;return function(s){s=Q(s);var l=i!==s;return l&&(i=s,r=L(document),n="svg"===e?document.createElementNS(o,"svg"):r,a=Se.bind(n)),a.apply(null,arguments),l&&("svg"===e&&B(r,Y.call(n.childNodes)),t=Ie(r)),t}},Oe=function(e,t){var n=t.indexOf(":"),r=Pe.get(e),i=t;return-1e.apply(void 0,n)),window.parent===window.self)return;var r=n.map(e=>String(JSON.stringify(e.stack||e)));window.parent.postMessage({topic:e,args:r},window.parent.location.origin)},e.sub=n,e.unsub=r;e.name="core/pubsubhub";const t=new Map;function n(e,i,o={once:!1}){return o.once?n(e,function t(...n){r({topic:e,cb:t}),i(...n)}):(t.has(e)?t.get(e).add(i):t.set(e,new Set([i])),{topic:e,cb:i})}function r({topic:e,cb:n}){const r=t.get(e);return r&&r.has(n)?r.delete(n):(console.warn("Already unsubscribed:",e,n),!1)}n("error",e=>{console.error(e,e.stack)}),n("warn",e=>{console.warn(e)})}),function(e){var t={newline:/^\n+/,code:/^( {4}[^\n]+\n*)+/,fences:h,hr:/^ {0,3}((?:- *){3,}|(?:_ *){3,}|(?:\* *){3,})(?:\n+|$)/,heading:/^ *(#{1,6}) *([^\n]+?) *(?:#+ *)?(?:\n+|$)/,nptable:h,blockquote:/^( {0,3}> ?(paragraph|[^\n]*)(?:\n|$))+/,list:/^( *)(bull) [\s\S]+?(?:hr|def|\n{2,}(?! )(?!\1bull )\n*|\s*$)/,html:"^ {0,3}(?:<(script|pre|style)[\\s>][\\s\\S]*?(?:[^\\n]*\\n+|$)|comment[^\\n]*(\\n+|$)|<\\?[\\s\\S]*?\\?>\\n*|\\n*|\\n*|)[\\s\\S]*?(?:\\n{2,}|$)|<(?!script|pre|style)([a-z][\\w-]*)(?:attribute)*? */?>(?=\\h*\\n)[\\s\\S]*?(?:\\n{2,}|$)|(?=\\h*\\n)[\\s\\S]*?(?:\\n{2,}|$))",def:/^ {0,3}\[(label)\]: *\n? *]+)>?(?:(?: +\n? *| *\n *)(title))? *(?:\n+|$)/,table:h,lheading:/^([^\n]+)\n *(=|-){2,} *(?:\n+|$)/,paragraph:/^([^\n]+(?:\n(?!hr|heading|lheading| {0,3}>|<\/?(?:tag)(?: +|\n|\/?>)|<(?:script|pre|style|!--))[^\n]+)*)/,text:/^[^\n]+/};function n(e){this.tokens=[],this.tokens.links={},this.options=e||b.defaults,this.rules=t.normal,this.options.pedantic?this.rules=t.pedantic:this.options.gfm&&(this.options.tables?this.rules=t.tables:this.rules=t.gfm)}t._label=/(?!\s*\])(?:\\[\[\]]|[^\[\]])+/,t._title=/(?:"(?:\\"?|[^"\\])*"|'[^'\n]*(?:\n[^'\n]+)*\n?'|\([^()]*\))/,t.def=u(t.def).replace("label",t._label).replace("title",t._title).getRegex(),t.bullet=/(?:[*+-]|\d+\.)/,t.item=/^( *)(bull) [^\n]*(?:\n(?!\1bull )[^\n]*)*/,t.item=u(t.item,"gm").replace(/bull/g,t.bullet).getRegex(),t.list=u(t.list).replace(/bull/g,t.bullet).replace("hr","\\n+(?=\\1?(?:(?:- *){3,}|(?:_ *){3,}|(?:\\* *){3,})(?:\\n+|$))").replace("def","\\n+(?="+t.def.source+")").getRegex(),t._tag="address|article|aside|base|basefont|blockquote|body|caption|center|col|colgroup|dd|details|dialog|dir|div|dl|dt|fieldset|figcaption|figure|footer|form|frame|frameset|h[1-6]|head|header|hr|html|iframe|legend|li|link|main|menu|menuitem|meta|nav|noframes|ol|optgroup|option|p|param|section|source|summary|table|tbody|td|tfoot|th|thead|title|tr|track|ul",t._comment=//,t.html=u(t.html,"i").replace("comment",t._comment).replace("tag",t._tag).replace("attribute",/ +[a-zA-Z:_][\w.:-]*(?: *= *"[^"\n]*"| *= *'[^'\n]*'| *= *[^\s"'=<>`]+)?/).getRegex(),t.paragraph=u(t.paragraph).replace("hr",t.hr).replace("heading",t.heading).replace("lheading",t.lheading).replace("tag",t._tag).getRegex(),t.blockquote=u(t.blockquote).replace("paragraph",t.paragraph).getRegex(),t.normal=m({},t),t.gfm=m({},t.normal,{fences:/^ *(`{3,}|~{3,})[ \.]*(\S+)? *\n([\s\S]*?)\n? *\1 *(?:\n+|$)/,paragraph:/^/,heading:/^ *(#{1,6}) +([^\n]+?) *#* *(?:\n+|$)/}),t.gfm.paragraph=u(t.paragraph).replace("(?!","(?!"+t.gfm.fences.source.replace("\\1","\\2")+"|"+t.list.source.replace("\\1","\\3")+"|").getRegex(),t.tables=m({},t.gfm,{nptable:/^ *([^|\n ].*\|.*)\n *([-:]+ *\|[-| :]*)(?:\n((?:.*[^>\n ].*(?:\n|$))*)\n*|$)/,table:/^ *\|(.+)\n *\|?( *[-:]+[-| :]*)(?:\n((?: *[^>\n ].*(?:\n|$))*)\n*|$)/}),t.pedantic=m({},t.normal,{html:u("^ *(?:comment *(?:\\n|\\s*$)|<(tag)[\\s\\S]+? *(?:\\n{2,}|\\s*$)|\\s]*)*?/?> *(?:\\n{2,}|\\s*$))").replace("comment",t._comment).replace(/tag/g,"(?!(?:a|em|strong|small|s|cite|q|dfn|abbr|data|time|code|var|samp|kbd|sub|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo|span|br|wbr|ins|del|img)\\b)\\w+(?!:|[^\\w\\s@]*@)\\b").getRegex(),def:/^ *\[([^\]]+)\]: *]+)>?(?: +(["(][^\n]+[")]))? *(?:\n+|$)/}),n.rules=t,n.lex=function(e,t){return new n(t).lex(e)},n.prototype.lex=function(e){return e=e.replace(/\r\n|\r/g,"\n").replace(/\t/g," ").replace(/\u00a0/g," ").replace(/\u2424/g,"\n"),this.token(e,!0)},n.prototype.token=function(e,n){var r,i,o,a,s,l,c,u,d,p,f,h,m;for(e=e.replace(/^ +$/gm,"");e;)if((o=this.rules.newline.exec(e))&&(e=e.substring(o[0].length),o[0].length>1&&this.tokens.push({type:"space"})),o=this.rules.code.exec(e))e=e.substring(o[0].length),o=o[0].replace(/^ {4}/gm,""),this.tokens.push({type:"code",text:this.options.pedantic?o:o.replace(/\n+$/,"")});else if(o=this.rules.fences.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"code",lang:o[2],text:o[3]||""});else if(o=this.rules.heading.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"heading",depth:o[1].length,text:o[2]});else if(n&&(o=this.rules.nptable.exec(e))&&(l={type:"table",header:g(o[1].replace(/^ *| *\| *$/g,"")),align:o[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:o[3]?o[3].replace(/\n$/,"").split("\n"):[]}).header.length===l.align.length){for(e=e.substring(o[0].length),u=0;u ?/gm,""),this.token(o,n),this.tokens.push({type:"blockquote_end"});else if(o=this.rules.list.exec(e)){for(e=e.substring(o[0].length),f=(a=o[2]).length>1,this.tokens.push({type:"list_start",ordered:f,start:f?+a:""}),r=!1,p=(o=o[0].match(this.rules.item)).length,u=0;u1&&s.length>1||(e=o.slice(u+1).join("\n")+e,u=p-1)),i=r||/\n\n(?!\s*$)/.test(l),u!==p-1&&(r="\n"===l.charAt(l.length-1),i||(i=r)),m=void 0,(h=/^\[[ xX]\] /.test(l))&&(m=" "!==l[1],l=l.replace(/^\[[ xX]\] +/,"")),this.tokens.push({type:i?"loose_item_start":"list_item_start",task:h,checked:m}),this.token(l,!1),this.tokens.push({type:"list_item_end"});this.tokens.push({type:"list_end"})}else if(o=this.rules.html.exec(e))e=e.substring(o[0].length),this.tokens.push({type:this.options.sanitize?"paragraph":"html",pre:!this.options.sanitizer&&("pre"===o[1]||"script"===o[1]||"style"===o[1]),text:o[0]});else if(n&&(o=this.rules.def.exec(e)))e=e.substring(o[0].length),o[3]&&(o[3]=o[3].substring(1,o[3].length-1)),d=o[1].toLowerCase().replace(/\s+/g," "),this.tokens.links[d]||(this.tokens.links[d]={href:o[2],title:o[3]});else if(n&&(o=this.rules.table.exec(e))&&(l={type:"table",header:g(o[1].replace(/^ *| *\| *$/g,"")),align:o[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:o[3]?o[3].replace(/(?: *\| *)?\n$/,"").split("\n"):[]}).header.length===l.align.length){for(e=e.substring(o[0].length),u=0;u?@\[\]\\^_`{|}~])/,autolink:/^<(scheme:[^\s\x00-\x1f<>]*|email)>/,url:h,tag:"^comment|^|^<[a-zA-Z][\\w-]*(?:attribute)*?\\s*/?>|^<\\?[\\s\\S]*?\\?>|^|^",link:/^!?\[(label)\]\(href(?:\s+(title))?\s*\)/,reflink:/^!?\[(label)\]\[(?!\s*\])((?:\\[\[\]]?|[^\[\]\\])+)\]/,nolink:/^!?\[(?!\s*\])((?:\[[^\[\]]*\]|\\[\[\]]|[^\[\]])*)\](?:\[\])?/,strong:/^__([^\s][\s\S]*?[^\s])__(?!_)|^\*\*([^\s][\s\S]*?[^\s])\*\*(?!\*)|^__([^\s])__(?!_)|^\*\*([^\s])\*\*(?!\*)/,em:/^_([^\s][\s\S]*?[^\s_])_(?!_)|^_([^\s_][\s\S]*?[^\s])_(?!_)|^\*([^\s][\s\S]*?[^\s*])\*(?!\*)|^\*([^\s*][\s\S]*?[^\s])\*(?!\*)|^_([^\s_])_(?!_)|^\*([^\s*])\*(?!\*)/,code:/^(`+)\s*([\s\S]*?[^`]?)\s*\1(?!`)/,br:/^ {2,}\n(?!\s*$)/,del:h,text:/^[\s\S]+?(?=[\\/g,">").replace(/"/g,""").replace(/'/g,"'")}function c(e){return e.replace(/&(#(?:\d+)|(?:#x[0-9A-Fa-f]+)|(?:\w+));?/gi,function(e,t){return"colon"===(t=t.toLowerCase())?":":"#"===t.charAt(0)?"x"===t.charAt(1)?String.fromCharCode(parseInt(t.substring(2),16)):String.fromCharCode(+t.substring(1)):""})}function u(e,t){return e=e.source||e,t=t||"",{replace:function(t,n){return n=(n=n.source||n).replace(/(^|[^\[])\^/g,"$1"),e=e.replace(t,n),this},getRegex:function(){return new RegExp(e,t)}}}function d(e,t){return p[" "+e]||(/^[^:]+:\/*[^/]*$/.test(e)?p[" "+e]=e+"/":p[" "+e]=e.replace(/[^/]*$/,"")),e=p[" "+e],"//"===t.slice(0,2)?e.replace(/:[\s\S]*/,":")+t:"/"===t.charAt(0)?e.replace(/(:\/*[^/]*)[\s\S]*/,"$1")+t:e+t}r._escapes=/\\([!"#$%&'()*+,\-./:;<=>?@\[\]\\^_`{|}~])/g,r._scheme=/[a-zA-Z][a-zA-Z0-9+.-]{1,31}/,r._email=/[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+(@)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+(?![-_])/,r.autolink=u(r.autolink).replace("scheme",r._scheme).replace("email",r._email).getRegex(),r._attribute=/\s+[a-zA-Z:_][\w.:-]*(?:\s*=\s*"[^"]*"|\s*=\s*'[^']*'|\s*=\s*[^\s"'=<>`]+)?/,r.tag=u(r.tag).replace("comment",t._comment).replace("attribute",r._attribute).getRegex(),r._label=/(?:\[[^\[\]]*\]|\\[\[\]]?|`[^`]*`|[^\[\]\\])*?/,r._href=/\s*(<(?:\\[<>]?|[^\s<>\\])*>|(?:\\[()]?|\([^\s\x00-\x1f()\\]*\)|[^\s\x00-\x1f()\\])*?)/,r._title=/"(?:\\"?|[^"\\])*"|'(?:\\'?|[^'\\])*'|\((?:\\\)?|[^)\\])*\)/,r.link=u(r.link).replace("label",r._label).replace("href",r._href).replace("title",r._title).getRegex(),r.reflink=u(r.reflink).replace("label",r._label).getRegex(),r.normal=m({},r),r.pedantic=m({},r.normal,{strong:/^__(?=\S)([\s\S]*?\S)__(?!_)|^\*\*(?=\S)([\s\S]*?\S)\*\*(?!\*)/,em:/^_(?=\S)([\s\S]*?\S)_(?!_)|^\*(?=\S)([\s\S]*?\S)\*(?!\*)/,link:u(/^!?\[(label)\]\((.*?)\)/).replace("label",r._label).getRegex(),reflink:u(/^!?\[(label)\]\s*\[([^\]]*)\]/).replace("label",r._label).getRegex()}),r.gfm=m({},r.normal,{escape:u(r.escape).replace("])","~|])").getRegex(),url:u(/^((?:ftp|https?):\/\/|www\.)(?:[a-zA-Z0-9\-]+\.?)+[^\s<]*|^email/).replace("email",r._email).getRegex(),_backpedal:/(?:[^?!.,:;*_~()&]+|\([^)]*\)|&(?![a-zA-Z0-9]+;$)|[?!.,:;*_~)]+(?!$))+/,del:/^~~(?=\S)([\s\S]*?\S)~~/,text:u(r.text).replace("]|","~]|").replace("|","|https?://|ftp://|www\\.|[a-zA-Z0-9.!#$%&'*+/=?^_`{\\|}~-]+@|").getRegex()}),r.breaks=m({},r.gfm,{br:u(r.br).replace("{2,}","*").getRegex(),text:u(r.gfm.text).replace("{2,}","*").getRegex()}),i.rules=r,i.output=function(e,t,n){return new i(t,n).output(e)},i.prototype.output=function(e){for(var t,n,r,o,a,s="";e;)if(a=this.rules.escape.exec(e))e=e.substring(a[0].length),s+=a[1];else if(a=this.rules.autolink.exec(e))e=e.substring(a[0].length),r="@"===a[2]?"mailto:"+(n=l(this.mangle(a[1]))):n=l(a[1]),s+=this.renderer.link(r,null,n);else if(this.inLink||!(a=this.rules.url.exec(e))){if(a=this.rules.tag.exec(e))!this.inLink&&/^/i.test(a[0])&&(this.inLink=!1),e=e.substring(a[0].length),s+=this.options.sanitize?this.options.sanitizer?this.options.sanitizer(a[0]):l(a[0]):a[0];else if(a=this.rules.link.exec(e))e=e.substring(a[0].length),this.inLink=!0,r=a[2],this.options.pedantic?(t=/^([^'"]*[^\s])\s+(['"])(.*)\2/.exec(r))?(r=t[1],o=t[3]):o="":o=a[3]?a[3].slice(1,-1):"",r=r.trim().replace(/^<([\s\S]*)>$/,"$1"),s+=this.outputLink(a,{href:i.escapes(r),title:i.escapes(o)}),this.inLink=!1;else if((a=this.rules.reflink.exec(e))||(a=this.rules.nolink.exec(e))){if(e=e.substring(a[0].length),t=(a[2]||a[1]).replace(/\s+/g," "),!(t=this.links[t.toLowerCase()])||!t.href){s+=a[0].charAt(0),e=a[0].substring(1)+e;continue}this.inLink=!0,s+=this.outputLink(a,t),this.inLink=!1}else if(a=this.rules.strong.exec(e))e=e.substring(a[0].length),s+=this.renderer.strong(this.output(a[4]||a[3]||a[2]||a[1]));else if(a=this.rules.em.exec(e))e=e.substring(a[0].length),s+=this.renderer.em(this.output(a[6]||a[5]||a[4]||a[3]||a[2]||a[1]));else if(a=this.rules.code.exec(e))e=e.substring(a[0].length),s+=this.renderer.codespan(l(a[2].trim(),!0));else if(a=this.rules.br.exec(e))e=e.substring(a[0].length),s+=this.renderer.br();else if(a=this.rules.del.exec(e))e=e.substring(a[0].length),s+=this.renderer.del(this.output(a[1]));else if(a=this.rules.text.exec(e))e=e.substring(a[0].length),s+=this.renderer.text(l(this.smartypants(a[0])));else if(e)throw new Error("Infinite loop on byte: "+e.charCodeAt(0))}else a[0]=this.rules._backpedal.exec(a[0])[0],e=e.substring(a[0].length),"@"===a[2]?r="mailto:"+(n=l(a[0])):(n=l(a[0]),r="www."===a[1]?"http://"+n:n),s+=this.renderer.link(r,null,n);return s},i.escapes=function(e){return e?e.replace(i.rules._escapes,"$1"):e},i.prototype.outputLink=function(e,t){var n=t.href,r=t.title?l(t.title):null;return"!"!==e[0].charAt(0)?this.renderer.link(n,r,this.output(e[1])):this.renderer.image(n,r,l(e[1]))},i.prototype.smartypants=function(e){return this.options.smartypants?e.replace(/---/g,"—").replace(/--/g,"–").replace(/(^|[-\u2014/(\[{"\s])'/g,"$1‘").replace(/'/g,"’").replace(/(^|[-\u2014/(\[{\u2018\s])"/g,"$1“").replace(/"/g,"”").replace(/\.{3}/g,"…"):e},i.prototype.mangle=function(e){if(!this.options.mangle)return e;for(var t,n="",r=e.length,i=0;i.5&&(t="x"+t.toString(16)),n+="&#"+t+";";return n},o.prototype.code=function(e,t,n){if(this.options.highlight){var r=this.options.highlight(e,t);null!=r&&r!==e&&(n=!0,e=r)}return t?'
          '+(n?e:l(e,!0))+"
          \n":"
          "+(n?e:l(e,!0))+"
          "},o.prototype.blockquote=function(e){return"
          \n"+e+"
          \n"},o.prototype.html=function(e){return e},o.prototype.heading=function(e,t,n){return this.options.headerIds?"'+e+"\n":""+e+"\n"},o.prototype.hr=function(){return this.options.xhtml?"
          \n":"
          \n"},o.prototype.list=function(e,t,n){var r=t?"ol":"ul";return"<"+r+(t&&1!==n?' start="'+n+'"':"")+">\n"+e+"\n"},o.prototype.listitem=function(e){return"
        32. "+e+"
        33. \n"},o.prototype.checkbox=function(e){return" "},o.prototype.paragraph=function(e){return"

          "+e+"

          \n"},o.prototype.table=function(e,t){return t&&(t=""+t+""),"\n\n"+e+"\n"+t+"
          \n"},o.prototype.tablerow=function(e){return"\n"+e+"\n"},o.prototype.tablecell=function(e,t){var n=t.header?"th":"td";return(t.align?"<"+n+' align="'+t.align+'">':"<"+n+">")+e+"\n"},o.prototype.strong=function(e){return""+e+""},o.prototype.em=function(e){return""+e+""},o.prototype.codespan=function(e){return""+e+""},o.prototype.br=function(){return this.options.xhtml?"
          ":"
          "},o.prototype.del=function(e){return""+e+""},o.prototype.link=function(e,t,n){if(this.options.sanitize){try{var r=decodeURIComponent(c(e)).replace(/[^\w:]/g,"").toLowerCase()}catch(e){return n}if(0===r.indexOf("javascript:")||0===r.indexOf("vbscript:")||0===r.indexOf("data:"))return n}this.options.baseUrl&&!f.test(e)&&(e=d(this.options.baseUrl,e));try{e=encodeURI(e).replace(/%25/g,"%")}catch(e){return n}var i='
          "},o.prototype.image=function(e,t,n){this.options.baseUrl&&!f.test(e)&&(e=d(this.options.baseUrl,e));var r=''+n+'":">"},o.prototype.text=function(e){return e},a.prototype.strong=a.prototype.em=a.prototype.codespan=a.prototype.del=a.prototype.text=function(e){return e},a.prototype.link=a.prototype.image=function(e,t,n){return""+n},a.prototype.br=function(){return""},s.parse=function(e,t){return new s(t).parse(e)},s.prototype.parse=function(e){this.inline=new i(e.links,this.options),this.inlineText=new i(e.links,m({},this.options,{renderer:new a})),this.tokens=e.reverse();for(var t="";this.next();)t+=this.tok();return t},s.prototype.next=function(){return this.token=this.tokens.pop()},s.prototype.peek=function(){return this.tokens[this.tokens.length-1]||0},s.prototype.parseText=function(){for(var e=this.token.text;"text"===this.peek().type;)e+="\n"+this.next().text;return this.inline.output(e)},s.prototype.tok=function(){switch(this.token.type){case"space":return"";case"hr":return this.renderer.hr();case"heading":return this.renderer.heading(this.inline.output(this.token.text),this.token.depth,c(this.inlineText.output(this.token.text)));case"code":return this.renderer.code(this.token.text,this.token.lang,this.token.escaped);case"table":var e,t,n,r,i="",o="";for(n="",e=0;et)n.splice(t);else for(;n.lengthAn error occurred:

          "+l(e.message+"",!0)+"
          ";throw e}}h.exec=h,b.options=b.setOptions=function(e){return m(b.defaults,e),b},b.getDefaults=function(){return{baseUrl:null,breaks:!1,gfm:!0,headerIds:!0,headerPrefix:"",highlight:null,langPrefix:"language-",mangle:!0,pedantic:!1,renderer:new o,sanitize:!1,sanitizer:null,silent:!1,smartLists:!1,smartypants:!1,tables:!0,xhtml:!1}},b.defaults=b.getDefaults(),b.Parser=s,b.parser=s.parse,b.Renderer=o,b.TextRenderer=a,b.Lexer=n,b.lexer=n.lex,b.InlineLexer=i,b.inlineLexer=i.output,b.parse=b,"undefined"!=typeof module&&"object"==typeof exports?module.exports=b:"function"==typeof define&&define.amd?define("deps/marked",[],function(){return b}):e.marked=b}(this||("undefined"!=typeof window?window:global)),define("core/utils",["exports","core/pubsubhub","deps/marked"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.ISODate=e.name=void 0,e.markdownToHtml=function(e){const t=h(e).replace(l,">").replace(c,"&");return(0,i.default)(t)},e.makeOwnerSwapper=function(e){if(!e)throw new TypeError("Expected instance of Node.");return t=>{if(t.ownerDocument.adoptNode(e),t.firstElementChild)return t.insertBefore(e,t.firstElementChild);t.appendChild(e)}},e.calculateLeftPad=function(e){if("string"!=typeof e)throw new TypeError("Invalid input");var t=e.split("\n").filter(e=>e).reduce((e,t)=>{if(0===e)return e;const n=t.match(o)[0]||"";return Math.min(n.length,e)},1/0);return t===1/0?0:t},e.createResourceHint=function(e){if(!e||"object"!=typeof e)throw new TypeError("Missing options");if(!p.has(e.hint))throw new TypeError("Invalid resources hint");const t=new URL(e.href,document.location),n=document.createElement("link");let r=t.href;switch(n.rel=e.hint,n.rel){case"dns-prefetch":case"preconnect":r=t.origin,(e.corsMode||t.origin!==document.location.origin)&&(n.crossOrigin=e.corsMode||"anonymous");break;case"preload":"as"in e&&"string"==typeof e.as&&(f.has(e.as)||console.warn(`Unknown request destination: ${e.as}`),n.setAttribute("as",e.as))}n.href=r,e.dontRemove||n.classList.add("removeOnSave");return n},e.normalizePadding=h,e.removeReSpec=function(e){Array.from(e.querySelectorAll(".remove, script[data-requiremodule]")).forEach(e=>{e.remove()})},e.joinAnd=function(e=[],t=(e=>e)){const n=e.map(t);switch(n.length){case 0:case 1:return n.toString();case 2:return n.join(" and ");default:const e=n.join(", "),t=e.lastIndexOf(",");return`${e.substr(0,t+1)} and ${e.slice(t+2)}`}},e.xmlEscape=function(e){return e.replace(/&/g,"&").replace(/>/g,">").replace(/"/g,""").replace(/i)return 1;if(i>t)return-1;if(!isNaN(t)&&isNaN(i))return 1;if(isNaN(t)&&!isNaN(i))return-1}return 0},e.concatDate=function(e,t=""){return u.format(e).replace(s,t)},e.toShortIsoDate=function(e){return u.format(e)},e.lead0=function(e){return 1===String(e).length?"0"+e:e},e.parseSimpleDate=function(e){return new Date(e)},e.parseLastModified=function(e){return e?new Date(Date.parse(e)):new Date},e.humanDate=function(e=new Date,t=document.documentElement.lang||"en"){e instanceof Date||(e=new Date(e));const n=[t,"en"],r=e.toLocaleString(n,{day:"2-digit",timeZone:"UTC"}),i=e.toLocaleString(n,{month:"long",timeZone:"UTC"}),o=e.toLocaleString(n,{year:"numeric",timeZone:"UTC"});return`${r} ${i} ${o}`},e.isoDate=function(e){return(e instanceof Date?e:new Date(e)).toISOString()},e.toKeyValuePairs=function(e,t=", ",n="="){return Array.from(Object.entries(e)).map(([e,t])=>`${e}${n}${JSON.stringify(t)}`).join(t)},e.linkCSS=function(e,t){const n=[].concat(t).map(t=>{var n=e.createElement("link");return n.rel="stylesheet",n.href=t,n}).reduce(function(e,t){return e.appendChild(t),e},e.createDocumentFragment());e.head.appendChild(n)},e.runTransforms=function(e,n){var r=[this,e],i=Array.from(arguments);if(i.shift(),i.shift(),r=r.concat(i),n)for(var o=n.split(/\s+/),a=0;anew Date)return i}catch(e){console.error("Failed to use Cache API.",e)}const o=await fetch(e);if(!o.ok&&i)return console.warn(`Returning a stale cached response for ${n}`),i;if(r){const n=o.clone(),i=new Headers(o.headers),a=new Date(Date.now()+t);i.set("Expires",a);const s=new Response(await n.blob(),{headers:i});return await r.put(e,s).catch(console.error),await r.match(e)}return o},e.flatten=function e(t,n){const r="object"==typeof n;const i=Object(n)[Symbol.iterator]&&"function"==typeof n.values;const o=r?i?[...n.values()].reduce(e,[]):Object.values(n):[n];return[...t,...o]};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/utils";i.default.setOptions({sanitize:!1,gfm:!0});const o=/^[\ |\t]*/,a=/\s+$/gm,s=/\-/g,l=/>/gm,c=/&/gm;const u=e.ISODate=new Intl.DateTimeFormat(["en-ca-iso8601"],{timeZone:"UTC",year:"numeric",month:"2-digit",day:"2-digit"}),d=new Set(["a","abbr","acronym","b","bdo","big","br","button","cite","code","dfn","em","i","img","input","kbd","label","map","object","q","samp","script","select","small","span","strong","sub","sup","textarea","time","tt","var"]),p=new Set(["dns-prefetch","preconnect","preload","prerender"]),f=new Set(["document","embed","font","image","manifest","media","object","report","script","serviceworker","sharedworker","style","worker","xslt",""]);function h(e=""){if(!e)return"";if("string"!=typeof e)throw TypeError("Invalid input");if("\n"===e)return"\n";function t(e){return null!==e&&e.nodeType===Node.TEXT_NODE}var n=""+e,r=(new DOMParser).parseFromString(n,"text/html");Array.from(r.body.children).filter(e=>!d.has(e.localName)).filter(e=>"pre"!==e.localName).filter(e=>"table"!==e.localName).forEach(e=>{e.innerHTML=h(e.innerHTML)}),Array.from(r.body.childNodes).filter(e=>t(e)&&""===e.textContent.trim()).forEach(e=>e.parentElement.replaceChild(r.createTextNode("\n"),e)),t(r.body.firstChild)||Array.from(r.body.firstChild.children).filter(e=>"table"!==e.localName).forEach(e=>{e.innerHTML=h(e.innerHTML)}),r.normalize();const i=r.body.innerText.replace(/^\ *\n/,"").split("\n").filter(e=>e&&e.startsWith(" "))[0];var o=i?i.match(/\ +/)[0].length:0;if(o){Array.from(r.body.childNodes).filter(e=>"pre"!==e.localName).filter(t).filter(e=>{const t=e.previousElementSibling,n=t?t.localName:e.parentElement.localName;return!d.has(n)||e.textContent.trim().includes("\n")}).reduce((e,t)=>{let n="";const r=t.previousElementSibling,i=r?r.localName:t.parentElement.localName;return/^[\t\ ]/.test(t.textContent)&&d.has(i)&&(n=t.textContent.match(/^\s+/)[0]),t.textContent=n+t.textContent.replace(e,""),e},new RegExp("^ {1,"+o+"}","gm"));const e=new RegExp(`\\ {${o}}$`,"gm");Array.from(r.body.querySelectorAll("pre")).map(e=>e.previousSibling).filter(t).reduce((t,n)=>(e.test(n.textContent)&&(n.textContent=n.textContent.substr(0,n.textContent.length-t)),t),o)}return a.test(r.body.innerHTML)?r.body.innerHTML.trimRight()+"\n":r.body.innerHTML}}),define("core/post-process",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0;e.name="core/post-process";let n;e.done=new Promise(e=>{n=e});(0,t.sub)("plugins-done",async e=>{const t=[];if(Array.isArray(e.postProcess)){const n=await Promise.all(e.postProcess.filter(e=>"function"==typeof e).map(t=>Promise.resolve(t(e,document))));t.push(...n)}"function"==typeof e.afterEnd&&t.push(await Promise.resolve(e.afterEnd(e,document))),n(t)},{once:!0})}),define("core/pre-process",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0;e.name="core/pre-process";let n;e.done=new Promise(e=>{n=e});(0,t.sub)("start-all",async e=>{const t=[];if(Array.isArray(e.preProcess)){const n=await Promise.all(e.preProcess.filter(e=>"function"==typeof e).map(t=>Promise.resolve(t(e,document))));t.push(...n)}n(t)},{once:!0})}),define("core/include-config",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/include-config";const n={},r=e=>Object.assign(n,e);(0,t.sub)("start-all",r),(0,t.sub)("amend-user-config",r),(0,t.sub)("end-all",()=>{const e=document.createElement("script");e.id="initialUserConfig",e.type="application/json",e.innerHTML=JSON.stringify(n,null,2),document.head.appendChild(e)})}),define("core/override-configuration",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/override-configuration";(0,t.sub)("start-all",function(e){const n=document.location.search.replace(/;/g,"&"),r=new URLSearchParams(n),i=Array.from(r.entries()).filter(([e,t])=>!!e&&!!t).map(([e,t])=>{const n=decodeURIComponent(e),r=decodeURIComponent(t.replace(/%3D/g,"="));let i;try{i=JSON.parse(r)}catch(e){i=r}return{key:n,value:i}}).reduce((e,{key:t,value:n})=>(e[t]=n,e),{});Object.assign(e,i),(0,t.pub)("amend-user-config",i)},{once:!0})}),define("core/respec-ready",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/respec-ready";const n=new Promise(e=>{(0,t.sub)("end-all",e,{once:!0})});Object.defineProperty(document,"respecIsReady",{get:()=>n})}),define("core/base-runner",["exports","core/utils","core/post-process","core/pre-process","core/pubsubhub","core/include-config","core/override-configuration","core/respec-ready"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.runAll=async function(e){(0,i.pub)("start-all",respecConfig),a&&performance.mark(o+"-start");await r.done;const l=e.filter(e=>e&&e.run).map(s);for(const e of l)try{await e(respecConfig)}catch(e){console.error(e)}(0,i.pub)("plugins-done",respecConfig),await n.done,(0,i.pub)("end-all",respecConfig),(0,t.removeReSpec)(document),a&&(performance.mark(o+"-end"),performance.measure(o,o+"-start",o+"-end"))};const o=e.name="core/base-runner",a=performance.mark&&performance.measure;function s(e){const t=e.name||"";return t||console.warn("Plugin lacks name:",e),n=>new Promise(async(r,i)=>{const o=setTimeout(()=>{const n=`Plugin ${t} took too long.`;console.error(n,e),i(new Error(n))},15e3);a&&performance.mark(t+"-start");try{e.run.length<=1?(await e.run(n),r()):e.run(n,document,r)}catch(e){i(e)}finally{clearTimeout(o)}a&&(performance.mark(t+"-end"),performance.measure(t,t+"-start",t+"-end"))})}});var shortcut={all_shortcuts:{},add:function(e,t,n){var r={type:"keydown",propagate:!1,disable_in_input:!1,target:document,keycode:!1};if(n)for(var i in r)void 0===n[i]&&(n[i]=r[i]);else n=r;var o=n.target;"string"==typeof n.target&&(o=document.getElementById(n.target));e=e.toLowerCase();var a=function(r){var i,o;if((r=r||window.event,n.disable_in_input)&&(r.target?o=r.target:r.srcElement&&(o=r.srcElement),3==o.nodeType&&(o=o.parentNode),"INPUT"==o.tagName||"TEXTAREA"==o.tagName))return;r.keyCode?i=r.keyCode:r.which&&(i=r.which);var a=String.fromCharCode(i).toLowerCase();188==i&&(a=","),190==i&&(a=".");var s=e.split("+"),l=0,c={"`":"~",1:"!",2:"@",3:"#",4:"$",5:"%",6:"^",7:"&",8:"*",9:"(",0:")","-":"_","=":"+",";":":","'":'"',",":"<",".":">","/":"?","\\":"|"},u={esc:27,escape:27,tab:9,space:32,return:13,enter:13,backspace:8,scrolllock:145,scroll_lock:145,scroll:145,capslock:20,caps_lock:20,caps:20,numlock:144,num_lock:144,num:144,pause:19,break:19,insert:45,home:36,delete:46,end:35,pageup:33,page_up:33,pu:33,pagedown:34,page_down:34,pd:34,left:37,up:38,right:39,down:40,f1:112,f2:113,f3:114,f4:115,f5:116,f6:117,f7:118,f8:119,f9:120,f10:121,f11:122,f12:123},d={shift:{wanted:!1,pressed:!1},ctrl:{wanted:!1,pressed:!1},alt:{wanted:!1,pressed:!1},meta:{wanted:!1,pressed:!1}};r.ctrlKey&&(d.ctrl.pressed=!0),r.shiftKey&&(d.shift.pressed=!0),r.altKey&&(d.alt.pressed=!0),r.metaKey&&(d.meta.pressed=!0);for(var p,f=0;p=s[f],f1?u[p]==i&&l++:n.keycode?n.keycode==i&&l++:a==p?l++:c[a]&&r.shiftKey&&(a=c[a])==p&&l++;if(l==s.length&&d.ctrl.pressed==d.ctrl.wanted&&d.shift.pressed==d.shift.wanted&&d.alt.pressed==d.alt.wanted&&d.meta.pressed==d.meta.wanted&&(t(r),!n.propagate))return r.cancelBubble=!0,r.returnValue=!1,r.stopPropagation&&(r.stopPropagation(),r.preventDefault()),!1};this.all_shortcuts[e]={callback:a,target:o,event:n.type},o.addEventListener?o.addEventListener(n.type,a,!1):o.attachEvent?o.attachEvent("on"+n.type,a):o["on"+n.type]=a}},Zx,t0,u0,Dha,Eha,mta,nta,eXa,fXa;define("shortcut",(Zx=this,function(){return Zx.shortcut})),define("deps/text",["module"],function(e){var t,n,r,i,o,a=["Msxml2.XMLHTTP","Microsoft.XMLHTTP","Msxml2.XMLHTTP.4.0"],s=/^\s*<\?xml(\s)+version=[\'\"](\d)*.(\d)*[\'\"](\s)*\?>/im,l=/]*>\s*([\s\S]+)\s*<\/body>/im,c="undefined"!=typeof location&&location.href,u=c&&location.protocol&&location.protocol.replace(/\:/,""),d=c&&location.hostname,p=c&&(location.port||void 0),f={},h=e.config&&e.config()||{};function m(e,t){return void 0===e||""===e?t:e}return t={version:"2.0.15",strip:function(e){if(e){var t=(e=e.replace(s,"")).match(l);t&&(e=t[1])}else e="";return e},jsEscape:function(e){return e.replace(/(['\\])/g,"\\$1").replace(/[\f]/g,"\\f").replace(/[\b]/g,"\\b").replace(/[\n]/g,"\\n").replace(/[\t]/g,"\\t").replace(/[\r]/g,"\\r").replace(/[\u2028]/g,"\\u2028").replace(/[\u2029]/g,"\\u2029")},createXhr:h.createXhr||function(){var e,t,n;if("undefined"!=typeof XMLHttpRequest)return new XMLHttpRequest;if("undefined"!=typeof ActiveXObject)for(t=0;t<3;t+=1){n=a[t];try{e=new ActiveXObject(n)}catch(e){}if(e){a=[n];break}}return e},parseName:function(e){var t,n,r,i=!1,o=e.lastIndexOf("."),a=0===e.indexOf("./")||0===e.indexOf("../");return-1!==o&&(!a||o>1)?(t=e.substring(0,o),n=e.substring(o+1)):t=e,-1!==(o=(r=n||t).indexOf("!"))&&(i="strip"===r.substring(o+1),r=r.substring(0,o),n?n=r:t=r),{moduleName:t,ext:n,strip:i}},xdRegExp:/^((\w+)\:)?\/\/([^\/\\]+)/,useXhr:function(e,n,r,i){var o,a,s,l=t.xdRegExp.exec(e);return!l||(o=l[2],s=(a=(a=l[3]).split(":"))[1],a=a[0],(!o||o===n)&&(!a||a.toLowerCase()===r.toLowerCase())&&(!s&&!a||function(e,t,n,r){if(t===r)return!0;if(e===n){if("http"===e)return m(t,"80")===m(r,"80");if("https"===e)return m(t,"443")===m(r,"443")}return!1}(o,s,n,i)))},finishLoad:function(e,n,r,i){r=n?t.strip(r):r,h.isBuild&&(f[e]=r),i(r)},load:function(e,n,r,i){if(i&&i.isBuild&&!i.inlineText)r();else{h.isBuild=i&&i.isBuild;var o=t.parseName(e),a=o.moduleName+(o.ext?"."+o.ext:""),s=n.toUrl(a),l=h.useXhr||t.useXhr;0!==s.indexOf("empty:")?!c||l(s,u,d,p)?t.get(s,function(n){t.finishLoad(e,o.strip,n,r)},function(e){r.error&&r.error(e)}):n([a],function(e){t.finishLoad(o.moduleName+"."+o.ext,o.strip,e,r)}):r()}},write:function(e,n,r,i){if(f.hasOwnProperty(n)){var o=t.jsEscape(f[n]);r.asModule(e+"!"+n,"define(function () { return '"+o+"';});\n")}},writeFile:function(e,n,r,i,o){var a=t.parseName(n),s=a.ext?"."+a.ext:"",l=a.moduleName+s,c=r.toUrl(a.moduleName+s)+".js";t.load(l,r,function(n){var r=function(e){return i(c,e)};r.asModule=function(e,t){return i.asModule(e,c,t)},t.write(e,l,r,o)},o)}},"node"===h.env||!h.env&&"undefined"!=typeof process&&process.versions&&process.versions.node&&!process.versions["node-webkit"]&&!process.versions["atom-shell"]?(n=require.nodeRequire("fs"),t.get=function(e,t,r){try{var i=n.readFileSync(e,"utf8");"\ufeff"===i[0]&&(i=i.substring(1)),t(i)}catch(e){r&&r(e)}}):"xhr"===h.env||!h.env&&t.createXhr()?t.get=function(e,n,r,i){var o,a=t.createXhr();if(a.open("GET",e,!0),i)for(o in i)i.hasOwnProperty(o)&&a.setRequestHeader(o.toLowerCase(),i[o]);h.onXhr&&h.onXhr(a,e),a.onreadystatechange=function(t){var i,o;4===a.readyState&&((i=a.status||0)>399&&i<600?((o=new Error(e+" HTTP status: "+i)).xhr=a,r&&r(o)):n(a.responseText),h.onXhrComplete&&h.onXhrComplete(a,e))},a.send(null)}:"rhino"===h.env||!h.env&&"undefined"!=typeof Packages&&"undefined"!=typeof java?t.get=function(e,t){var n,r,i=new java.io.File(e),o=java.lang.System.getProperty("line.separator"),a=new java.io.BufferedReader(new java.io.InputStreamReader(new java.io.FileInputStream(i),"utf-8")),s="";try{for(n=new java.lang.StringBuffer,(r=a.readLine())&&r.length()&&65279===r.charAt(0)&&(r=r.substring(1)),null!==r&&n.append(r);null!==(r=a.readLine());)n.append(o),n.append(r);s=String(n.toString())}finally{a.close()}t(s)}:("xpconnect"===h.env||!h.env&&"undefined"!=typeof Components&&Components.classes&&Components.interfaces)&&(r=Components.classes,i=Components.interfaces,Components.utils.import("resource://gre/modules/FileUtils.jsm"),o="@mozilla.org/windows-registry-key;1"in r,t.get=function(e,t){var n,a,s,l={};o&&(e=e.replace(/\//g,"\\")),s=new FileUtils.File(e);try{(n=r["@mozilla.org/network/file-input-stream;1"].createInstance(i.nsIFileInputStream)).init(s,1,0,!1),(a=r["@mozilla.org/intl/converter-input-stream;1"].createInstance(i.nsIConverterInputStream)).init(n,"utf-8",n.available(),i.nsIConverterInputStream.DEFAULT_REPLACEMENT_CHARACTER),a.readString(n.available(),l),a.close(),n.close(),t(l.value)}catch(e){throw new Error((s&&s.path||"")+": "+e)}}),t}),define("deps/text!ui/ui.css",[],function(){return'#respec-ui {\n position: fixed;\n display: flex;\n flex-direction: row-reverse;\n top: 20px;\n right: 20px;\n width: 202px;\n text-align: right;\n z-index: 9000;\n}\n\n#respec-pill,\n.respec-info-button {\n background: #fff;\n height: 2.5em;\n color: rgb(120, 120, 120);\n border: 1px solid #ccc;\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\n}\n\n.respec-info-button {\n border: none;\n opacity: 0.75;\n border-radius: 2em;\n margin-right: 1em;\n min-width: 3.5em;\n}\n\n.respec-info-button:focus,\n.respec-info-button:hover {\n opacity: 1;\n transition: opacity 0.2s;\n}\n\n#respec-pill:disabled {\n font-size: 2.8px;\n text-indent: -9999em;\n border-top: 1.1em solid rgba(40, 40, 40, 0.2);\n border-right: 1.1em solid rgba(40, 40, 40, 0.2);\n border-bottom: 1.1em solid rgba(40, 40, 40, 0.2);\n border-left: 1.1em solid #ffffff;\n transform: translateZ(0);\n animation: respec-spin 0.5s infinite linear;\n box-shadow: none;\n}\n\n#respec-pill:disabled,\n#respec-pill:disabled:after {\n border-radius: 50%;\n width: 10em;\n height: 10em;\n}\n\n@keyframes respec-spin {\n 0% {\n transform: rotate(0deg);\n }\n 100% {\n transform: rotate(360deg);\n }\n}\n\n.respec-hidden {\n visibility: hidden;\n opacity: 0;\n transition: visibility 0s 0.2s, opacity 0.2s linear;\n}\n\n.respec-visible {\n visibility: visible;\n opacity: 1;\n transition: opacity 0.2s linear;\n}\n\n#respec-pill:hover,\n#respec-pill:focus {\n color: rgb(0, 0, 0);\n background-color: rgb(245, 245, 245);\n transition: color 0.2s;\n}\n\n#respec-menu {\n position: absolute;\n margin: 0;\n padding: 0;\n font-family: sans-serif;\n background: #fff;\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\n width: 200px;\n display: none;\n text-align: left;\n margin-top: 32px;\n font-size: 0.8em;\n}\n\n#respec-menu:not([hidden]) {\n display: block;\n}\n\n#respec-menu li {\n list-style-type: none;\n margin: 0;\n padding: 0;\n}\n\n.respec-save-buttons {\n display: grid;\n grid-template-columns: repeat(auto-fill, minmax(47%, 2fr));\n grid-gap: 0.5cm;\n padding: 0.5cm;\n}\n\n.respec-save-button:link {\n padding-top: 16px;\n color: rgb(240, 240, 240);\n background: rgb(42, 90, 168);\n justify-self: stretch;\n height: 1cm;\n text-decoration: none;\n text-align: center;\n font-size: inherit;\n border: none;\n border-radius: 0.2cm;\n}\n\n.respec-save-button:link:hover {\n color: white;\n background: rgb(42, 90, 168);\n padding: 0;\n margin: 0;\n border: 0;\n padding-top: 16px;\n}\n\n#respec-ui button:focus,\n#respec-pill:focus,\n.respec-option:focus {\n outline: 0;\n outline-style: none;\n}\n\n#respec-pill-error {\n background-color: red;\n color: white;\n}\n\n#respec-pill-warning {\n background-color: orange;\n color: white;\n}\n\n.respec-warning-list,\n.respec-error-list {\n margin: 0;\n padding: 0;\n list-style: none;\n font-family: sans-serif;\n background-color: rgb(255, 251, 230);\n font-size: 0.85em;\n}\n\n.respec-warning-list > li,\n.respec-error-list > li {\n padding: 0.4em 0.7em;\n}\n\n.respec-warning-list > li::before {\n content: "⚠️";\n padding-right: 0.5em;\n}\n.respec-warning-list p,\n.respec-error-list p {\n padding: 0;\n margin: 0;\n}\n\n.respec-warning-list li {\n color: rgb(92, 59, 0);\n border-bottom: thin solid rgb(255, 245, 194);\n}\n\n.respec-error-list,\n.respec-error-list li {\n background-color: rgb(255, 240, 240);\n}\n\n.respec-error-list li::before {\n content: "💥";\n padding-right: 0.5em;\n}\n\n.respec-error-list li {\n padding: 0.4em 0.7em;\n color: rgb(92, 59, 0);\n border-bottom: thin solid rgb(255, 215, 215);\n}\n\n.respec-error-list li > p {\n margin: 0;\n padding: 0;\n display: inline-block;\n}\n\n#respec-overlay {\n display: block;\n position: fixed;\n z-index: 10000;\n top: 0px;\n left: 0px;\n height: 100%;\n width: 100%;\n background: #000;\n}\n\n.respec-show-overlay {\n transition: opacity 0.2s linear;\n opacity: 0.5;\n}\n\n.respec-hide-overlay {\n transition: opacity 0.2s linear;\n opacity: 0;\n}\n\n.respec-modal {\n display: block;\n position: fixed;\n z-index: 11000;\n margin: auto;\n top: 10%;\n background: #fff;\n border: 5px solid #666;\n min-width: 20%;\n width: 79%;\n padding: 0;\n max-height: 80%;\n overflow-y: auto;\n margin: 0 -0.5cm;\n}\n\n@media screen and (min-width: 78em) {\n .respec-modal {\n width: 62%;\n }\n}\n\n.respec-modal h3 {\n margin: 0;\n padding: 0.2em;\n text-align: center;\n color: black;\n background: linear-gradient(\n to bottom,\n rgba(238, 238, 238, 1) 0%,\n rgba(238, 238, 238, 1) 50%,\n rgba(204, 204, 204, 1) 100%\n );\n font-size: 1em;\n}\n\n.respec-modal .inside div p {\n padding-left: 1cm;\n}\n\n#respec-menu button.respec-option {\n background: white;\n padding: 0 0.2cm;\n border: none;\n width: 100%;\n text-align: left;\n font-size: inherit;\n padding: 1.2em 1.2em;\n}\n\n#respec-menu button.respec-option:hover,\n#respec-menu button:focus {\n background-color: #eeeeee;\n}\n\n.respec-cmd-icon {\n padding-right: 0.5em;\n}\n\n#respec-ui button.respec-option:last-child {\n border: none;\n border-radius: inherit;\n}\n\n.respec-offending-element {\n display: inline-block;\n position: relative;\n background: url(data:image/gif;base64,R0lGODdhBAADAPEAANv///8AAP///wAAACwAAAAABAADAEACBZQjmIAFADs=)\n bottom repeat-x;\n}\n\n@supports (text-decoration-style: wavy) {\n .respec-offending-element {\n background: none;\n text-decoration-line: underline;\n text-decoration-style: wavy;\n text-decoration-color: red;\n }\n}\n\n.respec-button-copy-paste {\n position: absolute;\n display: block;\n padding: 0px 8px;\n height: 28px;\n width: 40px;\n color: #333;\n white-space: nowrap;\n vertical-align: middle;\n cursor: pointer;\n background-color: #eee;\n background-image: linear-gradient(#fcfcfc, #eee);\n border: 1px solid rgb(144, 184, 222);\n border-radius: 0px 0px 3px 0;\n -webkit-user-select: none;\n -moz-user-select: none;\n -ms-user-select: none;\n user-select: none;\n -webkit-appearance: none;\n margin: 0px 127px;\n border-left: 0;\n}\n\np + .respec-button-copy-paste {\n margin: 1px 127px;\n}\n\n#specref-ui {\n margin: 0 2%;\n margin-bottom: 0.5cm;\n}\n\n#specref-ui header {\n font-size: 0.7em;\n background-color: #eee;\n text-align: center;\n padding: 0.2cm;\n margin-bottom: 0.5cm;\n border-radius: 0 0 0.2cm 0.2cm;\n}\n\n#specref-ui header h1 {\n padding: 0;\n margin: 0;\n color: black;\n}\n\n#specref-ui p {\n padding: 0;\n margin: 0;\n font-size: 0.8em;\n text-align: center;\n}\n\n#specref-ui p.state {\n margin: 1cm;\n}\n\n#specref-ui .searchcomponent {\n font-size: 16px;\n display: grid;\n grid-template-columns: auto 2cm;\n}\n#specref-ui .searchcomponent:focus {\n}\n\n#specref-ui input,\n#specref-ui button {\n border: 0;\n padding: 6px 12px;\n}\n\n#specref-ui label {\n font-size: 0.6em;\n grid-column-end: 3;\n text-align: right;\n grid-column-start: 1;\n}\n\n#specref-ui input[type="search"] {\n -webkit-appearance: none;\n font-size: 16px;\n border-radius: 0.1cm 0 0 0.1cm;\n border: 1px solid rgb(204, 204, 204);\n}\n\n#specref-ui button[type="submit"] {\n color: white;\n border-radius: 0 0.1cm 0.1cm 0;\n background-color: rgb(51, 122, 183);\n}\n\n#specref-ui button[type="submit"]:hover {\n background-color: #286090;\n border-color: #204d74;\n}\n\n#specref-ui .result-stats {\n margin: 0;\n padding: 0;\n color: rgb(128, 128, 128);\n font-size: 0.7em;\n font-weight: bold;\n}\n\n#specref-ui .specref-results {\n font-size: 0.8em;\n}\n\n#specref-ui .specref-results dd + dt {\n margin-top: 0.51cm;\n}\n\n#specref-ui .specref-results a {\n text-transform: capitalize;\n}\n#specref-ui .specref-results .authors {\n display: block;\n color: #006621;\n}\n\n@media print {\n #respec-ui {\n display: none;\n }\n}\n'}),t0="undefined"!=typeof window?window:this,u0=function(e,t){var n=[],r=e.document,i=Object.getPrototypeOf,o=n.slice,a=n.concat,s=n.push,l=n.indexOf,c={},u=c.toString,d=c.hasOwnProperty,p=d.toString,f=p.call(Object),h={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType},g=function(e){return null!=e&&e===e.window},b={type:!0,src:!0,noModule:!0};function y(e,t,n){var i,o=(t=t||r).createElement("script");if(o.text=e,n)for(i in b)n[i]&&(o[i]=n[i]);t.head.appendChild(o).parentNode.removeChild(o)}function v(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?c[u.call(e)]||"object":typeof e}var w="3.3.1 -ajax,-ajax/jsonp,-ajax/load,-ajax/parseXML,-ajax/script,-ajax/var/location,-ajax/var/nonce,-ajax/var/rquery,-ajax/xhr,-manipulation/_evalUrl,-event/ajax,-effects,-effects/Tween,-effects/animatedSelector",x=function(e,t){return new x.fn.init(e,t)},k=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;function C(e){var t=!!e&&"length"in e&&e.length,n=v(e);return!m(e)&&!g(e)&&("array"===n||0===t||"number"==typeof t&&t>0&&t-1 in e)}x.fn=x.prototype={jquery:w,constructor:x,length:0,toArray:function(){return o.call(this)},get:function(e){return null==e?o.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=x.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return x.each(this,e)},map:function(e){return this.pushStack(x.map(this,function(t,n){return e.call(t,n,t)}))},slice:function(){return this.pushStack(o.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(n>=0&&n+~]|"+M+")"+M+"*"),F=new RegExp("="+M+"*([^\\]'\"]*?)"+M+"*\\]","g"),z=new RegExp(q),G=new RegExp("^"+O+"$"),V={ID:new RegExp("^#("+O+")"),CLASS:new RegExp("^\\.("+O+")"),TAG:new RegExp("^("+O+"|[*])"),ATTR:new RegExp("^"+I),PSEUDO:new RegExp("^"+q),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+P+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},X=/^(?:input|select|textarea|button)$/i,Z=/^h\d$/i,Y=/^[^{]+\{\s*\[native \w/,Q=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,J=/[+~]/,K=new RegExp("\\\\([\\da-f]{1,6}"+M+"?|("+M+")|.)","ig"),ee=function(e,t,n){var r="0x"+t-65536;return r!=r||n?t:r<0?String.fromCharCode(r+65536):String.fromCharCode(r>>10|55296,1023&r|56320)},te=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ne=function(e,t){return t?"\0"===e?"�":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},re=function(){p()},ie=ye(function(e){return!0===e.disabled&&("form"in e||"label"in e)},{dir:"parentNode",next:"legend"});try{_.apply(L=N.call(x.childNodes),x.childNodes),L[x.childNodes.length].nodeType}catch(e){_={apply:L.length?function(e,t){D.apply(e,N.call(t))}:function(e,t){for(var n=e.length,r=0;e[n++]=t[r++];);e.length=n-1}}}function oe(e,t,r,i){var o,s,c,u,d,h,b,y=t&&t.ownerDocument,k=t?t.nodeType:9;if(r=r||[],"string"!=typeof e||!e||1!==k&&9!==k&&11!==k)return r;if(!i&&((t?t.ownerDocument||t:x)!==f&&p(t),t=t||f,m)){if(11!==k&&(d=Q.exec(e)))if(o=d[1]){if(9===k){if(!(c=t.getElementById(o)))return r;if(c.id===o)return r.push(c),r}else if(y&&(c=y.getElementById(o))&&v(t,c)&&c.id===o)return r.push(c),r}else{if(d[2])return _.apply(r,t.getElementsByTagName(e)),r;if((o=d[3])&&n.getElementsByClassName&&t.getElementsByClassName)return _.apply(r,t.getElementsByClassName(o)),r}if(n.qsa&&!T[e+" "]&&(!g||!g.test(e))){if(1!==k)y=t,b=e;else if("object"!==t.nodeName.toLowerCase()){for((u=t.getAttribute("id"))?u=u.replace(te,ne):t.setAttribute("id",u=w),s=(h=a(e)).length;s--;)h[s]="#"+u+" "+be(h[s]);b=h.join(","),y=J.test(e)&&me(t.parentNode)||t}if(b)try{return _.apply(r,y.querySelectorAll(b)),r}catch(e){}finally{u===w&&t.removeAttribute("id")}}}return l(e.replace(W,"$1"),t,r,i)}function ae(){var e=[];return function t(n,i){return e.push(n+" ")>r.cacheLength&&delete t[e.shift()],t[n+" "]=i}}function se(e){return e[w]=!0,e}function le(e){var t=f.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function ce(e,t){for(var n=e.split("|"),i=n.length;i--;)r.attrHandle[n[i]]=t}function ue(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)for(;n=n.nextSibling;)if(n===t)return-1;return e?1:-1}function de(e){return function(t){return"input"===t.nodeName.toLowerCase()&&t.type===e}}function pe(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function fe(e){return function(t){return"form"in t?t.parentNode&&!1===t.disabled?"label"in t?"label"in t.parentNode?t.parentNode.disabled===e:t.disabled===e:t.isDisabled===e||t.isDisabled!==!e&&ie(t)===e:t.disabled===e:"label"in t&&t.disabled===e}}function he(e){return se(function(t){return t=+t,se(function(n,r){for(var i,o=e([],n.length,t),a=o.length;a--;)n[i=o[a]]&&(n[i]=!(r[i]=n[i]))})})}function me(e){return e&&void 0!==e.getElementsByTagName&&e}n=oe.support={},o=oe.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return!!t&&"HTML"!==t.nodeName},p=oe.setDocument=function(e){var t,i,a=e?e.ownerDocument||e:x;return a!==f&&9===a.nodeType&&a.documentElement?(h=(f=a).documentElement,m=!o(f),x!==f&&(i=f.defaultView)&&i.top!==i&&(i.addEventListener?i.addEventListener("unload",re,!1):i.attachEvent&&i.attachEvent("onunload",re)),n.attributes=le(function(e){return e.className="i",!e.getAttribute("className")}),n.getElementsByTagName=le(function(e){return e.appendChild(f.createComment("")),!e.getElementsByTagName("*").length}),n.getElementsByClassName=Y.test(f.getElementsByClassName),n.getById=le(function(e){return h.appendChild(e).id=w,!f.getElementsByName||!f.getElementsByName(w).length}),n.getById?(r.filter.ID=function(e){var t=e.replace(K,ee);return function(e){return e.getAttribute("id")===t}},r.find.ID=function(e,t){if(void 0!==t.getElementById&&m){var n=t.getElementById(e);return n?[n]:[]}}):(r.filter.ID=function(e){var t=e.replace(K,ee);return function(e){var n=void 0!==e.getAttributeNode&&e.getAttributeNode("id");return n&&n.value===t}},r.find.ID=function(e,t){if(void 0!==t.getElementById&&m){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];for(i=t.getElementsByName(e),r=0;o=i[r++];)if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),r.find.TAG=n.getElementsByTagName?function(e,t){return void 0!==t.getElementsByTagName?t.getElementsByTagName(e):n.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){for(;n=o[i++];)1===n.nodeType&&r.push(n);return r}return o},r.find.CLASS=n.getElementsByClassName&&function(e,t){if(void 0!==t.getElementsByClassName&&m)return t.getElementsByClassName(e)},b=[],g=[],(n.qsa=Y.test(f.querySelectorAll))&&(le(function(e){h.appendChild(e).innerHTML="
          ",e.querySelectorAll("[msallowcapture^='']").length&&g.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||g.push("\\["+M+"*(?:value|"+P+")"),e.querySelectorAll("[id~="+w+"-]").length||g.push("~="),e.querySelectorAll(":checked").length||g.push(":checked"),e.querySelectorAll("a#"+w+"+*").length||g.push(".#.+[+~]")}),le(function(e){e.innerHTML="";var t=f.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&g.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&g.push(":enabled",":disabled"),h.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&g.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),g.push(",.*:")})),(n.matchesSelector=Y.test(y=h.matches||h.webkitMatchesSelector||h.mozMatchesSelector||h.oMatchesSelector||h.msMatchesSelector))&&le(function(e){n.disconnectedMatch=y.call(e,"*"),y.call(e,"[s!='']:x"),b.push("!=",q)}),g=g.length&&new RegExp(g.join("|")),b=b.length&&new RegExp(b.join("|")),t=Y.test(h.compareDocumentPosition),v=t||Y.test(h.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)for(;t=t.parentNode;)if(t===e)return!0;return!1},S=t?function(e,t){if(e===t)return d=!0,0;var r=!e.compareDocumentPosition-!t.compareDocumentPosition;return r||(1&(r=(e.ownerDocument||e)===(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!n.sortDetached&&t.compareDocumentPosition(e)===r?e===f||e.ownerDocument===x&&v(x,e)?-1:t===f||t.ownerDocument===x&&v(x,t)?1:u?R(u,e)-R(u,t):0:4&r?-1:1)}:function(e,t){if(e===t)return d=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e===f?-1:t===f?1:i?-1:o?1:u?R(u,e)-R(u,t):0;if(i===o)return ue(e,t);for(n=e;n=n.parentNode;)a.unshift(n);for(n=t;n=n.parentNode;)s.unshift(n);for(;a[r]===s[r];)r++;return r?ue(a[r],s[r]):a[r]===x?-1:s[r]===x?1:0},f):f},oe.matches=function(e,t){return oe(e,null,null,t)},oe.matchesSelector=function(e,t){if((e.ownerDocument||e)!==f&&p(e),t=t.replace(F,"='$1']"),n.matchesSelector&&m&&!T[t+" "]&&(!b||!b.test(t))&&(!g||!g.test(t)))try{var r=y.call(e,t);if(r||n.disconnectedMatch||e.document&&11!==e.document.nodeType)return r}catch(e){}return oe(t,f,null,[e]).length>0},oe.contains=function(e,t){return(e.ownerDocument||e)!==f&&p(e),v(e,t)},oe.attr=function(e,t){(e.ownerDocument||e)!==f&&p(e);var i=r.attrHandle[t.toLowerCase()],o=i&&A.call(r.attrHandle,t.toLowerCase())?i(e,t,!m):void 0;return void 0!==o?o:n.attributes||!m?e.getAttribute(t):(o=e.getAttributeNode(t))&&o.specified?o.value:null},oe.escape=function(e){return(e+"").replace(te,ne)},oe.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},oe.uniqueSort=function(e){var t,r=[],i=0,o=0;if(d=!n.detectDuplicates,u=!n.sortStable&&e.slice(0),e.sort(S),d){for(;t=e[o++];)t===e[o]&&(i=r.push(o));for(;i--;)e.splice(r[i],1)}return u=null,e},i=oe.getText=function(e){var t,n="",r=0,o=e.nodeType;if(o){if(1===o||9===o||11===o){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=i(e)}else if(3===o||4===o)return e.nodeValue}else for(;t=e[r++];)n+=i(t);return n},(r=oe.selectors={cacheLength:50,createPseudo:se,match:V,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(K,ee),e[3]=(e[3]||e[4]||e[5]||"").replace(K,ee),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||oe.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&oe.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return V.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&z.test(n)&&(t=a(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(K,ee).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=E[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&E(e,function(e){return t.test("string"==typeof e.className&&e.className||void 0!==e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r){var i=oe.attr(r,e);return null==i?"!="===t:!t||(i+="","="===t?i===n:"!="===t?i!==n:"^="===t?n&&0===i.indexOf(n):"*="===t?n&&i.indexOf(n)>-1:"$="===t?n&&i.slice(-n.length)===n:"~="===t?(" "+i.replace(U," ")+" ").indexOf(n)>-1:"|="===t&&(i===n||i.slice(0,n.length+1)===n+"-"))}},CHILD:function(e,t,n,r,i){var o="nth"!==e.slice(0,3),a="last"!==e.slice(-4),s="of-type"===t;return 1===r&&0===i?function(e){return!!e.parentNode}:function(t,n,l){var c,u,d,p,f,h,m=o!==a?"nextSibling":"previousSibling",g=t.parentNode,b=s&&t.nodeName.toLowerCase(),y=!l&&!s,v=!1;if(g){if(o){for(;m;){for(p=t;p=p[m];)if(s?p.nodeName.toLowerCase()===b:1===p.nodeType)return!1;h=m="only"===e&&!h&&"nextSibling"}return!0}if(h=[a?g.firstChild:g.lastChild],a&&y){for(v=(f=(c=(u=(d=(p=g)[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]||[])[0]===k&&c[1])&&c[2],p=f&&g.childNodes[f];p=++f&&p&&p[m]||(v=f=0)||h.pop();)if(1===p.nodeType&&++v&&p===t){u[e]=[k,f,v];break}}else if(y&&(v=f=(c=(u=(d=(p=t)[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]||[])[0]===k&&c[1]),!1===v)for(;(p=++f&&p&&p[m]||(v=f=0)||h.pop())&&((s?p.nodeName.toLowerCase()!==b:1!==p.nodeType)||!++v||(y&&((u=(d=p[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]=[k,v]),p!==t)););return(v-=i)===r||v%r==0&&v/r>=0}}},PSEUDO:function(e,t){var n,i=r.pseudos[e]||r.setFilters[e.toLowerCase()]||oe.error("unsupported pseudo: "+e);return i[w]?i(t):i.length>1?(n=[e,e,"",t],r.setFilters.hasOwnProperty(e.toLowerCase())?se(function(e,n){for(var r,o=i(e,t),a=o.length;a--;)e[r=R(e,o[a])]=!(n[r]=o[a])}):function(e){return i(e,0,n)}):i}},pseudos:{not:se(function(e){var t=[],n=[],r=s(e.replace(W,"$1"));return r[w]?se(function(e,t,n,i){for(var o,a=r(e,null,i,[]),s=e.length;s--;)(o=a[s])&&(e[s]=!(t[s]=o))}):function(e,i,o){return t[0]=e,r(t,null,o,n),t[0]=null,!n.pop()}}),has:se(function(e){return function(t){return oe(e,t).length>0}}),contains:se(function(e){return e=e.replace(K,ee),function(t){return(t.textContent||t.innerText||i(t)).indexOf(e)>-1}}),lang:se(function(e){return G.test(e||"")||oe.error("unsupported lang: "+e),e=e.replace(K,ee).toLowerCase(),function(t){var n;do{if(n=m?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return(n=n.toLowerCase())===e||0===n.indexOf(e+"-")}while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===h},focus:function(e){return e===f.activeElement&&(!f.hasFocus||f.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:fe(!1),disabled:fe(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!r.pseudos.empty(e)},header:function(e){return Z.test(e.nodeName)},input:function(e){return X.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:he(function(){return[0]}),last:he(function(e,t){return[t-1]}),eq:he(function(e,t,n){return[n<0?n+t:n]}),even:he(function(e,t){for(var n=0;n=0;)e.push(r);return e}),gt:he(function(e,t,n){for(var r=n<0?n+t:n;++r1?function(t,n,r){for(var i=e.length;i--;)if(!e[i](t,n,r))return!1;return!0}:e[0]}function we(e,t,n,r,i){for(var o,a=[],s=0,l=e.length,c=null!=t;s-1&&(o[c]=!(a[c]=d))}}else b=we(b===a?b.splice(h,b.length):b),i?i(null,a,b,l):_.apply(a,b)})}function ke(e){for(var t,n,i,o=e.length,a=r.relative[e[0].type],s=a||r.relative[" "],l=a?1:0,u=ye(function(e){return e===t},s,!0),d=ye(function(e){return R(t,e)>-1},s,!0),p=[function(e,n,r){var i=!a&&(r||n!==c)||((t=n).nodeType?u(e,n,r):d(e,n,r));return t=null,i}];l1&&ve(p),l>1&&be(e.slice(0,l-1).concat({value:" "===e[l-2].type?"*":""})).replace(W,"$1"),n,l0,l=i.length>0,u=function(e,t,n,a,u){var d,h,g,b=0,y="0",v=e&&[],w=[],x=c,C=e||l&&r.find.TAG("*",u),E=k+=null==x?1:Math.random()||.1,$=C.length;for(u&&(c=t===f||t||u);y!==$&&null!=(d=C[y]);y++){if(l&&d){for(h=0,t||d.ownerDocument===f||(p(d),n=!m);g=i[h++];)if(g(d,t||f,n)){a.push(d);break}u&&(k=E)}s&&((d=!g&&d)&&b--,e&&v.push(d))}if(b+=y,s&&y!==b){for(h=0;g=o[h++];)g(v,w,t,n);if(e){if(b>0)for(;y--;)v[y]||w[y]||(w[y]=j.call(a));w=we(w)}_.apply(a,w),u&&!e&&w.length>0&&b+o.length>1&&oe.uniqueSort(a)}return u&&(k=E,c=x),v},s?se(u):u))).selector=e}return g},l=oe.select=function(e,t,n,i){var o,l,c,u,d,p="function"==typeof e&&e,f=!i&&a(e=p.selector||e);if(n=n||[],1===f.length){if((l=f[0]=f[0].slice(0)).length>2&&"ID"===(c=l[0]).type&&9===t.nodeType&&m&&r.relative[l[1].type]){if(!(t=(r.find.ID(c.matches[0].replace(K,ee),t)||[])[0]))return n;p&&(t=t.parentNode),e=e.slice(l.shift().value.length)}for(o=V.needsContext.test(e)?0:l.length;o--&&(c=l[o],!r.relative[u=c.type]);)if((d=r.find[u])&&(i=d(c.matches[0].replace(K,ee),J.test(l[0].type)&&me(t.parentNode)||t))){if(l.splice(o,1),!(e=i.length&&be(l)))return _.apply(n,i),n;break}}return(p||s(e,f))(i,t,!m,n,!t||J.test(e)&&me(t.parentNode)||t),n},n.sortStable=w.split("").sort(S).join("")===w,n.detectDuplicates=!!d,p(),n.sortDetached=le(function(e){return 1&e.compareDocumentPosition(f.createElement("fieldset"))}),le(function(e){return e.innerHTML="","#"===e.firstChild.getAttribute("href")})||ce("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),n.attributes&&le(function(e){return e.innerHTML="",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||ce("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),le(function(e){return null==e.getAttribute("disabled")})||ce(P,function(e,t,n){var r;if(!n)return!0===e[t]?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),oe}(e);x.find=E,x.expr=E.selectors,x.expr[":"]=x.expr.pseudos,x.uniqueSort=x.unique=E.uniqueSort,x.text=E.getText,x.isXMLDoc=E.isXML,x.contains=E.contains,x.escapeSelector=E.escape;var $=function(e,t,n){for(var r=[],i=void 0!==n;(e=e[t])&&9!==e.nodeType;)if(1===e.nodeType){if(i&&x(e).is(n))break;r.push(e)}return r},T=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},S=x.expr.match.needsContext;function A(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var L=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,t,n){return m(t)?x.grep(e,function(e,r){return!!t.call(e,r,e)!==n}):t.nodeType?x.grep(e,function(e){return e===t!==n}):"string"!=typeof t?x.grep(e,function(e){return l.call(t,e)>-1!==n}):x.filter(t,e,n)}x.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?x.find.matchesSelector(r,e)?[r]:[]:x.find.matches(e,x.grep(t,function(e){return 1===e.nodeType}))},x.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(x(e).filter(function(){for(t=0;t1?x.uniqueSort(n):n},filter:function(e){return this.pushStack(j(this,e||[],!1))},not:function(e){return this.pushStack(j(this,e||[],!0))},is:function(e){return!!j(this,"string"==typeof e&&S.test(e)?x(e):e||[],!1).length}});var D,_=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/;(x.fn.init=function(e,t,n){var i,o;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(i="<"===e[0]&&">"===e[e.length-1]&&e.length>=3?[null,e,null]:_.exec(e))||!i[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(i[1]){if(t=t instanceof x?t[0]:t,x.merge(this,x.parseHTML(i[1],t&&t.nodeType?t.ownerDocument||t:r,!0)),L.test(i[1])&&x.isPlainObject(t))for(i in t)m(this[i])?this[i](t[i]):this.attr(i,t[i]);return this}return(o=r.getElementById(i[2]))&&(this[0]=o,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(x):x.makeArray(e,this)}).prototype=x.fn,D=x(r);var N=/^(?:parents|prev(?:Until|All))/,R={children:!0,contents:!0,next:!0,prev:!0};function P(e,t){for(;(e=e[t])&&1!==e.nodeType;);return e}x.fn.extend({has:function(e){var t=x(e,this),n=t.length;return this.filter(function(){for(var e=0;e-1:1===n.nodeType&&x.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(o.length>1?x.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?l.call(x(e),this[0]):l.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(x.uniqueSort(x.merge(this.get(),x(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),x.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return $(e,"parentNode")},parentsUntil:function(e,t,n){return $(e,"parentNode",n)},next:function(e){return P(e,"nextSibling")},prev:function(e){return P(e,"previousSibling")},nextAll:function(e){return $(e,"nextSibling")},prevAll:function(e){return $(e,"previousSibling")},nextUntil:function(e,t,n){return $(e,"nextSibling",n)},prevUntil:function(e,t,n){return $(e,"previousSibling",n)},siblings:function(e){return T((e.parentNode||{}).firstChild,e)},children:function(e){return T(e.firstChild)},contents:function(e){return A(e,"iframe")?e.contentDocument:(A(e,"template")&&(e=e.content||e),x.merge([],e.childNodes))}},function(e,t){x.fn[e]=function(n,r){var i=x.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(i=x.filter(r,i)),this.length>1&&(R[e]||x.uniqueSort(i),N.test(e)&&i.reverse()),this.pushStack(i)}});var M=/[^\x20\t\r\n\f]+/g;function O(e){return e}function I(e){throw e}function q(e,t,n,r){var i;try{e&&m(i=e.promise)?i.call(e).done(t).fail(n):e&&m(i=e.then)?i.call(e,t,n):t.apply(void 0,[e].slice(r))}catch(e){n.apply(void 0,[e])}}x.Callbacks=function(e){var t,n;e="string"==typeof e?(t=e,n={},x.each(t.match(M)||[],function(e,t){n[t]=!0}),n):x.extend({},e);var r,i,o,a,s=[],l=[],c=-1,u=function(){for(a=a||e.once,o=r=!0;l.length;c=-1)for(i=l.shift();++c-1;)s.splice(n,1),n<=c&&c--}),this},has:function(e){return e?x.inArray(e,s)>-1:s.length>0},empty:function(){return s&&(s=[]),this},disable:function(){return a=l=[],s=i="",this},disabled:function(){return!s},lock:function(){return a=l=[],i||r||(s=i=""),this},locked:function(){return!!a},fireWith:function(e,t){return a||(t=[e,(t=t||[]).slice?t.slice():t],l.push(t),r||u()),this},fire:function(){return d.fireWith(this,arguments),this},fired:function(){return!!o}};return d},x.extend({Deferred:function(t){var n=[["notify","progress",x.Callbacks("memory"),x.Callbacks("memory"),2],["resolve","done",x.Callbacks("once memory"),x.Callbacks("once memory"),0,"resolved"],["reject","fail",x.Callbacks("once memory"),x.Callbacks("once memory"),1,"rejected"]],r="pending",i={state:function(){return r},always:function(){return o.done(arguments).fail(arguments),this},catch:function(e){return i.then(null,e)},pipe:function(){var e=arguments;return x.Deferred(function(t){x.each(n,function(n,r){var i=m(e[r[4]])&&e[r[4]];o[r[1]](function(){var e=i&&i.apply(this,arguments);e&&m(e.promise)?e.promise().progress(t.notify).done(t.resolve).fail(t.reject):t[r[0]+"With"](this,i?[e]:arguments)})}),e=null}).promise()},then:function(t,r,i){var o=0;function a(t,n,r,i){return function(){var s=this,l=arguments,c=function(){var e,c;if(!(t=o&&(r!==I&&(s=void 0,l=[e]),n.rejectWith(s,l))}};t?u():(x.Deferred.getStackHook&&(u.stackTrace=x.Deferred.getStackHook()),e.setTimeout(u))}}return x.Deferred(function(e){n[0][3].add(a(0,e,m(i)?i:O,e.notifyWith)),n[1][3].add(a(0,e,m(t)?t:O)),n[2][3].add(a(0,e,m(r)?r:I))}).promise()},promise:function(e){return null!=e?x.extend(e,i):i}},o={};return x.each(n,function(e,t){var a=t[2],s=t[5];i[t[1]]=a.add,s&&a.add(function(){r=s},n[3-e][2].disable,n[3-e][3].disable,n[0][2].lock,n[0][3].lock),a.add(t[3].fire),o[t[0]]=function(){return o[t[0]+"With"](this===o?void 0:this,arguments),this},o[t[0]+"With"]=a.fireWith}),i.promise(o),t&&t.call(o,o),o},when:function(e){var t=arguments.length,n=t,r=Array(n),i=o.call(arguments),a=x.Deferred(),s=function(e){return function(n){r[e]=this,i[e]=arguments.length>1?o.call(arguments):n,--t||a.resolveWith(r,i)}};if(t<=1&&(q(e,a.done(s(n)).resolve,a.reject,!t),"pending"===a.state()||m(i[n]&&i[n].then)))return a.then();for(;n--;)q(i[n],s(n),a.reject);return a.promise()}});var U=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;x.Deferred.exceptionHook=function(t,n){e.console&&e.console.warn&&t&&U.test(t.name)&&e.console.warn("jQuery.Deferred exception: "+t.message,t.stack,n)},x.readyException=function(t){e.setTimeout(function(){throw t})};var W=x.Deferred();function H(){r.removeEventListener("DOMContentLoaded",H),e.removeEventListener("load",H),x.ready()}x.fn.ready=function(e){return W.then(e).catch(function(e){x.readyException(e)}),this},x.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--x.readyWait:x.isReady)||(x.isReady=!0,!0!==e&&--x.readyWait>0||W.resolveWith(r,[x]))}}),x.ready.then=W.then,"complete"===r.readyState||"loading"!==r.readyState&&!r.documentElement.doScroll?e.setTimeout(x.ready):(r.addEventListener("DOMContentLoaded",H),e.addEventListener("load",H));var B=function(e,t,n,r,i,o,a){var s=0,l=e.length,c=null==n;if("object"===v(n)){i=!0;for(s in n)B(e,t,s,n[s],!0,o,a)}else if(void 0!==r&&(i=!0,m(r)||(a=!0),c&&(a?(t.call(e,r),t=null):(c=t,t=function(e,t,n){return c.call(x(e),n)})),t))for(;s1,null,!0)},removeData:function(e){return this.each(function(){Q.remove(this,e)})}}),x.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Y.get(e,t),n&&(!r||Array.isArray(n)?r=Y.access(e,t,x.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=x.queue(e,t),r=n.length,i=n.shift(),o=x._queueHooks(e,t);"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,function(){x.dequeue(e,t)},o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Y.get(e,n)||Y.access(e,n,{empty:x.Callbacks("once memory").add(function(){Y.remove(e,[t+"queue",n])})})}}),x.fn.extend({queue:function(e,t){var n=2;return"string"!=typeof e&&(t=e,e="fx",n--),arguments.length\x20\t\r\n\f]+)/i,ue=/^$|^module$|\/(?:java|ecma)script/i,de={option:[1,""],thead:[1,"","
          "],col:[2,"","
          "],tr:[2,"","
          "],td:[3,"","
          "],_default:[0,"",""]};function pe(e,t){var n;return n=void 0!==e.getElementsByTagName?e.getElementsByTagName(t||"*"):void 0!==e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&A(e,t)?x.merge([e],n):n}function fe(e,t){for(var n=0,r=e.length;n-1)i&&i.push(o);else if(c=x.contains(o.ownerDocument,o),a=pe(d.appendChild(o),"script"),c&&fe(a),n)for(u=0;o=a[u++];)ue.test(o.type||"")&&n.push(o);return d}he=r.createDocumentFragment().appendChild(r.createElement("div")),(me=r.createElement("input")).setAttribute("type","radio"),me.setAttribute("checked","checked"),me.setAttribute("name","t"),he.appendChild(me),h.checkClone=he.cloneNode(!0).cloneNode(!0).lastChild.checked,he.innerHTML="",h.noCloneChecked=!!he.cloneNode(!0).lastChild.defaultValue;var ye=r.documentElement,ve=/^key/,we=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,xe=/^([^.]*)(?:\.(.+)|)/;function ke(){return!0}function Ce(){return!1}function Ee(){try{return r.activeElement}catch(e){}}function $e(e,t,n,r,i,o){var a,s;if("object"==typeof t){"string"!=typeof n&&(r=r||n,n=void 0);for(s in t)$e(e,s,n,r,t[s],o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=Ce;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return x().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=x.guid++)),e.each(function(){x.event.add(this,t,i,r,n)})}x.event={global:{},add:function(e,t,n,r,i){var o,a,s,l,c,u,d,p,f,h,m,g=Y.get(e);if(g)for(n.handler&&(n=(o=n).handler,i=o.selector),i&&x.find.matchesSelector(ye,i),n.guid||(n.guid=x.guid++),(l=g.events)||(l=g.events={}),(a=g.handle)||(a=g.handle=function(t){return void 0!==x&&x.event.triggered!==t.type?x.event.dispatch.apply(e,arguments):void 0}),c=(t=(t||"").match(M)||[""]).length;c--;)f=m=(s=xe.exec(t[c])||[])[1],h=(s[2]||"").split(".").sort(),f&&(d=x.event.special[f]||{},f=(i?d.delegateType:d.bindType)||f,d=x.event.special[f]||{},u=x.extend({type:f,origType:m,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&x.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=l[f])||((p=l[f]=[]).delegateCount=0,d.setup&&!1!==d.setup.call(e,r,h,a)||e.addEventListener&&e.addEventListener(f,a)),d.add&&(d.add.call(e,u),u.handler.guid||(u.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,u):p.push(u),x.event.global[f]=!0)},remove:function(e,t,n,r,i){var o,a,s,l,c,u,d,p,f,h,m,g=Y.hasData(e)&&Y.get(e);if(g&&(l=g.events)){for(c=(t=(t||"").match(M)||[""]).length;c--;)if(f=m=(s=xe.exec(t[c])||[])[1],h=(s[2]||"").split(".").sort(),f){for(d=x.event.special[f]||{},p=l[f=(r?d.delegateType:d.bindType)||f]||[],s=s[2]&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;o--;)u=p[o],!i&&m!==u.origType||n&&n.guid!==u.guid||s&&!s.test(u.namespace)||r&&r!==u.selector&&("**"!==r||!u.selector)||(p.splice(o,1),u.selector&&p.delegateCount--,d.remove&&d.remove.call(e,u));a&&!p.length&&(d.teardown&&!1!==d.teardown.call(e,h,g.handle)||x.removeEvent(e,f,g.handle),delete l[f])}else for(f in l)x.event.remove(e,f+t[c],n,r,!0);x.isEmptyObject(l)&&Y.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=x.event.fix(e),l=new Array(arguments.length),c=(Y.get(this,"events")||{})[s.type]||[],u=x.event.special[s.type]||{};for(l[0]=s,t=1;t=1))for(;c!==this;c=c.parentNode||this)if(1===c.nodeType&&("click"!==e.type||!0!==c.disabled)){for(o=[],a={},n=0;n-1:x.find(i,this,null,[c]).length),a[i]&&o.push(r);o.length&&s.push({elem:c,handlers:o})}return c=this,l\x20\t\r\n\f]*)[^>]*)\/>/gi,Se=/\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&x(e).children("tbody")[0]||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function _e(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Ne(e,t){var n,r,i,o,a,s,l,c;if(1===t.nodeType){if(Y.hasData(e)&&(o=Y.access(e),a=Y.set(t,o),c=o.events)){delete a.handle,a.events={};for(i in c)for(n=0,r=c[i].length;n1&&"string"==typeof g&&!h.checkClone&&Ae.test(g))return e.each(function(i){var o=e.eq(i);b&&(t[0]=g.call(this,i,o.html())),Re(o,t,n,r)});if(p&&(o=(i=be(t,e[0].ownerDocument,!1,e,r)).firstChild,1===i.childNodes.length&&(i=o),o||r)){for(l=(s=x.map(pe(i,"script"),De)).length;d")},clone:function(e,t,n){var r,i,o,a,s,l,c,u=e.cloneNode(!0),d=x.contains(e.ownerDocument,e);if(!(h.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||x.isXMLDoc(e)))for(a=pe(u),r=0,i=(o=pe(e)).length;r0&&fe(a,!d&&pe(e,"script")),u},cleanData:function(e){for(var t,n,r,i=x.event.special,o=0;void 0!==(n=e[o]);o++)if(X(n)){if(t=n[Y.expando]){if(t.events)for(r in t.events)i[r]?x.event.remove(n,r):x.removeEvent(n,r,t.handle);n[Y.expando]=void 0}n[Q.expando]&&(n[Q.expando]=void 0)}}}),x.fn.extend({detach:function(e){return Pe(this,e,!0)},remove:function(e){return Pe(this,e)},text:function(e){return B(this,function(e){return void 0===e?x.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return Re(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||je(this,e).appendChild(e)})},prepend:function(){return Re(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=je(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(x.cleanData(pe(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return x.clone(this,e,t)})},html:function(e){return B(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!Se.test(e)&&!de[(ce.exec(e)||["",""])[1].toLowerCase()]){e=x.htmlPrefilter(e);try{for(;n=0&&(l+=Math.max(0,Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-o-l-s-.5))),l}function Je(e,t,n){var r=Oe(e),i=qe(e,t,r),o="border-box"===x.css(e,"boxSizing",!1,r),a=o;if(Me.test(i)){if(!n)return i;i="auto"}return a=a&&(h.boxSizingReliable()||i===e.style[t]),("auto"===i||!parseFloat(i)&&"inline"===x.css(e,"display",!1,r))&&(i=e["offset"+t[0].toUpperCase()+t.slice(1)],a=!0),(i=parseFloat(i)||0)+Qe(e,t,n||(o?"border":"content"),a,r,i)+"px"}x.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=qe(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=V(t),l=Fe.test(t),c=e.style;if(l||(t=Ze(s)),a=x.cssHooks[t]||x.cssHooks[s],void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:c[t];"string"===(o=typeof n)&&(i=ne.exec(n))&&i[1]&&(n=function(e,t,n,r){var i,o,a=20,s=r?function(){return r.cur()}:function(){return x.css(e,t,"")},l=s(),c=n&&n[3]||(x.cssNumber[t]?"":"px"),u=(x.cssNumber[t]||"px"!==c&&+l)&&ne.exec(x.css(e,t));if(u&&u[3]!==c){for(l/=2,c=c||u[3],u=+l||1;a--;)x.style(e,t,u+c),(1-o)*(1-(o=s()/l||.5))<=0&&(a=0),u/=o;u*=2,x.style(e,t,u+c),n=n||[]}return n&&(u=+u||+l||0,i=n[1]?u+(n[1]+1)*n[2]:+n[2],r&&(r.unit=c,r.start=u,r.end=i)),i}(e,t,i),o="number"),null!=n&&n==n&&("number"===o&&(n+=i&&i[3]||(x.cssNumber[s]?"":"px")),h.clearCloneStyle||""!==n||0!==t.indexOf("background")||(c[t]="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(l?c.setProperty(t,n):c[t]=n))}},css:function(e,t,n,r){var i,o,a,s=V(t);return Fe.test(t)||(t=Ze(s)),(a=x.cssHooks[t]||x.cssHooks[s])&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=qe(e,t,r)),"normal"===i&&t in Ge&&(i=Ge[t]),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),x.each(["height","width"],function(e,t){x.cssHooks[t]={get:function(e,n,r){if(n)return!Be.test(x.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?Je(e,t,r):oe(e,ze,function(){return Je(e,t,r)})},set:function(e,n,r){var i,o=Oe(e),a="border-box"===x.css(e,"boxSizing",!1,o),s=r&&Qe(e,t,r,a,o);return a&&h.scrollboxSize()===o.position&&(s-=Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-parseFloat(o[t])-Qe(e,t,"border",!1,o)-.5)),s&&(i=ne.exec(n))&&"px"!==(i[3]||"px")&&(e.style[t]=n,n=x.css(e,t)),Ye(0,n,s)}}}),x.cssHooks.marginLeft=Ue(h.reliableMarginLeft,function(e,t){if(t)return(parseFloat(qe(e,"marginLeft"))||e.getBoundingClientRect().left-oe(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),x.each({margin:"",padding:"",border:"Width"},function(e,t){x.cssHooks[e+t]={expand:function(n){for(var r=0,i={},o="string"==typeof n?n.split(" "):[n];r<4;r++)i[e+re[r]+t]=o[r]||o[r-2]||o[0];return i}},"margin"!==e&&(x.cssHooks[e+t].set=Ye)}),x.fn.extend({css:function(e,t){return B(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=Oe(e),i=t.length;a1)}}),x.fn.delay=function(t,n){return t=x.fx&&x.fx.speeds[t]||t,n=n||"fx",this.queue(n,function(n,r){var i=e.setTimeout(n,t);r.stop=function(){e.clearTimeout(i)}})},We=r.createElement("input"),He=r.createElement("select").appendChild(r.createElement("option")),We.type="checkbox",h.checkOn=""!==We.value,h.optSelected=He.selected,(We=r.createElement("input")).value="t",We.type="radio",h.radioValue="t"===We.value;var Ke,et=x.expr.attrHandle;x.fn.extend({attr:function(e,t){return B(this,x.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){x.removeAttr(this,e)})}}),x.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return void 0===e.getAttribute?x.prop(e,t,n):(1===o&&x.isXMLDoc(e)||(i=x.attrHooks[t.toLowerCase()]||(x.expr.match.bool.test(t)?Ke:void 0)),void 0!==n?null===n?void x.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=x.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!h.radioValue&&"radio"===t&&A(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(M);if(i&&1===e.nodeType)for(;n=i[r++];)e.removeAttribute(n)}}),Ke={set:function(e,t,n){return!1===t?x.removeAttr(e,n):e.setAttribute(n,n),n}},x.each(x.expr.match.bool.source.match(/\w+/g),function(e,t){var n=et[t]||x.find.attr;et[t]=function(e,t,r){var i,o,a=t.toLowerCase();return r||(o=et[a],et[a]=i,i=null!=n(e,t,r)?a:null,et[a]=o),i}});var tt=/^(?:input|select|textarea|button)$/i,nt=/^(?:a|area)$/i;function rt(e){return(e.match(M)||[]).join(" ")}function it(e){return e.getAttribute&&e.getAttribute("class")||""}function ot(e){return Array.isArray(e)?e:"string"==typeof e&&e.match(M)||[]}x.fn.extend({prop:function(e,t){return B(this,x.prop,e,t,arguments.length>1)},removeProp:function(e){return this.each(function(){delete this[x.propFix[e]||e]})}}),x.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&x.isXMLDoc(e)||(t=x.propFix[t]||t,i=x.propHooks[t]),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=x.find.attr(e,"tabindex");return t?parseInt(t,10):tt.test(e.nodeName)||nt.test(e.nodeName)&&e.href?0:-1}}},propFix:{for:"htmlFor",class:"className"}}),h.optSelected||(x.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),x.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){x.propFix[this.toLowerCase()]=this}),x.fn.extend({addClass:function(e){var t,n,r,i,o,a,s,l=0;if(m(e))return this.each(function(t){x(this).addClass(e.call(this,t,it(this)))});if((t=ot(e)).length)for(;n=this[l++];)if(i=it(n),r=1===n.nodeType&&" "+rt(i)+" "){for(a=0;o=t[a++];)r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=rt(r))&&n.setAttribute("class",s)}return this},removeClass:function(e){var t,n,r,i,o,a,s,l=0;if(m(e))return this.each(function(t){x(this).removeClass(e.call(this,t,it(this)))});if(!arguments.length)return this.attr("class","");if((t=ot(e)).length)for(;n=this[l++];)if(i=it(n),r=1===n.nodeType&&" "+rt(i)+" "){for(a=0;o=t[a++];)for(;r.indexOf(" "+o+" ")>-1;)r=r.replace(" "+o+" "," ");i!==(s=rt(r))&&n.setAttribute("class",s)}return this},toggleClass:function(e,t){var n=typeof e,r="string"===n||Array.isArray(e);return"boolean"==typeof t&&r?t?this.addClass(e):this.removeClass(e):m(e)?this.each(function(n){x(this).toggleClass(e.call(this,n,it(this),t),t)}):this.each(function(){var t,i,o,a;if(r)for(i=0,o=x(this),a=ot(e);t=a[i++];)o.hasClass(t)?o.removeClass(t):o.addClass(t);else void 0!==e&&"boolean"!==n||((t=it(this))&&Y.set(this,"__className__",t),this.setAttribute&&this.setAttribute("class",t||!1===e?"":Y.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;for(t=" "+e+" ";n=this[r++];)if(1===n.nodeType&&(" "+rt(it(n))+" ").indexOf(t)>-1)return!0;return!1}});var at=/\r/g;x.fn.extend({val:function(e){var t,n,r,i=this[0];return arguments.length?(r=m(e),this.each(function(n){var i;1===this.nodeType&&(null==(i=r?e.call(this,n,x(this).val()):e)?i="":"number"==typeof i?i+="":Array.isArray(i)&&(i=x.map(i,function(e){return null==e?"":e+""})),(t=x.valHooks[this.type]||x.valHooks[this.nodeName.toLowerCase()])&&"set"in t&&void 0!==t.set(this,i,"value")||(this.value=i))})):i?(t=x.valHooks[i.type]||x.valHooks[i.nodeName.toLowerCase()])&&"get"in t&&void 0!==(n=t.get(i,"value"))?n:"string"==typeof(n=i.value)?n.replace(at,""):null==n?"":n:void 0}}),x.extend({valHooks:{option:{get:function(e){var t=x.find.attr(e,"value");return null!=t?t:rt(x.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:[],l=a?o+1:i.length;for(r=o<0?l:a?o:0;r-1)&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),x.each(["radio","checkbox"],function(){x.valHooks[this]={set:function(e,t){if(Array.isArray(t))return e.checked=x.inArray(x(e).val(),t)>-1}},h.checkOn||(x.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})}),h.focusin="onfocusin"in e;var st=/^(?:focusinfocus|focusoutblur)$/,lt=function(e){e.stopPropagation()};x.extend(x.event,{trigger:function(t,n,i,o){var a,s,l,c,u,p,f,h,b=[i||r],y=d.call(t,"type")?t.type:t,v=d.call(t,"namespace")?t.namespace.split("."):[];if(s=h=l=i=i||r,3!==i.nodeType&&8!==i.nodeType&&!st.test(y+x.event.triggered)&&(y.indexOf(".")>-1&&(y=(v=y.split(".")).shift(),v.sort()),u=y.indexOf(":")<0&&"on"+y,(t=t[x.expando]?t:new x.Event(y,"object"==typeof t&&t)).isTrigger=o?2:3,t.namespace=v.join("."),t.rnamespace=t.namespace?new RegExp("(^|\\.)"+v.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,t.result=void 0,t.target||(t.target=i),n=null==n?[t]:x.makeArray(n,[t]),f=x.event.special[y]||{},o||!f.trigger||!1!==f.trigger.apply(i,n))){if(!o&&!f.noBubble&&!g(i)){for(c=f.delegateType||y,st.test(c+y)||(s=s.parentNode);s;s=s.parentNode)b.push(s),l=s;l===(i.ownerDocument||r)&&b.push(l.defaultView||l.parentWindow||e)}for(a=0;(s=b[a++])&&!t.isPropagationStopped();)h=s,t.type=a>1?c:f.bindType||y,(p=(Y.get(s,"events")||{})[t.type]&&Y.get(s,"handle"))&&p.apply(s,n),(p=u&&s[u])&&p.apply&&X(s)&&(t.result=p.apply(s,n),!1===t.result&&t.preventDefault());return t.type=y,o||t.isDefaultPrevented()||f._default&&!1!==f._default.apply(b.pop(),n)||!X(i)||u&&m(i[y])&&!g(i)&&((l=i[u])&&(i[u]=null),x.event.triggered=y,t.isPropagationStopped()&&h.addEventListener(y,lt),i[y](),t.isPropagationStopped()&&h.removeEventListener(y,lt),x.event.triggered=void 0,l&&(i[u]=l)),t.result}},simulate:function(e,t,n){var r=x.extend(new x.Event,n,{type:e,isSimulated:!0});x.event.trigger(r,null,t)}}),x.fn.extend({trigger:function(e,t){return this.each(function(){x.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return x.event.trigger(e,t,n,!0)}}),h.focusin||x.each({focus:"focusin",blur:"focusout"},function(e,t){var n=function(e){x.event.simulate(t,e.target,x.event.fix(e))};x.event.special[t]={setup:function(){var r=this.ownerDocument||this,i=Y.access(r,t);i||r.addEventListener(e,n,!0),Y.access(r,t,(i||0)+1)},teardown:function(){var r=this.ownerDocument||this,i=Y.access(r,t)-1;i?Y.access(r,t,i):(r.removeEventListener(e,n,!0),Y.remove(r,t))}}});var ct,ut=/\[\]$/,dt=/\r?\n/g,pt=/^(?:submit|button|image|reset|file)$/i,ft=/^(?:input|select|textarea|keygen)/i;function ht(e,t,n,r){var i;if(Array.isArray(t))x.each(t,function(t,i){n||ut.test(e)?r(e,i):ht(e+"["+("object"==typeof i&&null!=i?t:"")+"]",i,n,r)});else if(n||"object"!==v(t))r(e,t);else for(i in t)ht(e+"["+i+"]",t[i],n,r)}x.param=function(e,t){var n,r=[],i=function(e,t){var n=m(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(Array.isArray(e)||e.jquery&&!x.isPlainObject(e))x.each(e,function(){i(this.name,this.value)});else for(n in e)ht(n,e[n],t,i);return r.join("&")},x.fn.extend({serialize:function(){return x.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=x.prop(this,"elements");return e?x.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!x(this).is(":disabled")&&ft.test(this.nodeName)&&!pt.test(e)&&(this.checked||!le.test(e))}).map(function(e,t){var n=x(this).val();return null==n?null:Array.isArray(n)?x.map(n,function(e){return{name:t.name,value:e.replace(dt,"\r\n")}}):{name:t.name,value:n.replace(dt,"\r\n")}}).get()}}),x.fn.extend({wrapAll:function(e){var t;return this[0]&&(m(e)&&(e=e.call(this[0])),t=x(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){for(var e=this;e.firstElementChild;)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(e){return m(e)?this.each(function(t){x(this).wrapInner(e.call(this,t))}):this.each(function(){var t=x(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=m(e);return this.each(function(n){x(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(e){return this.parent(e).not("body").each(function(){x(this).replaceWith(this.childNodes)}),this}}),x.expr.pseudos.hidden=function(e){return!x.expr.pseudos.visible(e)},x.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},h.createHTMLDocument=((ct=r.implementation.createHTMLDocument("").body).innerHTML="
          ",2===ct.childNodes.length),x.parseHTML=function(e,t,n){return"string"!=typeof e?[]:("boolean"==typeof t&&(n=t,t=!1),t||(h.createHTMLDocument?((i=(t=r.implementation.createHTMLDocument("")).createElement("base")).href=r.location.href,t.head.appendChild(i)):t=r),o=L.exec(e),a=!n&&[],o?[t.createElement(o[1])]:(o=be([e],t,a),a&&a.length&&x(a).remove(),x.merge([],o.childNodes)));var i,o,a},x.offset={setOffset:function(e,t,n){var r,i,o,a,s,l,c=x.css(e,"position"),u=x(e),d={};"static"===c&&(e.style.position="relative"),s=u.offset(),o=x.css(e,"top"),l=x.css(e,"left"),("absolute"===c||"fixed"===c)&&(o+l).indexOf("auto")>-1?(a=(r=u.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(l)||0),m(t)&&(t=t.call(e,n,x.extend({},s))),null!=t.top&&(d.top=t.top-s.top+a),null!=t.left&&(d.left=t.left-s.left+i),"using"in t?t.using.call(e,d):u.css(d)}},x.fn.extend({offset:function(e){if(arguments.length)return void 0===e?this:this.each(function(t){x.offset.setOffset(this,e,t)});var t,n,r=this[0];return r?r.getClientRects().length?(t=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:t.top+n.pageYOffset,left:t.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this[0]){var e,t,n,r=this[0],i={top:0,left:0};if("fixed"===x.css(r,"position"))t=r.getBoundingClientRect();else{for(t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;e&&(e===n.body||e===n.documentElement)&&"static"===x.css(e,"position");)e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=x(e).offset()).top+=x.css(e,"borderTopWidth",!0),i.left+=x.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-x.css(r,"marginTop",!0),left:t.left-i.left-x.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){for(var e=this.offsetParent;e&&"static"===x.css(e,"position");)e=e.offsetParent;return e||ye})}}),x.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,t){var n="pageYOffset"===t;x.fn[e]=function(r){return B(this,function(e,r,i){var o;if(g(e)?o=e:9===e.nodeType&&(o=e.defaultView),void 0===i)return o?o[t]:e[r];o?o.scrollTo(n?o.pageXOffset:i,n?i:o.pageYOffset):e[r]=i},e,r,arguments.length)}}),x.each(["top","left"],function(e,t){x.cssHooks[t]=Ue(h.pixelPosition,function(e,n){if(n)return n=qe(e,t),Me.test(n)?x(e).position()[t]+"px":n})}),x.each({Height:"height",Width:"width"},function(e,t){x.each({padding:"inner"+e,content:t,"":"outer"+e},function(n,r){x.fn[r]=function(i,o){var a=arguments.length&&(n||"boolean"!=typeof i),s=n||(!0===i||!0===o?"margin":"border");return B(this,function(t,n,i){var o;return g(t)?0===r.indexOf("outer")?t["inner"+e]:t.document.documentElement["client"+e]:9===t.nodeType?(o=t.documentElement,Math.max(t.body["scroll"+e],o["scroll"+e],t.body["offset"+e],o["offset"+e],o["client"+e])):void 0===i?x.css(t,n,s):x.style(t,n,i,s)},t,a?i:void 0,a)}})}),x.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,t){x.fn[t]=function(e,n){return arguments.length>0?this.on(t,null,e,n):this.trigger(t)}}),x.fn.extend({hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),x.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)}}),x.proxy=function(e,t){var n,r,i;if("string"==typeof t&&(n=e[t],t=e,e=n),m(e))return r=o.call(arguments,2),(i=function(){return e.apply(t||this,r.concat(o.call(arguments)))}).guid=e.guid=e.guid||x.guid++,i},x.holdReady=function(e){e?x.readyWait++:x.ready(!0)},x.isArray=Array.isArray,x.parseJSON=JSON.parse,x.nodeName=A,x.isFunction=m,x.isWindow=g,x.camelCase=V,x.type=v,x.now=Date.now,x.isNumeric=function(e){var t=x.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},"function"==typeof define&&define.amd&&define("jquery",[],function(){return x});var mt=e.jQuery,gt=e.$;return x.noConflict=function(t){return e.$===x&&(e.$=gt),t&&e.jQuery===x&&(e.jQuery=mt),x},t||(e.jQuery=e.$=x),x},"object"==typeof module&&"object"==typeof module.exports?module.exports=t0.document?u0(t0,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return u0(e)}:u0(t0),define("deps/jquery",function(){}),define("core/jquery-enhanced",["exports","core/pubsubhub","core/utils","deps/jquery"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/jquery-enhanced";window.$=$,window.$.fn.renameElement=function(e){var n=[];return this.each(function(){for(var r=$(this.ownerDocument.createElement(e)),i=0,o=this.attributes.length;i""!==e).reduce((e,t)=>e.add(t),new Set)]},window.$.fn.linkTargets=function(){var e=this[0].closest("[data-link-for]"),t=e?e.dataset.linkFor.toLowerCase():"",n=this.getDfnTitles(),r=[];for(const e of n){r.push({for:t,title:e});const n=e.split(".");2===n.length&&r.push({for:n[0],title:n[1]}),r.push({for:"",title:e})}return r},window.$.fn.makeID=function(e="",t="",n=!1){const r=this[0];if(r.id)return r.id;t||(t=(r.title?r.title:r.textContent).trim());var i=n?t:t.toLowerCase();if((i=i.replace(/[\W]+/gim,"-").replace(/^-+/,"").replace(/-+$/,""))?!/\.$/.test(i)&&/^[a-z]/i.test(i)||(i="x"+i):i="generatedID",e&&(i=`${e}-${i}`),r.ownerDocument.getElementById(i)){let e=0,t=i+"-"+e;for(;r.ownerDocument.getElementById(t);)t=i+"-"+e++;i=t}return r.id=i,i},window.$.fn.allTextNodes=function(e){for(var t=[],n={},r=0,i=e.length;r(e.setAttribute("aria-"+t,n),e),e)}l.id="respec-ui-styles",l.textContent=a.default,l.classList.add("removeOnSave"),document.head.appendChild(l);const u=$(""),d=$("");var p,f;const h=[],m=[],g={};(0,n.sub)("start-all",()=>{document.body.insertAdjacentElement("afterbegin",u[0])},{once:!0}),(0,n.sub)("end-all",()=>{document.body.insertAdjacentElement("afterbegin",u[0])},{once:!0});const b=$("");b.click(function(e){e.stopPropagation(),d[0].hidden?(d[0].classList.remove("respec-hidden"),d[0].classList.add("respec-visible")):(d[0].classList.add("respec-hidden"),d[0].classList.remove("respec-visible")),this.setAttribute("aria-expanded",String(d[0].hidden)),d[0].hidden=!d[0].hidden}).appendTo(u),document.documentElement.addEventListener("click",function(){d[0].hidden||(d[0].classList.remove("respec-visible"),d[0].classList.add("respec-hidden"),d[0].hidden=!0)}),d.appendTo(u);const y=new Map([["controls","respec-menu"],["expanded","false"],["haspopup","true"],["label","ReSpec Menu"]]);function v(e,t,n,r){if(t.push(e),g.hasOwnProperty(n))return void g[n].text(t.length);g[n]=$("").appendTo(u).click(function(){this.setAttribute("aria-expanded","true");for(var e=$("
            "),o=0,a=t.length;o
            ").appendTo(e).find("span").text("["+s.name+"] "+s.message).end().find("a").css({fontSize:"1.1em",color:"#999",cursor:"pointer"}).click(function(){var e=$(this),t=e.text(),n=e.parent().find("pre");"⊞"===t?(e.text("⊟"),n.show()):(e.text("⊞"),n.hide())}).end().find("pre").text(s.stack).css({marginLeft:"0",maxWidth:"100%",overflowY:"hidden",overflowX:"scroll"}).hide().end();else{const t=document.createElement("tmp");t.innerHTML=(0,i.markdownToHtml)(s);const n=document.createElement("li");if(t.firstElementChild===t.lastElementChild)for(;t.firstElementChild&&t.firstElementChild.hasChildNodes();)n.appendChild(t.firstElementChild.firstChild);else n.innerHTML=t.innerHTML;e[0].appendChild(n)}}w.freshModal(r,e,this)});const o=new Map([["expanded","false"],["haspopup","true"],["controls","respec-pill-"+n+"-modal"],["label","Document "+r.toLowerCase()]]);c(g[n][0],o)}c(b[0],y);const w=e.ui={show:function(){try{u[0].hidden=!1}catch(e){console.error(e)}},hide:function(){u[0].hidden=!0},enable:function(){b[0].removeAttribute("disabled")},addCommand:function(e,t,n,r){r=r||"";var i=function(){require([t],function(e){e.show()})},a="respec-button-"+e.toLowerCase().replace(/\s+/,"-"),s=$('
          1. ").click(i).appendTo(d);return n&&o.default.add(n,i),s[0].querySelector("button")},error:function(e){v(e,h,"error","Errors")},warning:function(e){v(e,m,"warning","Warnings")},closeModal:function(e){f&&(f[0].classList.remove("respec-show-overlay"),f[0].classList.add("respec-hide-overlay"),f[0].addEventListener("transitionend",()=>{f.remove(),f=null})),e&&e.setAttribute("aria-expanded","false"),p&&(p.remove(),p=null)},freshModal:function(e,t,n){p&&p.remove(),f&&f.remove(),f=$("
            ");const r=n.id+"-modal",i=r+"-heading";(p=$("")).find("h3").text(e),p.find("h3")[0].id=i;const o=new Map([["labelledby",i]]);c(p[0],o),p.find(".inside").append(t),$(document.body).append(f).append(p),f.click(()=>{this.closeModal(n)}),f[0].classList.toggle("respec-show-overlay"),p[0].hidden=!1}};o.default.add("Esc",function(){w.closeModal()}),o.default.add("Ctrl+Alt+Shift+E",function(){g.error&&g.error.click()}),o.default.add("Ctrl+Alt+Shift+W",function(){g.warning&&g.warning.click()}),window.respecUI=w,(0,n.sub)("error",function(e){w.error(e)}),(0,n.sub)("warn",function(e){w.warning(e)})}),define("core/l10n",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e){e.l10n=i[o]||i.en};var t=Object.assign||function(e){for(var t=1;te.add(t),this.rules)}async lint(e,i=window.document){const a=[...r.get(this).rules].map(r=>(async function(e){(await e).map(async e=>{const t=await e,r=n({},o,t),{description:i,help:a,howToFix:s,name:l,occurrences:c,offendingElements:u}=r,d=`${i} ${s} ${a} ("${l}" x ${c})`;return u.forEach(e=>{e.classList.add("respec-offending-element")}),console.warn(`Linter (${l}):`,i,...u),d}).forEach(async e=>{(0,t.pub)("warn",await e)})})(r.lint(e,i)));await a}};e.default=i;const o={name:"unknown",description:"",occurrences:0,howToFix:"",offendingElements:[],help:""}}),define("core/LinterRule",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0});const t=new WeakMap;e.default=class{constructor(e,n){t.set(this,{name:e,lintingFunction:n})}get name(){return t.get(this).name}lint(e={lint:{[this.name]:!1}},n=document){return r=e,i=this.name,!1!==r.hasOwnProperty("lint")&&!1!==r.lint&&r.lint[i]?[].concat(t.get(this).lintingFunction(e,n)):[];var r,i}}}),define("core/linter-rules/no-headingless-sections",["exports","core/LinterRule","../l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=t)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t`.",help:"See developer console."},nl:{description:"Alle secties moeten beginnen met een `h2-6` element.",howToFix:"Voeg een `h2-6` toe aan de conflicterende sectie of gebruik een `
            `.",help:"Zie de developer console."}},l=n.lang in s?n.lang:"en",c=({firstElementChild:e})=>null===e||!1===/^h[1-6]$/.test(e.localName);e.rule=new i.default(a,function(e,t){const n=Array.from(t.querySelectorAll("section")).filter(c);return n.length?o({name:a,offendingElements:n,occurrences:n.length},s[l]):[]})}),define("core/linter-rules/no-http-props",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;te.endsWith("URI")||"prevED"===e).filter(n=>new URL(e[n],t.location.href).href.startsWith("http://")).reduce((e,t)=>e.concat(t),[]);if(!n.length)return[];const r=o({name:a,occurrences:n.length},s[l]);return r.howToFix+=n.map(e=>"`"+e+"`").join(", ")+".",r})}),define("w3c/l10n",["exports","core/l10n"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="w3c/l10n";const n={en:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."},ko:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."},zh:{status_at_publication:"本章节描述了本文档的发布状态。其它更新版本可能会覆盖本文档。W3C的文档列 表和最新版本可通过W3C技术报告索引访问。"},ja:{status_at_publication:"この節には、公開時点でのこの文書の位置づけが記されている。他の文書によって置き換えられる可能性がある。現時点でのW3Cの発行文書とこのテクニカルレポートの最新版は、下記から参照できる。 W3C technical reports index (https://www.w3.org/TR/)"},nl:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/."}};Object.keys(n).reduce((e,t)=>(Object.assign(e[t],n[t]),e),t.l10n)}),define("w3c/linter-rules/privsec-section",["exports","core/LinterRule","../l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=t)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t{const t=/(privacy|security)/im.test(e),n=/(considerations)/im.test(e);return t&&n||t}))&&n.push(o({name:a,occurrences:1},s[l])),n})}),define("core/linter-rules/check-punctuation",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t`"${e}"`).join(", ")}.`}},c=t.lang in l?t.lang:"en";e.rule=new i.default(a,function(e,t){const n=new RegExp(`[${s.join("")}\\]]$|^ *$`,"m"),r=[...t.querySelectorAll("p:not(#back-to-top)")].filter(e=>!n.test(e.textContent.trim()));return r.length?o({name:a,offendingElements:r,occurrences:r.length},l[c]):[]})}),define("core/linter-rules/local-refs-exist",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t p:first-child {\n margin-top: 0;\n}\n\n.section dd > p:last-child {\n margin-bottom: 0;\n}\n\n.section dd {\n margin-bottom: 1em;\n}\n\n.section dl.attrs dd,\n.section dl.eldef dd {\n margin-bottom: 0;\n}\n\n#issue-summary > ul,\n.respec-dfn-list {\n column-count: 2;\n}\n\n#issue-summary li,\n.respec-dfn-list li {\n list-style: none;\n}\n\ndetails.respec-tests-details {\n margin-left: 1em;\n display: inline-block;\n vertical-align: top;\n}\n\ndetails.respec-tests-details > * {\n padding-right: 2em;\n}\n\ndetails.respec-tests-details[open] {\n z-index: 999999;\n position: absolute;\n border: thin solid #cad3e2;\n border-radius: .3em;\n background-color: white;\n padding-bottom: .5em;\n}\n\ndetails.respec-tests-details[open] > summary {\n border-bottom: thin solid #cad3e2;\n padding-left: 1em;\n margin-bottom: 1em;\n line-height: 2em;\n}\n\ndetails.respec-tests-details > ul {\n width: 100%;\n margin-top: -0.3em;\n}\n\ndetails.respec-tests-details > li {\n padding-left: 1em;\n}\n\n@media print {\n .removeOnSave {\n display: none;\n }\n}\n'}),define("core/style",["exports","deps/text!core/css/respec2.css"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){e.noReSpecCSS&&i.remove();n()};var n,r=(n=t)&&n.__esModule?n:{default:n};e.name="core/style";const i=document.createElement("style");i.id="respec-mainstyle",i.textContent=r.default,document.head.appendChild(i)}),define("w3c/style",["exports","core/utils","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,i){if(!e.specStatus){const t="`respecConfig.specStatus` missing. Defaulting to 'base'.";e.specStatus="base",(0,n.pub)("warn",t)}let o="W3C-";switch(e.specStatus.toUpperCase()){case"CG-DRAFT":case"CG-FINAL":case"BG-DRAFT":case"BG-FINAL":o=e.specStatus.toLowerCase();break;case"FPWD":case"LC":case"WD-NOTE":case"LC-NOTE":o+="WD";break;case"WG-NOTE":case"FPWD-NOTE":o+="WG-NOTE.css";break;case"UNOFFICIAL":o+="UD";break;case"FINDING":case"FINDING-DRAFT":case"BASE":o="base.css";break;default:o+=e.specStatus}const a=function(e){let t="";switch(e){case null:case!0:t="2016";break;default:e&&!isNaN(e)&&(t=e.toString().trim())}return t}(e.useExperimentalStyles||"2016");a&&!e.noToc&&(0,n.sub)("end-all",function(){!function(e,t){const n=e.createElement("script");n.addEventListener("load",function(){window.location.hash&&(window.location=window.location)},{once:!0}),n.src=`https://www.w3.org/scripts/TR/${t}/fixup.js`,e.body.appendChild(n)}(r,a)},{once:!0});const s=`https://www.w3.org/StyleSheets/TR/${a?a+"/":""}${o}`;(0,t.linkCSS)(r,s),i()};e.name="w3c/style";const r=[{hint:"preconnect",href:"https://www.w3.org"},{hint:"preload",href:"https://www.w3.org/scripts/TR/2016/fixup.js",as:"script"},{hint:"preload",href:"https://www.w3.org/StyleSheets/TR/2016/base.css",as:"style"},{hint:"preload",href:"https://www.w3.org/StyleSheets/TR/2016/logos/W3C",as:"image"}].map(t.createResourceHint).reduce(function(e,t){return e.appendChild(t),e},document.createDocumentFragment());r.appendChild(function(){const e=document.createElement("link");return e.rel="stylesheet",e.href="https://www.w3.org/StyleSheets/TR/2016/base.css",e.classList.add("removeOnSave"),e}()),document.head.querySelector("meta[name=viewport]")||r.insertBefore(function(){const e=document.createElement("meta");return e.name="viewport",e.content=(0,t.toKeyValuePairs)({width:"device-width","initial-scale":"1","shrink-to-fit":"no"}).replace(/\"/g,""),e}(),r.firstChild),document.head.insertBefore(r,document.head.firstChild)}),define("core/github",["exports","core/l10n","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.fetchAll=o,e.fetchIndex=function(e,t){return o(e.replace(/\{[^}]+\}/,""),t)},e.run=async function(e){if(!e.hasOwnProperty("github")||!e.github)return;if("object"==typeof e.github&&!e.github.hasOwnProperty("repoURL")){const e="Config option `[github](https://github.com/w3c/respec/wiki/github)` is missing property `repoURL`.";return void(0,n.pub)("error",e)}let t;try{t=new URL(e.github.repoURL||e.github,"https://github.com")}catch(e){return void(0,n.pub)("error",`\`respecConf.github\` is not a valid URL? (${t})`)}if("https://github.com"!==t.origin){const e=`\`respecConf.github\` must be HTTPS and pointing to GitHub. (${t})`;return void(0,n.pub)("error",e)}const[r,o]=t.pathname.split("/").filter(e=>e);if(!r||!o){const e="`respecConf.github` URL needs a path with, for example, w3c/my-spec";return void(0,n.pub)("error",e)}const a=e.github.branch||"gh-pages",s={edDraftURI:`https://${r.toLowerCase()}.github.io/${o}/`,githubToken:void 0,githubUser:void 0,githubAPI:`https://api.github.com/repos/${r}/${o}`,issueBase:new URL("./issues/",t).href,otherLinks:[],pullBase:new URL("./pulls/",t).href,shortName:o},l={key:e.l10n.participate,data:[{value:`GitHub ${r}/${o}`,href:t},{value:e.l10n.file_a_bug,href:s.issueBase},{value:e.l10n.commit_history,href:new URL(`./commits/${a}`,t.href).href},{value:e.l10n.pull_requests,href:s.pullBase}]},c={branch:a,repoURL:t.href},u=i({},s,e,{github:c});Object.assign(e,u),e.otherLinks.unshift(l)};var r;(r=t)&&r.__esModule;var i=Object.assign||function(e){for(var t=1;t]+)>\s*;\s*rel="next"/))&&u[1]||null);var c,u;return l?o(l,t,n):n}}),define("core/data-include",["exports","core/pubsubhub","core/utils"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,i){const o=Array.from(r.querySelectorAll("[data-include]")).map(async e=>{const r=e.dataset.include;if(!r)return;const i="include-"+String(Math.random()).substr(2);e.dataset.includeId=i;try{const o=await fetch(r),a=await o.text();!function(e,t,r){const i=document.querySelector(`[data-include-id=${t}]`),o=i.ownerDocument,a=(0,n.runTransforms)(e,i.dataset.oninclude,r),s="string"==typeof i.dataset.includeReplace;let l;switch(i.dataset.includeFormat){case"text":s?(l=o.createTextNode(a),i.parentNode.replaceChild(l,i)):i.textContent=a;break;default:if(i.innerHTML=a,s){for(l=o.createDocumentFragment();i.hasChildNodes();)l.append(i.removeChild(i.firstChild));i.parentNode.replaceChild(l,i)}}o.contains(i)&&(c=i,["data-include","data-include-format","data-include-replace","data-include-id","oninclude"].forEach(e=>c.removeAttribute(e)));var c}(a,i,r)}catch(n){const i=`\`data-include\` failed: \`${r}\` (${n.message}). See console for details.`;console.error("data-include failed for element: ",e,n),(0,t.pub)("error",i)}});Promise.all(o).then(i)};e.name="core/data-include"}),define("core/markdown",["exports","core/utils"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){const r=!!t.querySelector("[data-format=markdown]:not(body)"),s="markdown"===e.format;if(!s&&!r)return n();if(!s)return o(t.body).map(e=>{const t=i(e,e.ownerDocument);return{structuredInternals:t,elem:e}}).forEach(({elem:e,structuredInternals:t})=>{if(e.setAttribute("aria-busy","true"),"section"===t.firstElementChild.localName&&"section"===e.localName){const n=t.firstElementChild;for(n.remove();n.hasChildNodes();)e.appendChild(n.firstChild)}else e.innerHTML="";e.appendChild(t),e.setAttribute("aria-busy","false")}),n();const l=t.getElementById("respec-ui");l.remove();const c=t.createElement("html"),u=t.createElement("body");u.innerHTML=t.body.innerHTML,c.appendChild(u),a(c);const d=u.innerHTML.replace(/

            \s*<\/p>/gm,"");u.innerHTML=d,p=u.querySelectorAll(".nolinks a[href]"),Array.from(p).forEach(e=>{const t=e.ownerDocument.createTextNode(e.textContent);e.parentElement.replaceChild(t,e)});var p;var f=i(u,t);u.appendChild(f),u.insertAdjacentElement("afterbegin",l),t.body.parentNode.replaceChild(u,t.body),n()};e.name="core/markdown";function n(e){return n=>{const r=Array.from(n.querySelectorAll(e));return r.reverse().forEach(e=>{e.innerHTML=(0,t.markdownToHtml)(e.innerHTML)}),r}}class r{constructor(e){this.doc=e,this.root=e.createDocumentFragment(),this.stack=[this.root],this.current=this.root}findPosition(e){return parseInt(e.tagName.charAt(1),10)}findParent(e){let t;for(;e>0;)if(e--,t=this.stack[e])return t}findHeader({firstChild:e}){for(;e;){if(/H[1-6]/.test(e.tagName))return e;e=e.nextSibling}return null}addHeader(e){const t=this.doc.createElement("section"),n=this.findPosition(e);t.appendChild(e),this.findParent(n).appendChild(t),this.stack[n]=t,this.stack.length=n+1,this.current=t}addSection(e,t){const n=this.findHeader(e),r=n?this.findPosition(n):1,i=this.findParent(r);n&&e.removeChild(n),e.appendChild(t(e)),n&&e.insertBefore(n,e.firstChild),i.appendChild(e),this.current=i}addElement(e){this.current.appendChild(e)}}function i(e,t){return function e(n){const i=new r(t);for(;n.firstChild;){const t=n.firstChild;if(t.nodeType===Node.ELEMENT_NODE)switch(t.localName){case"h1":case"h2":case"h3":case"h4":case"h5":case"h6":i.addHeader(t);break;case"section":i.addSection(t,e);break;default:i.addElement(t)}else n.removeChild(t)}return i.root}(e)}const o=n("[data-format='markdown']:not(body)"),a=n("[data-format=markdown]:not(body), section, div, address, article, aside, figure, header, main, body")}),Dha=this,Eha=function(){return function(e){var t={};function n(r){if(t[r])return t[r].exports;var i=t[r]={exports:{},id:r,loaded:!1};return e[r].call(i.exports,i,i.exports,n),i.loaded=!0,i.exports}return n.m=e,n.c=t,n.p="",n(0)}([function(e,t,n){var r=n(1).default,i=n(2).default;t.__esModule=!0;var o=r(n(3)),a=i(n(20)),s=i(n(5)),l=r(n(4)),c=r(n(21)),u=i(n(33));function d(){var e=new o.HandlebarsEnvironment;return l.extend(e,o),e.SafeString=a.default,e.Exception=s.default,e.Utils=l,e.escapeExpression=l.escapeExpression,e.VM=c,e.template=function(t){return c.template(t,e)},e}var p=d();p.create=d,u.default(p),p.default=p,t.default=p,e.exports=t.default},function(e,t){t.default=function(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&(t[n]=e[n]);return t.default=e,t},t.__esModule=!0},function(e,t){t.default=function(e){return e&&e.__esModule?e:{default:e}},t.__esModule=!0},function(e,t,n){var r=n(2).default;t.__esModule=!0,t.HandlebarsEnvironment=u;var i=n(4),o=r(n(5)),a=n(9),s=n(17),l=r(n(19));t.VERSION="4.0.11";t.COMPILER_REVISION=7;t.REVISION_CHANGES={1:"<= 1.0.rc.2",2:"== 1.0.0-rc.3",3:"== 1.0.0-rc.4",4:"== 1.x.x",5:"== 2.0.0-alpha.x",6:">= 2.0.0-beta.1",7:">= 4.0.0"};var c="[object Object]";function u(e,t,n){this.helpers=e||{},this.partials=t||{},this.decorators=n||{},a.registerDefaultHelpers(this),s.registerDefaultDecorators(this)}u.prototype={constructor:u,logger:l.default,log:l.default.log,registerHelper:function(e,t){if(i.toString.call(e)===c){if(t)throw new o.default("Arg not supported with multiple helpers");i.extend(this.helpers,e)}else this.helpers[e]=t},unregisterHelper:function(e){delete this.helpers[e]},registerPartial:function(e,t){if(i.toString.call(e)===c)i.extend(this.partials,e);else{if(void 0===t)throw new o.default('Attempting to register a partial called "'+e+'" as undefined');this.partials[e]=t}},unregisterPartial:function(e){delete this.partials[e]},registerDecorator:function(e,t){if(i.toString.call(e)===c){if(t)throw new o.default("Arg not supported with multiple decorators");i.extend(this.decorators,e)}else this.decorators[e]=t},unregisterDecorator:function(e){delete this.decorators[e]}};var d=l.default.log;t.log=d,t.createFrame=i.createFrame,t.logger=l.default},function(e,t){t.__esModule=!0,t.extend=a,t.indexOf=function(e,t){for(var n=0,r=e.length;n":">",'"':""","'":"'","`":"`","=":"="},r=/[&<>"'`=]/g,i=/[&<>"'`=]/;function o(e){return n[e]}function a(e){for(var t=1;t0?(n.ids&&(n.ids=[n.name]),e.helpers.each(t,n)):i(this);if(n.data&&n.ids){var a=r.createFrame(n.data);a.contextPath=r.appendContextPath(n.data.contextPath,n.name),n={data:a}}return o(t,n)})},e.exports=t.default},function(e,t,n){var r=n(2).default;t.__esModule=!0;var i=n(4),o=r(n(5));t.default=function(e){e.registerHelper("each",function(e,t){if(!t)throw new o.default("Must pass iterator to #each");var n=t.fn,r=t.inverse,a=0,s="",l=void 0,c=void 0;function u(t,r,o){l&&(l.key=t,l.index=r,l.first=0===r,l.last=!!o,c&&(l.contextPath=c+t)),s+=n(e[t],{data:l,blockParams:i.blockParams([e[t],t],[c+t,null])})}if(t.data&&t.ids&&(c=i.appendContextPath(t.data.contextPath,t.ids[0])+"."),i.isFunction(e)&&(e=e.call(this)),t.data&&(l=i.createFrame(t.data)),e&&"object"==typeof e)if(i.isArray(e))for(var d=e.length;a=0?t:parseInt(e,10)}return e},log:function(e){if(e=i.lookupLevel(e),"undefined"!=typeof console&&i.lookupLevel(i.level)<=e){var t=i.methodMap[e];console[t]||(t="log");for(var n=arguments.length,r=Array(n>1?n-1:0),o=1;o *:hover > span.permalink { visibility: visible; }\n"},3:function(e,t,n,r,i){return" float: right;\n"},5:function(e,t,n,r,i){return" visibility: hidden;\n"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{};return"/* --- PERMALINKS --- */\n"+(null!=(o=n.if.call(a,null!=t?t.permalinkHide:t,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"\n.permalink {\n width: 1px;\n height: 1px;\n overflow: visible;\n font-size: 10pt;\n font-style: normal;\n vertical-align: middle;\n margin-left: 4px;\n"+(null!=(o=n.if.call(a,null!=t?t.permalinkEdge:t,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+(null!=(o=n.if.call(a,null!=t?t.permalinkHide:t,{name:"if",hash:{},fn:e.program(5,i,0),inverse:e.noop,data:i}))?o:"")+"}\n\n.permalink a, .permalink a:link, .permalink a:visited, .permalink a:hover, .permalink a:focus, .permalink a:active {\n background:transparent !important;\n text-decoration:none;\n font-weight: bold;\n color:#666 !important;\n}\n\n.permalink abbr {\n border:0;\n}\n"},useData:!0}),n["attribute.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression((n.escapeAttributeName||t&&t.escapeAttributeName||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.name:o,{name:"escapeAttributeName",hash:{},data:i}))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:u)?a.call(c,{name:"qualifiers",hash:{},data:i}):a)+"attribute "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["callback.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"callback "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" = "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" ("+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+");"},useData:!0}),n["const.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"const "+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+""+l("function"==typeof(a=null!=(a=n.nullable||(null!=t?t.nullable:t))?a:u)?a.call(c,{name:"nullable",hash:{},data:i}):a)+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" = "+l((n.stringifyIdlConst||t&&t.stringifyIdlConst||u).call(c,null!=(o=null!=t?t.obj:t)?o.value:o,{name:"stringifyIdlConst",hash:{},data:i}))+";\n"},useData:!0}),n["dict-member.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" = "+e.escapeExpression((n.stringifyIdlConst||t&&t.stringifyIdlConst||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.default:o,{name:"stringifyIdlConst",hash:{},data:i}))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:u)?a.call(c,{name:"qualifiers",hash:{},data:i}):a)+""+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.typePad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.default:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["dictionary.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" : "+e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.inheritance:o,t))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.partial||(null!=t?t.partial:t))?a:u)?a.call(c,{name:"partial",hash:{},data:i}):a)+"dictionary "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.inheritance:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+"};"},useData:!0}),n["enum-item.html"]=t({1:function(e,t,n,r,i){return","},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression,u="function";return c((n.idn||t&&t.idn||l).call(s,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+'"'+c(typeof(a=null!=(a=n.name||(null!=t?t.name:t))?a:l)===u?a.call(s,{name:"name",hash:{},data:i}):a)+'"'+(null!=(o=n.if.call(s,null!=t?t.needsComma:t,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"\n"},useData:!0}),n["enum.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"enum "+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"};"},useData:!0}),n["extended-attribute.html"]=t({1:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return"'+c("function"==typeof(a=null!=(a=n.name||(null!=t?t.name:t))?a:l)?a.call(s,{name:"name",hash:{},data:i}):a)+""+(null!=(o=n.if.call(s,null!=t?t.rhs:t,{name:"if",hash:{},fn:e.program(2,i,0),inverse:e.noop,data:i}))?o:"")+(null!=(o=(n.jsIf||t&&t.jsIf||l).call(s,null!=t?t.arguments:t,{name:"jsIf",hash:{},fn:e.program(5,i,0),inverse:e.noop,data:i}))?o:"")+""},2:function(e,t,n,r,i){var o;return'='+(null!=(o=(n.extAttrRhs||t&&t.extAttrRhs||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=t?t.rhs:t,{name:"extAttrRhs",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+""},3:function(e,t,n,r,i){return e.escapeExpression(e.lambda(t,t))},5:function(e,t,n,r,i){var o;return"("+(null!=(o=(n.joinNonWhitespace||t&&t.joinNonWhitespace||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=t?t.arguments:t,", ",{name:"joinNonWhitespace",hash:{},fn:e.program(6,i,0),inverse:e.noop,data:i}))?o:"")+")"},6:function(e,t,n,r,i){return e.escapeExpression((n.param||t&&t.param||n.helperMissing).call(null!=t?t:e.nullContext||{},t,{name:"param",hash:{},data:i}))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return c((n.idn||t&&t.idn||l).call(s,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"["+(null!=(o=(n.join||t&&t.join||l).call(s,null!=t?t.extAttrs:t,null!=t?t.sep:t,{name:"join",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"]"+c("function"==typeof(a=null!=(a=n.end||(null!=t?t.end:t))?a:l)?a.call(s,{name:"end",hash:{},data:i}):a)},useData:!0}),n["field.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=e.lambda,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+s((n.pads||t&&t.pads||c).call(l,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";\n"},useData:!0}),n["implements.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression,c=e.lambda;return""+l((n.extAttr||t&&t.extAttr||s).call(a,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+l(c(null!=(o=null!=t?t.obj:t)?o.target:o,t))+" implements "+l(c(null!=(o=null!=t?t.obj:t)?o.implements:o,t))+";"},useData:!0}),n["includes.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression,c=e.lambda;return""+l((n.extAttr||t&&t.extAttr||s).call(a,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+""+l(c(null!=(o=null!=t?t.obj:t)?o.target:o,t))+" includes "+l(c(null!=(o=null!=t?t.obj:t)?o.includes:o,t))+";"},useData:!0}),n["interface.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" : "+e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.inheritance:o,t))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing,d="function";return""+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l(typeof(a=null!=(a=n.partial||(null!=t?t.partial:t))?a:u)===d?a.call(c,{name:"partial",hash:{},data:i}):a)+l(typeof(a=null!=(a=n.callback||(null!=t?t.callback:t))?a:u)===d?a.call(c,{name:"callback",hash:{},data:i}):a)+"interface "+l(typeof(a=null!=(a=n.mixin||(null!=t?t.mixin:t))?a:u)===d?a.call(c,{name:"mixin",hash:{},data:i}):a)+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.inheritance:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o=typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)===d?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"};"},useData:!0}),n["iterable.html"]=t({1:function(e,t,n,r,i){return"iterable"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+s("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:c)?a.call(l,{name:"qualifiers",hash:{},data:i}):a)+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"<"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+">;\n"},useData:!0}),n["line-comment.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression;return""+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"//"+l("function"==typeof(o=null!=(o=n.comment||(null!=t?t.comment:t))?o:s)?o.call(a,{name:"comment",hash:{},data:i}):o)+"\n"},useData:!0}),n["maplike.html"]=t({1:function(e,t,n,r,i){return"maplike"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return""+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+s("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:c)?a.call(l,{name:"qualifiers",hash:{},data:i}):a)+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"<"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+">;\n"},useData:!0}),n["method.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return""+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l((n.extAttrInline||t&&t.extAttrInline||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttrInline",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.special||(null!=t?t.special:t))?a:u)?a.call(c,{name:"special",hash:{},data:i}):a)+""+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+""+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"("+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+");\n"},useData:!0}),n["multiline-comment.html"]=t({1:function(e,t,n,r,i,o,a){var s=e.escapeExpression;return s((n.idn||t&&t.idn||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=a[1]?a[1].indent:a[1],{name:"idn",hash:{},data:i}))+s(e.lambda(t,t))+"\n"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i,o,a){var s,l,c=null!=t?t:e.nullContext||{},u=n.helperMissing,d=e.escapeExpression;return""+d((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"/*"+d("function"==typeof(l=null!=(l=n.firstLine||(null!=t?t.firstLine:t))?l:u)?l.call(c,{name:"firstLine",hash:{},data:i}):l)+"\n"+(null!=(s=n.each.call(c,null!=t?t.innerLine:t,{name:"each",hash:{},fn:e.program(1,i,0,o,a),inverse:e.noop,data:i}))?s:"")+d((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+d("function"==typeof(l=null!=(l=n.lastLine||(null!=t?t.lastLine:t))?l:u)?l.call(c,{name:"lastLine",hash:{},data:i}):l)+"*/\n"},useData:!0,useDepths:!0}),n["param.html"]=t({1:function(e,t,n,r,i){var o;return" = "+e.escapeExpression((n.stringifyIdlConst||t&&t.stringifyIdlConst||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.default:o,{name:"stringifyIdlConst",hash:{},data:i}))+""},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return""+c((n.extAttrInline||t&&t.extAttrInline||l).call(s,null!=t?t.obj:t,{name:"extAttrInline",hash:{},data:i}))+c("function"==typeof(a=null!=(a=n.optional||(null!=t?t.optional:t))?a:l)?a.call(s,{name:"optional",hash:{},data:i}):a)+""+c((n.idlType||t&&t.idlType||l).call(s,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+c("function"==typeof(a=null!=(a=n.variadic||(null!=t?t.variadic:t))?a:l)?a.call(s,{name:"variadic",hash:{},data:i}):a)+" "+c(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))+""+(null!=(o=n.if.call(s,null!=(o=null!=t?t.obj:t)?o.default:o,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+""},useData:!0}),n["typedef.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=e.lambda,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return"typedef "+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+" "+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+";"},useData:!0}),n}),define("w3c/templates/cgbg-sotd",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const t=hyperHTML;return t`

            ${e.l10n.sotd}

            -${e.isPreview?t` -
            - This is a preview -

            - Do not attempt to implement this version of the specification. Do not reference this - version as authoritative in any way. - ${e.edDraftURI?t` - Instead, see ${e.edDraftURI} for the Editor's draft. - `:""} -

            -
            -`:""} -

            - This specification was published by the ${e.wg}. - It is not a W3C Standard nor is it on the W3C Standards Track. - ${e.isCGFinal?t` - Please note that under the - W3C Community Final Specification Agreement (FSA) - other conditions apply. - `:t` - Please note that under the - W3C Community Contributor License Agreement (CLA) - there is a limited opt-out and other conditions apply. - `} - Learn more about - W3C Community and Business Groups. -

            -${e.sotdAfterWGinfo?"":[e.additionalContent]} - ${e.wgPublicList?t` -

            If you wish to make comments regarding this document, please send them to - ${e.wgPublicList}@w3.org - (subscribe, - archives)${e.subjectPrefix?t` - with ${e.subjectPrefix} at the start of your - email's subject`:""}.

            - `:""} -${e.sotdAfterWGinfo?[e.additionalContent]:""} -${[e.additionalSections]}`})}),define("w3c/templates/sotd",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const t=hyperHTML;return t`

            ${e.l10n.sotd}

            -${e.isPreview?t` -
            - This is a preview -

            - Do not attempt to implement this version of the specification. Do not reference this - version as authoritative in any way. - ${e.edDraftURI?t` - Instead, see ${e.edDraftURI} for the Editor's draft. - `:""} -

            -
            -`:""} -${e.isUnofficial?t` -

            - This document is draft of a potential specification. It has no official standing of - any kind and does not represent the support or consensus of any standards organisation. -

            - ${[e.additionalContent]} -`:t` - ${e.isTagFinding?[e.additionalContent]:t` - ${e.isNoTrack?t` -

            - This document is merely a W3C-internal ${e.isMO?"member-confidential":""} document. It - has no official standing of any kind and does not represent consensus of the W3C - Membership. -

            - ${[e.additionalContent]} - `:t` -

            - ${[e.l10n.status_at_publication]} -

            - ${e.isSubmission?t` - ${[e.additionalContent]} - ${e.isMemberSubmission?t` -

            - By publishing this document, W3C acknowledges that the Submitting Members - have made a formal Submission request to W3C for discussion. Publication of this document - by W3C indicates no endorsement of its content by W3C, nor that W3C has, is, or will be - allocating any resources to the issues addressed by it. This document is not the product - of a chartered W3C group, but is published as potential input to - the W3C Process. - A W3C Team Comment has been - published in conjunction with this Member Submission. Publication of acknowledged Member Submissions - at the W3C site is one of the benefits of - W3C Membership. Please consult the requirements associated with Member Submissions of - section 3.3 of the - W3C Patent Policy. Please consult the complete list - of acknowledged W3C Member Submissions. -

            - `:t` - ${e.isTeamSubmission?t` -

            If you wish to make comments regarding this document, please send them to - ${e.wgPublicList}@w3.org - (subscribe, - archives)${e.subjectPrefix?t` - with ${e.subjectPrefix} at the start of your email's subject`:""}.

            -

            Please consult the complete list of Team Submissions.

            - `:""} - `} - `:t` - ${e.sotdAfterWGinfo?"":[e.additionalContent]} - ${e.overrideStatus?"":t` -

            - This document was published by ${[e.wgHTML]} as ${e.anOrA} ${e.longStatus}. - ${e.notYetRec?"This document is intended to become a W3C Recommendation.":""} - ${e.wgPublicList?t` - Comments regarding this document are welcome. Please send them to - ${e.wgPublicList}@w3.org - (subscribe, - archives)${e.subjectPrefix?t` - with ${e.subjectPrefix} at the start of your email's subject`:""}. - `:""} - ${e.isCR?`\n W3C publishes a Candidate Recommendation to indicate that the document is believed to be\n stable and to encourage implementation by the developer community. This Candidate\n Recommendation is expected to advance to Proposed Recommendation no earlier than\n ${e.humanCREnd}.\n `:""} - ${e.isPER?t` - W3C Advisory Committee Members are invited to - send formal review comments on this Proposed - Edited Recommendation to the W3C Team until - ${e.humanPEREnd}. - Members of the Advisory Committee will find the - appropriate review form for this document by - consulting their list of current - WBS questionnaires. - `:""} - ${e.isPR?t` - The W3C Membership and other interested parties are invited to review the document and - send comments to - ${e.wgPublicList}@w3.org - (subscribe, - archives) - through ${e.humanPREnd}. Advisory Committee Representatives should consult their - WBS questionnaires. - Note that substantive technical comments were expected during the Candidate Recommendation - review period that ended ${e.humanCREnd}. - `:""} -

            - `} - ${e.implementationReportURI?t` -

            - Please see the Working Group's implementation - report. -

            - `:""} - ${e.sotdAfterWGinfo?[e.additionalContent]:""} - ${e.notRec?t` -

            - Publication as ${e.anOrA} ${e.textStatus} does not imply endorsement by the W3C - Membership. This is a draft document and may be updated, replaced or obsoleted by other - documents at any time. It is inappropriate to cite this document as other than work in - progress. -

            - `:""} - ${e.isRec?t` -

            - This document has been reviewed by W3C Members, by software developers, and by other W3C - groups and interested parties, and is endorsed by the Director as a W3C Recommendation. - It is a stable document and may be used as reference material or cited from another - document. W3C's role in making the Recommendation is to draw attention to the - specification and to promote its widespread deployment. This enhances the functionality - and interoperability of the Web. -

            - `:""} -

            - ${e.isIGNote?"":t` - This document was produced by - ${e.multipleWGs?"groups":"a group"} - operating under the - W3C Patent Policy. - `} - ${e.recNotExpected?"The group does not expect this document to become a W3C Recommendation.":""} - ${e.isIGNote?"":t` - ${e.multipleWGs?t`W3C maintains ${[e.wgPatentHTML]}`:t` - W3C maintains a public list of any patent - disclosures - `} - made in connection with the deliverables of - ${e.multipleWGs?"each group; these pages also include":"the group; that page also includes"} - instructions for disclosing a patent. An individual who has actual knowledge of a patent - which the individual believes contains - Essential - Claim(s) must disclose the information in accordance with - section - 6 of the W3C Patent Policy. - `} - ${e.isIGNote?t` - The disclosure obligations of the Participants of this group are described in the - charter. - `:""} -

            -

            This document is governed by the 1 February 2018 W3C Process Document. -

            - ${e.addPatentNote?t`

            ${[e.addPatentNote]}

            `:""} - `} - `} - `} -`} -${[e.additionalSections]}`})}),define("w3c/templates/show-logo",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const n=document.createElement("a");if(!e.alt){const e="Found spec logo without an `alt` attribute. See dev console.";n.classList.add("respec-offending-element"),(0,t.pub)("warn",e),console.warn("warn",e,n)}return n.href=e.url||"",n.classList.add("logo"),hyperHTML.bind(n)` - ${e.alt} - `,n.querySelector("img").src=e.src,n})}),define("w3c/templates/show-people",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=((e,t,n=[])=>{const r=hyperHTML,i=[];for(let e=0;e`,o=document.createDocumentFragment(),s=[];if(e.mailto?s.push(r``):e.url?s.push(r`${n}`):s.push(r`${n}`),e.company&&(e.companyURL?s.push(r` (${e.company})`):s.push(r` (${e.company})`)),e.note&&s.push(document.createTextNode(` (${e.note})`)),e.extras){const t=e.extras.filter(e=>e.name&&e.name.trim()).map(a);for(const e of t)s.push(document.createTextNode(", "),e)}return hyperHTML.bind(o)`${s}`,i.appendChild(o),i}function a(e){const t=r``;let n=t;return e.href&&(n=r``,t.appendChild(n)),n.textContent=e.name,t}})}),define("w3c/templates/show-link",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0});const n=hyperHTML;function r(e){return n` -
            - ${e.href?n` - ${e.value||e.href} - `:""} -
            - `}e.default=(e=>{if(!e.key){const n="Found a link without `key` attribute in the configuration. See dev console.";return(0,t.pub)("warn",n),void console.warn("warn",n,e)}return n` -
            ${e.key}:
            - ${e.data?e.data.map(r):r(e)} - `})}),define("w3c/templates/cgbg-headers",["exports","./show-logo","./show-people","./show-link","deps/hyperhtml"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0});var i=s(t),o=s(n),a=s(r);function s(e){return e&&e.__esModule?e:{default:e}}e.default=(e=>{const t=hyperHTML;return t`
            - ${e.logos.map(i.default)} -

            ${e.title}

            - ${e.subtitle?t` -

            ${e.subtitle}

            - `:""} -

            ${e.longStatus}

            -
            - ${e.thisVersion?t` -
            ${e.l10n.this_version}
            -
            ${e.thisVersion}
            - `:""} - ${e.latestVersion?t` -
            ${e.l10n.latest_published_version}
            -
            ${e.latestVersion}
            - `:""} - ${e.edDraftURI?t` -
            ${e.l10n.latest_editors_draft}
            -
            ${e.edDraftURI}
            - `:""} - ${e.testSuiteURI?t` -
            Test suite:
            -
            ${e.testSuiteURI}
            - `:""} - ${e.implementationReportURI?t` -
            Implementation report:
            -
            ${e.implementationReportURI}
            - `:""} - ${e.bugTrackerHTML?t` -
            ${e.l10n.bug_tracker}
            -
            ${[e.bugTrackerHTML]}
            - `:""} - ${e.prevVersion?t` -
            Previous version:
            -
            ${e.prevVersion}
            - `:""} - ${e.isCGFinal?"":t` - ${e.prevED?t` -
            Previous editor's draft:
            -
            ${e.prevED}
            - `:""} - `} -
            ${e.multipleEditors?e.l10n.editors:e.l10n.editor}
            - ${(0,o.default)(e,"Editor",e.editors)} - ${Array.isArray(e.formerEditors)&&e.formerEditors.length>0?t` -
            ${e.multipleFormerEditors?e.l10n.former_editors:e.l10n.former_editor}
            - ${(0,o.default)(e,"Editor",e.formerEditors)} - `:""} - ${e.authors?t` -
            ${e.multipleAuthors?e.l10n.authors:e.l10n.author}
            - ${(0,o.default)(e,"Author",e.authors)} - `:""} - ${e.otherLinks?e.otherLinks.map(a.default):""} -
            - ${e.alternateFormats?t` -

            - ${e.multipleAlternates?"This document is also available in these non-normative formats:":"This document is also available in this non-normative format:"} - ${[e.alternatesHTML]} -

            - `:""} - -
            -
            `})}),define("oai/templates/show-logo",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const n=document.createElement("a");if(!e.alt){const e="Found spec logo without an `alt` attribute. See dev console.";n.classList.add("respec-offending-element"),(0,t.pub)("warn",e),console.warn("warn",e,n)}return n.href=e.url||"",n.classList.add("logo"),hyperHTML.bind(n)` - ${e.alt} - `,n.querySelector("img").src=e.src,n})}),define("oai/templates/show-people",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=((e,t,n=[])=>{const r=hyperHTML,i=[];for(let e=0;e`,o=document.createDocumentFragment(),s=[];if(e.mailto?s.push(r``):e.url?s.push(r`${n}`):s.push(r`${n}`),e.company&&(e.companyURL?s.push(r` (${e.company})`):s.push(r` (${e.company})`)),e.note&&s.push(document.createTextNode(` (${e.note})`)),e.extras){const t=e.extras.filter(e=>e.name&&e.name.trim()).map(a);for(const e of t)s.push(document.createTextNode(", "),e)}return hyperHTML.bind(o)`${s}`,i.appendChild(o),i}function a(e){const t=r``;let n=t;return e.href&&(n=r``,t.appendChild(n)),n.textContent=e.name,t}})}),define("oai/templates/show-link",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0});const n=hyperHTML;function r(e){return n` -
            - ${e.href?n` - ${e.value||e.href} - `:""} -
            - `}e.default=(e=>{if(!e.key){const n="Found a link without `key` attribute in the configuration. See dev console.";return(0,t.pub)("warn",n),void console.warn("warn",n,e)}return n` -
            ${e.key}:
            - ${e.data?e.data.map(r):r(e)} - `})}),define("oai/templates/headers",["exports","./show-logo","./show-people","./show-link","core/pubsubhub","deps/hyperhtml"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0});var o=l(t),a=l(n),s=l(r);function l(e){return e&&e.__esModule?e:{default:e}}e.default=(e=>{const t=hyperHTML;return t`
            - ${e.logos.map(o.default)} - ${function(e){const t=document.querySelector("h1#title")||document.createElement("h1");return t.parentElement?(t.remove(),e.title=t.textContent.trim()):(t.textContent=e.title,t.id="title"),t.classList.add("title","p-name"),null===document.querySelector("title")?document.title=e.title:document.title!==e.title&&(0,i.pub)("warn","The document's title and the `` element differ."),t}(e)} - ${function(e){let t=document.querySelector("h2#subtitle");return t&&t.parentElement?(t.remove(),e.subtitle=t.textContent.trim()):e.subtitle&&((t=document.createElement("h2")).textContent=e.subtitle,t.id="subtitle"),t&&t.classList.add("subtitle"),t}(e)} - <h2>${e.prependW3C?"W3C":""}${e.textStatus} <time class='dt-published' datetime='${e.dashDate}'>${e.publishHumanDate}</time></h2> - <dl> - ${e.isNoTrack?"":t` - <dt>${e.l10n.this_version}</dt> - <dd><a class='u-url' href='${e.thisVersion}'>${e.thisVersion}</a></dd> - <dt>${e.l10n.latest_published_version}</dt> - <dd>${e.latestVersion?t`<a href='${e.latestVersion}'>${e.latestVersion}</a>`:"none"}</dd> - `} - ${e.edDraftURI?t` - <dt>${e.l10n.latest_editors_draft}</dt> - <dd><a href='${e.edDraftURI}'>${e.edDraftURI}</a></dd> - `:""} - ${e.testSuiteURI?t` - <dt>Test suite:</dt> - <dd><a href='${e.testSuiteURI}'>${e.testSuiteURI}</a></dd> - `:""} - ${e.implementationReportURI?t` - <dt>Implementation report:</dt> - <dd><a href='${e.implementationReportURI}'>${e.implementationReportURI}</a></dd> - `:""} - ${e.bugTrackerHTML?t` - <dt>${e.l10n.bug_tracker}</dt> - <dd>${[e.bugTrackerHTML]}</dd> - `:""} - ${e.isED?t` - ${e.prevED?t` - <dt>Previous editor's draft:</dt> - <dd><a href='${e.prevED}'>${e.prevED}</a></dd> - `:""} - `:""} - ${e.showPreviousVersion?t` - <dt>Previous version:</dt> - <dd><a href='${e.prevVersion}'>${e.prevVersion}</a></dd> - `:""} - ${e.prevRecURI?t` - ${e.isRec?t` - <dt>Previous Recommendation:</dt> - <dd><a href='${e.prevRecURI}'>${e.prevRecURI}</a></dd> - `:t` - <dt>Latest Recommendation:</dt> - <dd><a href='${e.prevRecURI}'>${e.prevRecURI}</a></dd> - `} - `:""} - <dt>${e.multipleEditors?e.l10n.editors:e.l10n.editor}</dt> - ${(0,a.default)(e,"Editor",e.editors)} - ${Array.isArray(e.formerEditors)&&e.formerEditors.length>0?t` - <dt>${e.multipleFormerEditors?e.l10n.former_editors:e.l10n.former_editor}</dt> - ${(0,a.default)(e,"Editor",e.formerEditors)} - `:""} - ${e.authors?t` - <dt>${e.multipleAuthors?e.l10n.authors:e.l10n.author}</dt> - ${(0,a.default)(e,"Author",e.authors)} - `:""} - ${e.otherLinks?e.otherLinks.map(s.default):""} - </dl> - ${e.errata?t` - <p> - Please check the <a href="${e.errata}"><strong>errata</strong></a> for any errors or issues - reported since publication. - </p> - `:""} - ${e.isRec?t` - <p> - See also <a href="${`http://www.w3.org/2003/03/Translations/byTechnology?technology=${e.shortName}`}"> - <strong>translations</strong></a>. - </p> - `:""} - ${e.alternateFormats?t` - <p> - ${e.multipleAlternates?"This document is also available in these non-normative formats:":"This document is also available in this non-normative format:"} - ${[e.alternatesHTML]} - </p> - `:""} - ${e.isUnofficial?t` - ${e.additionalCopyrightHolders?t` - <p class='copyright'>${[e.additionalCopyrightHolders]}</p> - `:t` - ${e.overrideCopyright?[e.overrideCopyright]:t` - <p class='copyright'> - This document is licensed under a - <a class='subfoot' href='https://creativecommons.org/licenses/by/3.0/' rel='license'>Creative Commons - Attribution 3.0 License</a>. - </p> - `} - `} - `:t` - ${e.overrideCopyright?[e.overrideCopyright]:t` - <p class='copyright'> - Copyright © - ${e.copyrightStart?`${e.copyrightStart}-`:""}${e.publishYear} - ${e.additionalCopyrightHolders?t` ${[e.additionalCopyrightHolders]} `:""} - ${e.isCCBY?t` - Some Rights Reserved: this document is dual-licensed, - <a rel="license" href="https://creativecommons.org/licenses/by/3.0/">CC-BY</a> and - <a rel="license" href="https://www.w3.org/Consortium/Legal/copyright-documents">W3C Document License</a>. - `:""} - </p> - `} - `} - <hr title="Separator for header"> -</div>`})}),define("oai/headers",["exports","core/utils","handlebars.runtime","core/pubsubhub","templates","w3c/templates/cgbg-sotd","w3c/templates/sotd","w3c/templates/cgbg-headers","oai/templates/headers"],function(e,t,n,r,i,o,a,s,l){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){e.isUnofficial="unofficial"===e.specStatus,e.isUnofficial&&(e.logos=[]);if(e.license="apache2",e.isCCBY="cc-by"===e.license,e.isW3CSoftAndDocLicense="w3c-software-doc"===e.license,["cc-by"].includes(e.license)){let t=`You cannot use license "\`${e.license}\`" with W3C Specs. `;t+='Please set `respecConfig.license: "w3c-software-doc"` instead.',(0,r.pub)("error",t)}e.licenseInfo=k[e.license],e.isCGBG=w.includes(e.specStatus),e.isCGFinal=e.isCGBG&&/G-FINAL$/.test(e.specStatus),e.isBasic="base"===e.specStatus,e.isRegular=!e.isCGBG&&!e.isBasic,e.specStatus||(0,r.pub)("error","Missing required configuration: `specStatus`");e.isRegular&&!e.shortName&&(0,r.pub)("error","Missing required configuration: `shortName`");if(e.testSuiteURI){const t=new URL(e.testSuiteURI,document.location),{host:n,pathname:i}=t;if("github.com"===n&&i.startsWith("/w3c/web-platform-tests/")){const t="Web Platform Tests have moved to a new Github Organization at https://github.com/web-platform-tests. Please update your [`testSuiteURI`](https://github.com/w3c/respec/wiki/testSuiteURI) to point to the "+`new tests repository (e.g., https://github.com/web-platform-tests/${e.shortName} ).`;(0,r.pub)("warn",t)}}e.title=document.title||"No Title",e.subtitle||(e.subtitle="");if(e.publishDate=E(e,"publishDate",document.lastModified),e.publishYear=e.publishDate.getUTCFullYear(),e.publishHumanDate=f.format(e.publishDate),e.isNoTrack=v.includes(e.specStatus),e.isRecTrack=!e.noRecTrack&&y.includes(e.specStatus),e.isMemberSubmission="Member-SUBM"===e.specStatus,e.isMemberSubmission){const t={alt:"W3C Member Submission",href:"https://www.w3.org/Submission/",src:"https://www.w3.org/Icons/member_subm-v.svg",width:"211"};e.logos.push(p({},C,t))}if(e.isTeamSubmission="Team-SUBM"===e.specStatus,e.isTeamSubmission){const t={alt:"W3C Team Submission",href:"https://www.w3.org/TeamSubmission/",src:"https://www.w3.org/Icons/team_subm-v.svg",width:"211"};e.logos.push(p({},C,t))}e.isSubmission=e.isMemberSubmission||e.isTeamSubmission,e.anOrA=x.includes(e.specStatus)?"an":"a",e.isTagFinding="finding"===e.specStatus||"draft-finding"===e.specStatus,e.edDraftURI||(e.edDraftURI="","ED"===e.specStatus&&(0,r.pub)("warn","Editor's Drafts should set edDraftURI."));e.maturity=h[e.specStatus]?h[e.specStatus]:e.specStatus;var n="TR";"Member-SUBM"===e.specStatus?n="Submission":"Team-SUBM"===e.specStatus&&(n="TeamSubmission");e.isRegular&&(e.thisVersion="https://www.w3.org/"+n+"/"+e.publishDate.getUTCFullYear()+"/"+e.maturity+"-"+e.shortName+"-"+(0,t.concatDate)(e.publishDate)+"/");"ED"===e.specStatus&&(e.thisVersion=e.edDraftURI);e.isRegular&&(e.latestVersion="https://www.w3.org/"+n+"/"+e.shortName+"/");e.isTagFinding&&(e.latestVersion="https://www.w3.org/2001/tag/doc/"+e.shortName,e.thisVersion=e.latestVersion+"-"+t.ISODate.format(e.publishDate));if(e.previousPublishDate){e.previousMaturity||e.isTagFinding||(0,r.pub)("error","`previousPublishDate` is set, but not `previousMaturity`."),e.previousPublishDate=E(e,"previousPublishDate");var i=h[e.previousMaturity]?h[e.previousMaturity]:e.previousMaturity;e.isTagFinding?e.prevVersion=e.latestVersion+"-"+t.ISODate.format(e.previousPublishDate):e.isCGBG?e.prevVersion=e.prevVersion||"":e.isBasic?e.prevVersion="":e.prevVersion="https://www.w3.org/TR/"+e.previousPublishDate.getUTCFullYear()+"/"+i+"-"+e.shortName+"-"+(0,t.concatDate)(e.previousPublishDate)+"/"}else/NOTE$/.test(e.specStatus)||"FPWD"===e.specStatus||"FPLC"===e.specStatus||"ED"===e.specStatus||e.noRecTrack||e.isNoTrack||e.isSubmission||(0,r.pub)("error","Document on track but no previous version: Add `previousMaturity`, and `previousPublishDate` to ReSpec's config."),e.prevVersion||(e.prevVersion="");e.prevRecShortname&&!e.prevRecURI&&(e.prevRecURI="https://www.w3.org/TR/"+e.prevRecShortname);e.editors&&0!==e.editors.length||(0,r.pub)("error","At least one editor is required");var o=function(e){e.name||(0,r.pub)("error","All authors and editors must have a name.")};e.editors&&e.editors.forEach(o);e.formerEditors&&e.formerEditors.forEach(o);e.authors&&e.authors.forEach(o);e.multipleEditors=e.editors&&e.editors.length>1,e.multipleFormerEditors=Array.isArray(e.formerEditors)&&e.formerEditors.length>1,e.multipleAuthors=e.authors&&e.authors.length>1,$.each(e.alternateFormats||[],function(e,t){t.uri&&t.label||(0,r.pub)("error","All alternate formats must have a uri and a label.")}),e.multipleAlternates=e.alternateFormats&&e.alternateFormats.length>1,e.alternatesHTML=e.alternateFormats&&(0,t.joinAnd)(e.alternateFormats,function(e){var t=e.hasOwnProperty("lang")&&e.lang?" hreflang='"+e.lang+"'":"";return t+=e.hasOwnProperty("type")&&e.type?" type='"+e.type+"'":"","<a rel='alternate' href='"+e.uri+"'"+t+">"+e.label+"</a>"}),e.bugTracker&&(e.bugTracker.new&&e.bugTracker.open?e.bugTrackerHTML="<a href='"+e.bugTracker.new+"'>"+e.l10n.file_a_bug+"</a> "+e.l10n.open_parens+"<a href='"+e.bugTracker.open+"'>"+e.l10n.open_bugs+"</a>"+e.l10n.close_parens:e.bugTracker.open?e.bugTrackerHTML="<a href='"+e.bugTracker.open+"'>open bugs</a>":e.bugTracker.new&&(e.bugTrackerHTML="<a href='"+e.bugTracker.new+"'>file a bug</a>"));e.copyrightStart&&e.copyrightStart==e.publishYear&&(e.copyrightStart="");for(var a in g)b[a]||(b[a]=g[a]);e.longStatus=b[e.specStatus],e.textStatus=g[e.specStatus],m[e.specStatus]&&(e.rdfStatus=m[e.specStatus]);e.showThisVersion=!e.isNoTrack||e.isTagFinding,e.showPreviousVersion="FPWD"!==e.specStatus&&"FPLC"!==e.specStatus&&"ED"!==e.specStatus&&!e.isNoTrack&&!e.isSubmission,/NOTE$/.test(e.specStatus)&&!e.prevVersion&&(e.showPreviousVersion=!1);e.isTagFinding&&(e.showPreviousVersion=!!e.previousPublishDate);e.notYetRec=e.isRecTrack&&"REC"!==e.specStatus,e.isRec=e.isRecTrack&&"REC"===e.specStatus,e.isRec&&!e.errata&&(0,r.pub)("error","Recommendations must have an errata link.");e.notRec="REC"!==e.specStatus,e.prependW3C=!1,e.isED="ED"===e.specStatus,e.isCR="CR"===e.specStatus,e.isPR="PR"===e.specStatus,e.isPER="PER"===e.specStatus,e.isMO="MO"===e.specStatus,e.isNote=["FPWD-NOTE","WG-NOTE"].includes(e.specStatus),e.isIGNote="IG-NOTE"===e.specStatus,e.dashDate=t.ISODate.format(e.publishDate),e.publishISODate=e.publishDate.toISOString(),e.shortISODate=t.ISODate.format(e.publishDate),Object.defineProperty(e,"wgId",{get(){if(!this.hasOwnProperty("wgPatentURI"))return"";const e=this.wgPatentURI.split("/"),t=e.findIndex(e=>"pp-impl"===e)+1;return e[t]||""}});const s=(e.isCGBG?c.default:u.default)(e);document.body.insertBefore(s,document.body.firstChild),document.body.classList.add("h-entry");var l=document.getElementById("sotd")||document.createElement("section");!e.isCGBG&&e.isNoTrack&&!e.isTagFinding||l.id||(0,r.pub)("error","A custom SotD paragraph is required for your type of document.");l.id=l.id||"sotd",l.classList.add("introductory");var d=[e.wg,e.wgURI,e.wgPatentURI];d.some(e=>Array.isArray(e))&&!d.every(e=>Array.isArray(e))&&(0,r.pub)("error","If one of '`wg`', '`wgURI`', or '`wgPatentURI`' is an array, they all have to be.");e.isCGBG&&!e.wg&&(0,r.pub)("error","[`wg`](https://github.com/w3c/respec/wiki/wg) configuration option is required for this kind of document.");if(Array.isArray(e.wg)){e.multipleWGs=e.wg.length>1,e.wgHTML=(0,t.joinAnd)(e.wg,function(t,n){return"the <a href='"+e.wgURI[n]+"'>"+t+"</a>"});for(var T=[],S=0,A=e.wg.length;S<A;S++)T.push("a <a href='"+e.wgPatentURI[S]+"' rel='disclosure'>public list of any patent disclosures ("+e.wg[S]+")</a>");e.wgPatentHTML=(0,t.joinAnd)(T)}else e.multipleWGs=!1,e.wgHTML="the <a href='"+e.wgURI+"'>"+e.wg+"</a>";"PR"!==e.specStatus||e.crEnd||(0,r.pub)("error",'`specStatus` is "PR" but no `crEnd` is specified (needed to indicate end of previous CR).');"CR"!==e.specStatus||e.crEnd||(0,r.pub)("error",'`specStatus` is "CR", but no `crEnd` is specified in Respec config.');e.crEnd=E(e,"crEnd"),e.humanCREnd=f.format(e.crEnd),"PR"!==e.specStatus||e.prEnd||(0,r.pub)("error",'`specStatus` is "PR" but no `prEnd` is specified.');e.prEnd=E(e,"prEnd"),e.humanPREnd=f.format(e.prEnd),"PER"!==e.specStatus||e.perEnd||(0,r.pub)("error","Status is PER but no perEnd is specified");e.perEnd=E(e,"perEnd"),e.humanPEREnd=f.format(e.perEnd),e.recNotExpected=!!e.recNotExpected||!e.isRecTrack&&"WD"==e.maturity&&"FPWD-NOTE"!==e.specStatus,e.isIGNote&&!e.charterDisclosureURI&&(0,r.pub)("error","IG-NOTEs must link to charter's disclosure section using `charterDisclosureURI`.");""!==e.subjectPrefix&&(e.subjectPrefixEnc=encodeURIComponent(e.subjectPrefix));!e.implementationReportURI&&e.isCR&&(0,r.pub)("error","CR documents must have an [`implementationReportURI`](https://github.com/w3c/respec/wiki/implementationReportURI) that describes [implementation experience](https://www.w3.org/2018/Process-20180201/#implementation-experience).");!e.implementationReportURI&&e.isPR&&(0,r.pub)("warn","PR documents should include an [`implementationReportURI`](https://github.com/w3c/respec/wiki/implementationReportURI) that describes [implementation experience](https://www.w3.org/2018/Process-20180201/#implementation-experience).");e.isTagFinding&&!e.additionalContent&&(0,r.pub)("warn","ReSpec does not support automated SotD generation for TAG findings, please add the prerequisite content in the 'sotd' section");(0,r.pub)("amend-user-config",{publishISODate:e.publishISODate,generatedSubtitle:`${e.longStatus} ${e.publishHumanDate}`})};d(n),d(i),d(o),d(a);var c=d(s),u=d(l);function d(e){return e&&e.__esModule?e:{default:e}}var p=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="oai/headers";const f=new Intl.DateTimeFormat(["en-GB"],{timeZone:"UTC",year:"numeric",month:"long",day:"2-digit"}),h={FPWD:"WD",LC:"WD",FPLC:"WD","FPWD-NOTE":"NOTE","WD-NOTE":"WD","LC-NOTE":"LC","IG-NOTE":"NOTE","WG-NOTE":"NOTE"},m={NOTE:"w3p:NOTE",WD:"w3p:WD",LC:"w3p:LastCall",CR:"w3p:CR",PR:"w3p:PR",REC:"w3p:REC",PER:"w3p:PER",RSCND:"w3p:RSCND"},g={NOTE:"Working Group Note","WG-NOTE":"Working Group Note","CG-NOTE":"Co-ordination Group Note","IG-NOTE":"Interest Group Note","Member-SUBM":"Member Submission","Team-SUBM":"Team Submission",MO:"Member-Only Document",ED:"Editor's Draft",FPWD:"First Public Working Draft",WD:"Working Draft","FPWD-NOTE":"Working Group Note","WD-NOTE":"Working Draft","LC-NOTE":"Working Draft",FPLC:"First Public and Last Call Working Draft",LC:"Last Call Working Draft",CR:"Candidate Recommendation",PR:"Proposed Recommendation",PER:"Proposed Edited Recommendation",REC:"Recommendation",RSCND:"Rescinded Recommendation",unofficial:"Unofficial Draft",base:"Published",finding:"TAG Finding","draft-finding":"Draft TAG Finding","CG-DRAFT":"Draft Community Group Report","CG-FINAL":"Final Community Group Report","BG-DRAFT":"Draft Business Group Report","BG-FINAL":"Final Business Group Report"},b={"FPWD-NOTE":"First Public Working Group Note","LC-NOTE":"Last Call Working Draft"},y=["FPWD","WD","FPLC","LC","CR","PR","PER","REC"],v=["MO","unofficial","base","finding","draft-finding","CG-DRAFT","CG-FINAL","BG-DRAFT","BG-FINAL"],w=["CG-DRAFT","CG-FINAL","BG-DRAFT","BG-FINAL"],x=["ED","IG-NOTE"],k={cc0:{name:"Creative Commons 0 Public Domain Dedication",short:"CC0",url:"https://creativecommons.org/publicdomain/zero/1.0/"},"w3c-software":{name:"W3C Software Notice and License",short:"W3C Software",url:"https://www.w3.org/Consortium/Legal/2002/copyright-software-20021231"},"w3c-software-doc":{name:"W3C Software and Document Notice and License",short:"W3C Software and Document",url:"https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document"},apache2:{name:"Apache 2.0 License",short:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"},"cc-by":{name:"Creative Commons Attribution 4.0 International Public License",short:"CC-BY",url:"https://creativecommons.org/licenses/by/4.0/legalcode"}},C=Object.freeze({id:"",alt:"",href:"",src:"",height:"48",width:"72"});function E(e,n,i=new Date){const o=e[n]?new Date(e[n]):new Date(i);if(Number.isFinite(o.valueOf())){const e=t.ISODate.format(o);return new Date(e)}const a=`[\`${n}\`](https://github.com/w3c/respec/wiki/${n}) `+`is not a valid date: "${e[n]}". Expected format 'YYYY-MM-DD'.`;return(0,r.pub)("error",a),new Date(t.ISODate.format(new Date))}}),define("w3c/abstract",["exports","core/pubsubhub","core/l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(){const e=document.getElementById("abstract");if(!e)return void(0,t.pub)("error",'Document must have one element with `id="abstract"');e.classList.add("introductory");let r=document.querySelector("#abstract>h2");if(r)return;(r=document.createElement("h2")).innerText=n.l10n[n.lang].abstract,e.insertAdjacentElement("afterbegin",r)};e.name="w3c/abstract"}),define("w3c/templates/conformance",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(()=>{const e=hyperHTML;return e`<h2>Conformance</h2> -<p> - As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, - and notes in this specification are non-normative. Everything else in this specification is - normative. -</p> -<p id='respecRFC2119'> - to be interpreted as described in [[!RFC2119]]. -</p>`})}),define("w3c/conformance",["exports","w3c/templates/conformance","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,r){var o=$("#conformance");o.length&&o.prepend((0,i.default)(e).childNodes);(0,n.pub)("end","w3c/conformance"),r()};var r,i=(r=t)&&r.__esModule?r:{default:r};e.name="w3c/conformance"}),define("core/data-transform",["exports","core/utils"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){Array.from(n.querySelectorAll("[data-transform]")).forEach(e=>{e.innerHTML=(0,t.runTransforms)(e.innerHTML,e.dataset.transform),e.removeAttribute("data-transform")}),r()};e.name="core/data-transform"}),define("core/inlines",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){document.normalize(),e.normativeReferences||(e.normativeReferences=new Set);e.informativeReferences||(e.informativeReferences=new Set);e.respecRFC2119||(e.respecRFC2119={});const n=new Map;for(const e of Array.from(document.querySelectorAll("abbr[title]")))n.set(e.textContent,e.title);const r=[...n.keys()];r.sort((e,t)=>t.length-e.length);const i=r.length?`(?:\\b${r.join("\\b)|(?:\\b")}\\b)`:null,o=window.$.fn.allTextNodes.call([document.body],["pre"]),a=new RegExp("(\\bMUST(?:\\s+NOT)?\\b|\\bSHOULD(?:\\s+NOT)?\\b|\\bSHALL(?:\\s+NOT)?\\b|\\bMAY\\b|\\b(?:NOT\\s+)?REQUIRED\\b|\\b(?:NOT\\s+)?RECOMMENDED\\b|\\bOPTIONAL\\b|(?:\\[\\[(?:!|\\\\)?[A-Za-z0-9\\.-]+\\]\\])"+(i?`|${i}`:"")+")");for(const r of o){const i=r.data.split(a);if(1===i.length)continue;const o=document.createDocumentFragment();for(;i.length;){const a=i.shift();let s=null;if(i.length&&(s=i.shift()),o.appendChild(document.createTextNode(a)),s)if(/MUST(?:\s+NOT)?|SHOULD(?:\s+NOT)?|SHALL(?:\s+NOT)?|MAY|(?:NOT\s+)?REQUIRED|(?:NOT\s+)?RECOMMENDED|OPTIONAL/.test(s))s=s.split(/\s+/).join(" "),o.appendChild(hyperHTML`<em class="rfc2119" title="${s}">${s}</em>`),e.respecRFC2119[s]=!0;else if(/^\[\[/.test(s)){let t=s;if(0===(t=(t=t.replace(/^\[\[/,"")).replace(/\]\]$/,"")).indexOf("\\"))o.appendChild(document.createTextNode(`[[${t.replace(/^\\/,"")}]]`));else{let n=!1;0===t.indexOf("!")&&(n=!0,t=t.replace(/^!/,"")),n?e.normativeReferences.add(t):e.informativeReferences.add(t),o.appendChild(document.createTextNode("[")),o.appendChild(hyperHTML`<cite><a class="bibref" href="${`#bib-${t}`}">${t}</a></cite>`),o.appendChild(document.createTextNode("]"))}}else n.has(s)?"ABBR"===r.parentNode.tagName?o.appendChild(document.createTextNode(s)):o.appendChild(hyperHTML`<abbr title="${n.get(s)}">${s}</abbr>`):(0,t.pub)("error",`Found token '${s}' but it does not correspond to anything`)}r.parentNode.replaceChild(o,r)}};e.name="core/inlines"}),mta=this,nta=function(){var e=[],t=[],n={},r={},i={};function o(e){return"string"==typeof e?new RegExp("^"+e+"$","i"):e}function a(e,t){return e===t?t:e===e.toUpperCase()?t.toUpperCase():e[0]===e[0].toUpperCase()?t.charAt(0).toUpperCase()+t.substr(1).toLowerCase():t.toLowerCase()}function s(e,t){return e.replace(t[0],function(n,r){var i,o,s=(i=t[1],o=arguments,i.replace(/\$(\d{1,2})/g,function(e,t){return o[t]||""}));return a(""===n?e[r-1]:n,s)})}function l(e,t,r){if(!e.length||n.hasOwnProperty(e))return t;for(var i=r.length;i--;){var o=r[i];if(o[0].test(t))return s(t,o)}return t}function c(e,t,n){return function(r){var i=r.toLowerCase();return t.hasOwnProperty(i)?a(r,i):e.hasOwnProperty(i)?a(r,e[i]):l(i,r,n)}}function u(e,t,n,r){return function(r){var i=r.toLowerCase();return!!t.hasOwnProperty(i)||!e.hasOwnProperty(i)&&l(i,i,n)===i}}function d(e,t,n){var r=1===t?d.singular(e):d.plural(e);return(n?t+" ":"")+r}return d.plural=c(i,r,e),d.isPlural=u(i,r,e),d.singular=c(r,i,t),d.isSingular=u(r,i,t),d.addPluralRule=function(t,n){e.push([o(t),n])},d.addSingularRule=function(e,n){t.push([o(e),n])},d.addUncountableRule=function(e){"string"!=typeof e?(d.addPluralRule(e,"$0"),d.addSingularRule(e,"$0")):n[e.toLowerCase()]=!0},d.addIrregularRule=function(e,t){t=t.toLowerCase(),e=e.toLowerCase(),i[e]=t,r[t]=e},[["I","we"],["me","us"],["he","they"],["she","they"],["them","them"],["myself","ourselves"],["yourself","yourselves"],["itself","themselves"],["herself","themselves"],["himself","themselves"],["themself","themselves"],["is","are"],["was","were"],["has","have"],["this","these"],["that","those"],["echo","echoes"],["dingo","dingoes"],["volcano","volcanoes"],["tornado","tornadoes"],["torpedo","torpedoes"],["genus","genera"],["viscus","viscera"],["stigma","stigmata"],["stoma","stomata"],["dogma","dogmata"],["lemma","lemmata"],["schema","schemata"],["anathema","anathemata"],["ox","oxen"],["axe","axes"],["die","dice"],["yes","yeses"],["foot","feet"],["eave","eaves"],["goose","geese"],["tooth","teeth"],["quiz","quizzes"],["human","humans"],["proof","proofs"],["carve","carves"],["valve","valves"],["looey","looies"],["thief","thieves"],["groove","grooves"],["pickaxe","pickaxes"],["whiskey","whiskies"]].forEach(function(e){return d.addIrregularRule(e[0],e[1])}),[[/s?$/i,"s"],[/[^\u0000-\u007F]$/i,"$0"],[/([^aeiou]ese)$/i,"$1"],[/(ax|test)is$/i,"$1es"],[/(alias|[^aou]us|tlas|gas|ris)$/i,"$1es"],[/(e[mn]u)s?$/i,"$1s"],[/([^l]ias|[aeiou]las|[emjzr]as|[iu]am)$/i,"$1"],[/(alumn|syllab|octop|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i,"$1i"],[/(alumn|alg|vertebr)(?:a|ae)$/i,"$1ae"],[/(seraph|cherub)(?:im)?$/i,"$1im"],[/(her|at|gr)o$/i,"$1oes"],[/(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|automat|quor)(?:a|um)$/i,"$1a"],[/(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)(?:a|on)$/i,"$1a"],[/sis$/i,"ses"],[/(?:(kni|wi|li)fe|(ar|l|ea|eo|oa|hoo)f)$/i,"$1$2ves"],[/([^aeiouy]|qu)y$/i,"$1ies"],[/([^ch][ieo][ln])ey$/i,"$1ies"],[/(x|ch|ss|sh|zz)$/i,"$1es"],[/(matr|cod|mur|sil|vert|ind|append)(?:ix|ex)$/i,"$1ices"],[/(m|l)(?:ice|ouse)$/i,"$1ice"],[/(pe)(?:rson|ople)$/i,"$1ople"],[/(child)(?:ren)?$/i,"$1ren"],[/eaux$/i,"$0"],[/m[ae]n$/i,"men"],["thou","you"]].forEach(function(e){return d.addPluralRule(e[0],e[1])}),[[/s$/i,""],[/(ss)$/i,"$1"],[/(wi|kni|(?:after|half|high|low|mid|non|night|[^\w]|^)li)ves$/i,"$1fe"],[/(ar|(?:wo|[ae])l|[eo][ao])ves$/i,"$1f"],[/ies$/i,"y"],[/\b([pl]|zomb|(?:neck|cross)?t|coll|faer|food|gen|goon|group|lass|talk|goal|cut)ies$/i,"$1ie"],[/\b(mon|smil)ies$/i,"$1ey"],[/(m|l)ice$/i,"$1ouse"],[/(seraph|cherub)im$/i,"$1"],[/(x|ch|ss|sh|zz|tto|go|cho|alias|[^aou]us|tlas|gas|(?:her|at|gr)o|ris)(?:es)?$/i,"$1"],[/(analy|ba|diagno|parenthe|progno|synop|the|empha|cri)(?:sis|ses)$/i,"$1sis"],[/(movie|twelve|abuse|e[mn]u)s$/i,"$1"],[/(test)(?:is|es)$/i,"$1is"],[/(alumn|syllab|octop|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i,"$1us"],[/(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|quor)a$/i,"$1um"],[/(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)a$/i,"$1on"],[/(alumn|alg|vertebr)ae$/i,"$1a"],[/(cod|mur|sil|vert|ind)ices$/i,"$1ex"],[/(matr|append)ices$/i,"$1ix"],[/(pe)(rson|ople)$/i,"$1rson"],[/(child)ren$/i,"$1"],[/(eau)x?$/i,"$1"],[/men$/i,"man"]].forEach(function(e){return d.addSingularRule(e[0],e[1])}),["adulthood","advice","agenda","aid","alcohol","ammo","anime","athletics","audio","bison","blood","bream","buffalo","butter","carp","cash","chassis","chess","clothing","cod","commerce","cooperation","corps","debris","diabetes","digestion","elk","energy","equipment","excretion","expertise","flounder","fun","gallows","garbage","graffiti","headquarters","health","herpes","highjinks","homework","housework","information","jeans","justice","kudos","labour","literature","machinery","mackerel","mail","media","mews","moose","music","manga","news","pike","plankton","pliers","pollution","premises","rain","research","rice","salmon","scissors","series","sewage","shambles","shrimp","species","staff","swine","tennis","traffic","transporation","trout","tuna","wealth","welfare","whiting","wildebeest","wildlife","you",/[^aeiou]ese$/i,/deer$/i,/fish$/i,/measles$/i,/o[iu]s$/i,/pox$/i,/sheep$/i].forEach(d.addUncountableRule),d},"function"==typeof require&&"object"==typeof exports&&"object"==typeof module?module.exports=nta():"function"==typeof define&&define.amd?define("deps/pluralize",[],function(){return nta()}):mta.pluralize=nta(),define("core/dfn",["exports","deps/pluralize","core/utils"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){e.hasOwnProperty("definitionMap")||(e.definitionMap=Object.create(null));let r;!0===e.pluralize&&(r=function(){const e=new Set;document.querySelectorAll("a:not([href])").forEach(t=>{const r=(0,n.norm)(t.textContent).toLowerCase();e.add(r),t.dataset.lt&&e.add(t.dataset.lt)});const r=new Set;return document.querySelectorAll("dfn:not([data-lt-noDefault])").forEach(e=>{const t=(0,n.norm)(e.textContent).toLowerCase();r.add(t),e.dataset.lt&&e.dataset.lt.split("|").reduce((e,t)=>e.add(t),r)}),function(n){const i=(0,t.plural)(n);return e.has(i)&&!r.has(i)?i:""}}());document.querySelectorAll("dfn").forEach(t=>{const i=t.closest("[data-dfn-for]");i&&i!==t&&!t.dataset.dfnFor&&(t.dataset.dfnFor=i.dataset.dfnFor),t.dataset.dfnFor&&(t.dataset.dfnFor=t.dataset.dfnFor.toLowerCase());const o=$(t),a=o.getDfnTitles({isDefinition:!0});if(r&&!t.hasAttribute("data-lt-no-plural")&&!t.hasAttribute("data-lt-noDefault")){const e=(0,n.norm)(t.textContent).toLowerCase(),i=r(e);i&&(a[0]===e?a.unshift(i):a.push(i),t.dataset.lt=a.filter(t=>t!==e).join("|"))}a.map(t=>(e.definitionMap[t]||(e.definitionMap[t]=[]),e.definitionMap[t])).reduce((e,t)=>(t.push(e),e),o)})};e.name="core/dfn"}),define("w3c/rfc2119",["exports","core/utils"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){const i=n.getElementById("respecRFC2119");if(!i)return r();const o=Object.getOwnPropertyNames(e.respecRFC2119);if(0===o.length)return i.remove(),r();const a=(0,t.joinAnd)(o.sort(),e=>`<em class="rfc2119">${e}</em>`),s=o.length>1,l=`The key word${s?"s ":" "} ${a} ${s?"are":"is"} ${i.innerHTML}`;i.innerHTML=l,r()};e.name="w3c/rfc2119"}),define("deps/text!core/css/examples.css",[],function(){return"/* --- EXAMPLES --- */\ndiv.example-title {\n min-width: 7.5em;\n color: #b9ab2d;\n}\ndiv.example-title span {\n text-transform: uppercase;\n}\naside.example, div.example, div.illegal-example {\n padding: 0.5em;\n margin: 1em 0;\n position: relative;\n clear: both;\n}\ndiv.illegal-example { color: red }\ndiv.illegal-example p { color: black }\naside.example, div.example {\n padding: .5em;\n border-left-width: .5em;\n border-left-style: solid;\n border-color: #e0cb52;\n background: #fcfaee;\n}\n\naside.example div.example {\n border-left-width: .1em;\n border-color: #999;\n background: #fff;\n}\naside.example div.example div.example-title {\n color: #999;\n}\n"}),define("core/examples",["exports","core/pubsubhub","deps/text!core/css/examples.css"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){var a=$("pre.example, pre.illegal-example, aside.example"),s=0;a.length&&($(n).find("head link").first().before($("<style/>").text(i.default)),a.each(function(n,r){var i=$(r),a={number:s,illegal:i.hasClass("illegal-example")};if(i.is("aside")){var l=o(e,i,++s,a);i.prepend(l),(0,t.pub)("example",a)}else{var c=!!i.parents("aside").length;c||s++;for(var u=i.html().split("\n");u.length&&/^\s*$/.test(u[0]);)u.shift();for(;u.length&&/^\s*$/.test(u[u.length-1]);)u.pop();var d=/^(\s+)/.exec(u[0]);if(d)for(var p=new RegExp("^"+d[1]),f=0;f<u.length;f++)u[f]=u[f].replace(p,"");a.content=u.join("\n"),i.html(u.join("\n")),i.removeClass("example illegal-example");var h=$("<div class='example'></div>"),l=o(e,i,c?0:s,a);h.append(l),h.append(i.clone()),i.replaceWith(h),c||(0,t.pub)("example",a)}}));r()};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/examples";var o=function(e,t,n,r){var i=n>0?" "+n:"",o=$(`<div class='example-title'><span>${e.l10n.example}${i}</span></div>`);return r.title=t.attr("title"),r.title&&(o.append($("<span style='text-transform: none'>: "+r.title+"</span>")),t.removeAttr("title")),o.addClass("marker"),o}}),define("deps/text!core/css/issues-notes.css",[],function(){return'/* --- ISSUES/NOTES --- */\ndiv.issue-title, div.note-title , div.ednote-title, div.warning-title {\n padding-right: 1em;\n min-width: 7.5em;\n color: #b9ab2d;\n}\ndiv.issue-title { color: #e05252; }\ndiv.note-title, div.ednote-title { color: #2b2; }\ndiv.warning-title { color: #f22; }\ndiv.issue-title span, div.note-title span, div.ednote-title span, div.warning-title span {\n text-transform: uppercase;\n}\ndiv.note, div.issue, div.ednote, div.warning {\n margin-top: 1em;\n margin-bottom: 1em;\n}\n.note > p:first-child, .ednote > p:first-child, .issue > p:first-child, .warning > p:first-child { margin-top: 0 }\n.issue, .note, .ednote, .warning {\n padding: .5em;\n border-left-width: .5em;\n border-left-style: solid;\n}\ndiv.issue, div.note , div.ednote, div.warning {\n padding: 1em 1.2em 0.5em;\n margin: 1em 0;\n position: relative;\n clear: both;\n}\nspan.note, span.ednote, span.issue, span.warning { padding: .1em .5em .15em; }\n\n.issue {\n border-color: #e05252;\n background: #fbe9e9;\n}\n.note, .ednote {\n border-color: #52e052;\n background: #e9fbe9;\n}\n\n.warning {\n border-color: #f11;\n border-width: .2em;\n border-style: solid;\n background: #fbe9e9;\n}\n\n.warning-title:before{\n content: "⚠"; /*U+26A0 WARNING SIGN*/\n font-size: 3em;\n float: left;\n height: 100%;\n padding-right: .3em;\n vertical-align: top;\n margin-top: -0.5em;\n}\n\nli.task-list-item {\n list-style: none;\n}\n\ninput.task-list-item-checkbox {\n margin: 0 0.35em 0.25em -1.6em;\n vertical-align: middle;\n}\n\n.issue a.respec-gh-label {\n padding: 5px;\n margin: 0 2px 0 2px;\n font-size: 10px;\n text-transform: none;\n text-decoration: none;\n font-weight: bold;\n border-radius: 4px;\n position: relative;\n bottom: 2px;\n}\n\n.issue a.respec-label-dark {\n color: #fff;\n background-color: #000;\n}\n\n.issue a.respec-label-light {\n color: #000;\n background-color: #fff;\n}\n'}),define("core/issues-notes",["exports","core/pubsubhub","deps/text!core/css/issues-notes.css","core/utils","deps/hyperhtml"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){const n=document.querySelectorAll(".issue, .note, .warning, .ednote");if(!n.length)return;const i=e.githubAPI?await async function(e){const{githubAPI:n,githubUser:i,githubToken:o}=e,a=document.querySelectorAll(".issue[data-number]");if(a.length>s){const e=`Your spec contains ${a.length} Github issues, `+`but GitHub only allows ${s} requests. Some issues might not show up.`;(0,t.pub)("warning",e)}const l=[...a].map(e=>Number.parseInt(e.dataset.number,10)).filter(e=>e).map(async e=>{const a=`${n}/issues/${e}`,s={Accept:"application/vnd.github.v3.html+json"};if(i&&o){const e=btoa(`${i}:${o}`),t=`Basic ${e}`;Object.assign(s,{Authorization:t})}const l=new Request(a,{headers:s}),c=await(0,r.fetchAndCache)(l);return async function(e,n){const r={title:"",number:n,state:"",message:""};try{const t=await e.json();Object.assign(r,t)}catch(e){r.message=`Error JSON parsing issue #${n} from GitHub.`}if(!e.ok||r.message){const i=`Error fetching issue #${n} from GitHub. ${r.message} (HTTP Status ${e.status}).`;(0,t.pub)("error",i)}return[n,r]}(c,e)}),c=await Promise.all(l);return new Map(c)}(e):new Map,{head:c}=document;c.insertBefore(hyperHTML`<style>${[o.default]}</style>`,c.querySelector("link")),function(e,n,r){const i=$(e),{issueBase:o,githubAPI:s}=r;var c=!!document.querySelector(".issue[data-number]"),u=0,d=$("<div><h2>"+r.l10n.issue_summary+"</h2><ul></ul></div>"),p=d.find("ul");s&&Array.from(i).filter(({dataset:{number:e}})=>void 0!==e&&"closed"===n.get(Number(e)).state).forEach(e=>{const{dataset:{number:n}}=e,r=`Github issue ${n} was closed on GitHub, so removing from spec`;(0,t.pub)("warn",r),e.remove()});i.filter((e,t)=>t.parentNode).each(function(e,i){var d=$(i),f=d.hasClass("issue"),h=d.hasClass("warning"),m=d.hasClass("ednote"),g=d.hasClass("atrisk"),b="span"===d[0].localName,y=d.attr("data-number"),v={inline:b};if(v.type=f?"issue":h?"warning":m?"ednote":"note",!f||b||c?y&&(v.number=y):(u++,v.number=u),!b){var w,x=$("<div class='"+v.type+(g?" atrisk":"")+"'></div>"),k=$("<div role='heading' class='"+v.type+"-title'><span></span></div>"),C=f?g?r.l10n.feature_at_risk:r.l10n.issue:h?r.l10n.warning:m?r.l10n.editors_note:r.l10n.note;if(i.id?(x[0].id=i.id,i.removeAttribute("id")):x.makeID("issue-container",v.number?`number-${v.number}`:""),k.makeID("h",v.type),v.title=d.attr("title"),f&&(c?y&&(C+=" "+y,!g&&o?k.find("span").wrap($("<a href='"+o+y+"'/>")):g&&r.atRiskBase&&k.find("span").wrap($("<a href='"+r.atRiskBase+y+"'/>")),(w=n.get(Number(y)))&&!v.title&&(v.title=w.title)):C+=" "+u,void 0!==v.number)){var E=$("<li><a></a></li>");E.find("a").attr("href","#"+x[0].id).text(r.l10n.issue+" "+v.number),v.title&&E.append($("<span style='text-transform: none'>: "+v.title+"</span>")),p.append(E)}if(k.find("span").text(C),w&&v.title&&s){const e=Array.from(w.labels).map(e=>{const t=new URL("issues/",r.github.repoURL+"/");return t.searchParams.set("q",`is:issue is:open label:"${e.name}"`),a({},e,{href:t.href})}).map(l).reduce((e,t)=>(e.appendChild(t),e),document.createDocumentFragment());k.append($("<span style='text-transform: none'>: "+v.title+"</span>").append(e)),d.removeAttr("title")}else v.title&&(k.append($("<span style='text-transform: none'>: "+v.title+"</span>")),d.removeAttr("title"));k.addClass("marker"),x.append(k),d.replaceWith(x);var T=d.removeClass(v.type).removeAttr("data-number");w&&!T.text().trim()&&(T=w.body_html),x.append(T);const e=k.parents("section").length+2;k.attr("aria-level",e)}(0,t.pub)(v.type,v)}),$(".issue").length?$("#issue-summary")&&$("#issue-summary").append(d.contents()):$("#issue-summary").length&&((0,t.pub)("warn","Using issue summary (#issue-summary) but no issues found."),$("#issue-summary").remove())}(n,i,e)};var i,o=(i=n)&&i.__esModule?i:{default:i};var a=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="core/issues-notes";const s=60;function l(e){const{color:t,href:n,name:r}=e,i=parseInt(t,16);var o;return hyperHTML`<a - class="${`respec-gh-label respec-label-${isNaN(i)||.2126*((o=i)>>16&255)+.7152*(o>>8&255)+.0722*(o>>0&255)>140?"light":"dark"}`}" - style="${`background-color: #${t}`}" - href="${n}">${r}</a>`}}),define("core/requirements",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){$(".req").each(function(e){e++;var t=$(this),n="Req. "+e;t.prepend("<a href='#"+t.attr("id")+"'>"+n+"</a>: ")}),$("a.reqRef").each(function(){var e,n,r,i=$(this),o=i.attr("href");o&&(e=o.substring(1),(n=$("#"+e)).length?r=n.find("> a").text():(r="Req. not found '"+e+"'",(0,t.pub)("error","Requirement not found in element `a.reqRef`: "+e)),i.text(r))}),r()};e.name="core/requirements"}),define("deps/text!core/css/bp.css",[],function(){return"/* --- Best Practices --- */\ndiv.practice {\n border: solid #bebebe 1px;\n margin: 2em 1em 1em 2em;\n}\n\nspan.practicelab {\n margin: 1.5em 0.5em 1em 1em;\n font-weight: bold;\n font-style: italic;\n background: #dfffff;\n position: relative;\n padding: 0 0.5em;\n top: -1.5em;\n}\n\np.practicedesc {\n margin: 1.5em 0.5em 1em 1em;\n}\n\n@media screen {\n p.practicedesc {\n position: relative;\n top: -2em;\n padding: 0;\n margin: 1.5em 0.5em -1em 1em;\n }\n}\n"}),define("core/best-practices",["exports","deps/text!core/css/bp.css","core/pubsubhub","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(){let e=0;const t=document.querySelectorAll("span.practicelab"),r=document.createElement("ul");for(const n of Array.from(t)){e++;const t=window.$.fn.makeID.call([n],"bp"),i=hyperHTML`<li><a href="${`#${t}`}">Best Practice ${e}</a>: ${n.textContent}</li>`;r.appendChild(i),n.insertBefore(document.createTextNode(`Best Practice ${e}: `),n.firstChild)}const o=document.getElementById("bp-summary");t.length?(document.head.insertBefore(hyperHTML`<style>${[i.default]}</style>`,document.head.querySelector("link")),o&&(o.appendChild(hyperHTML`<h2>Best Practices Summary</h2>`),o.appendChild(r))):o&&((0,n.pub)("warn","Using best practices summary (#bp-summary) but no best practices found."),o.remove())};var r,i=(r=t)&&r.__esModule?r:{default:r};e.name="core/best-practices"}),define("core/figures",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){i=n,[...i.querySelectorAll(":not(picture)>img:not([width]):not([height]):not([srcset])")].forEach(e=>{e.height=e.naturalHeight,e.width=e.naturalWidth});var i;var o={},a=[],s=0;$("figure").each(function(){var r=$(this),i=r.find("figcaption"),l=i.text(),c=r.makeID("fig",l);i.length||(0,t.pub)("warn","A `<figure>` should contain a `<figcaption>`."),s++,i.wrapInner($("<span class='fig-title'/>")).prepend(n.createTextNode(" ")).prepend($("<span class='figno'>"+s+"</span>")).prepend(n.createTextNode(e.l10n.fig)),o[c]=i.contents();var u=i.clone();u.find("a").renameElement("span").removeAttr("href"),a.push($("<li class='tofline'><a class='tocxref' href='#"+c+"'></a></li>").find(".tocxref").append(u.contents()).end())}),$("a[href]",n).each(function(){var e=$(this),t=e.attr("href");if(t&&(t=t.substring(1),o[t]&&(e.addClass("fig-ref"),""===e.html()))){const n=o[t].slice(0,2).clone();if(!e[0].hasAttribute("title")){const n=o[t].slice(2).clone().text();e.attr("title",n.trim())}e.append(n)}});var l=$("#tof",n);if(a.length&&l.length){l.hasClass("appendix")||l.hasClass("introductory")||l.parents("section").length||(l.prevAll("section.introductory").length===l.prevAll("section").length?l.addClass("introductory"):l.prevAll("appendix").length&&l.addClass("appendix")),l.append($("<h2>"+e.l10n.table_of_fig+"</h2>")),l.append($("<ul class='tof'/>"));for(var c=l.find("ul");a.length;)c.append(a.shift())}r()};e.name="core/figures"}),(()=>{const e={float:/-?(?=[0-9]*\.|[0-9]+[eE])(([0-9]+\.[0-9]*|[0-9]*\.[0-9]+)([Ee][-+]?[0-9]+)?|[0-9]+[Ee][-+]?[0-9]+)/y,integer:/-?(0([Xx][0-9A-Fa-f]+|[0-7]*)|[1-9][0-9]*)/y,identifier:/[A-Z_a-z][0-9A-Z_a-z-]*/y,string:/"[^"]*"/y,whitespace:/[\t\n\r ]+/y,comment:/((\/(\/.*|\*([^*]|\*[^\/])*\*\/)[\t\n\r ]*)+)/y,other:/[^\t\n\r 0-9A-Z_a-z]/y};function t(t,n,r,i){const o=e[n];o.lastIndex=r;const a=o.exec(t);return a?(i.push({type:n,value:a[0]}),o.lastIndex):-1}class n{constructor(e,t,n,r){this.message=e,this.line=t,this.input=n,this.tokens=r}toString(){return`${this.message}, line ${this.line} (tokens: '${this.input}')\n${JSON.stringify(this.tokens,null,4)}`}}function r(e,t){let r=1;e=e.slice();const i=new Map;let o=null;const a="float",s="integer",l="identifier",c="string",u="other",d=Object.freeze({type:"operation",getter:!1,setter:!1,deleter:!1,static:!1,stringifier:!1}),p=Object.freeze({sequence:!1,generic:null,nullable:!1,union:!1,idlType:null,extAttrs:[]});function f(t){let i="",a=0;for(;a<5&&e.length>a;)i+=e[a].value,a++;let s;throw s=o?`Got an error during or right after parsing \`${o.partial?"partial ":""}${o.type} ${o.name}\`: ${t}`:`Got an error before parsing any named definition: ${t}`,new n(s,r,i,e.slice(0,5))}function h(e,t){return i.has(e)&&f(`The name "${e}" of type "${i.get(e)}" is already seen`),i.set(e,t),e}let m=null;function g(t,n){if(e.length&&e[0].type===t)return void 0===n||e[0].value===n?(m=e.shift(),t===l&&m.value.startsWith("_")&&(m.value=m.value.substring(1)),m):void 0}function b(){if(e.length&&("whitespace"===e[0].type||"comment"===e[0].type)){const t=e.shift();return r+=function(e,t){let n=0;for(let r=e.indexOf(t);-1!==r;r=e.indexOf(t,r+1))++n;return n}(t.value,"\n"),t}}const y={ws:/([\t\n\r ]+)/y,"line-comment":/\/\/(.*)\r?\n?/y,"multiline-comment":/\/\*((?:[^*]|\*[^/])*)\*\//y};function v(e,t){const n={type:"whitespace",value:""};for(;;){const e=b();if(!e)break;n.value+=e.value}if(n.value.length>0){if(e){let r=n.value,i=0;for(;i<r.length;){let n=!1;for(let o in y){const a=y[o];a.lastIndex=i;const s=a.exec(r);if(s){e.push({type:o+(t?"-"+t:""),value:s[1]}),n=!0,i=a.lastIndex;break}}if(!n)throw new Error("Surprising white space construct.")}}return n}}function w(){const e=function(){let e="";return v(),g(l,"unsigned")&&(e="unsigned "),v(),g(l,"short")?e+"short":g(l,"long")?(e+="long",v(),g(l,"long")?e+" long":e):void(e&&f("Failed to parse integer type"))}()||function(){let e="";return v(),g(l,"unrestricted")&&(e="unrestricted "),v(),g(l,"float")?e+"float":g(l,"double")?e+"double":void(e&&f("Failed to parse float type"))}();return e||(v(),g(l,"boolean")?"boolean":g(l,"byte")?"byte":g(l,"octet")?"octet":void 0)}function x(){if(g(l,"true"))return{type:"boolean",value:!0};if(g(l,"false"))return{type:"boolean",value:!1};if(g(l,"null"))return{type:"null"};if(g(l,"Infinity"))return{type:"Infinity",negative:!1};if(g(l,"NaN"))return{type:"NaN"};const t=g(a)||g(s);if(t)return{type:"number",value:t.value};const n=g(u,"-");if(n){if(g(l,"Infinity"))return{type:"Infinity",negative:!0};e.unshift(n)}}function k(e){for(;;){if(v(),!g(u,"?"))return;e.nullable&&f("Can't nullable more than once"),e.nullable=!0}}function C(e){const t=w(),n=Object.assign({type:e||null},p);let r,i;if(t)n.idlType=t;else{if(!(r=g(l)))return;if(i=r.value,v(),g(u,"<")){"sequence"===i&&(n.sequence=!0),n.generic=i;const t=[];do{v(),t.push($(e)||f("Error parsing generic type "+i)),v()}while(g(u,","));return"sequence"===i?1!==t.length&&f("A sequence must have exactly one subtype"):"record"===i?(2!==t.length&&f("A record must have exactly two subtypes"),/^(DOMString|USVString|ByteString)$/.test(t[0].idlType)||f("Record key must be DOMString, USVString, or ByteString"),t[0].extAttrs.length&&f("Record key cannot have extended attribute")):"Promise"===i&&t[0].extAttrs.length&&f("Promise type cannot have extended attribute"),n.idlType=1===t.length?t[0]:t,v(),g(u,">")||f("Unterminated generic type "+i),k(n),n}n.idlType=i}return k(n),n.nullable&&"any"===n.idlType&&f("Type any cannot be made nullable"),n}function E(e){if(v(),!g(u,"("))return;const t=Object.assign({type:e||null},p,{union:!0,idlType:[]}),n=$()||f("Union type with no content");for(t.idlType.push(n);v(),g(l,"or");){const e=$()||f("No type after 'or' in union type");t.idlType.push(e)}return g(u,")")||f("Unterminated union type"),k(t),t}function $(e){const t=L(),n=C(e)||E(e);return t.length&&n&&(n.extAttrs=t),n}function T(t){const n={optional:!1,variadic:!1};n.extAttrs=L(t),v(t,"pea");const r=g(l,"optional");if(r&&(n.optional=!0,v()),n.idlType=$("argument-type"),!n.idlType)return void(r&&e.unshift(r));const i=m;n.optional||(v(),e.length>=3&&"other"===e[0].type&&"."===e[0].value&&"other"===e[1].type&&"."===e[1].value&&"other"===e[2].type&&"."===e[2].value&&(e.shift(),e.shift(),e.shift(),n.variadic=!0)),v();const o=g(l);if(!o)return r&&e.unshift(r),void e.unshift(i);if(n.name=o.value,n.optional){v();const e=j();void 0!==e&&(n.default=e)}return n}function S(e){const t=[],n=T(e?t:null);if(!n)return t;for(t.push(n);;){if(v(e?t:null),!g(u,","))return t;const n=T(e?t:null)||f("Trailing comma in arguments list");t.push(n)}}function A(e){v();const t=g(l);if(!t)return;const n={name:t.value,arguments:null,type:"extended-attribute",rhs:null};v();const r=g(u,"=");return r&&(v(),n.rhs=g(l)||g(a)||g(s)||g(c)),v(),g(u,"(")&&(r&&!n.rhs?n.rhs={type:"identifier-list",value:function(){const e=[],t=g(l);t?e.push(t.value):f("Expected identifiers but not found");for(;v(),g(u,",");){v();const t=g(l)||f("Trailing comma in identifiers list");e.push(t.value)}return e}()}:n.arguments=S(e),v(),g(u,")")||f("Unexpected token in extended attribute argument list")),r&&!n.rhs&&f("No right hand side to extended attribute assignment"),n}function L(e){const t=[];if(v(e),!g(u,"["))return t;for(t[0]=A(e)||f("Extended attribute with not content"),v();g(u,",");)t.push(A(e)||f("Trailing comma in extended attribute"));return v(),g(u,"]")||f("No end of extended attribute"),t}function j(){if(v(),g(u,"=")){v();const e=x();if(e)return e;if(g(u,"["))return g(u,"]")||f("Default sequence value must be empty"),{type:"sequence",value:[]};{const e=g(c)||f("No value for default");return e.value=e.value.slice(1,-1),e}}}function D(e){if(v(e,"pea"),!g(l,"const"))return;const t={type:"const",nullable:!1};v();let n=w();n||(n=(n=g(l)||f("No type for const")).value),t.idlType=Object.assign({type:"const-type"},p,{idlType:n}),v(),g(u,"?")&&(t.nullable=!0,v());const r=g(l)||f("No name for const");t.name=r.value,v(),g(u,"=")||f("No value assignment for const"),v();const i=x();return i?t.value=i:f("No value for const"),v(),g(u,";")||f("Unterminated const"),t}function _(){if(v(),g(u,":"))return v(),(g(l)||f("No type in inheritance")).value}function N(e,t){v(),e||(e={});const n=g(l);return e.name=n?n.value:null,v(),g(u,"(")||f("Invalid operation"),e.arguments=S(t),v(),g(u,")")||f("Unterminated operation"),v(),g(u,";")||f("Unterminated operation"),e}function R(t){v(t,"pea");const n=[],r={type:"attribute",static:!1,stringifier:!1,inherit:!1,readonly:!1},i=v();if(i&&n.push(i),g(l,"inherit")){(r.static||r.stringifier)&&f("Cannot have a static or stringifier inherit"),r.inherit=!0,n.push(m);const e=v();e&&n.push(e)}if(g(l,"readonly")){r.readonly=!0,n.push(m);const e=v();e&&n.push(e)}const o=P(r);return o||(e=n.concat(e)),o}function P(e){if(!g(l,"attribute"))return;v(),e.idlType=$("attribute-type")||f("No type in attribute"),e.idlType.sequence&&f("Attributes cannot accept sequence types"),"record"===e.idlType.generic&&f("Attributes cannot accept record types"),v();const t=g(l)||f("No name in attribute");return e.name=t.value,v(),g(u,";")||f("Unterminated attribute"),e}function M(){const e=C(t="return-type")||E(t);var t;if(!e){if(g(l,"void"))return"void";f("No return type")}return e}function O(e){v(e,"pea");const t=Object.assign({},d);for(;;)if(v(),g(l,"getter"))t.getter=!0;else if(g(l,"setter"))t.setter=!0;else{if(!g(l,"deleter"))break;t.deleter=!0}return t.getter||t.setter||t.deleter?(v(),t.idlType=M(),N(t,e),t):(t.idlType=M(),v(),N(t,e),t)}function I(e){if(v(e,"pea"),g(l,"static"))return v(),G(e,"static")||V(e,"static")||f("No body in static member")}function q(e){if(v(e,"pea"),g(l,"stringifier"))return v(),g(u,";")?Object.assign({},d,{stringifier:!0}):G(e,"stringifier")||V(e,"stringifier")||f("Unterminated stringifier")}function U(){return g(l,"iterable")?"iterable":g(l,"legacyiterable")?"legacyiterable":g(l,"maplike")?"maplike":g(l,"setlike")?"setlike":void 0}function W(){return g(l,"maplike")?"maplike":g(l,"setlike")?"setlike":void 0}function H(t){v(t,"pea");const n=[],r={type:null,idlType:null,readonly:!1};if(g(l,"readonly")){r.readonly=!0,n.push(m);var i=v();i&&n.push(i)}const o=(r.readonly?W:U)();if(!o)return void(e=n.concat(e));const a="maplike"===o,s=a||"iterable"===o;return r.type=o,"maplike"!==r.type&&"setlike"!==r.type&&delete r.readonly,v(),g(u,"<")?(r.idlType=[$()]||f(`Error parsing ${o} declaration`),v(),s&&(g(u,",")?(v(),r.idlType.push($()),v()):a&&f(`Missing second type argument in ${o} declaration`)),g(u,">")||f(`Unterminated ${o} declaration`),v(),g(u,";")||f(`Missing semicolon after ${o} declaration`)):f(`Error parsing ${o} declaration`),r}function B(e,n,r="interface"){v();const i=g(l)||f("No name for interface"),a=[],s=o={type:r,name:e?i.value:h(i.value,"interface"),partial:e,members:a};for(e||(s.inheritance=_()||null),v(),g(u,"{")||f("Bodyless interface");;){if(v(n?a:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after interface"),s;const e=L(n?a:null);v();const r=D(n?a:null);if(r){r.extAttrs=e,s.members.push(r);continue}const i=t.allowNestedTypedefs&&Z(n?a:null)||I(n?a:null)||q(n?a:null)||H(n?a:null)||R(n?a:null)||O(n?a:null)||f("Unknown member");i.extAttrs=e,s.members.push(i)}}function F(e,t){if(v(e?null:t,"pea"),g(l,"interface"))return function(e,t){if(v(),!g(l,"mixin"))return;v();const n=g(l)||f("No name for interface mixin"),r=[],i=o={type:"interface mixin",name:e?n.value:h(n.value,"interface mixin"),partial:e,members:r};for(v(),g(u,"{")||f("Bodyless interface mixin");;){if(v(t?r:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after interface mixin"),i;const e=L(t?r:null);v();const n=D(t?r:null);if(n){n.extAttrs=e,i.members.push(n);continue}const o=q(t?r:null)||G(t?r:null)||V(t?r:null)||f("Unknown member");o.extAttrs=e,i.members.push(o)}}(e,t)||B(e,t)||f("Interface has no proper body")}function z(e,t){if(v(e?null:t,"pea"),!g(l,"namespace"))return;v();const n=g(l)||f("No name for namespace"),r=[],i=o={type:"namespace",name:e?n.value:h(n.value,"namespace"),partial:e,members:r};for(v(),g(u,"{")||f("Bodyless namespace");;){if(v(t?r:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after namespace"),i;const e=L(t?r:null);v();const n=G(t?r:null)||V(t?r:null)||f("Unknown member");n.extAttrs=e,i.members.push(n)}}function G(t,n){const r=v(t,"pea"),i=[],o={type:"attribute",static:!1,stringifier:!1,inherit:!1,readonly:!1};if(n&&(o[n]=!0),r&&i.push(r),g(l,"readonly")){o.readonly=!0,i.push(m);const e=v();e&&i.push(e)}const a=P(o);return a||(e=i.concat(e)),a}function V(e,t){v(e,"pea");const n=Object.assign({},d);return t&&(n[t]=!0),n.idlType=M(),N(n,e)}function X(e,t){if(v(e?null:t,"pea"),!g(l,"dictionary"))return;v();const n=g(l)||f("No name for dictionary"),r=[],i=o={type:"dictionary",name:e?n.value:h(n.value,"dictionary"),partial:e,members:r};for(e||(i.inheritance=_()||null),v(),g(u,"{")||f("Bodyless dictionary");;){if(v(t?r:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after dictionary"),i;const e=L(t?r:null);v(t?r:null,"pea");const n=g(l,"required"),o=$("dictionary-type")||f("No type for dictionary member");v();const a=g(l)||f("No name for dictionary member"),s=j();n&&s&&f("Required member must not have a default");const c={type:"field",name:a.value,required:!!n,idlType:o,extAttrs:e};void 0!==s&&(c.default=s),i.members.push(c),v(),g(u,";")||f("Unterminated dictionary member")}}function Z(e){if(v(e,"pea"),!g(l,"typedef"))return;const t={type:"typedef"};v(),t.idlType=$("typedef-type")||f("No type in typedef"),v();const n=g(l)||f("No name in typedef");return t.name=h(n.value,"typedef"),o=t,v(),g(u,";")||f("Unterminated typedef"),t}function Y(t){return function(e){let t;if(v(e,"pea"),!g(l,"callback"))return;if(v(),g(l,"interface"))return t=B(!1,e,"callback interface");const n=g(l)||f("No name for callback");return t=o={type:"callback",name:h(n.value,"callback")},v(),g(u,"=")||f("No assignment in callback"),v(),t.idlType=M(),v(),g(u,"(")||f("No arguments in callback"),t.arguments=S(e),v(),g(u,")")||f("Unterminated callback"),v(),g(u,";")||f("Unterminated callback"),t}(t)||F(!1,t)||function(e){if(v(e,"pea"),!g(l,"partial"))return;return X(!0,e)||F(!0,e)||z(!0,e)||f("Partial doesn't apply to anything")}(t)||X(!1,t)||function(e){if(v(e,"pea"),!g(l,"enum"))return;v();const t=g(l)||f("No name for enum"),n=[],r=o={type:"enum",name:h(t.value,"enum"),values:n};v(),g(u,"{")||f("No curly for enum");let i=!1;for(;;){if(v(e?n:null),g(u,"}"))return v(),g(u,";")||f("No semicolon after enum"),r;const t=g(c)||f("Unexpected value in enum");t.value=t.value.slice(1,-1),r.values.push(t),v(e?n:null),g(u,",")?(e&&n.push({type:","}),v(e?n:null),i=!0):i=!1}}(t)||Z(t)||function(t){v(t,"pea");const n=g(l);if(!n)return;const r=v();if(g(l,"implements")){const e={type:"implements",target:n.value};v();const t=g(l)||f("Incomplete implements statement");return e.implements=t.value,v(),g(u,";")||f("No terminating ; for implements statement"),e}r&&e.unshift(r),e.unshift(n)}(t)||function(t){v(t,"pea");const n=g(l);if(!n)return;const r=v();if(g(l,"includes")){const e={type:"includes",target:n.value};v();const t=g(l)||f("Incomplete includes statement");return e.includes=t.value,v(),g(u,";")||f("No terminating ; for includes statement"),e}r&&e.unshift(r),e.unshift(n)}(t)||z(!1,t)}const Q=function(t){if(!e.length)return[];const n=[];for(;;){const e=L(t?n:null),r=Y(t?n:null);if(!r){e.length&&f("Stray extended attributes");break}r.extAttrs=e,n.push(r)}return n}(t.ws);return e.length&&f("Unrecognised tokens"),Q}const i={parse:(e,n)=>(n||(n={}),r(function(e){const n=[];let r=0;for(;r<e.length;){const i=e.charAt(r);let o=-1;if(/[-0-9.]/.test(i)?(-1===(o=t(e,"float",r,n))&&(o=t(e,"integer",r,n)),-1===o&&(o=t(e,"other",r,n))):/[A-Z_a-z]/.test(i)?o=t(e,"identifier",r,n):'"'===i?-1===(o=t(e,"string",r,n))&&(o=t(e,"other",r,n)):/[\t\n\r ]/.test(i)?o=t(e,"whitespace",r,n):"/"===i?-1===(o=t(e,"comment",r,n))&&(o=t(e,"other",r,n)):o=t(e,"other",r,n),-1===o)throw new Error("Token stream not progressing");r=o}return n}(e),n))};"undefined"!=typeof module&&void 0!==module.exports?module.exports=i:"function"==typeof define&&define.amd?define("deps/webidl2",[],()=>i):(self||window).WebIDL2=i})(),define("deps/text!core/css/webidl.css",[],function(){return'/* --- WEB IDL --- */\n\npre.idl {\n padding: 1em;\n}\n\n.respec-idl-separator {\n padding: 0 0 0.4cm 0;\n}\n\n.respec-idl-separator:last-child {\n padding: 0;\n}\n\n@media print {\n pre.idl {\n white-space: pre-wrap;\n }\n}\n\npre.idl::before {\n content: "WebIDL";\n display: block;\n width: 150px;\n background: #90b8de;\n color: #fff;\n font-family: sans-serif;\n font-weight: bold;\n margin: -1em 0 1em -1em;\n height: 28px;\n line-height: 28px; \n}\n\n.idlType {\n color: #ff4500;\n font-weight: bold;\n text-decoration: none;\n}\n\n\n/*.idlModule*/\n\n\n/*.idlModuleID*/\n\n\n/*.idlInterface*/\n\n.idlInterfaceID,\n.idlDictionaryID,\n.idlCallbackID,\n.idlEnumID {\n font-weight: bold;\n color: #005a9c;\n}\n\na.idlEnumItem {\n color: #000;\n border-bottom: 1px dotted #ccc;\n text-decoration: none;\n}\n\n.idlSuperclass {\n font-style: italic;\n color: #005a9c;\n}\n\n\n/*.idlAttribute*/\n\n.idlAttrType,\n.idlFieldType,\n.idlMemberType {\n color: #005a9c;\n}\n\n.idlAttrName,\n.idlFieldName,\n.idlMemberName {\n color: #ff4500;\n}\n\n.idlAttrName a,\n.idlFieldName a,\n.idlMemberName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlMethod*/\n\n.idlMethType,\n.idlCallbackType {\n color: #005a9c;\n}\n\n.idlMethName {\n color: #ff4500;\n}\n\n.idlMethName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlCtor*/\n\n.idlCtorName {\n color: #ff4500;\n}\n\n.idlCtorName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlParam*/\n\n.idlParamType {\n color: #005a9c;\n}\n\n.idlParamName,\n.idlDefaultValue {\n font-style: italic;\n}\n\n.extAttr {\n color: #666;\n}\n\n\n/*.idlSectionComment*/\n\n.idlSectionComment {\n color: gray;\n}\n\n\n/*.idlIterable*/\n\n.idlIterableKeyType,\n.idlIterableValueType {\n color: #005a9c;\n}\n\n\n/*.idlMaplike*/\n\n.idlMaplikeKeyType,\n.idlMaplikeValueType {\n color: #005a9c;\n}\n\n\n/*.idlConst*/\n\n.idlConstType {\n color: #005a9c;\n}\n\n.idlConstName {\n color: #ff4500;\n}\n\n.idlConstName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlException*/\n\n.idlExceptionID {\n font-weight: bold;\n color: #c00;\n}\n\n.idlTypedefID,\n.idlTypedefType {\n color: #005a9c;\n}\n\n.idlRaises,\n.idlRaises a.idlType,\n.idlRaises a.idlType code,\n.excName a,\n.excName a code {\n color: #c00;\n font-weight: normal;\n}\n\n.excName a {\n font-family: monospace;\n}\n\n.idlRaises a.idlType,\n.excName a.idlType {\n border-bottom: 1px dotted #c00;\n}\n\n.excGetSetTrue,\n.excGetSetFalse,\n.prmNullTrue,\n.prmNullFalse,\n.prmOptTrue,\n.prmOptFalse {\n width: 45px;\n text-align: center;\n}\n\n.excGetSetTrue,\n.prmNullTrue,\n.prmOptTrue {\n color: #0c0;\n}\n\n.excGetSetFalse,\n.prmNullFalse,\n.prmOptFalse {\n color: #c00;\n}\n\n.idlImplements a, .idlIncludes a {\n font-weight: bold;\n}\n\ndl.attributes,\ndl.methods,\ndl.constants,\ndl.constructors,\ndl.fields,\ndl.dictionary-members {\n margin-left: 2em;\n}\n\n.attributes dt,\n.methods dt,\n.constants dt,\n.constructors dt,\n.fields dt,\n.dictionary-members dt {\n font-weight: normal;\n}\n\n.attributes dt code,\n.methods dt code,\n.constants dt code,\n.constructors dt code,\n.fields dt code,\n.dictionary-members dt code {\n font-weight: bold;\n color: #000;\n font-family: monospace;\n}\n\n.attributes dt code,\n.fields dt code,\n.dictionary-members dt code {\n background: #ffffd2;\n}\n\n.attributes dt .idlAttrType code,\n.fields dt .idlFieldType code,\n.dictionary-members dt .idlMemberType code {\n color: #005a9c;\n background: transparent;\n font-family: inherit;\n font-weight: normal;\n font-style: italic;\n}\n\n.methods dt code {\n background: #d9e6f8;\n}\n\n.constants dt code {\n background: #ddffd2;\n}\n\n.constructors dt code {\n background: #cfc;\n}\n\n.attributes dd,\n.methods dd,\n.constants dd,\n.constructors dd,\n.fields dd,\n.dictionary-members dd {\n margin-bottom: 1em;\n}\n\ntable.parameters,\ntable.exceptions {\n border-spacing: 0;\n border-collapse: collapse;\n margin: 0.5em 0;\n width: 100%;\n}\n\ntable.parameters {\n border-bottom: 1px solid #90b8de;\n}\n\ntable.exceptions {\n border-bottom: 1px solid #deb890;\n}\n\n.parameters th,\n.exceptions th {\n color: inherit;\n padding: 3px 5px;\n text-align: left;\n font-weight: normal;\n}\n\n.parameters th {\n color: #fff;\n background: #005a9c;\n}\n\n.exceptions th {\n background: #deb890;\n}\n\n.parameters td,\n.exceptions td {\n padding: 3px 10px;\n border-top: 1px solid #ddd;\n vertical-align: top;\n}\n\n.parameters tr:first-child td,\n.exceptions tr:first-child td {\n border-top: none;\n}\n\n.parameters td.prmName,\n.exceptions td.excName,\n.exceptions td.excCodeName {\n width: 100px;\n}\n\n.parameters td.prmType {\n width: 120px;\n}\n\ntable.exceptions table {\n border-spacing: 0;\n border-collapse: collapse;\n width: 100%;\n}\n\n.respec-button-copy-paste:focus {\n text-decoration: none;\n border-color: #51a7e8;\n outline: none;\n box-shadow: 0 0 5px rgba(81, 167, 232, 0.5);\n}\n\n.respec-button-copy-paste:focus:hover,\n.respec-button-copy-paste.selected:focus {\n border-color: #51a7e8;\n}\n\n.respec-button-copy-paste:hover,\n.respec-button-copy-paste:active,\n.respec-button-copy-paste.zeroclipboard-is-hover,\n.respec-button-copy-paste.zeroclipboard-is-active {\n text-decoration: none;\n background-color: #ddd;\n background-image: linear-gradient(#eee, #ddd);\n border-color: #ccc;\n}\n\n.respec-button-copy-paste:active,\n.respec-button-copy-paste.selected,\n.respec-button-copy-paste.zeroclipboard-is-active {\n background-color: #dcdcdc;\n background-image: none;\n border-color: #b5b5b5;\n box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15)\n}\n\n.respec-button-copy-paste.selected:hover {\n background-color: #cfcfcf;\n}\n\n.respec-button-copy-paste:disabled,\n.respec-button-copy-paste:disabled:hover,\n.respec-button-copy-paste.disabled,\n.respec-button-copy-paste.disabled:hover {\n color: rgba(102, 102, 102, 0.5);\n cursor: default;\n background-color: rgba(229, 229, 229, 0.5);\n background-image: none;\n border-color: rgba(197, 197, 197, 0.5);\n box-shadow: none;\n}\n'}),define("core/webidl",["exports","core/pubsubhub","deps/webidl2","handlebars.runtime","deps/text!core/css/webidl.css","templates","core/utils"],function(e,t,n,r,i,o,a){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0,e.run=function(e,n,r){var i=function(){z(),(0,t.pub)("end","core/webidl"),r()},o=$("pre.idl",n);if(!o.length)return i();l.default.registerHelper("extAttr",function(e,t){return U(e.extAttrs,t,!1)}),l.default.registerHelper("extAttrInline",function(e){return U(e.extAttrs,0,!0)}),l.default.registerHelper("extAttrClassName",function(){return"Constructor"===this.name||"NamedConstructor"===this.name?"idlCtor":"extAttr"}),l.default.registerHelper("extAttrRhs",function(e,t){return"identifier"===e.type?t.fn(e.value):`(${e.value.map(t.fn)})`}),l.default.registerHelper("param",function(e){return new l.default.SafeString(L({obj:e,optional:e.optional?"optional ":"",variadic:e.variadic?"...":""}))}),l.default.registerHelper("jsIf",function(e,t){return e?t.fn(this):t.inverse(this)}),l.default.registerHelper("idn",function(e){return new l.default.SafeString(_(e))}),l.default.registerHelper("idlType",function(e){return new l.default.SafeString(N(e.idlType))}),l.default.registerHelper("stringifyIdlConst",function(e){switch(e.type){case"null":return"null";case"Infinity":return e.negative?"-Infinity":"Infinity";case"NaN":return"NaN";case"number":return e.value;case"string":case"boolean":case"sequence":return JSON.stringify(e.value);default:return(0,t.pub)("error","Unexpected constant value type: `"+e.type+"`."),"<Unknown>"}}),l.default.registerHelper("escapeArgumentName",X),l.default.registerHelper("escapeAttributeName",Z),l.default.registerHelper("escapeIdentifier",Y),l.default.registerHelper("pads",function(e){return new l.default.SafeString(M(e))}),l.default.registerHelper("join",function(e,t,n){return e.map(n.fn).join(t)}),l.default.registerHelper("joinNonWhitespace",function(e,t,n){return e.filter(e=>"ws"!==e.type).map(n.fn).join(t)}),l.default.registerHelper("tryLink",function(e,t){const n=t.fn(this),r="toJSON"===e.name&&e.extAttrs.some(({name:e})=>"Default"===e);if(!e.dfn&&!r)return n;const i=document.createElement("a");return i.innerText=n,!e.dfn&&r?i.dataset.cite="WEBIDL#default-tojson-operation":(i.dataset.noDefault="",i.dataset.linkFor=e.linkFor?l.default.Utils.escapeExpression(e.linkFor).toLowerCase():"",i.dataset.lt=e.dfn[0].dataset.lt||""),i.outerHTML}),$(".idl",n).not("pre").length||$(n).find("head link").first().before($("<style/>").text(c.default));o.each(function(){var n;try{n=s.default.parse($(this).text(),{ws:!0})}catch(e){return void(0,t.pub)("error",`Failed to parse WebIDL: \`${e.message}\`.\n <details>\n <pre>${(0,a.normalizePadding)(this.textContent)}\n ${e}</pre>\n </details>`)}!function e(n,r,i,o){n.filter(({type:e})=>!1===["includes","implements","ws","ws-pea","ws-tpea","line-comment","multiline-comment"].includes(e)).forEach(function(n){var a;switch(n.type){case"callback interface":case"dictionary":case"interface":case"interface mixin":var s="";n.partial&&(V[n.name]||(V[n.name]=[]),V[n.name].push(n),s="-partial-"+V[n.name].length),e(n.members,r,n.name,o),a=n.name,n.idlId="idl-def-"+a.toLowerCase()+s;break;case"enum":a=n.name;for(const e of n.values)"string"===e.type&&(e.dfn=ne(a,e.value,r,n.type,o));n.idlId="idl-def-"+a.toLowerCase();break;case"callback":case"typedef":a=n.name,n.idlId="idl-def-"+a.toLowerCase();break;case"attribute":case"const":case"field":a=n.name,n.idlId="idl-def-"+i.toLowerCase()+"-"+a.toLowerCase();break;case"operation":if(n.name){a=n.name;var l=i+"."+a,c=i+"."+a+"()";G[c]||(G[c]=[]),G[l]?(n.overload=G[l].length,a=n.name+"!overload-"+n.overload):G[l]=[],G[c].push(n),G[l].push(n)}else(n.getter||n.setter||n.deleter||n.stringifier)&&(a="");const u=`idl-def-${i.toLowerCase()}-${a.toLowerCase()}`,d=n.overload||!n.arguments.length?"":"-"+n.arguments.filter(e=>!I(e.type)).map(e=>e.name.toLowerCase()).join("-").replace(/\s/g,"_");n.idlId=u+d;break;case"maplike":a="maplike",n.idlId=("idl-def-"+i+"-"+a).toLowerCase();break;case"iterable":a="iterable",n.idlId="idl-def-"+i.toLowerCase()+"-"+a.toLowerCase();break;default:return void(0,t.pub)("error",new Error("ReSpec doesn't know about IDL type: `"+n.type+"`."))}i&&(n.linkFor=i),n.dfn=ne(i,a,r,n.type,o)})}(n,e.definitionMap,"",this);var r,i,o=(r=n,(i=$("<pre></pre>").attr({class:"def idl"})).html(r.filter(function(e){return!I(e.type)}).map(function(e){return function(e,n){var r={indent:++n,obj:e};switch(e.type){case"typedef":return j(r);case"includes":return w(r);case"implements":return x(r);case"interface":return Q(r);case"interface mixin":return Q(r,{mixin:!0});case"callback interface":return Q(r,{callback:!0});case"dictionary":var i=0,o=0;e.members.filter(function(e){return!I(e.type)});for(const t of e.members){if(I(t.type))continue;const e=t.required?"required ":"";i<e.length&&(i=e.length);var a=P(t.idlType).length;o<a&&(o=a)}var s=e.members.map(function(e){switch(e.type){case"field":return r=i,(a={obj:t=e,indent:n+1}).typePad=o-P(t.idlType).length,t.required?a.qualifiers="required ":a.qualifiers=" ",a.qualifiers=a.qualifiers.slice(0,r),g(a);case"line-comment":return ee(e,n+1);case"multiline-comment":return te(e,n+1);case"ws":return K(e);case"ws-pea":break;default:throw new Error("Unexpected type in dictionary: `"+e.type+"`.")}var t,r,a}).join("");return m({obj:e,indent:n,children:s,partial:e.partial?"partial ":""});case"callback":var l=e.arguments.filter(function(e){return!I(e.type)}).map(function(e){return L({obj:e,optional:e.optional?"optional ":"",variadic:e.variadic?"...":""})}),c={obj:e,indent:n,children:l.join(", ")},u=f(c),d=$(u).text();if(d.length>80){var p=d.indexOf("(")+1;c.children=l.join(",\n"+M(p)),u=f(c)}return u;case"enum":for(var s="",h=0;h<e.values.length;h++){var v=e.values[h];switch(v.type){case"string":for(var k=!1,C=h+1;C<e.values.length;C++){var E=e.values[C];if(void 0===E.type)break;if(","===E.type){k=!0;break}}s+=b({lname:v.value?v.value.toLowerCase():"the-empty-string",name:v.value,parentID:e.name.toLowerCase(),indent:n+1,needsComma:k});break;case"line-comment":s+=ee(v,n+1);break;case"multiline-comment":s+=te(v,n+1);break;case"ws":s+=K(v);break;case",":case"ws-pea":break;default:throw new Error("Unexpected type in exception: `"+v.type+"`.")}}return y({obj:e,indent:n,children:s});default:return(0,t.pub)("error","Unexpected object type `"+e.type+"` in "+JSON.stringify(e)),""}}(e,-1)}).join("\n\n")),i);o.attr({id:this.id}),o.find(".idlAttribute,.idlCallback,.idlConst,.idlDictionary,.idlEnum,.idlException,.idlField,.idlInterface,.idlMember,.idlMethod,.idlMaplike,.idlIterable,.idlTypedef").each(function(){var t=$(this),n=t.attr("data-title").toLowerCase(),r=t.parent().closest(".idlDictionary,.idlEnum,.idlException,.idlInterface");r.length&&t.attr("data-dfn-for",r.attr("data-title").toLowerCase()),e.definitionMap[n]||(e.definitionMap[n]=[]),e.definitionMap[n].push(t)}),$(this).replaceWith(o),o[0].classList.add(...this.classList)}),n.normalize(),i()};var s=d(n),l=d(r),c=d(i),u=d(o);function d(e){return e&&e.__esModule?e:{default:e}}e.name="core/webidl";var p=u.default["attribute.html"],f=u.default["callback.html"],h=u.default["const.html"],m=u.default["dictionary.html"],g=u.default["dict-member.html"],b=u.default["enum-item.html"],y=u.default["enum.html"],v=u.default["extended-attribute.html"],w=(u.default["field.html"],u.default["includes.html"]),x=u.default["implements.html"],k=u.default["interface.html"],C=u.default["iterable.html"],E=u.default["line-comment.html"],T=u.default["maplike.html"],S=u.default["method.html"],A=u.default["multiline-comment.html"],L=u.default["param.html"],j=u.default["typedef.html"],D=new Set(["maplike","setlike","stringifier"]);function _(e){return" ".repeat(e)}function N(e){if("string"==typeof e)return`<a>${l.default.Utils.escapeExpression(e)}</a>`;if(Array.isArray(e))return e.map(N).join(", ");const t=U(e.extAttrs,0,!0),n=e.nullable?"?":"";if(e.union)return`${t}(${e.idlType.map(N).join(" or ")})${n}`;let r="";return t+(r=e.generic?`${r=W.has(e.generic)?R(e.generic):N(e.generic)}<${N(e.idlType)}>`:W.has(e.idlType)?R(e.idlType):N(e.idlType))+n}function R(e){if(!W.has(e))return e;const t=l.default.Utils.escapeExpression(e);return`<a data-cite='${W.get(t)}'>${t}</a>`}function P(e){if("string"==typeof e)return e;const t=e.nullable?"?":"";if(e.union)return`(${e.idlType.map(P).join(" or ")})${t}`;if(e.generic){const n=[].concat(e.idlType).map(P).join(", ");return`${e.generic}<${n}>${t}`}return P(e.idlType)+t}function M(e){return" ".repeat(e)}var O={ws:!0,"ws-pea":!0,"ws-tpea":!0,"line-comment":!0,"multiline-comment":!0};function I(e){return O[e]}const q=new Map([["CEReactions","HTML#cereactions"],["Clamp","WEBIDL#Clamp"],["Constructor","WEBIDL#Constructor"],["Default","WEBIDL#Default"],["EnforceRange","WEBIDL#EnforceRange"],["Exposed","WEBIDL#Exposed"],["Global","WEBIDL#Global"],["HTMLConstructor","HTML#htmlconstructor"],["LegacyUnenumerableNamedProperties","WEBIDL#LegacyUnenumerableNamedProperties"],["LenientSetter","WEBIDL#LenientSetter"],["LenientThis","WEBIDL#LenientThis"],["NamedConstructor","WEBIDL#NamedConstructor"],["NewObject","WEBIDL#NewObject"],["NoInterfaceObject","WEBIDL#NoInterfaceObject"],["OverrideBuiltins","WEBIDL#OverrideBuiltins"],["PrimaryGlobal","WEBIDL#PrimaryGlobal"],["PutForwards","WEBIDL#PutForwards"],["Replaceable","WEBIDL#Replaceable"],["SameObject","WEBIDL#SameObject"],["SecureContext","WEBIDL#SecureContext"],["TreatNonObjectAsNull","WEBIDL#TreatNonObjectAsNull"],["TreatNullAs","WEBIDL#TreatNullAs"],["Unforgeable","WEBIDL#Unforgeable"],["Unscopable","WEBIDL#Unscopable"]]);function U(e,t,n){if(0===e.length)return"";var r={extAttrs:e,indent:t,sep:n?", ":",\n "+_(t),end:n?" ":"\n"};const i=new l.default.SafeString(v(r)),o=document.createElement("div");return o.innerHTML=i,Array.from(o.querySelectorAll(".extAttrName")).filter(function(e){return q.has(e.textContent)}).forEach(function(e){const t=e.ownerDocument.createElement("a");t.dataset.cite=q.get(e.textContent),t.textContent=e.textContent,e.replaceChild(t,e.firstChild)}),new l.default.SafeString(o.innerHTML)}const W=new Map([["any","WEBIDL#idl-any"],["ArrayBuffer","WEBIDL#idl-ArrayBuffer"],["boolean","WEBIDL#idl-boolean"],["Buffer","WEBIDL#idl-Buffer"],["byte","WEBIDL#idl-byte"],["ByteString","WEBIDL#idl-ByteString"],["Callback","WEBIDL#idl-Callback"],["DataView","WEBIDL#idl-DataView"],["DOMException","WEBIDL#idl-DOMException"],["DOMString","WEBIDL#idl-DOMString"],["double","WEBIDL#idl-double"],["Error","WEBIDL#idl-Error"],["EventHandler","HTML#eventhandler"],["float","WEBIDL#idl-float"],["Float32Array","WEBIDL#idl-Float32Array"],["Float64Array","WEBIDL#idl-Float64Array"],["FrozenArray","WEBIDL#idl-frozen-array"],["Int16Array","WEBIDL#idl-Int16Array"],["Int32Array","WEBIDL#idl-Int32Array"],["Int8Array","WEBIDL#idl-Int8Array"],["long long","WEBIDL#idl-long-long"],["long","WEBIDL#idl-long"],["object","WEBIDL#idl-object"],["octet","WEBIDL#idl-octet"],["Promise","WEBIDL#idl-promise"],["record","WEBIDL#idl-record"],["sequence","WEBIDL#idl-sequence"],["short","WEBIDL#idl-short"],["Uint16Array","WEBIDL#idl-Uint16Array"],["Uint32Array","WEBIDL#idl-Uint32Array"],["Uint8Array","WEBIDL#idl-Uint8Array"],["Uint8ClampedArray","WEBIDL#dl-Uint8ClampedArray"],["unrestricted double","WEBIDL#idl-unrestricted-double"],["unrestricted float","WEBIDL#idl-unrestricted-float"],["unsigned long long","WEBIDL#idl-unsigned-long-long"],["unsigned long","WEBIDL#idl-unsigned-long"],["unsigned short","WEBIDL#idl-unsigned-short"],["USVString","WEBIDL#idl-USVString"]]),H=new Set(["any","attribute","boolean","byte","ByteString","callback","const","creator","Date","deleter","dictionary","DOMString","double","enum","false","float","getter","implements","Infinity","inherit","interface","iterable","long","maplike","NaN","null","object","octet","optional","or","partial","readonly","RegExp","required","sequence","setlike","setter","short","static","stringifier","true","typedef","unrestricted","unsigned","USVString","void"]),B=new Set(["attribute","callback","const","creator","deleter","dictionary","enum","getter","implements","inherit","interface","iterable","maplike","partial","required","setlike","setter","static","stringifier","typedef","unrestricted"]),F=new Set(["required"]);var z,G={},V={};function X(e){return H.has(e)&&!B.has(e)?"_"+e:e}function Z(e){return H.has(e)&&!F.has(e)?"_"+e:e}function Y(e){return H.has(e)?"_"+e:e}function Q(e,t={}){var n=e.obj,r=e.indent,i=0,o=0,a=0,s=0;for(const e of n.members)if(!I(e.type)&&"maplike"!==e.type&&"iterable"!==e.type){var l=P(e.idlType).length;if("attribute"===e.type){var c=J(e).length;i=Math.max(l,i),o=Math.max(c,o)}else"operation"===e.type?(e.static?l+="static ".length:e.stringifier?l+="stringifier ".length:e.getter?l+="getter ".length:e.setter&&(l+="setter ".length),a=Math.max(l,a)):"const"===e.type&&(s=Math.max(l,s))}var u=n.members.map(function(e){switch(e.type){case"attribute":return d=i,f=r+1,m=o,g=P((u=e).idlType).length,b=d-g,y=J(u),y=(y+=M(m)).slice(0,m),p({obj:u,indent:f,qualifiers:y,pad:b});case"operation":return function(e,t,n){var r=e.arguments.filter(function(e){return!I(e.type)}).map(function(e){return L({obj:e,optional:e.optional?"optional ":"",variadic:e.variadic?"...":""})}),i=r.join(", "),o=P(e.idlType).length,a=["getter","setter","deleter","stringifier","static"],s="";for(var l in a)if(e[a[l]]){o+=(s=a[l]+" ").length;break}var c={obj:e,indent:n,special:s,pad:t-o,children:i},u=S(c),d=$(u).text();if(d.length>80){var p=d.indexOf("(")+1;c.children=r.join(",\n"+M(p)),u=S(c)}return u}(e,a,r+1);case"const":return function(e,t,n){var r=t-P(e.idlType).length;e.nullable&&r--;return h({obj:e,indent:n,pad:r,nullable:e.nullable?"?":""})}(e,s,r+1);case"maplike":return c=r+1,T({obj:l=e,qualifiers:l.readonly?"readonly ":"",indent:c});case"iterable":return n=r+1,C({obj:t=e,qualifiers:t.readonly?"readonly ":"",indent:n});case"ws":return K(e);case"line-comment":return ee(e,r+1);case"multiline-comment":return te(e,r+1);default:throw new Error("Unexpected member type: `"+e.type+"`.")}var t,n,l,c,u,d,f,m,g,b,y}).join("");return k({obj:n,indent:r,partial:n.partial?"partial ":"",callback:t.callback?"callback ":"",mixin:t.mixin?"mixin ":"",children:u})}function J(e){var t="";return e.static&&(t+="static "),e.stringifier&&(t+="stringifier "),e.inherit&&(t+="inherit "),e.readonly&&(t+="readonly "),t}function K(e){return/\n.*\n/.test(e.value)?"\n":""}function ee(e,t){return E({indent:t,comment:e.value})}function te(e,t){var n=e.value.split(/\r\n|\r|\n/);if(0===n.length)return"";if(1===n.length)return E({indent:t,comment:n[0]});var r=Math.max(0,/^ */.exec(n[1])[0].length-3);function i(e){return e.slice(r)}return A({indent:t,firstLine:n[0],lastLine:i(n[n.length-1]),innerLine:n.slice(1,-1).map(i)})}function ne(e,n,r,i,o){const a=e,s=n;switch(e=e.toLowerCase(),i){case"operation":if(-1!==n.search("!overload")){n=n.toLowerCase();break}const t=n.toLowerCase()+"()",a=e+"."+n.toLowerCase()+"()";if(r[t]||r[a]){const i=r[t]?t:a,s=ne(e,i,r,null,o);if(!s)break;const l=s[0].dataset.lt?s[0].dataset.lt.split("|"):[];return l.push(i,n),s[0].dataset.lt=l.join("|"),r[n]||(r[n]=[]),r[n].push(s),s}const s=ne(e,n,r,null,o);if(!s)break;const l=s[0].dataset.lt?s[0].dataset.lt.split("|"):[];return l.push(t,n),s[0].dataset.lt=l.reverse().join("|"),r[t]=[s],s;case"enum":if(""===n){n="the-empty-string";break}default:n=n.toLowerCase()}if(D.has(n))return;var l=r[n],c=[];if(l&&0===(c=l.filter(t=>t[0].dataset.dfnFor===e)).length&&""===e&&1===l.length&&(c=l),0===c.length&&""!==e){var u=e+"."+n;void 0!==(l=r[u])&&1===l.length&&(c=l,delete r[u],c[0].attr("data-dfn-for",e),c[0].attr("data-lt",n),void 0===r[n]&&(r[n]=[]),r[n].push(c[0]))}if(c.length>1){const e=`Multiple \`<dfn>\`s for \`${s}\` ${a?`in \`${a}\``:""}`;(0,t.pub)("error",new Error(e))}if(0===c.length){if(i&&o&&n&&!1===o.classList.contains("no-link-warnings")){var d=`No \`<dfn>\` for ${i} \`${s}\`${a?" in `"+a+"`":""}`;d+=". [More info](https://github.com/w3c/respec/wiki/WebIDL-thing-is-not-defined).",(0,t.pub)("warn",d)}return}const p=c[0][0],f="dom-"+(e?e+"-":"")+n.replace(/[()]/g,"");if(p.id=f,p.dataset.idl="",p.dataset.title=p.textContent,p.dataset.dfnFor=e,!p.querySelector("code")&&!p.closest("code")&&p.children){const e=p.ownerDocument.createElement("code");for(;p.hasChildNodes();)e.appendChild(p.firstChild);p.appendChild(e)}return c[0]}e.done=new Promise(function(e){z=e})}),define("core/biblio-db",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.biblioDB=e.name=void 0;e.name="core/biblio-db";const n=new Set(["alias","reference"]),r=new Promise((e,t)=>{let n;try{n=window.indexedDB.open("respec-biblio2",12)}catch(e){return t(e)}n.onerror=(()=>{t(new DOMException(n.error.message,n.error.name))}),n.onsuccess=(()=>{e(n.result)}),n.onupgradeneeded=(async()=>{const r=n.result;Array.from(r.objectStoreNames).map(e=>r.deleteObjectStore(e));const i=[new Promise((e,t)=>{try{const n=r.createObjectStore("alias",{keyPath:"id"});n.createIndex("aliasOf","aliasOf",{unique:!1}),n.transaction.oncomplete=e,n.transaction.onerror=t}catch(e){t(e)}}),new Promise((e,t)=>{try{const n=r.createObjectStore("reference",{keyPath:"id"}).transaction;n.oncomplete=e,n.onerror=t}catch(e){t(e)}})];try{await Promise.all(i),e()}catch(e){t(e)}})});e.biblioDB={get ready(){return r},async find(e){return await this.isAlias(e)&&(e=await this.resolveAlias(e)),this.get("reference",e)},async has(e,t){if(!n.has(e))throw new TypeError("Invalid type: "+e);if(!t)throw new TypeError("id is required");const r=await this.ready;return new Promise((n,i)=>{var o=r.transaction([e],"readonly").objectStore(e),a=IDBKeyRange.only(t),s=o.openCursor(a);s.onsuccess=(()=>{n(!!s.result)}),s.onerror=(()=>{i(new DOMException(s.error.message,s.error.name))})})},async isAlias(e){if(!e)throw new TypeError("id is required");const t=await this.ready;return new Promise((n,r)=>{var i=t.transaction(["alias"],"readonly").objectStore("alias"),o=IDBKeyRange.only(e),a=i.openCursor(o);a.onsuccess=(()=>{n(!!a.result)}),a.onerror=(()=>{r(new DOMException(a.error.message,a.error.name))})})},async resolveAlias(e){if(!e)throw new TypeError("id is required");const t=await this.ready;return new Promise((n,r)=>{var i=t.transaction("alias","readonly").objectStore("alias"),o=IDBKeyRange.only(e),a=i.openCursor(o);a.onsuccess=(()=>{if(null===a.result)return n(null);n(a.result.value.aliasOf)}),a.onerror=(()=>{r(new DOMException(a.error.message,a.error.name))})})},async get(e,t){if(!n.has(e))throw new TypeError("Invalid type: "+e);if(!t)throw new TypeError("id is required");const r=await this.ready;return new Promise((n,i)=>{var o=r.transaction([e],"readonly").objectStore(e),a=IDBKeyRange.only(t),s=o.openCursor(a);s.onsuccess=(()=>{if(null===s.result)return n(null);n(s.result.value)}),s.onerror=(()=>{i(new DOMException(s.error.message,s.error.name))})})},async addAll(e){if(!e)return;const n={alias:new Set,reference:new Set};Object.keys(e).filter(n=>{if("string"==typeof e[n]){let e=`Legacy SpecRef entries are not supported: \`[[${n}]]\`. `;return e+="Please update it to the new format at [specref repo](https://github.com/tobie/specref/)",(0,t.pub)("error",e),!1}return!0}).map(t=>Object.assign({id:t},e[t])).reduce((e,t)=>(t.aliasOf?e.alias.add(t):e.reference.add(t),e),n);const r=Object.keys(n).map(e=>Array.from(n[e]).map(t=>this.add(e,t))).reduce((e,t)=>e.concat(t),[]);await Promise.all(r)},async add(e,t){if(!n.has(e))throw new TypeError("Invalid type: "+e);if("object"!=typeof t)throw new TypeError("details should be an object");if("alias"===e&&!t.hasOwnProperty("aliasOf"))throw new TypeError("Invalid alias object.");const r=await this.ready,i=await this.has(e,t.id);return new Promise((n,o)=>{const a=r.transaction([e],"readwrite").objectStore(e);var s=i?a.put(t):a.add(t);s.onsuccess=n,s.onerror=(()=>{o(new DOMException(s.error.message,s.error.name))})})},async close(){(await this.ready).close()}}}),define("core/biblio",["exports","core/biblio-db","core/utils","core/pubsubhub"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0,e.wireReference=function(e,t="_blank"){if("object"!=typeof e)throw new TypeError("Only modern object references are allowed");const n=Object.assign({},s,e),r=n.authors.join("; ")+(n.etAl?" et al":""),i=a.get(n.status)||n.status;return hyperHTML.wire(n)` - <cite> - <a - href="${n.href}" - target="${t}" - rel="noopener noreferrer"> - ${n.title.trim()}</a>. - </cite> - <span class="authors"> - ${l(r)} - </span> - <span class="publisher"> - ${l(n.publisher)} - </span> - <span class="pubDate"> - ${l(n.date)} - </span> - <span class="pubStatus"> - ${l(i)} - </span> - `},e.stringifyReference=u,e.resolveRef=async function e(t){const n=await f;if(!n.hasOwnProperty(t))return null;const r=n[t];if(r.aliasOf)return await e(r.aliasOf);return r},e.run=async function(e,n,i){e.localBiblio||(e.localBiblio={});if(e.biblio){let e="Overriding `.biblio` in config. Please use ";e+="`.localBiblio` for custom biblio entries.",(0,r.pub)("warn",e)}e.biblio={};const a=Array.from(Object.keys(e.localBiblio)).filter(t=>e.localBiblio[t].hasOwnProperty("aliasOf")).map(t=>e.localBiblio[t].aliasOf);s=e,Array.from(s.informativeReferences).filter(e=>s.normativeReferences.has(e)).forEach(e=>s.informativeReferences.delete(e));var s;const l=o(e),c=l.normativeReferences.concat(l.informativeReferences).filter(t=>!e.localBiblio.hasOwnProperty(t)).concat(a).reduce((e,t)=>(-1===e.indexOf(t)&&e.push(t),e),[]).sort(),d=[];try{await t.biblioDB.ready;const e=c.map(async e=>({id:e,data:await t.biblioDB.find(e)}));d.push(...await Promise.all(e))}catch(e){d.push(...c.map(e=>({id:e,data:null}))),console.warn(e)}const f={hasData:[],noData:[]};d.reduce((e,t)=>(t.data?e.hasData.push(t):e.noData.push(t),e),f),f.hasData.reduce((e,t)=>(e[t.id]=t.data,e),e.biblio);const m=f.noData.map(e=>e.id);if(m.length){const t=await h(m,{forceUpdate:!0});Object.assign(e.biblio,t)}Object.assign(e.biblio,e.localBiblio),function(e){var t={},n=o(e),i=n.informativeReferences,a=n.normativeReferences,s={};if(!i.length&&!a.length&&!e.refNote)return;var l=$("<section id='references' class='appendix'><h2>"+e.l10n.references+"</h2></section>").appendTo($("body"));e.refNote&&$("<p></p>").html(e.refNote).appendTo(l);for(var c=["Normative","Informative"],d=0;d<c.length;d++){var p=c[d],f="Normative"===p?a:i,h="Normative"===p?e.l10n.norm_references:e.l10n.info_references;if(f.length){var m=$("<section><h3></h3></section>").appendTo(l).find("h3").text(h).end();m.makeID(null,p+" references"),f.sort((e,t)=>e.toLowerCase().localeCompare(t.toLowerCase()));for(var g=$("<dl class='bibliography'></dl>").appendTo(m),b=0;b<f.length;b++){var y=f[b];$("<dt></dt>").attr({id:"bib-"+y}).text("["+y+"]").appendTo(g);var v=$("<dd></dd>").appendTo(g),w=e.biblio[y],x={},k=y;for(x[y]=!0;w&&w.aliasOf;)if(x[w.aliasOf]){w=null;const e=`Circular reference in biblio DB between [\`${y}\`] and [\`${k}\`].`;(0,r.pub)("error",e)}else k=w.aliasOf,w=e.biblio[k],x[k]=!0;s[k]=s[k]||[],s[k].indexOf(y)<0&&s[k].push(y),w?v.html(u(w)+"\n"):(t[y]||(t[y]=0),t[y]++,v.html("<em style='color: #f00'>Reference not found.</em>\n"))}}}for(var C in s)if(s[C].length>1){let e=`[${C}] is referenced in ${s[C].length} ways: `;e+=`(${s[C].map(e=>`'${e}'`).join(", ")}). This causes`,e+=" duplicate entries in the References section.",(0,r.pub)("warn",e)}for(var E in t){const e=`Bad reference: [\`${E}\`] (appears ${t[E]} times)`;t.hasOwnProperty(E)&&(0,r.pub)("error",e)}}(e),p(e.biblio),i(),await h(c)};e.name="core/biblio";const i=new URL("https://specref.herokuapp.com/bibrefs?refs=");function o(e){return{informativeReferences:Array.from(e.informativeReferences),normativeReferences:Array.from(e.normativeReferences)}}const a=new Map([["CR","W3C Candidate Recommendation"],["ED","W3C Editor's Draft"],["FPWD","W3C First Public Working Draft"],["LCWD","W3C Last Call Working Draft"],["NOTE","W3C Note"],["PER","W3C Proposed Edited Recommendation"],["PR","W3C Proposed Recommendation"],["REC","W3C Recommendation"],["WD","W3C Working Draft"],["WG-NOTE","W3C Working Group Note"]]),s=Object.freeze({authors:[],date:"",href:"",publisher:"",status:"",title:"",etAl:!1}),l=(c=".",e=>{const t=e.trim();return!t||t.endsWith(c)?t:t+c});var c;function u(e){if("string"==typeof e)return e;let t=`<cite>${e.title}</cite>`;(t=e.href?`<a href="${e.href}">${t}</a>. `:`${t}. `,e.authors&&e.authors.length&&(t+=e.authors.join("; "),e.etAl&&(t+=" et al"),t+="."),e.publisher)&&(t=`${t} ${e.publisher+(/\.$/.test(e.publisher)?"":".")} `);return e.date&&(t+=e.date+". "),e.status&&(t+=(a.get(e.status)||e.status)+". "),e.href&&(t+=`URL: <a href="${e.href}">${e.href}</a>`),t}var d=(0,n.createResourceHint)({hint:"dns-prefetch",href:i.origin});let p;document.head.appendChild(d);const f=e.done=new Promise(e=>{p=e});async function h(e,n={forceUpdate:!1}){if(!e.length||!1===navigator.onLine)return;let r;try{r=await fetch(i.href+e.join(","))}catch(e){return console.error(e),null}if(!n.forceUpdate&&!r.ok||200!==r.status)return null;const o=await r.json();try{await t.biblioDB.addAll(o)}catch(e){console.error(e)}return o}}),define("core/data-cite",["exports","core/pubsubhub","core/biblio"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){const t=r(e);Array.from(document.querySelectorAll(["dfn[data-cite], a[data-cite]"])).filter(e=>e.dataset.cite).map(t).forEach(({isNormative:t,key:n})=>{const r=t?e.normativeReferences:e.informativeReferences;r.add(n)})},e.linkInlineCitations=async function(e,i=respecConfig){const o=function(e){const i=r(e);return async function(r){const o=r.dataset.cite;let{key:a,frag:s,path:l}=i(r),c="";if(a===e.shortName)c=document.location.href;else{const e=await(0,n.resolveRef)(a);if(d=r,["data-cite","data-cite-frag"].filter(e=>d.hasAttribute(e)).forEach(e=>d.removeAttribute(e)),!e){var u=`Couldn't find a match for 'data-cite=${o}'.`;return console.warn(u,r),u+=" Please check developer console for offending element.",void(0,t.pub)("warn",u)}c=e.href}var d;switch(l&&(c=new URL(l,c).href),s&&(c=new URL(s,c).href),r.localName){case"a":r.href=c;break;case"dfn":{const e=r.ownerDocument.createElement("a");for(e.href=c;r.firstChild;)e.appendChild(r.firstChild);r.appendChild(e,r);break}}}}(i),a=e.querySelectorAll("dfn[data-cite], a[data-cite]"),s=Array.from(a).map(o);return await Promise.all(s)};e.name="core/data-cite";function r(e){return function t(n){const{dataset:r}=n;let{cite:i,citeFrag:o,citePath:a}=r;const s=i.startsWith("!"),l=i.search("/"),c=i.search("#");if(i.startsWith("#")&&!o){const r=n.parentElement.closest('[data-cite]:not([data-cite^="#"])'),{key:o,isNormative:a}=r?t(r):{key:e.shortName||"",isNormative:!1};return n.dataset.cite=a?`!${o}`:o,n.dataset.citeFrag=i,t(n)}return-1!==c&&(o=o||i.substr(c),i=i.substring(0,c)),-1!==l&&(a=a||i.substr(l),i=i.substring(0,l)),s&&(i=i.substr(1)),o&&!o.startsWith("#")&&(o="#"+o),a&&a.startsWith("/")&&(a=a.substr(1)),{key:i,isNormative:s,frag:o,path:a}}}}),define("core/webidl-index",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,t,n){const r=t.querySelector("section#idl-index");if(!r)return n();const i=[2,3,4,5,6].map(e=>`h${e}:first-child`).join(",");if(!r.querySelector(i)){const e=document.createElement("h2");r.title?(e.innerHTML=r.title,r.removeAttribute("title")):e.innerHTML="IDL Index",r.insertAdjacentElement("afterbegin",e)}if(!document.querySelector("pre.idl")){const e="This specification doesn't declare any Web IDL.",t=document.createTextNode(e);return r.appendChild(t),n()}const o=document.createDocumentFragment(),a=document.createElement("pre");a.classList.add("idl","def"),a.id="actual-idl-index",Array.from(document.querySelectorAll("pre.def.idl")).map(e=>{const t=document.createElement("span"),{children:n}=e.cloneNode(!0);for(const e of Array.from(n))t.appendChild(e),t.appendChild(document.createTextNode("\n"));return t.classList.add("respec-idl-separator"),t}).reduce((e,t)=>(e.appendChild(t),e),a),Array.from(a.querySelectorAll("*[id]")).forEach(e=>e.removeAttribute("id")),o.appendChild(a),r.appendChild(o),n()};e.name="core/webidl-index"}),define("core/link-to-dfn",["exports","core/data-cite","core/pubsubhub","./l10n"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,a){r.normalize();var s={};Object.keys(e.definitionMap).forEach(function(t){s[t]={};var r=[];if(e.definitionMap[t].forEach(function(e){void 0===e.attr("data-idl")&&e.removeAttr("data-dfn-for");var n=e.attr("data-dfn-for")||"";if(n in s[t]){var a=0!==s[t][n].filter("dfn").length,l=0!==e.filter("dfn").length;if(a&&l&&(e.addClass("respec-offending-element"),void 0===e.attr("title")&&e.attr("title",i[o].duplicate),void 0===e.attr("id")&&e.makeID(null,t),r.push(e[0])),a)return}s[t][n]=e,void 0===e.attr("id")&&(e.attr("data-idl")?e.makeID("dom",(n?n+"-":"")+t):e.makeID("dfn",t))}),r.length>0){const e=r.map((e,t)=>`[${t+1}](#${e.id})`).join(", ");(0,n.pub)("error",`Duplicate definitions of '${t}' at: ${e}.`)}}),$("a:not([href]):not([data-cite]):not(.logo)").each(function(){const e=$(this);if(e.hasClass("externalDFN"))return;const t=e.linkTargets(),r=t.some(function(t){if(s[t.title]&&s[t.title][t.for]){const n=s[t.title][t.for];if(n[0].dataset.cite)e[0].dataset.cite=n[0].dataset.cite;else{const t="#"+encodeURIComponent(n.prop("id"));e.attr("href",t).addClass("internalDFN")}if(e.attr("data-link-type")||e.attr("data-link-type","dfn"),n.closest("code,pre").length||1===n.contents().length&&1===n.children("code").length){const t=e[0].textContent.trim(),r=n[0].dataset.hasOwnProperty("idl"),i=r?n[0].dataset.title===t:n[0].textContent.trim()===t;if(r&&!i)return!0;e.wrapInner("<code></code>")}return!0}return!1});if(!r&&0!==t.length){if(!e.parents(".idl:not(.extAttr), dl.methods, dl.attributes, dl.constants, dl.constructors, dl.fields, dl.dictionary-members, span.idlMemberType, span.idlTypedefType, div.idlImplementsDesc").length){const r=t[0].for,i=t[0].title;return this.classList.add("respec-offending-element"),this.title="Linking error: not matching <dfn>",(0,n.pub)("warn","Found linkless <a> element "+(r?"for '"+r+"' ":"")+"with text '"+i+"' but no matching `<dfn>`."),void console.warn("Linkless element:",e[0])}e.replaceWith(e.contents())}}),(0,t.linkInlineCitations)(r,e).then(()=>{(0,n.pub)("end","core/link-to-dfn"),a()})};e.name="core/link-to-dfn";const i={en:{duplicate:"This is defined more than once in the document."}},o=r.lang in i?r.lang:"en"}),define("core/contrib",["exports","core/github","core/pubsubhub","core/utils"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){const i=document.getElementById("gh-commenters"),l=document.getElementById("gh-contributors");if(!i&&!l)return;const c={},{githubAPI:u,githubUser:d,githubToken:p}=e;if(d&&p){const e=btoa(`${d}:${p}`),t=`Basic ${e}`;Object.assign(c,{Authorization:t})}if(!u){const e="Requested list of contributors and/or commenters from GitHub, but [`githubAPI`](https://github.com/w3c/respec/wiki/githubAPI) is not set.";return void(0,n.pub)("error",e)}const f=await fetch(u,{headers:c});if(!f.ok){const e="Error fetching repository information from GitHub. "+`(HTTP Status ${f.status}).`;return void(0,n.pub)("error",e)}const h=await f.json(),{issues_url:m,issue_comment_url:g,contributors_url:b}=h,[y,v,w]=await Promise.all([(0,t.fetchIndex)(m,c),(0,t.fetchIndex)(g,c),(0,t.fetchIndex)(b,c)]),x=e.editors.map(o),k=i?function(...e){const t=e.reduce(r.flatten,[]).filter(e=>e&&e.user).map(({user:e})=>e.url);return[...new Set(t)]}(y,v):[],C=l?w.map(a):[];try{await Promise.all(s(k,x,i,c),s(C,x,l,c))}catch(e){(0,n.pub)("error","Error loading contributors and/or commenters from GitHub.")}};e.name="core/contrib";function i(e){return t=>t[e]}const o=i("name"),a=i("url");async function s(e,t,n,i){const o=(await Promise.all(e.map(e=>fetch(e,{headers:i})))).map(([e])=>e.name||e.login).filter(e=>!t.includes(e)).sort((e,t)=>e.toLowerCase().localeCompare(t.toLowerCase()));n.textContent=(0,r.joinAnd)(o),n.id=null}}),define("core/fix-headers",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,t,n){$("section:not(.introductory)",t).find("h1:first, h2:first, h3:first, h4:first, h5:first, h6:first").each(function(){var e=$(this).parents("section").length+1;e>6&&(e=6);var t="h"+e;this.localName.toLowerCase()!==t&&$(this).renameElement(t)}),n()};e.name="core/fix-headers"}),define("core/structure",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,o,a){"tocIntroductory"in e==!1&&(e.tocIntroductory=!1);"maxTocLevel"in e==!1&&(e.maxTocLevel=0);var s=$("section:not(.introductory)",o).find("h1:first, h2:first, h3:first, h4:first, h5:first, h6:first").toArray().filter(e=>null===e.closest("section.introductory"));if(!(s=$(s)).length)return a();if(s.each(function(){var e=$(this).parents("section").length+1;e>6&&(e=6);var t="h"+e;this.localName.toLowerCase()!==t&&$(this).renameElement(t)}),!e.noTOC){var l=function e(o,a,s,l,c){var u=o.children(c.tocIntroductory?"section":"section:not(.introductory)");if(0===u.length)return null;var d=$("<ol class='toc'></ol>");for(var p=0;p<u.length;p++){var f=$(u[p],a),h=f.hasClass("introductory"),m=f.hasClass("notoc");if(f.children().length&&!m){var g=f.children()[0],b=g.localName.toLowerCase();if("h2"===b||"h3"===b||"h4"===b||"h5"===b||"h6"===b){var y=g.textContent,v=$("<div></div>").append($(g).contents().clone());v.find("a").renameElement("span").attr("class","formerLink").removeAttr("href"),v.find("dfn").renameElement("span").removeAttr("id");var w=g.id?g.id:f.makeID(null,y);h||s[s.length-1]++;var x=s.slice();f.hasClass("appendix")&&1===s.length&&!n&&(r=s[0],n=!0),n&&(x[0]=i.charAt(s[0]-r));var k=x.join("."),C=1==x.length;C&&(k+=".",$(g).before(document.createComment("OddPage")));var E=$("<span class='secno'></span>").text(k+" ");h||$(g).prepend(E),t[w]=(h?"":"<span class='secno'>"+k+"</span> ")+"<span class='sec-title'>"+y+"</span>";var T=$("<a/>").attr({href:"#"+w,class:"tocxref"}).append(h?"":E.clone()).append(v.contents()),S=$("<li class='tocline'/>").append(T);(0===c.maxTocLevel||l<=c.maxTocLevel)&&d.append(S),s.push(0);var A=e(f,a,s,l+1,c);A&&S.append(A),s.pop()}}}return d}($("body",o),o,[0],1,e);if(!l)return;var c=o.createElement("nav");c.id="toc",c.innerHTML="<h2 class='introductory'>"+e.l10n.toc+"</h2>",c.appendChild(l[0]);var u=$("#toc",o),d=!1;u.length&&(d=!0),u.length||(u=$("#sotd",o)),u.length||(u=$("#abstract",o)),d?u.replaceWith(c):u.after(c);var p=$("<p role='navigation' id='back-to-top'><a href='#title'><abbr title='Back to Top'>↑</abbr></a></p>");$("body").append(p)}$("a[href^='#']:not(.tocxref)",o).each(function(){var e=$(this);if(""===e.html()){var n=e.attr("href").slice(1);t[n]&&(e.addClass("sec-ref"),e.html((e.hasClass("sectionRef")?"section ":"")+t[n]))}}),a()};var t={},n=!1,r=0,i="ABCDEFGHIJKLMNOPQRSTUVWXYZ";e.name="core/structure"}),define("w3c/informative",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(){Array.from(document.querySelectorAll("section.informative")).map(e=>e.querySelector("h2, h3, h4, h5, h6")).filter(e=>e).forEach(e=>{e.parentNode.insertBefore(hyperHTML`<p><em>This section is non-normative.</em></p>`,e.nextSibling)})};e.name="w3c/informative"}),define("w3c/permalinks",["exports","templates"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){if(!e.includePermalinks)return n();const i=r.default["permalinks.css"];var o=e.permalinkSymbol||"§",a="<style>"+i(e)+"</style>";$(t).find("head link").first().before(a),$(t).find("h2, h3, h4, h5, h6").each(function(t,n){var r=$(n);if(!r.hasClass("nolink")){var i=r.attr("id"),a=r.parent();if((a.is("section")||a.is("div"))&&(i=a.hasClass("introductory")||a.hasClass("nolink")?null:a.attr("id")),i){var s=$("<span></span>");s.attr("class","permalink");var l=r.text(),c=$("<a></a>");c.attr({href:"#"+i,"aria-label":"Permalink for "+l,title:"Permalink for "+l});var u=$("<span></span>");u.append(o),c.append(u),s.append(c),e.permalinkEdge||r.append(" "),r.append(s)}}}),n()};var n,r=(n=t)&&n.__esModule?n:{default:n};e.name="w3c/permalinks"}),define("core/id-headers",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,t,n){Array.from(document.querySelectorAll("h2:not([id]), h3:not([id]), h4:not([id]), h5:not([id]), h6:not([id])")).forEach(e=>{$(e).makeID()}),n()};e.name="core/id-headers"}),define("core/location-hash",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){(0,t.pub)("start","core/location-hash");let i="";try{i=decodeURIComponent(window.location.hash).substr(1)}catch(e){i=""}if(!i&&!document.documentElement.scrollTop)return r();const o=!!n.getElementById(i),a=/\W/.test(i);if(!o&&a){const e=i.replace(/[\W]+/gim,"-").replace(/^-+/,"").replace(/-+$/,"");document.getElementById(e)&&(i=e)}window.location.hash=`#${i}`,r()};e.name="core/location-hash"}),define("deps/text!core/css/caniuse.css",[],function(){return"/* container for stats */\n.caniuse-stats {\n display: flex;\n flex-wrap: wrap;\n justify-content: flex-start;\n align-items: baseline;\n cursor: pointer;\n}\n\nbutton.caniuse-cell {\n margin: 1px 1px 0 0;\n border: none;\n}\n\n.caniuse-browser {\n position: relative;\n}\n\n/* reset styles, hide old versions by default */\n.caniuse-browser ul {\n display: none;\n margin: 0;\n padding: 0;\n list-style: none;\n position: absolute;\n left: 0;\n z-index: 2;\n background: #fff;\n margin-top: 1px;\n}\n\n.caniuse-stats a {\n white-space: nowrap;\n align-self: center;\n margin-left: .5em;\n}\n\n/* a browser version */\n.caniuse-cell {\n display: flex;\n color: rgba(0, 0, 0, 0.8);\n font-size: 90%;\n height: 0.8cm;\n margin-right: 1px;\n margin-top: 0;\n min-width: 3cm;\n overflow: visible;\n justify-content: center;\n align-items: center;\n}\n\nli.caniuse-cell {\n margin-bottom: 1px;\n}\n\n.caniuse-cell:focus {\n outline: none;\n}\n\n.caniuse-cell:hover {\n color: rgba(0, 0, 0, 1);\n}\n\n/* supports */\n.caniuse-cell.y {\n background: #8bc34a;\n}\n\n/* no support */\n.caniuse-cell.n {\n background: #e53935;\n}\n\n/* not supported by default / partial support etc\nsee https://github.com/Fyrd/caniuse/blob/master/CONTRIBUTING.md for stats */\n.caniuse-cell.d,\n.caniuse-cell.a,\n.caniuse-cell.x,\n.caniuse-cell.p {\n background: #ffc107;\n}\n\n/* show rest of the browser versions */\n.caniuse-stats button:focus + ul,\n.caniuse-stats .caniuse-browser:hover > ul {\n display: block;\n}\n"}),define("core/caniuse",["exports","core/utils","core/pubsubhub","deps/text!core/css/caniuse.css","deps/hyperhtml"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){if(!e.caniuse)return;!function(e){const t={maxAge:864e5,browsers:["chrome","firefox","safari","edge"],versions:4};if("string"==typeof e.caniuse)return void(e.caniuse=a({feature:e.caniuse},t));Array.isArray(e.caniuse.browsers)?e.caniuse.browsers=e.caniuse.browsers.map(e=>e.toLowerCase()).filter(function(e){if(l.has(e))return!0;return(0,n.pub)("warn",`Ignoring invalid browser "\`${e}\`" in `+"[`respecConfig.caniuse.browsers`](https://github.com/w3c/respec/wiki/caniuse)"),!1}):e.caniuse.browsers=t.browsers;Object.assign(e.caniuse,t,a({},e.caniuse))}(e);const{caniuse:r}=e;if(!r.feature)return;const{feature:i}=r,u="https://caniuse.com/#feat="+i,d=(0,t.createResourceHint)({hint:"preconnect",href:"https://raw.githubusercontent.com"});document.head.appendChild(d),document.head.appendChild(hyperHTML` - <style class="removeOnSave">${o.default}</style>`);const p=document.querySelector(".head dl"),f=new Promise(async e=>{let o;try{const e=await async function(e){const{apiURL:n,feature:r,maxAge:i}=e,o=n?n.replace("{FEATURE}",r):`${s}${r}.json`,a=new Request(o),l=await(0,t.fetchAndCache)(a,i),{stats:c}=await l.json();return c}(r);o=function(e,n){return hyperHTML` - ${e.browsers.map(r=>(function(e,n,r){if(!r)return;const i=e=>{const t=r[e].split("#",1)[0].split(" ").filter(e=>e),n=t.filter(e=>c.has(e)).map(e=>c.get(e));return{support:t.join(" "),title:n.join(" ")}},[o,...a]=Object.keys(r).sort(t.semverCompare).slice(-n).reverse(),{support:s,title:u}=i(o);return hyperHTML` - <div class="caniuse-browser"> - <button class="${`caniuse-cell ${s}`}" title="${u}"> - ${l.get(e)||e} ${o} - </button> - <ul> - ${a.map(e=>{const{support:t,title:n}=i(e);return`<li class="${"caniuse-cell "+t}" title="${n}">${e}</li>`})} - </ul> - </div>`})(r,e.versions,n[r])).filter(e=>e)} - <a href="${`https://caniuse.com/#feat=${e.feature}`}" - title="Get details at caniuse.com">More info - </a>`}(r,e)}catch(e){console.error(e);const t=`Couldn't find feature "${i}" on caniuse.com? `+"Please check the feature key on [caniuse.com](https://caniuse.com)";(0,n.pub)("error",t),o=hyperHTML`<a href="${u}">caniuse.com</a>`}e(o)}),h=hyperHTML.bind(document.createDocumentFragment())` - <dt class="caniuse-title">Can I Use this API?</dt> - <dd class="caniuse-stats">${{any:f,placeholder:"Fetching data from caniuse.com..."}}</dd>`;p.appendChild(h),await f,(0,n.pub)("amend-user-config",{caniuse:i}),(0,n.sub)("beforesave",e=>{hyperHTML.bind(e.querySelector(".caniuse-stats"))` - <a href="${u}">caniuse.com</a>`})};var i,o=(i=r)&&i.__esModule?i:{default:i};var a=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="core/caniuse";const s="https://raw.githubusercontent.com/Fyrd/caniuse/master/features-json/",l=new Map([["chrome","Chrome"],["firefox","Firefox"],["ie","IE"],["edge","Edge"],["android","Android"],["safari","Safari"],["opera","Opera"],["bb","Blackberry"],["and_uc","UC (Android)"],["and_ff","Firefox (Android)"]]),c=new Map([["y","Supported."],["a","Almost supported (aka Partial support)."],["n","No support, or disabled by default."],["p","No support, but has Polyfill."],["u","Support unknown."],["x","Requires prefix to work."],["d","Disabled by default (needs to enabled)."]])}),define("core/exporter",["exports","core/utils","core/pubsubhub","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rsDocToDataURL=function(e,i=document){const o=r.get(e);if(!o){const t=[...r.values()].join(", "),n=`Invalid format: ${e}. Expected one of: ${t}.`;throw new TypeError(n)}const a=function(e,r){const i=r.cloneNode(!0);!function(e){const{head:r,body:i,documentElement:o}=e;(function({documentElement:e}){const t=document.createTreeWalker(e,NodeFilter.SHOW_COMMENT,e=>e.textContent.startsWith("_hyper"));for(const e of[...function*(e){for(;e.nextNode();)yield e.currentNode}(t)])e.remove()})(e),e.querySelectorAll(".removeOnSave, #toc-nav").forEach(e=>e.remove()),i.classList.remove("toc-sidebar"),(0,t.removeReSpec)(o);const a=e.createDocumentFragment(),s=e.querySelector("meta[name='viewport']");s&&r.firstChild!==s&&a.appendChild(s);let l=e.querySelector("meta[charset], meta[content*='charset=']");l||(l=hyperHTML`<meta charset="utf-8">`);a.appendChild(l);const c=hyperHTML` - <meta name="generator" content="${`ReSpec ${window.respecVersion||"Developer Channel"}`}"> - `;a.appendChild(c),r.insertBefore(a,r.firstChild),(0,n.pub)("beforesave",o)}(i);let o="";switch(e){case"xml":o=(new XMLSerializer).serializeToString(i);break;default:i.doctype&&(o+=(new XMLSerializer).serializeToString(i.doctype)),o+=i.documentElement.outerHTML}return o}(o,i),s=encodeURIComponent(a);return`data:${e};charset=utf-8,${s}`};const r=new Map([["text/html","html"],["application/xml","xml"]])}),define("ui/save-html",["exports","core/ui","core/l10n","core/pubsubhub","core/exporter","deps/hyperhtml"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.show=function(){if(!c)return;l.show(u)},e.exportDocument=function(e,t){const n="Exporting via ui/save-html module's `exportDocument()` is deprecated and will be removed. Use core/exporter `rsDocToDataURL()` instead.";return(0,r.pub)("warn",n),console.warn(n),(0,i.rsDocToDataURL)(t)};e.name="ui/save-html";const o=new URL("https://labs.w3.org/epub-generator/cgi-bin/epub-generator.py");o.searchParams.append("type","respec"),o.searchParams.append("url",document.location.href);const a=[{id:"respec-save-as-html",fileName:"index.html",title:"HTML",type:"text/html",get href(){return(0,i.rsDocToDataURL)(this.type)}},{id:"respec-save-as-xml",fileName:"index.xhtml",title:"XML",type:"application/xml",get href(){return(0,i.rsDocToDataURL)(this.type)}},{id:"respec-save-as-epub",fileName:"spec.epub",title:"EPUB 3",type:"application/epub+zip",href:o.href}];function s(e){const{id:n,href:r,fileName:i,title:o,type:a}=e;return hyperHTML` - <a - href="${r}" - id="${n}" - download="${i}" - type="${a}" - class="respec-save-button" - onclick=${()=>t.ui.closeModal()} - >${o}</a>`}const l={async show(e){await document.respecIsReady;const r=hyperHTML` - <div class="respec-save-buttons"> - ${a.map(s)} - </div>`;t.ui.freshModal(n.l10n[n.lang].save_snapshot,r,e)}},c="download"in HTMLAnchorElement.prototype;let u;c&&(u=t.ui.addCommand(n.l10n[n.lang].save_snapshot,"ui/save-html","Ctrl+Shift+Alt+S","💾"))}),define("ui/search-specref",["exports","core/ui","core/biblio","core/l10n"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.show=void 0;const i=t.ui.addCommand(r.l10n[r.lang].search_specref,"ui/search-specref","Ctrl+Shift+Alt+space","🔎"),o="https://specref.herokuapp.com/",a=`${o}search-refs`,s=`${o}reverse-lookup`,l=document.createElement("form"),c=window.hyperHTML.bind(l),u=hyperHTML.bind(document.createElement("div"));function d([e,t]){return hyperHTML.wire(t)` - <dt> - [${e}] - </dt> - <dd>${(0,n.wireReference)(t)}</dd> - `}l.id="specref-ui",l.addEventListener("submit",async e=>{e.preventDefault();const{searchBox:t}=l,n=t.value;if(!n)return void t.focus();f({state:"Searching Specref…"});const r=new URL(a);r.searchParams.set("q",n);const i=new URL(s);i.searchParams.set("urls",n);try{const e=performance.now(),o=await Promise.all([fetch(r).then(e=>e.json()),fetch(i).then(e=>e.json())]),{checked:a}=l.includeVersions;f({query:n,results:function({includeVersions:e}={includeVersions:!1}){return(...t)=>{const n=t.reduce((e,t)=>Object.assign(e,t),{}),r=new Map(Object.entries(n));return Array.from(r.entries()).filter(([,e])=>e.aliasOf).map(([e])=>e).reduce((e,t)=>e.delete(t)&&e,r),e||Array.from(r.values()).filter(e=>"object"==typeof e&&"versions"in e).reduce((e,t)=>e.concat(t.versions),[]).forEach(e=>{r.delete(e)}),Array.from(r.entries()).filter(([,e])=>"object"!=typeof e).reduce((e,[t])=>r.delete(t)&&r,r),r}}({includeVersions:a})(...o),state:"",timeTaken:Math.round(performance.now()-e)/1e3})}catch(e){console.error(e),f({state:"Error! Couldn't do search."})}finally{t.focus()}});const p=hyperHTML.wire()` - <header> - <p> - An Open-Source, Community-Maintained Database of - Web Standards & Related References. - </p> - </header> - <div class="searchcomponent"> - <input - name="searchBox" - type="search" - autocomplete="off" - placeholder="Keywords, titles, authors, urls…"> - <button - type="submit"> - Search - </button> - <label> - <input type="checkbox" name="includeVersions"> Include all versions. - </label> - </div> -`;function f({state:e,results:t,timeTaken:n,query:r}={state:""}){t?c` - <div>${p}</div> - <p class="state" hidden="${!e}"> - ${e} - </p> - <section hidden="${!t}">${t?function(e,t,n){if(!e.size)return u` - <p class="state"> - Your search - <strong> ${t} </strong> - - did not match any references. - </p> - `;const r=Array.from(e.entries()).slice(0,99).map(d).reduce((e,t)=>e.concat(t),[]);return u` - <p class="result-stats"> - ${e.size} results (${n} seconds). - ${e.size>99?"First 100 results.":""} - </p> - <dl class="specref-results">${r}</dl> - `}(t,r,n):[]}</section> - `:c`<div>${p}</div>`}e.show=function(){f(),t.ui.freshModal(r.l10n[r.lang].search_specref,l,i),l.querySelector("input[type=search]").focus()}}),define("ui/dfn-list",["exports","core/ui","core/l10n","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.show=void 0;const r=t.ui.addCommand(n.l10n[n.lang].definition_list,"ui/dfn-list","Ctrl+Shift+Alt+D","📔"),i=document.createElement("ul");i.classList.add("respec-dfn-list");const o=window.hyperHTML.bind(i);i.addEventListener("click",e=>{t.ui.closeModal(),e.stopPropagation()}),e.show=function(){o`${Object.entries(respecConfig.definitionMap).sort(([e],[t])=>e.localeCompare(t)).map(([e,t])=>{const[n]=t[0];return window.hyperHTML.wire(n,":li>a")` - <li> - <a href="${"#"+n.id}"> - ${n.textContent} - </a> - </li> - `})}`,t.ui.freshModal(n.l10n[n.lang].list_of_definitions,i,r)}}),define("ui/about-respec",["exports","core/ui","core/l10n","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.show=void 0,window.respecVersion=window.respecVersion||"Developer Edition";const r=document.createElement("div"),i=hyperHTML.bind(r),o=t.ui.addCommand(`About ${window.respecVersion}`,"ui/about-respec","Ctrl+Shift+Alt+A","ℹ️");function a({name:e,duration:t}){const n=hyperHTML.bind(document.createElement("tr"));return n` - <td> - <a href="${`https://github.com/w3c/respec/tree/develop/src/${e}.js`}"> - ${e} - </a> - </td> - <td> - ${t} - </td> - `}e.show=function(){t.ui.freshModal(`${n.l10n[n.lang].about_respec} - ${window.respecVersion}`,r,o);let e=[];"getEntriesByType"in performance&&performance.getEntriesByType("measure").sort((e,t)=>t.duration-e.duration).map(({name:e,duration:t})=>{const n=t.toFixed(2);return{name:e,duration:n>1e3?`${Math.round(n/1e3)} second(s)`:`${n} milliseconds`}}).map(a).reduce((e,t)=>(e.push(t),e),e),i` - <p> - ReSpec is a document production toolchain, with a notable focus on W3C specifications. - </p> - <p> - <a href='https://github.com/w3c/respec/wiki'>Documentation</a>, - <a href='https://github.com/w3c/respec/issues'>Bugs</a>. - </p> - <table border="1" width="100%" hidden="${!e.length}"> - <caption> - Loaded plugins - </caption> - <thead> - <tr> - <th> - Plugin Name - </th> - <th> - Processing time - </th> - </tr> - </thead> - <tbody>${e}</tbody> - </table> -`}}),define("core/seo",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=async function(e,t,n){n(),await t.respecIsReady;const r=t.querySelector("#abstract p:first-of-type");if(!r)return;!function(e){const t=e.ownerDocument,n=e.textContent.replace(/\s+/," ").trim(),r=t.createElement("meta");r.name="description",r.content=n,t.head.appendChild(r)}(r)};e.name="core/seo"}),define("w3c/seo",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,i,o){var a=e.shortName?"https://www.w3.org/TR/"+e.shortName+"/":null;switch(e.canonicalURI){case"edDraft":e.edDraftURI?e.canonicalURI=new URL(e.edDraftURI,i.location).href:((0,t.pub)("warn","Canonical URI set to edDraft, but no edDraftURI is set in configuration"),e.canonicalURI=null);break;case"TR":a?e.canonicalURI=a:((0,t.pub)("warn","Canonical URI set to TR, but no shortName is set in configuration"),e.canonicalURI=null);break;default:if(e.canonicalURI)try{e.canonicalURI=new URL(e.canonicalURI,i.location).href}catch(n){(0,t.pub)("warn","CanonicalURI is an invalid URL: "+n.message),e.canonicalURI=null}else a&&(e.canonicalURI=a)}if(e.canonicalURI){var s=i.createElement("link");s.setAttribute("rel","canonical"),s.setAttribute("href",e.canonicalURI),i.head.appendChild(s)}o(),e.doJsonLd&&async function(e,t){await t.respecIsReady;const i=["TechArticle"];e.rdfStatus&&i.push(e.rdfStatus);const o={"@context":["http://schema.org",{"@vocab":"http://schema.org/","@language":t.documentElement.lang||"en",w3p:"http://www.w3.org/2001/02pd/rec54#",foaf:"http://xmlns.com/foaf/0.1/",datePublished:{"@type":"http://www.w3.org/2001/XMLSchema#date"},inLanguage:{"@language":null},isBasedOn:{"@type":"@id"},license:{"@type":"@id"}}],id:e.canonicalURI||e.thisVersion,type:i,name:e.title,inLanguage:t.documentElement.lang||"en",license:e.licenseInfo.url,datePublished:e.dashDate,copyrightHolder:{name:"World Wide Web Consortium",url:"https://www.w3.org/"},discussionUrl:e.issueBase,alternativeHeadline:e.subtitle,isBasedOn:e.prevVersion};if(e.additionalCopyrightHolders){const t=Array.isArray(e.additionalCopyrightHolders)?e.additionalCopyrightHolders:[e.additionalCopyrightHolders];o.copyrightHolder=[o.copyrightHolder,...t.map(e=>({name:e}))]}const a=t.head.querySelector("meta[name=description]");a&&(o.description=a.content);e.editors&&(o.editor=e.editors.map(n));e.authors&&(o.contributor=e.authors.map(n));o.citation=[...e.normativeReferences,...e.informativeReferences].map(t=>e.biblio[t]).filter(e=>"object"==typeof e).map(r);const s=t.createElement("script");s.type="application/ld+json",s.textContent=JSON.stringify(o,null,2),t.head.appendChild(s)}(e,i)};e.name="w3c/seo";function n({name:e,url:t,mailto:n,company:r,companyURL:i}){const o={type:"Person",name:e,url:t,"foaf:mbox":n};return(r||i)&&(o.worksFor={name:r,url:i}),o}function r(e){const{href:t,title:n,href:r}=e;return{id:t,type:"TechArticle",name:n,url:r}}}),define("deps/text!core/css/github.css",[],function(){return"/*\n\ngithub.com style (c) Vasily Polovnyov <vast@whiteants.net>\n\n*/\n\n.hljs {\n display: block;\n overflow-x: auto;\n padding: 0.5em;\n color: #333;\n background: #f8f8f8;\n}\n\n.hljs-comment,\n.hljs-quote {\n color: #998;\n font-style: italic;\n}\n\n.hljs-keyword,\n.hljs-selector-tag,\n.hljs-subst {\n color: #333;\n font-weight: bold;\n}\n\n.hljs-number,\n.hljs-literal,\n.hljs-variable,\n.hljs-template-variable,\n.hljs-tag .hljs-attr {\n color: #008080;\n}\n\n.hljs-string,\n.hljs-doctag {\n color: #d14;\n}\n\n.hljs-title,\n.hljs-section,\n.hljs-selector-id {\n color: #900;\n font-weight: bold;\n}\n\n.hljs-subst {\n font-weight: normal;\n}\n\n.hljs-type,\n.hljs-class .hljs-title {\n color: #458;\n font-weight: bold;\n}\n\n.hljs-tag,\n.hljs-name,\n.hljs-attribute {\n color: #000080;\n font-weight: normal;\n}\n\n.hljs-regexp,\n.hljs-link {\n color: #009926;\n}\n\n.hljs-symbol,\n.hljs-bullet {\n color: #990073;\n}\n\n.hljs-built_in,\n.hljs-builtin-name {\n color: #0086b3;\n}\n\n.hljs-meta {\n color: #999;\n font-weight: bold;\n}\n\n.hljs-deletion {\n background: #fdd;\n}\n\n.hljs-addition {\n background: #dfd;\n}\n\n.hljs-emphasis {\n font-style: italic;\n}\n\n.hljs-strong {\n font-weight: bold;\n}\n"}),define("deps/text!core/../../worker/respec-worker.js",[],function(){return'// ReSpec Worker v0.1.1\n"use strict";\ntry {\n importScripts("https://www.w3.org/Tools/respec/respec-highlight.js");\n hljs.configure({\n tabReplace: " ", // 2 spaces\n languages: ["abnf", "css", "http", "javascript", "json", "markdown", "xml"],\n });\n} catch (err) {\n console.error("Network error loading/configuring highlighter", err);\n}\n\nself.addEventListener("message", ({ data: originalData }) => {\n const data = Object.assign({}, originalData);\n switch (data.action) {\n case "highlight":\n const { code } = data;\n const langs = data.languages.length ? data.languages : undefined;\n try {\n const { value, language } = self.hljs.highlightAuto(code, langs);\n Object.assign(data, { value, language });\n } catch (err) {\n console.error("Could not transform some code?", err);\n // Post back the original code\n Object.assign(data, { value: code, language: "" });\n }\n }\n self.postMessage(data);\n});\n'}),define("core/worker",["exports","core/utils","deps/text!../../worker/respec-worker.js"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.worker=e.name=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/worker";const o=(0,t.createResourceHint)({hint:"preload",href:"https://www.w3.org/Tools/respec/respec-highlight.js",as:"script"});document.head.appendChild(o);const a=URL.createObjectURL(new Blob([i.default],{type:"application/javascript"}));e.worker=new Worker(a)}),define("core/highlight",["exports","deps/text!core/css/github.css","core/worker"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){if(e.noHighlightCSS)return void o.remove();const t=Array.from(document.querySelectorAll("pre:not(.idl):not(.nohighlight), code.highlight"));if(0===t.length)return void o.remove();const r=t.map((e,t)=>new Promise(r=>{if(""===e.textContent.trim())return r();const o=()=>{e.setAttribute("aria-busy","false"),r()},a=setTimeout(()=>{console.error("Timed-out waiting for highlight:",e),o()},4e3),s={action:"highlight",code:e.textContent,id:`highlight:${t}`,languages:(i=e.classList,Array.from(i).filter(e=>"highlight"!==e&&"nolinks"!==e).map(e=>e.toLowerCase()))};n.worker.addEventListener("message",function t(r){const{data:{id:i,code:l,language:c,value:u}}=r;i===s.id&&(e.innerHTML=u,"pre"===e.localName&&e.classList.add("hljs"),c&&e.classList.add(c),clearTimeout(a),n.worker.removeEventListener("message",t),o())}),e.setAttribute("aria-busy","true"),n.worker.postMessage(s)}));var i;await Promise.all(r)};var r,i=(r=t)&&r.__esModule?r:{default:r};e.name="core/highlight";const o=document.createElement("style");o.textContent=i.default,document.head.appendChild(o)}),define("deps/text!core/images/clipboard.svg",[],function(){return'<svg height="16" viewBox="0 0 14 16" width="14"><path fill-rule="evenodd" d="M2 13h4v1H2v-1zm5-6H2v1h5V7zm2 3V8l-3 3 3 3v-2h5v-2H9zM4.5 9H2v1h2.5V9zM2 12h2.5v-1H2v1zm9 1h1v2c-.02.28-.11.52-.3.7-.19.18-.42.28-.7.3H1c-.55 0-1-.45-1-1V4c0-.55.45-1 1-1h3c0-1.11.89-2 2-2 1.11 0 2 .89 2 2h3c.55 0 1 .45 1 1v5h-1V6H1v9h10v-2zM2 5h8c0-.55-.45-1-1-1H8c-.55 0-1-.45-1-1s-.45-1-1-1-1 .45-1 1-.45 1-1 1H3c-.55 0-1 .45-1 1z"/></svg>'}),eXa=this,fXa=function(){return function(e){var t={};function n(r){if(t[r])return t[r].exports;var i=t[r]={i:r,l:!1,exports:{}};return e[r].call(i.exports,i,i.exports,n),i.l=!0,i.exports}return n.m=e,n.c=t,n.i=function(e){return e},n.d=function(e,t,r){n.o(e,t)||Object.defineProperty(e,t,{configurable:!1,enumerable:!0,get:r})},n.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return n.d(t,"a",t),t},n.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},n.p="",n(n.s=3)}([function(e,t,n){var r,i,o,a;a=function(e,t){var n,r=(n=t)&&n.__esModule?n:{default:n};var i="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e};var o=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),a=function(){function e(t){!function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}(this,e),this.resolveOptions(t),this.initSelection()}return o(e,[{key:"resolveOptions",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this.action=e.action,this.container=e.container,this.emitter=e.emitter,this.target=e.target,this.text=e.text,this.trigger=e.trigger,this.selectedText=""}},{key:"initSelection",value:function(){this.text?this.selectFake():this.target&&this.selectTarget()}},{key:"selectFake",value:function(){var e=this,t="rtl"==document.documentElement.getAttribute("dir");this.removeFake(),this.fakeHandlerCallback=function(){return e.removeFake()},this.fakeHandler=this.container.addEventListener("click",this.fakeHandlerCallback)||!0,this.fakeElem=document.createElement("textarea"),this.fakeElem.style.fontSize="12pt",this.fakeElem.style.border="0",this.fakeElem.style.padding="0",this.fakeElem.style.margin="0",this.fakeElem.style.position="absolute",this.fakeElem.style[t?"right":"left"]="-9999px";var n=window.pageYOffset||document.documentElement.scrollTop;this.fakeElem.style.top=n+"px",this.fakeElem.setAttribute("readonly",""),this.fakeElem.value=this.text,this.container.appendChild(this.fakeElem),this.selectedText=(0,r.default)(this.fakeElem),this.copyText()}},{key:"removeFake",value:function(){this.fakeHandler&&(this.container.removeEventListener("click",this.fakeHandlerCallback),this.fakeHandler=null,this.fakeHandlerCallback=null),this.fakeElem&&(this.container.removeChild(this.fakeElem),this.fakeElem=null)}},{key:"selectTarget",value:function(){this.selectedText=(0,r.default)(this.target),this.copyText()}},{key:"copyText",value:function(){var e=void 0;try{e=document.execCommand(this.action)}catch(t){e=!1}this.handleResult(e)}},{key:"handleResult",value:function(e){this.emitter.emit(e?"success":"error",{action:this.action,text:this.selectedText,trigger:this.trigger,clearSelection:this.clearSelection.bind(this)})}},{key:"clearSelection",value:function(){this.trigger&&this.trigger.focus(),window.getSelection().removeAllRanges()}},{key:"destroy",value:function(){this.removeFake()}},{key:"action",set:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:"copy";if(this._action=e,"copy"!==this._action&&"cut"!==this._action)throw new Error('Invalid "action" value, use either "copy" or "cut"')},get:function(){return this._action}},{key:"target",set:function(e){if(void 0!==e){if(!e||"object"!==(void 0===e?"undefined":i(e))||1!==e.nodeType)throw new Error('Invalid "target" value, use a valid Element');if("copy"===this.action&&e.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if("cut"===this.action&&(e.hasAttribute("readonly")||e.hasAttribute("disabled")))throw new Error('Invalid "target" attribute. You can\'t cut text from elements with "readonly" or "disabled" attributes');this._target=e}},get:function(){return this._target}}]),e}();e.exports=a},i=[e,n(7)],void 0===(o="function"==typeof(r=a)?r.apply(t,i):r)||(e.exports=o)},function(e,t,n){var r=n(6),i=n(5);e.exports=function(e,t,n){if(!e&&!t&&!n)throw new Error("Missing required arguments");if(!r.string(t))throw new TypeError("Second argument must be a String");if(!r.fn(n))throw new TypeError("Third argument must be a Function");if(r.node(e))return p=t,f=n,(d=e).addEventListener(p,f),{destroy:function(){d.removeEventListener(p,f)}};if(r.nodeList(e))return l=e,c=t,u=n,Array.prototype.forEach.call(l,function(e){e.addEventListener(c,u)}),{destroy:function(){Array.prototype.forEach.call(l,function(e){e.removeEventListener(c,u)})}};if(r.string(e))return o=e,a=t,s=n,i(document.body,o,a,s);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList");var o,a,s,l,c,u,d,p,f}},function(e,t){function n(){}n.prototype={on:function(e,t,n){var r=this.e||(this.e={});return(r[e]||(r[e]=[])).push({fn:t,ctx:n}),this},once:function(e,t,n){var r=this;function i(){r.off(e,i),t.apply(n,arguments)}return i._=t,this.on(e,i,n)},emit:function(e){for(var t=[].slice.call(arguments,1),n=((this.e||(this.e={}))[e]||[]).slice(),r=0,i=n.length;r<i;r++)n[r].fn.apply(n[r].ctx,t);return this},off:function(e,t){var n=this.e||(this.e={}),r=n[e],i=[];if(r&&t)for(var o=0,a=r.length;o<a;o++)r[o].fn!==t&&r[o].fn._!==t&&i.push(r[o]);return i.length?n[e]=i:delete n[e],this}},e.exports=n},function(e,t,n){var r,i,o,a;a=function(e,t,n,r){var i=s(t),o=s(n),a=s(r);function s(e){return e&&e.__esModule?e:{default:e}}var l="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e};var c=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}();var u=function(e){function t(e,n){!function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}(this,t);var r=function(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}(this,(t.__proto__||Object.getPrototypeOf(t)).call(this));return r.resolveOptions(n),r.listenClick(e),r}return function(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}(t,o.default),c(t,[{key:"resolveOptions",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this.action="function"==typeof e.action?e.action:this.defaultAction,this.target="function"==typeof e.target?e.target:this.defaultTarget,this.text="function"==typeof e.text?e.text:this.defaultText,this.container="object"===l(e.container)?e.container:document.body}},{key:"listenClick",value:function(e){var t=this;this.listener=(0,a.default)(e,"click",function(e){return t.onClick(e)})}},{key:"onClick",value:function(e){var t=e.delegateTarget||e.currentTarget;this.clipboardAction&&(this.clipboardAction=null),this.clipboardAction=new i.default({action:this.action(t),target:this.target(t),text:this.text(t),container:this.container,trigger:t,emitter:this})}},{key:"defaultAction",value:function(e){return d("action",e)}},{key:"defaultTarget",value:function(e){var t=d("target",e);if(t)return document.querySelector(t)}},{key:"defaultText",value:function(e){return d("text",e)}},{key:"destroy",value:function(){this.listener.destroy(),this.clipboardAction&&(this.clipboardAction.destroy(),this.clipboardAction=null)}}],[{key:"isSupported",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:["copy","cut"],t="string"==typeof e?[e]:e,n=!!document.queryCommandSupported;return t.forEach(function(e){n=n&&!!document.queryCommandSupported(e)}),n}}]),t}();function d(e,t){var n="data-clipboard-"+e;if(t.hasAttribute(n))return t.getAttribute(n)}e.exports=u},i=[e,n(0),n(2),n(1)],void 0===(o="function"==typeof(r=a)?r.apply(t,i):r)||(e.exports=o)},function(e,t){var n=9;if("undefined"!=typeof Element&&!Element.prototype.matches){var r=Element.prototype;r.matches=r.matchesSelector||r.mozMatchesSelector||r.msMatchesSelector||r.oMatchesSelector||r.webkitMatchesSelector}e.exports=function(e,t){for(;e&&e.nodeType!==n;){if("function"==typeof e.matches&&e.matches(t))return e;e=e.parentNode}}},function(e,t,n){var r=n(4);function i(e,t,n,i,o){var a=function(e,t,n,i){return function(n){n.delegateTarget=r(n.target,t),n.delegateTarget&&i.call(e,n)}}.apply(this,arguments);return e.addEventListener(n,a,o),{destroy:function(){e.removeEventListener(n,a,o)}}}e.exports=function(e,t,n,r,o){return"function"==typeof e.addEventListener?i.apply(null,arguments):"function"==typeof n?i.bind(null,document).apply(null,arguments):("string"==typeof e&&(e=document.querySelectorAll(e)),Array.prototype.map.call(e,function(e){return i(e,t,n,r,o)}))}},function(e,t){t.node=function(e){return void 0!==e&&e instanceof HTMLElement&&1===e.nodeType},t.nodeList=function(e){var n=Object.prototype.toString.call(e);return void 0!==e&&("[object NodeList]"===n||"[object HTMLCollection]"===n)&&"length"in e&&(0===e.length||t.node(e[0]))},t.string=function(e){return"string"==typeof e||e instanceof String},t.fn=function(e){return"[object Function]"===Object.prototype.toString.call(e)}},function(e,t){e.exports=function(e){var t;if("SELECT"===e.nodeName)e.focus(),t=e.value;else if("INPUT"===e.nodeName||"TEXTAREA"===e.nodeName){var n=e.hasAttribute("readonly");n||e.setAttribute("readonly",""),e.select(),e.setSelectionRange(0,e.value.length),n||e.removeAttribute("readonly"),t=e.value}else{e.hasAttribute("contenteditable")&&e.focus();var r=window.getSelection(),i=document.createRange();i.selectNodeContents(e),r.removeAllRanges(),r.addRange(i),t=r.toString()}return t}}])},"object"==typeof exports&&"object"==typeof module?module.exports=fXa():"function"==typeof define&&define.amd?define("deps/clipboard",[],fXa):"object"==typeof exports?exports.ClipboardJS=fXa():eXa.ClipboardJS=fXa(),define("core/webidl-clipboard",["exports","deps/text!core/images/clipboard.svg","deps/clipboard"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e,t,n){Array.from(t.querySelectorAll("pre.idl")).map(e=>{const t=a.cloneNode(!0),n=e.querySelector('span[id^="idl-def-"], span[id^="dom-"]');let r="#";return null===n&&""===e.id?"idl-index"===e.parentElement.id?r+="actual-idl-index":(e.id=`idl-${String(Math.random()).substr(2)}`,r+=e.id):r+=e.id||n.id,{button:t,elem:e,target:r}}).forEach(({elem:e,button:n,target:r})=>{const i=t.createElement("div");n.dataset.clipboardTarget=r,e.parentElement.replaceChild(i,e),i.appendChild(n),i.appendChild(e)}),new i.default(".respec-button-copy-paste",s).on("success",e=>e.clearSelection()),n()};var r=o(t),i=o(n);function o(e){return e&&e.__esModule?e:{default:e}}e.name="core/webidl-clipboard";const a=document.createElement("button");a.innerHTML=r.default,a.title="Copy IDL to clipboard",a.classList.add("respec-button-copy-paste","removeOnSave");const s={text:e=>document.querySelector(e.dataset.clipboardTarget).textContent.replace(/\ +/gm," ").replace(/^\ /gm," ").replace(/^};\n/gm,"};\n").trim()}}),define("core/data-tests",["exports","core/pubsubhub","core/l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){const n=document.querySelectorAll("[data-tests]");if(!n.length)return;if(!e.testSuiteURI)return void(0,t.pub)("error",r[i].missing_test_suite_uri);Array.from(n).filter(e=>e.dataset.tests).map(n=>{const a=document.createElement("details"),s=hyperHTML.bind(a),l=n.dataset.tests.split(/,/gm).map(e=>e.trim()).map(n=>{let o="";try{o=new URL(n,e.testSuiteURI).href}catch(e){(0,t.pub)("warn",`${r[i].bad_uri}: ${n}`)}return o});return a.classList.add("respec-tests-details","removeOnSave"),s` - <summary> - tests: ${l.length} - </summary> - <ul>${l.map(o)}</ul> - `,{elem:n,details:a}}).forEach(({elem:e,details:t})=>{delete e.dataset.tests,e.insertAdjacentElement("beforeend",t)})};const r={en:{missing_test_suite_uri:"Found tests in your spec, but missing '[`testSuiteURI`](https://github.com/w3c/respec/wiki/testSuiteURI)' in your ReSpec config.",tests:"tests",test:"test"}},i=(e.name="core/data-tests",n.lang in r?n.lang:"en");function o(e){const t=[],[n]=new URL(e).pathname.split("/").reverse(),r=n.split(".");let[i]=r;if(r.find(e=>"https"===e)){const e=document.createElement("span");e.innerHTML="🔒",e.setAttribute("aria-label","requires a secure connection"),e.setAttribute("title","Test requires HTTPS"),i=i.replace(".https",""),t.push(e)}if(i.split(".").join("-").split("-").find(e=>"manual"===e)){const e=document.createElement("span");e.innerHTML="💪",e.setAttribute("aria-label","the test must be run manually"),e.setAttribute("title","Manual test"),i=i.replace("-manual",""),t.push(e)}return hyperHTML.bind(document.createElement("li"))` - <a href="${e}"> - ${i} - </a> ${t} - `}}),define("core/list-sorter",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.sortListItems=r,e.sortDefinitionTerms=o,e.run=function(e,n,i){for(const e of document.querySelectorAll("[data-sort]")){let n;const i=e.dataset.sort||"ascending";switch(e.localName){case"dl":n=o(e,i);break;case"ol":case"ul":n=r(e,i);break;default:(0,t.pub)("warning",`ReSpec can't sort ${e.localName} elements.`)}if(n){const t=document.createRange();t.selectNodeContents(e),t.deleteContents(),e.appendChild(n)}}i()};e.name="core/list-sorter";function n(e){return({textContent:t},{textContent:n})=>"ascending"===e?t.localeCompare(n):n.localeCompare(t)}function r(e,t){return i(e,"li").sort(n(t)).reduce((e,t)=>(e.appendChild(t),e),document.createDocumentFragment())}function i(e,t){let n;try{n=e.querySelectorAll(`:scope > ${t}`)}catch(r){let i="";e.id||(i=`temp-${String(Math.random()).substr(2)}`,e.id=i);const o=`#${e.id} > ${t}`;n=e.parentElement.querySelectorAll(o),i&&(e.id="")}return[...n]}function o(e,t){return i(e,"dt").sort(n(t)).reduce((e,t)=>{const{nodeType:n,nodeName:r}=t,i=document.createDocumentFragment();let{nextSibling:o}=t;for(;o&&o.nextSibling;){i.appendChild(o.cloneNode(!0));const{nodeType:e,nodeName:t}=o.nextSibling;if(e===n&&t===r)break;o=o.nextSibling}return i.prepend(t.cloneNode(!0)),e.appendChild(i),e},document.createDocumentFragment())}}),define("deps/text!core/css/var.css",[],function(){return"var:hover {\n border-bottom: 1px dotted;\n cursor: pointer;\n}\n\nvar.respec-hl {\n color: var(--color, #000);\n background-color: var(--bg-color);\n box-shadow: 0 0 0px 2px var(--bg-color);\n}\n\n/* highlight colors\n https://github.com/w3c/tr-design/issues/152\n*/\nvar.respec-hl-c1 {\n --bg-color: #f4d200;\n}\n\nvar.respec-hl-c2 {\n --bg-color: #ff87a2;\n}\n\nvar.respec-hl-c3 {\n --bg-color: #96e885;\n}\n\nvar.respec-hl-c4 {\n --bg-color: #3eeed2;\n}\n\nvar.respec-hl-c5 {\n --bg-color: #eacfb6;\n}\n\nvar.respec-hl-c6 {\n --bg-color: #82ddff;\n}\n\nvar.respec-hl-c7 {\n --bg-color: #ffbcf2;\n}\n\n@media print {\n var.respec-hl {\n background: none;\n color: #000;\n box-shadow: unset;\n }\n}\n"}),define("core/highlight-vars",["exports","core/pubsubhub","deps/text!core/css/var.css"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){if(!e.highlightVars)return;const n=document.createElement("style");n.textContent=i.default,n.classList.add("removeOnSave"),document.head.appendChild(n),[...document.querySelectorAll("var")].forEach(e=>e.addEventListener("click",o)),(0,t.sub)("beforesave",e=>{[...e.querySelectorAll("var.respec-hl")].forEach(l)})};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/highlight-vars";function o(e){e.stopPropagation();const{target:t}=e,n=function(e){const t=e.textContent.trim(),n=e.closest("section"),r=s(e),i=[...n.querySelectorAll("var")].filter(e=>e.textContent.trim()===t),o=i[0].classList.contains("respec-hl");if(a.set(r,o),o)return i.forEach(e=>l(e,r)),[];i.forEach(e=>(c=e,u=r,void c.classList.add("respec-hl",u)));var c,u;return i}(t),r=()=>{const e=s(t);n.forEach(t=>l(t,e)),[...a.keys()].forEach(e=>a.set(e,!0))};n.length&&document.body.addEventListener("click",r,{once:!0})}const a=new Map([["respec-hl-c1",!0],["respec-hl-c2",!0],["respec-hl-c3",!0],["respec-hl-c4",!0],["respec-hl-c5",!0],["respec-hl-c6",!0],["respec-hl-c7",!0]]);function s(e){const{value:t}=e.classList,n=/respec-hl-\w+/,r=n.test(t)&&t.match(n);return r?r[0]:!0===a.get("respec-hl-c1")?"respec-hl-c1":[...a.keys()].find(e=>a.get(e))||"respec-hl-c1"}function l(e,t){e.classList.remove("respec-hl",t),e.classList.length||e.removeAttribute("class")}}),window.addEventListener("error",e=>{console.error(e.error,e.message,e)}),require.config({shim:{shortcut:{exports:"shortcut"},highlight:{exports:"hljs"}},paths:{"handlebars.runtime":"deps/handlebars","deps/highlight":"https://www.w3.org/Tools/respec/respec-highlight"},deps:["deps/hyperhtml","deps/url-search-params"]}),define("profile-oai",["deps/domReady","core/base-runner","core/ui","core/l10n","oai/defaults","core/style","w3c/style","w3c/l10n","core/github","core/data-include","core/markdown","oai/headers","w3c/abstract","w3c/conformance","core/data-transform","core/inlines","core/dfn","w3c/rfc2119","core/examples","core/issues-notes","core/requirements","core/best-practices","core/figures","core/webidl","core/data-cite","core/biblio","core/webidl-index","core/link-to-dfn","core/contrib","core/fix-headers","core/structure","w3c/informative","w3c/permalinks","core/id-headers","core/location-hash","core/caniuse","ui/save-html","ui/search-specref","ui/dfn-list","ui/about-respec","core/seo","w3c/seo","core/highlight","core/webidl-clipboard","core/data-tests","core/list-sorter","core/highlight-vars","core/linter"],(e,t,{ui:n},...r)=>{n.show(),e(async()=>{try{await t.runAll(r),await document.respecIsReady}catch(e){console.error(e)}finally{n.enable()}})}),require(["profile-oai"]); -//# sourceMappingURL=respec-oai.build.js.map diff --git a/docs/js/respec-oai.build.js.map b/docs/js/respec-oai.build.js.map deleted file mode 100644 index 899b0a5f60..0000000000 --- a/docs/js/respec-oai.build.js.map +++ /dev/null @@ -1,210 +0,0 @@ -{ - "version": 3, - "sources": [ - "deps/require.js", - "deps/hyperhtml.js", - "deps/url-search-params.js", - "deps/domReady.js", - "core/pubsubhub.js", - "deps/marked.js", - "core/utils.js", - "core/post-process.js", - "core/pre-process.js", - "core/include-config.js", - "core/override-configuration.js", - "core/respec-ready.js", - "core/base-runner.js", - "shortcut.js", - "deps/text.js", - "ui/ui.css!deps/text", - "deps/jquery.js", - "core/jquery-enhanced.js", - "core/ui.js", - "core/l10n.js", - "core/linter.js", - "core/LinterRule.js", - "core/linter-rules/no-headingless-sections.js", - "core/linter-rules/no-http-props.js", - "w3c/l10n.js", - "w3c/linter-rules/privsec-section.js", - "core/linter-rules/check-punctuation.js", - "core/linter-rules/local-refs-exist.js", - "oai/defaults.js", - "core/css/respec2.css!deps/text", - "core/style.js", - "w3c/style.js", - "core/github.js", - "core/data-include.js", - "core/markdown.js", - "deps/handlebars.js", - "templates.js", - "w3c/templates/cgbg-sotd.js", - "w3c/templates/sotd.js", - "w3c/templates/show-logo.js", - "w3c/templates/show-people.js", - "w3c/templates/show-link.js", - "w3c/templates/cgbg-headers.js", - "oai/templates/show-logo.js", - "oai/templates/show-people.js", - "oai/templates/show-link.js", - "oai/templates/headers.js", - "oai/headers.js", - "w3c/abstract.js", - "w3c/templates/conformance.js", - "w3c/conformance.js", - "core/data-transform.js", - "core/inlines.js", - "deps/pluralize.js", - "core/dfn.js", - "w3c/rfc2119.js", - "core/css/examples.css!deps/text", - "core/examples.js", - "deps/text!core/css/issues-notes.css", - "core/issues-notes.js", - "core/requirements.js", - "core/css/bp.css!deps/text", - "core/best-practices.js", - "core/figures.js", - "deps/webidl2.js", - "core/css/webidl.css!deps/text", - "core/webidl.js", - "core/biblio-db.js", - "core/biblio.js", - "core/data-cite.js", - "core/webidl-index.js", - "core/link-to-dfn.js", - "core/contrib.js", - "core/fix-headers.js", - "core/structure.js", - "w3c/informative.js", - "w3c/permalinks.js", - "core/id-headers.js", - "core/location-hash.js", - "core/css/caniuse.css!deps/text", - "core/caniuse.js", - "core/exporter.js", - "ui/save-html.js", - "ui/search-specref.js", - "ui/dfn-list.js", - "ui/about-respec.js", - "core/seo.js", - "w3c/seo.js", - "core/css/github.css!deps/text", - "deps/text!core/../../worker/respec-worker.js", - "core/worker.js", - "core/highlight.js", - "core/images/clipboard.svg!deps/text", - "deps/clipboard.js", - "core/webidl-clipboard.js", - "core/data-tests.js", - "core/list-sorter.js", - "core/css/var.css!deps/text", - "core/highlight-vars.js", - "profile-oai.js" - ], - "names": [], - "mappings": "AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACpmEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC10CA;AACA;AACA;AACA;AACA;AACA,ACLA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3+CA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACndA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC1EA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC9OA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzZA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChlQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3LA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChNA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC/FA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACxEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC7DA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzGA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3CA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC5JA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC57CA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC1aA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACpDA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjLA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC/BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC/BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACtKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3bA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC7BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC/BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC9BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC7FA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3eA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC/FA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACnCA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AClFA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChDA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC9CA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACpFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzkCA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC12BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACxQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChSA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACpIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AClIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACzBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACtJA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACjBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACxFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC1CA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3GA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACvFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AClJA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACxCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3EA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACpCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AChJA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACvCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACxFA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC36BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACrEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,ACtGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC7GA;AACA;AACA;AACA,ACHA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,AC3GA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA", - "file": "profile-oai.build.js", - "sourcesContent": [ - "/** vim: et:ts=4:sw=4:sts=4\n * @license RequireJS 2.3.5 Copyright jQuery Foundation and other contributors.\n * Released under MIT license, https://github.com/requirejs/requirejs/blob/master/LICENSE\n */\n//Not using strict: uneven strict support in browsers, #392, and causes\n//problems with requirejs.exec()/transpiler plugins that may not be strict.\n/*jslint regexp: true, nomen: true, sloppy: true */\n/*global window, navigator, document, importScripts, setTimeout, opera */\n\nvar requirejs, require, define;\n(function (global, setTimeout) {\n var req, s, head, baseElement, dataMain, src,\n interactiveScript, currentlyAddingScript, mainScript, subPath,\n version = '2.3.5',\n commentRegExp = /\\/\\*[\\s\\S]*?\\*\\/|([^:\"'=]|^)\\/\\/.*$/mg,\n cjsRequireRegExp = /[^.]\\s*require\\s*\\(\\s*[\"']([^'\"\\s]+)[\"']\\s*\\)/g,\n jsSuffixRegExp = /\\.js$/,\n currDirRegExp = /^\\.\\//,\n op = Object.prototype,\n ostring = op.toString,\n hasOwn = op.hasOwnProperty,\n isBrowser = !!(typeof window !== 'undefined' && typeof navigator !== 'undefined' && window.document),\n isWebWorker = !isBrowser && typeof importScripts !== 'undefined',\n //PS3 indicates loaded and complete, but need to wait for complete\n //specifically. Sequence is 'loading', 'loaded', execution,\n // then 'complete'. The UA check is unfortunate, but not sure how\n //to feature test w/o causing perf issues.\n readyRegExp = isBrowser && navigator.platform === 'PLAYSTATION 3' ?\n /^complete$/ : /^(complete|loaded)$/,\n defContextName = '_',\n //Oh the tragedy, detecting opera. See the usage of isOpera for reason.\n isOpera = typeof opera !== 'undefined' && opera.toString() === '[object Opera]',\n contexts = {},\n cfg = {},\n globalDefQueue = [],\n useInteractive = false;\n\n //Could match something like ')//comment', do not lose the prefix to comment.\n function commentReplace(match, singlePrefix) {\n return singlePrefix || '';\n }\n\n function isFunction(it) {\n return ostring.call(it) === '[object Function]';\n }\n\n function isArray(it) {\n return ostring.call(it) === '[object Array]';\n }\n\n /**\n * Helper function for iterating over an array. If the func returns\n * a true value, it will break out of the loop.\n */\n function each(ary, func) {\n if (ary) {\n var i;\n for (i = 0; i < ary.length; i += 1) {\n if (ary[i] && func(ary[i], i, ary)) {\n break;\n }\n }\n }\n }\n\n /**\n * Helper function for iterating over an array backwards. If the func\n * returns a true value, it will break out of the loop.\n */\n function eachReverse(ary, func) {\n if (ary) {\n var i;\n for (i = ary.length - 1; i > -1; i -= 1) {\n if (ary[i] && func(ary[i], i, ary)) {\n break;\n }\n }\n }\n }\n\n function hasProp(obj, prop) {\n return hasOwn.call(obj, prop);\n }\n\n function getOwn(obj, prop) {\n return hasProp(obj, prop) && obj[prop];\n }\n\n /**\n * Cycles over properties in an object and calls a function for each\n * property value. If the function returns a truthy value, then the\n * iteration is stopped.\n */\n function eachProp(obj, func) {\n var prop;\n for (prop in obj) {\n if (hasProp(obj, prop)) {\n if (func(obj[prop], prop)) {\n break;\n }\n }\n }\n }\n\n /**\n * Simple function to mix in properties from source into target,\n * but only if target does not already have a property of the same name.\n */\n function mixin(target, source, force, deepStringMixin) {\n if (source) {\n eachProp(source, function (value, prop) {\n if (force || !hasProp(target, prop)) {\n if (deepStringMixin && typeof value === 'object' && value &&\n !isArray(value) && !isFunction(value) &&\n !(value instanceof RegExp)) {\n\n if (!target[prop]) {\n target[prop] = {};\n }\n mixin(target[prop], value, force, deepStringMixin);\n } else {\n target[prop] = value;\n }\n }\n });\n }\n return target;\n }\n\n //Similar to Function.prototype.bind, but the 'this' object is specified\n //first, since it is easier to read/figure out what 'this' will be.\n function bind(obj, fn) {\n return function () {\n return fn.apply(obj, arguments);\n };\n }\n\n function scripts() {\n return document.getElementsByTagName('script');\n }\n\n function defaultOnError(err) {\n throw err;\n }\n\n //Allow getting a global that is expressed in\n //dot notation, like 'a.b.c'.\n function getGlobal(value) {\n if (!value) {\n return value;\n }\n var g = global;\n each(value.split('.'), function (part) {\n g = g[part];\n });\n return g;\n }\n\n /**\n * Constructs an error with a pointer to an URL with more information.\n * @param {String} id the error ID that maps to an ID on a web page.\n * @param {String} message human readable error.\n * @param {Error} [err] the original error, if there is one.\n *\n * @returns {Error}\n */\n function makeError(id, msg, err, requireModules) {\n var e = new Error(msg + '\\nhttp://requirejs.org/docs/errors.html#' + id);\n e.requireType = id;\n e.requireModules = requireModules;\n if (err) {\n e.originalError = err;\n }\n return e;\n }\n\n if (typeof define !== 'undefined') {\n //If a define is already in play via another AMD loader,\n //do not overwrite.\n return;\n }\n\n if (typeof requirejs !== 'undefined') {\n if (isFunction(requirejs)) {\n //Do not overwrite an existing requirejs instance.\n return;\n }\n cfg = requirejs;\n requirejs = undefined;\n }\n\n //Allow for a require config object\n if (typeof require !== 'undefined' && !isFunction(require)) {\n //assume it is a config object.\n cfg = require;\n require = undefined;\n }\n\n function newContext(contextName) {\n var inCheckLoaded, Module, context, handlers,\n checkLoadedTimeoutId,\n config = {\n //Defaults. Do not set a default for map\n //config to speed up normalize(), which\n //will run faster if there is no default.\n waitSeconds: 7,\n baseUrl: './',\n paths: {},\n bundles: {},\n pkgs: {},\n shim: {},\n config: {}\n },\n registry = {},\n //registry of just enabled modules, to speed\n //cycle breaking code when lots of modules\n //are registered, but not activated.\n enabledRegistry = {},\n undefEvents = {},\n defQueue = [],\n defined = {},\n urlFetched = {},\n bundlesMap = {},\n requireCounter = 1,\n unnormalizedCounter = 1;\n\n /**\n * Trims the . and .. from an array of path segments.\n * It will keep a leading path segment if a .. will become\n * the first path segment, to help with module name lookups,\n * which act like paths, but can be remapped. But the end result,\n * all paths that use this function should look normalized.\n * NOTE: this method MODIFIES the input array.\n * @param {Array} ary the array of path segments.\n */\n function trimDots(ary) {\n var i, part;\n for (i = 0; i < ary.length; i++) {\n part = ary[i];\n if (part === '.') {\n ary.splice(i, 1);\n i -= 1;\n } else if (part === '..') {\n // If at the start, or previous value is still ..,\n // keep them so that when converted to a path it may\n // still work when converted to a path, even though\n // as an ID it is less than ideal. In larger point\n // releases, may be better to just kick out an error.\n if (i === 0 || (i === 1 && ary[2] === '..') || ary[i - 1] === '..') {\n continue;\n } else if (i > 0) {\n ary.splice(i - 1, 2);\n i -= 2;\n }\n }\n }\n }\n\n /**\n * Given a relative module name, like ./something, normalize it to\n * a real name that can be mapped to a path.\n * @param {String} name the relative name\n * @param {String} baseName a real name that the name arg is relative\n * to.\n * @param {Boolean} applyMap apply the map config to the value. Should\n * only be done if this normalization is for a dependency ID.\n * @returns {String} normalized name\n */\n function normalize(name, baseName, applyMap) {\n var pkgMain, mapValue, nameParts, i, j, nameSegment, lastIndex,\n foundMap, foundI, foundStarMap, starI, normalizedBaseParts,\n baseParts = (baseName && baseName.split('/')),\n map = config.map,\n starMap = map && map['*'];\n\n //Adjust any relative paths.\n if (name) {\n name = name.split('/');\n lastIndex = name.length - 1;\n\n // If wanting node ID compatibility, strip .js from end\n // of IDs. Have to do this here, and not in nameToUrl\n // because node allows either .js or non .js to map\n // to same file.\n if (config.nodeIdCompat && jsSuffixRegExp.test(name[lastIndex])) {\n name[lastIndex] = name[lastIndex].replace(jsSuffixRegExp, '');\n }\n\n // Starts with a '.' so need the baseName\n if (name[0].charAt(0) === '.' && baseParts) {\n //Convert baseName to array, and lop off the last part,\n //so that . matches that 'directory' and not name of the baseName's\n //module. For instance, baseName of 'one/two/three', maps to\n //'one/two/three.js', but we want the directory, 'one/two' for\n //this normalization.\n normalizedBaseParts = baseParts.slice(0, baseParts.length - 1);\n name = normalizedBaseParts.concat(name);\n }\n\n trimDots(name);\n name = name.join('/');\n }\n\n //Apply map config if available.\n if (applyMap && map && (baseParts || starMap)) {\n nameParts = name.split('/');\n\n outerLoop: for (i = nameParts.length; i > 0; i -= 1) {\n nameSegment = nameParts.slice(0, i).join('/');\n\n if (baseParts) {\n //Find the longest baseName segment match in the config.\n //So, do joins on the biggest to smallest lengths of baseParts.\n for (j = baseParts.length; j > 0; j -= 1) {\n mapValue = getOwn(map, baseParts.slice(0, j).join('/'));\n\n //baseName segment has config, find if it has one for\n //this name.\n if (mapValue) {\n mapValue = getOwn(mapValue, nameSegment);\n if (mapValue) {\n //Match, update name to the new value.\n foundMap = mapValue;\n foundI = i;\n break outerLoop;\n }\n }\n }\n }\n\n //Check for a star map match, but just hold on to it,\n //if there is a shorter segment match later in a matching\n //config, then favor over this star map.\n if (!foundStarMap && starMap && getOwn(starMap, nameSegment)) {\n foundStarMap = getOwn(starMap, nameSegment);\n starI = i;\n }\n }\n\n if (!foundMap && foundStarMap) {\n foundMap = foundStarMap;\n foundI = starI;\n }\n\n if (foundMap) {\n nameParts.splice(0, foundI, foundMap);\n name = nameParts.join('/');\n }\n }\n\n // If the name points to a package's name, use\n // the package main instead.\n pkgMain = getOwn(config.pkgs, name);\n\n return pkgMain ? pkgMain : name;\n }\n\n function removeScript(name) {\n if (isBrowser) {\n each(scripts(), function (scriptNode) {\n if (scriptNode.getAttribute('data-requiremodule') === name &&\n scriptNode.getAttribute('data-requirecontext') === context.contextName) {\n scriptNode.parentNode.removeChild(scriptNode);\n return true;\n }\n });\n }\n }\n\n function hasPathFallback(id) {\n var pathConfig = getOwn(config.paths, id);\n if (pathConfig && isArray(pathConfig) && pathConfig.length > 1) {\n //Pop off the first array value, since it failed, and\n //retry\n pathConfig.shift();\n context.require.undef(id);\n\n //Custom require that does not do map translation, since\n //ID is \"absolute\", already mapped/resolved.\n context.makeRequire(null, {\n skipMap: true\n })([id]);\n\n return true;\n }\n }\n\n //Turns a plugin!resource to [plugin, resource]\n //with the plugin being undefined if the name\n //did not have a plugin prefix.\n function splitPrefix(name) {\n var prefix,\n index = name ? name.indexOf('!') : -1;\n if (index > -1) {\n prefix = name.substring(0, index);\n name = name.substring(index + 1, name.length);\n }\n return [prefix, name];\n }\n\n /**\n * Creates a module mapping that includes plugin prefix, module\n * name, and path. If parentModuleMap is provided it will\n * also normalize the name via require.normalize()\n *\n * @param {String} name the module name\n * @param {String} [parentModuleMap] parent module map\n * for the module name, used to resolve relative names.\n * @param {Boolean} isNormalized: is the ID already normalized.\n * This is true if this call is done for a define() module ID.\n * @param {Boolean} applyMap: apply the map config to the ID.\n * Should only be true if this map is for a dependency.\n *\n * @returns {Object}\n */\n function makeModuleMap(name, parentModuleMap, isNormalized, applyMap) {\n var url, pluginModule, suffix, nameParts,\n prefix = null,\n parentName = parentModuleMap ? parentModuleMap.name : null,\n originalName = name,\n isDefine = true,\n normalizedName = '';\n\n //If no name, then it means it is a require call, generate an\n //internal name.\n if (!name) {\n isDefine = false;\n name = '_@r' + (requireCounter += 1);\n }\n\n nameParts = splitPrefix(name);\n prefix = nameParts[0];\n name = nameParts[1];\n\n if (prefix) {\n prefix = normalize(prefix, parentName, applyMap);\n pluginModule = getOwn(defined, prefix);\n }\n\n //Account for relative paths if there is a base name.\n if (name) {\n if (prefix) {\n if (isNormalized) {\n normalizedName = name;\n } else if (pluginModule && pluginModule.normalize) {\n //Plugin is loaded, use its normalize method.\n normalizedName = pluginModule.normalize(name, function (name) {\n return normalize(name, parentName, applyMap);\n });\n } else {\n // If nested plugin references, then do not try to\n // normalize, as it will not normalize correctly. This\n // places a restriction on resourceIds, and the longer\n // term solution is not to normalize until plugins are\n // loaded and all normalizations to allow for async\n // loading of a loader plugin. But for now, fixes the\n // common uses. Details in #1131\n normalizedName = name.indexOf('!') === -1 ?\n normalize(name, parentName, applyMap) :\n name;\n }\n } else {\n //A regular module.\n normalizedName = normalize(name, parentName, applyMap);\n\n //Normalized name may be a plugin ID due to map config\n //application in normalize. The map config values must\n //already be normalized, so do not need to redo that part.\n nameParts = splitPrefix(normalizedName);\n prefix = nameParts[0];\n normalizedName = nameParts[1];\n isNormalized = true;\n\n url = context.nameToUrl(normalizedName);\n }\n }\n\n //If the id is a plugin id that cannot be determined if it needs\n //normalization, stamp it with a unique ID so two matching relative\n //ids that may conflict can be separate.\n suffix = prefix && !pluginModule && !isNormalized ?\n '_unnormalized' + (unnormalizedCounter += 1) :\n '';\n\n return {\n prefix: prefix,\n name: normalizedName,\n parentMap: parentModuleMap,\n unnormalized: !!suffix,\n url: url,\n originalName: originalName,\n isDefine: isDefine,\n id: (prefix ?\n prefix + '!' + normalizedName :\n normalizedName) + suffix\n };\n }\n\n function getModule(depMap) {\n var id = depMap.id,\n mod = getOwn(registry, id);\n\n if (!mod) {\n mod = registry[id] = new context.Module(depMap);\n }\n\n return mod;\n }\n\n function on(depMap, name, fn) {\n var id = depMap.id,\n mod = getOwn(registry, id);\n\n if (hasProp(defined, id) &&\n (!mod || mod.defineEmitComplete)) {\n if (name === 'defined') {\n fn(defined[id]);\n }\n } else {\n mod = getModule(depMap);\n if (mod.error && name === 'error') {\n fn(mod.error);\n } else {\n mod.on(name, fn);\n }\n }\n }\n\n function onError(err, errback) {\n var ids = err.requireModules,\n notified = false;\n\n if (errback) {\n errback(err);\n } else {\n each(ids, function (id) {\n var mod = getOwn(registry, id);\n if (mod) {\n //Set error on module, so it skips timeout checks.\n mod.error = err;\n if (mod.events.error) {\n notified = true;\n mod.emit('error', err);\n }\n }\n });\n\n if (!notified) {\n req.onError(err);\n }\n }\n }\n\n /**\n * Internal method to transfer globalQueue items to this context's\n * defQueue.\n */\n function takeGlobalQueue() {\n //Push all the globalDefQueue items into the context's defQueue\n if (globalDefQueue.length) {\n each(globalDefQueue, function(queueItem) {\n var id = queueItem[0];\n if (typeof id === 'string') {\n context.defQueueMap[id] = true;\n }\n defQueue.push(queueItem);\n });\n globalDefQueue = [];\n }\n }\n\n handlers = {\n 'require': function (mod) {\n if (mod.require) {\n return mod.require;\n } else {\n return (mod.require = context.makeRequire(mod.map));\n }\n },\n 'exports': function (mod) {\n mod.usingExports = true;\n if (mod.map.isDefine) {\n if (mod.exports) {\n return (defined[mod.map.id] = mod.exports);\n } else {\n return (mod.exports = defined[mod.map.id] = {});\n }\n }\n },\n 'module': function (mod) {\n if (mod.module) {\n return mod.module;\n } else {\n return (mod.module = {\n id: mod.map.id,\n uri: mod.map.url,\n config: function () {\n return getOwn(config.config, mod.map.id) || {};\n },\n exports: mod.exports || (mod.exports = {})\n });\n }\n }\n };\n\n function cleanRegistry(id) {\n //Clean up machinery used for waiting modules.\n delete registry[id];\n delete enabledRegistry[id];\n }\n\n function breakCycle(mod, traced, processed) {\n var id = mod.map.id;\n\n if (mod.error) {\n mod.emit('error', mod.error);\n } else {\n traced[id] = true;\n each(mod.depMaps, function (depMap, i) {\n var depId = depMap.id,\n dep = getOwn(registry, depId);\n\n //Only force things that have not completed\n //being defined, so still in the registry,\n //and only if it has not been matched up\n //in the module already.\n if (dep && !mod.depMatched[i] && !processed[depId]) {\n if (getOwn(traced, depId)) {\n mod.defineDep(i, defined[depId]);\n mod.check(); //pass false?\n } else {\n breakCycle(dep, traced, processed);\n }\n }\n });\n processed[id] = true;\n }\n }\n\n function checkLoaded() {\n var err, usingPathFallback,\n waitInterval = config.waitSeconds * 1000,\n //It is possible to disable the wait interval by using waitSeconds of 0.\n expired = waitInterval && (context.startTime + waitInterval) < new Date().getTime(),\n noLoads = [],\n reqCalls = [],\n stillLoading = false,\n needCycleCheck = true;\n\n //Do not bother if this call was a result of a cycle break.\n if (inCheckLoaded) {\n return;\n }\n\n inCheckLoaded = true;\n\n //Figure out the state of all the modules.\n eachProp(enabledRegistry, function (mod) {\n var map = mod.map,\n modId = map.id;\n\n //Skip things that are not enabled or in error state.\n if (!mod.enabled) {\n return;\n }\n\n if (!map.isDefine) {\n reqCalls.push(mod);\n }\n\n if (!mod.error) {\n //If the module should be executed, and it has not\n //been inited and time is up, remember it.\n if (!mod.inited && expired) {\n if (hasPathFallback(modId)) {\n usingPathFallback = true;\n stillLoading = true;\n } else {\n noLoads.push(modId);\n removeScript(modId);\n }\n } else if (!mod.inited && mod.fetched && map.isDefine) {\n stillLoading = true;\n if (!map.prefix) {\n //No reason to keep looking for unfinished\n //loading. If the only stillLoading is a\n //plugin resource though, keep going,\n //because it may be that a plugin resource\n //is waiting on a non-plugin cycle.\n return (needCycleCheck = false);\n }\n }\n }\n });\n\n if (expired && noLoads.length) {\n //If wait time expired, throw error of unloaded modules.\n err = makeError('timeout', 'Load timeout for modules: ' + noLoads, null, noLoads);\n err.contextName = context.contextName;\n return onError(err);\n }\n\n //Not expired, check for a cycle.\n if (needCycleCheck) {\n each(reqCalls, function (mod) {\n breakCycle(mod, {}, {});\n });\n }\n\n //If still waiting on loads, and the waiting load is something\n //other than a plugin resource, or there are still outstanding\n //scripts, then just try back later.\n if ((!expired || usingPathFallback) && stillLoading) {\n //Something is still waiting to load. Wait for it, but only\n //if a timeout is not already in effect.\n if ((isBrowser || isWebWorker) && !checkLoadedTimeoutId) {\n checkLoadedTimeoutId = setTimeout(function () {\n checkLoadedTimeoutId = 0;\n checkLoaded();\n }, 50);\n }\n }\n\n inCheckLoaded = false;\n }\n\n Module = function (map) {\n this.events = getOwn(undefEvents, map.id) || {};\n this.map = map;\n this.shim = getOwn(config.shim, map.id);\n this.depExports = [];\n this.depMaps = [];\n this.depMatched = [];\n this.pluginMaps = {};\n this.depCount = 0;\n\n /* this.exports this.factory\n this.depMaps = [],\n this.enabled, this.fetched\n */\n };\n\n Module.prototype = {\n init: function (depMaps, factory, errback, options) {\n options = options || {};\n\n //Do not do more inits if already done. Can happen if there\n //are multiple define calls for the same module. That is not\n //a normal, common case, but it is also not unexpected.\n if (this.inited) {\n return;\n }\n\n this.factory = factory;\n\n if (errback) {\n //Register for errors on this module.\n this.on('error', errback);\n } else if (this.events.error) {\n //If no errback already, but there are error listeners\n //on this module, set up an errback to pass to the deps.\n errback = bind(this, function (err) {\n this.emit('error', err);\n });\n }\n\n //Do a copy of the dependency array, so that\n //source inputs are not modified. For example\n //\"shim\" deps are passed in here directly, and\n //doing a direct modification of the depMaps array\n //would affect that config.\n this.depMaps = depMaps && depMaps.slice(0);\n\n this.errback = errback;\n\n //Indicate this module has be initialized\n this.inited = true;\n\n this.ignore = options.ignore;\n\n //Could have option to init this module in enabled mode,\n //or could have been previously marked as enabled. However,\n //the dependencies are not known until init is called. So\n //if enabled previously, now trigger dependencies as enabled.\n if (options.enabled || this.enabled) {\n //Enable this module and dependencies.\n //Will call this.check()\n this.enable();\n } else {\n this.check();\n }\n },\n\n defineDep: function (i, depExports) {\n //Because of cycles, defined callback for a given\n //export can be called more than once.\n if (!this.depMatched[i]) {\n this.depMatched[i] = true;\n this.depCount -= 1;\n this.depExports[i] = depExports;\n }\n },\n\n fetch: function () {\n if (this.fetched) {\n return;\n }\n this.fetched = true;\n\n context.startTime = (new Date()).getTime();\n\n var map = this.map;\n\n //If the manager is for a plugin managed resource,\n //ask the plugin to load it now.\n if (this.shim) {\n context.makeRequire(this.map, {\n enableBuildCallback: true\n })(this.shim.deps || [], bind(this, function () {\n return map.prefix ? this.callPlugin() : this.load();\n }));\n } else {\n //Regular dependency.\n return map.prefix ? this.callPlugin() : this.load();\n }\n },\n\n load: function () {\n var url = this.map.url;\n\n //Regular dependency.\n if (!urlFetched[url]) {\n urlFetched[url] = true;\n context.load(this.map.id, url);\n }\n },\n\n /**\n * Checks if the module is ready to define itself, and if so,\n * define it.\n */\n check: function () {\n if (!this.enabled || this.enabling) {\n return;\n }\n\n var err, cjsModule,\n id = this.map.id,\n depExports = this.depExports,\n exports = this.exports,\n factory = this.factory;\n\n if (!this.inited) {\n // Only fetch if not already in the defQueue.\n if (!hasProp(context.defQueueMap, id)) {\n this.fetch();\n }\n } else if (this.error) {\n this.emit('error', this.error);\n } else if (!this.defining) {\n //The factory could trigger another require call\n //that would result in checking this module to\n //define itself again. If already in the process\n //of doing that, skip this work.\n this.defining = true;\n\n if (this.depCount < 1 && !this.defined) {\n if (isFunction(factory)) {\n //If there is an error listener, favor passing\n //to that instead of throwing an error. However,\n //only do it for define()'d modules. require\n //errbacks should not be called for failures in\n //their callbacks (#699). However if a global\n //onError is set, use that.\n if ((this.events.error && this.map.isDefine) ||\n req.onError !== defaultOnError) {\n try {\n exports = context.execCb(id, factory, depExports, exports);\n } catch (e) {\n err = e;\n }\n } else {\n exports = context.execCb(id, factory, depExports, exports);\n }\n\n // Favor return value over exports. If node/cjs in play,\n // then will not have a return value anyway. Favor\n // module.exports assignment over exports object.\n if (this.map.isDefine && exports === undefined) {\n cjsModule = this.module;\n if (cjsModule) {\n exports = cjsModule.exports;\n } else if (this.usingExports) {\n //exports already set the defined value.\n exports = this.exports;\n }\n }\n\n if (err) {\n err.requireMap = this.map;\n err.requireModules = this.map.isDefine ? [this.map.id] : null;\n err.requireType = this.map.isDefine ? 'define' : 'require';\n return onError((this.error = err));\n }\n\n } else {\n //Just a literal value\n exports = factory;\n }\n\n this.exports = exports;\n\n if (this.map.isDefine && !this.ignore) {\n defined[id] = exports;\n\n if (req.onResourceLoad) {\n var resLoadMaps = [];\n each(this.depMaps, function (depMap) {\n resLoadMaps.push(depMap.normalizedMap || depMap);\n });\n req.onResourceLoad(context, this.map, resLoadMaps);\n }\n }\n\n //Clean up\n cleanRegistry(id);\n\n this.defined = true;\n }\n\n //Finished the define stage. Allow calling check again\n //to allow define notifications below in the case of a\n //cycle.\n this.defining = false;\n\n if (this.defined && !this.defineEmitted) {\n this.defineEmitted = true;\n this.emit('defined', this.exports);\n this.defineEmitComplete = true;\n }\n\n }\n },\n\n callPlugin: function () {\n var map = this.map,\n id = map.id,\n //Map already normalized the prefix.\n pluginMap = makeModuleMap(map.prefix);\n\n //Mark this as a dependency for this plugin, so it\n //can be traced for cycles.\n this.depMaps.push(pluginMap);\n\n on(pluginMap, 'defined', bind(this, function (plugin) {\n var load, normalizedMap, normalizedMod,\n bundleId = getOwn(bundlesMap, this.map.id),\n name = this.map.name,\n parentName = this.map.parentMap ? this.map.parentMap.name : null,\n localRequire = context.makeRequire(map.parentMap, {\n enableBuildCallback: true\n });\n\n //If current map is not normalized, wait for that\n //normalized name to load instead of continuing.\n if (this.map.unnormalized) {\n //Normalize the ID if the plugin allows it.\n if (plugin.normalize) {\n name = plugin.normalize(name, function (name) {\n return normalize(name, parentName, true);\n }) || '';\n }\n\n //prefix and name should already be normalized, no need\n //for applying map config again either.\n normalizedMap = makeModuleMap(map.prefix + '!' + name,\n this.map.parentMap,\n true);\n on(normalizedMap,\n 'defined', bind(this, function (value) {\n this.map.normalizedMap = normalizedMap;\n this.init([], function () { return value; }, null, {\n enabled: true,\n ignore: true\n });\n }));\n\n normalizedMod = getOwn(registry, normalizedMap.id);\n if (normalizedMod) {\n //Mark this as a dependency for this plugin, so it\n //can be traced for cycles.\n this.depMaps.push(normalizedMap);\n\n if (this.events.error) {\n normalizedMod.on('error', bind(this, function (err) {\n this.emit('error', err);\n }));\n }\n normalizedMod.enable();\n }\n\n return;\n }\n\n //If a paths config, then just load that file instead to\n //resolve the plugin, as it is built into that paths layer.\n if (bundleId) {\n this.map.url = context.nameToUrl(bundleId);\n this.load();\n return;\n }\n\n load = bind(this, function (value) {\n this.init([], function () { return value; }, null, {\n enabled: true\n });\n });\n\n load.error = bind(this, function (err) {\n this.inited = true;\n this.error = err;\n err.requireModules = [id];\n\n //Remove temp unnormalized modules for this module,\n //since they will never be resolved otherwise now.\n eachProp(registry, function (mod) {\n if (mod.map.id.indexOf(id + '_unnormalized') === 0) {\n cleanRegistry(mod.map.id);\n }\n });\n\n onError(err);\n });\n\n //Allow plugins to load other code without having to know the\n //context or how to 'complete' the load.\n load.fromText = bind(this, function (text, textAlt) {\n /*jslint evil: true */\n var moduleName = map.name,\n moduleMap = makeModuleMap(moduleName),\n hasInteractive = useInteractive;\n\n //As of 2.1.0, support just passing the text, to reinforce\n //fromText only being called once per resource. Still\n //support old style of passing moduleName but discard\n //that moduleName in favor of the internal ref.\n if (textAlt) {\n text = textAlt;\n }\n\n //Turn off interactive script matching for IE for any define\n //calls in the text, then turn it back on at the end.\n if (hasInteractive) {\n useInteractive = false;\n }\n\n //Prime the system by creating a module instance for\n //it.\n getModule(moduleMap);\n\n //Transfer any config to this other module.\n if (hasProp(config.config, id)) {\n config.config[moduleName] = config.config[id];\n }\n\n try {\n req.exec(text);\n } catch (e) {\n return onError(makeError('fromtexteval',\n 'fromText eval for ' + id +\n ' failed: ' + e,\n e,\n [id]));\n }\n\n if (hasInteractive) {\n useInteractive = true;\n }\n\n //Mark this as a dependency for the plugin\n //resource\n this.depMaps.push(moduleMap);\n\n //Support anonymous modules.\n context.completeLoad(moduleName);\n\n //Bind the value of that module to the value for this\n //resource ID.\n localRequire([moduleName], load);\n });\n\n //Use parentName here since the plugin's name is not reliable,\n //could be some weird string with no path that actually wants to\n //reference the parentName's path.\n plugin.load(map.name, localRequire, load, config);\n }));\n\n context.enable(pluginMap, this);\n this.pluginMaps[pluginMap.id] = pluginMap;\n },\n\n enable: function () {\n enabledRegistry[this.map.id] = this;\n this.enabled = true;\n\n //Set flag mentioning that the module is enabling,\n //so that immediate calls to the defined callbacks\n //for dependencies do not trigger inadvertent load\n //with the depCount still being zero.\n this.enabling = true;\n\n //Enable each dependency\n each(this.depMaps, bind(this, function (depMap, i) {\n var id, mod, handler;\n\n if (typeof depMap === 'string') {\n //Dependency needs to be converted to a depMap\n //and wired up to this module.\n depMap = makeModuleMap(depMap,\n (this.map.isDefine ? this.map : this.map.parentMap),\n false,\n !this.skipMap);\n this.depMaps[i] = depMap;\n\n handler = getOwn(handlers, depMap.id);\n\n if (handler) {\n this.depExports[i] = handler(this);\n return;\n }\n\n this.depCount += 1;\n\n on(depMap, 'defined', bind(this, function (depExports) {\n if (this.undefed) {\n return;\n }\n this.defineDep(i, depExports);\n this.check();\n }));\n\n if (this.errback) {\n on(depMap, 'error', bind(this, this.errback));\n } else if (this.events.error) {\n // No direct errback on this module, but something\n // else is listening for errors, so be sure to\n // propagate the error correctly.\n on(depMap, 'error', bind(this, function(err) {\n this.emit('error', err);\n }));\n }\n }\n\n id = depMap.id;\n mod = registry[id];\n\n //Skip special modules like 'require', 'exports', 'module'\n //Also, don't call enable if it is already enabled,\n //important in circular dependency cases.\n if (!hasProp(handlers, id) && mod && !mod.enabled) {\n context.enable(depMap, this);\n }\n }));\n\n //Enable each plugin that is used in\n //a dependency\n eachProp(this.pluginMaps, bind(this, function (pluginMap) {\n var mod = getOwn(registry, pluginMap.id);\n if (mod && !mod.enabled) {\n context.enable(pluginMap, this);\n }\n }));\n\n this.enabling = false;\n\n this.check();\n },\n\n on: function (name, cb) {\n var cbs = this.events[name];\n if (!cbs) {\n cbs = this.events[name] = [];\n }\n cbs.push(cb);\n },\n\n emit: function (name, evt) {\n each(this.events[name], function (cb) {\n cb(evt);\n });\n if (name === 'error') {\n //Now that the error handler was triggered, remove\n //the listeners, since this broken Module instance\n //can stay around for a while in the registry.\n delete this.events[name];\n }\n }\n };\n\n function callGetModule(args) {\n //Skip modules already defined.\n if (!hasProp(defined, args[0])) {\n getModule(makeModuleMap(args[0], null, true)).init(args[1], args[2]);\n }\n }\n\n function removeListener(node, func, name, ieName) {\n //Favor detachEvent because of IE9\n //issue, see attachEvent/addEventListener comment elsewhere\n //in this file.\n if (node.detachEvent && !isOpera) {\n //Probably IE. If not it will throw an error, which will be\n //useful to know.\n if (ieName) {\n node.detachEvent(ieName, func);\n }\n } else {\n node.removeEventListener(name, func, false);\n }\n }\n\n /**\n * Given an event from a script node, get the requirejs info from it,\n * and then removes the event listeners on the node.\n * @param {Event} evt\n * @returns {Object}\n */\n function getScriptData(evt) {\n //Using currentTarget instead of target for Firefox 2.0's sake. Not\n //all old browsers will be supported, but this one was easy enough\n //to support and still makes sense.\n var node = evt.currentTarget || evt.srcElement;\n\n //Remove the listeners once here.\n removeListener(node, context.onScriptLoad, 'load', 'onreadystatechange');\n removeListener(node, context.onScriptError, 'error');\n\n return {\n node: node,\n id: node && node.getAttribute('data-requiremodule')\n };\n }\n\n function intakeDefines() {\n var args;\n\n //Any defined modules in the global queue, intake them now.\n takeGlobalQueue();\n\n //Make sure any remaining defQueue items get properly processed.\n while (defQueue.length) {\n args = defQueue.shift();\n if (args[0] === null) {\n return onError(makeError('mismatch', 'Mismatched anonymous define() module: ' +\n args[args.length - 1]));\n } else {\n //args are id, deps, factory. Should be normalized by the\n //define() function.\n callGetModule(args);\n }\n }\n context.defQueueMap = {};\n }\n\n context = {\n config: config,\n contextName: contextName,\n registry: registry,\n defined: defined,\n urlFetched: urlFetched,\n defQueue: defQueue,\n defQueueMap: {},\n Module: Module,\n makeModuleMap: makeModuleMap,\n nextTick: req.nextTick,\n onError: onError,\n\n /**\n * Set a configuration for the context.\n * @param {Object} cfg config object to integrate.\n */\n configure: function (cfg) {\n //Make sure the baseUrl ends in a slash.\n if (cfg.baseUrl) {\n if (cfg.baseUrl.charAt(cfg.baseUrl.length - 1) !== '/') {\n cfg.baseUrl += '/';\n }\n }\n\n // Convert old style urlArgs string to a function.\n if (typeof cfg.urlArgs === 'string') {\n var urlArgs = cfg.urlArgs;\n cfg.urlArgs = function(id, url) {\n return (url.indexOf('?') === -1 ? '?' : '&') + urlArgs;\n };\n }\n\n //Save off the paths since they require special processing,\n //they are additive.\n var shim = config.shim,\n objs = {\n paths: true,\n bundles: true,\n config: true,\n map: true\n };\n\n eachProp(cfg, function (value, prop) {\n if (objs[prop]) {\n if (!config[prop]) {\n config[prop] = {};\n }\n mixin(config[prop], value, true, true);\n } else {\n config[prop] = value;\n }\n });\n\n //Reverse map the bundles\n if (cfg.bundles) {\n eachProp(cfg.bundles, function (value, prop) {\n each(value, function (v) {\n if (v !== prop) {\n bundlesMap[v] = prop;\n }\n });\n });\n }\n\n //Merge shim\n if (cfg.shim) {\n eachProp(cfg.shim, function (value, id) {\n //Normalize the structure\n if (isArray(value)) {\n value = {\n deps: value\n };\n }\n if ((value.exports || value.init) && !value.exportsFn) {\n value.exportsFn = context.makeShimExports(value);\n }\n shim[id] = value;\n });\n config.shim = shim;\n }\n\n //Adjust packages if necessary.\n if (cfg.packages) {\n each(cfg.packages, function (pkgObj) {\n var location, name;\n\n pkgObj = typeof pkgObj === 'string' ? {name: pkgObj} : pkgObj;\n\n name = pkgObj.name;\n location = pkgObj.location;\n if (location) {\n config.paths[name] = pkgObj.location;\n }\n\n //Save pointer to main module ID for pkg name.\n //Remove leading dot in main, so main paths are normalized,\n //and remove any trailing .js, since different package\n //envs have different conventions: some use a module name,\n //some use a file name.\n config.pkgs[name] = pkgObj.name + '/' + (pkgObj.main || 'main')\n .replace(currDirRegExp, '')\n .replace(jsSuffixRegExp, '');\n });\n }\n\n //If there are any \"waiting to execute\" modules in the registry,\n //update the maps for them, since their info, like URLs to load,\n //may have changed.\n eachProp(registry, function (mod, id) {\n //If module already has init called, since it is too\n //late to modify them, and ignore unnormalized ones\n //since they are transient.\n if (!mod.inited && !mod.map.unnormalized) {\n mod.map = makeModuleMap(id, null, true);\n }\n });\n\n //If a deps array or a config callback is specified, then call\n //require with those args. This is useful when require is defined as a\n //config object before require.js is loaded.\n if (cfg.deps || cfg.callback) {\n context.require(cfg.deps || [], cfg.callback);\n }\n },\n\n makeShimExports: function (value) {\n function fn() {\n var ret;\n if (value.init) {\n ret = value.init.apply(global, arguments);\n }\n return ret || (value.exports && getGlobal(value.exports));\n }\n return fn;\n },\n\n makeRequire: function (relMap, options) {\n options = options || {};\n\n function localRequire(deps, callback, errback) {\n var id, map, requireMod;\n\n if (options.enableBuildCallback && callback && isFunction(callback)) {\n callback.__requireJsBuild = true;\n }\n\n if (typeof deps === 'string') {\n if (isFunction(callback)) {\n //Invalid call\n return onError(makeError('requireargs', 'Invalid require call'), errback);\n }\n\n //If require|exports|module are requested, get the\n //value for them from the special handlers. Caveat:\n //this only works while module is being defined.\n if (relMap && hasProp(handlers, deps)) {\n return handlers[deps](registry[relMap.id]);\n }\n\n //Synchronous access to one module. If require.get is\n //available (as in the Node adapter), prefer that.\n if (req.get) {\n return req.get(context, deps, relMap, localRequire);\n }\n\n //Normalize module name, if it contains . or ..\n map = makeModuleMap(deps, relMap, false, true);\n id = map.id;\n\n if (!hasProp(defined, id)) {\n return onError(makeError('notloaded', 'Module name \"' +\n id +\n '\" has not been loaded yet for context: ' +\n contextName +\n (relMap ? '' : '. Use require([])')));\n }\n return defined[id];\n }\n\n //Grab defines waiting in the global queue.\n intakeDefines();\n\n //Mark all the dependencies as needing to be loaded.\n context.nextTick(function () {\n //Some defines could have been added since the\n //require call, collect them.\n intakeDefines();\n\n requireMod = getModule(makeModuleMap(null, relMap));\n\n //Store if map config should be applied to this require\n //call for dependencies.\n requireMod.skipMap = options.skipMap;\n\n requireMod.init(deps, callback, errback, {\n enabled: true\n });\n\n checkLoaded();\n });\n\n return localRequire;\n }\n\n mixin(localRequire, {\n isBrowser: isBrowser,\n\n /**\n * Converts a module name + .extension into an URL path.\n * *Requires* the use of a module name. It does not support using\n * plain URLs like nameToUrl.\n */\n toUrl: function (moduleNamePlusExt) {\n var ext,\n index = moduleNamePlusExt.lastIndexOf('.'),\n segment = moduleNamePlusExt.split('/')[0],\n isRelative = segment === '.' || segment === '..';\n\n //Have a file extension alias, and it is not the\n //dots from a relative path.\n if (index !== -1 && (!isRelative || index > 1)) {\n ext = moduleNamePlusExt.substring(index, moduleNamePlusExt.length);\n moduleNamePlusExt = moduleNamePlusExt.substring(0, index);\n }\n\n return context.nameToUrl(normalize(moduleNamePlusExt,\n relMap && relMap.id, true), ext, true);\n },\n\n defined: function (id) {\n return hasProp(defined, makeModuleMap(id, relMap, false, true).id);\n },\n\n specified: function (id) {\n id = makeModuleMap(id, relMap, false, true).id;\n return hasProp(defined, id) || hasProp(registry, id);\n }\n });\n\n //Only allow undef on top level require calls\n if (!relMap) {\n localRequire.undef = function (id) {\n //Bind any waiting define() calls to this context,\n //fix for #408\n takeGlobalQueue();\n\n var map = makeModuleMap(id, relMap, true),\n mod = getOwn(registry, id);\n\n mod.undefed = true;\n removeScript(id);\n\n delete defined[id];\n delete urlFetched[map.url];\n delete undefEvents[id];\n\n //Clean queued defines too. Go backwards\n //in array so that the splices do not\n //mess up the iteration.\n eachReverse(defQueue, function(args, i) {\n if (args[0] === id) {\n defQueue.splice(i, 1);\n }\n });\n delete context.defQueueMap[id];\n\n if (mod) {\n //Hold on to listeners in case the\n //module will be attempted to be reloaded\n //using a different config.\n if (mod.events.defined) {\n undefEvents[id] = mod.events;\n }\n\n cleanRegistry(id);\n }\n };\n }\n\n return localRequire;\n },\n\n /**\n * Called to enable a module if it is still in the registry\n * awaiting enablement. A second arg, parent, the parent module,\n * is passed in for context, when this method is overridden by\n * the optimizer. Not shown here to keep code compact.\n */\n enable: function (depMap) {\n var mod = getOwn(registry, depMap.id);\n if (mod) {\n getModule(depMap).enable();\n }\n },\n\n /**\n * Internal method used by environment adapters to complete a load event.\n * A load event could be a script load or just a load pass from a synchronous\n * load call.\n * @param {String} moduleName the name of the module to potentially complete.\n */\n completeLoad: function (moduleName) {\n var found, args, mod,\n shim = getOwn(config.shim, moduleName) || {},\n shExports = shim.exports;\n\n takeGlobalQueue();\n\n while (defQueue.length) {\n args = defQueue.shift();\n if (args[0] === null) {\n args[0] = moduleName;\n //If already found an anonymous module and bound it\n //to this name, then this is some other anon module\n //waiting for its completeLoad to fire.\n if (found) {\n break;\n }\n found = true;\n } else if (args[0] === moduleName) {\n //Found matching define call for this script!\n found = true;\n }\n\n callGetModule(args);\n }\n context.defQueueMap = {};\n\n //Do this after the cycle of callGetModule in case the result\n //of those calls/init calls changes the registry.\n mod = getOwn(registry, moduleName);\n\n if (!found && !hasProp(defined, moduleName) && mod && !mod.inited) {\n if (config.enforceDefine && (!shExports || !getGlobal(shExports))) {\n if (hasPathFallback(moduleName)) {\n return;\n } else {\n return onError(makeError('nodefine',\n 'No define call for ' + moduleName,\n null,\n [moduleName]));\n }\n } else {\n //A script that does not call define(), so just simulate\n //the call for it.\n callGetModule([moduleName, (shim.deps || []), shim.exportsFn]);\n }\n }\n\n checkLoaded();\n },\n\n /**\n * Converts a module name to a file path. Supports cases where\n * moduleName may actually be just an URL.\n * Note that it **does not** call normalize on the moduleName,\n * it is assumed to have already been normalized. This is an\n * internal API, not a public one. Use toUrl for the public API.\n */\n nameToUrl: function (moduleName, ext, skipExt) {\n var paths, syms, i, parentModule, url,\n parentPath, bundleId,\n pkgMain = getOwn(config.pkgs, moduleName);\n\n if (pkgMain) {\n moduleName = pkgMain;\n }\n\n bundleId = getOwn(bundlesMap, moduleName);\n\n if (bundleId) {\n return context.nameToUrl(bundleId, ext, skipExt);\n }\n\n //If a colon is in the URL, it indicates a protocol is used and it is just\n //an URL to a file, or if it starts with a slash, contains a query arg (i.e. ?)\n //or ends with .js, then assume the user meant to use an url and not a module id.\n //The slash is important for protocol-less URLs as well as full paths.\n if (req.jsExtRegExp.test(moduleName)) {\n //Just a plain path, not module name lookup, so just return it.\n //Add extension if it is included. This is a bit wonky, only non-.js things pass\n //an extension, this method probably needs to be reworked.\n url = moduleName + (ext || '');\n } else {\n //A module that needs to be converted to a path.\n paths = config.paths;\n\n syms = moduleName.split('/');\n //For each module name segment, see if there is a path\n //registered for it. Start with most specific name\n //and work up from it.\n for (i = syms.length; i > 0; i -= 1) {\n parentModule = syms.slice(0, i).join('/');\n\n parentPath = getOwn(paths, parentModule);\n if (parentPath) {\n //If an array, it means there are a few choices,\n //Choose the one that is desired\n if (isArray(parentPath)) {\n parentPath = parentPath[0];\n }\n syms.splice(0, i, parentPath);\n break;\n }\n }\n\n //Join the path parts together, then figure out if baseUrl is needed.\n url = syms.join('/');\n url += (ext || (/^data\\:|^blob\\:|\\?/.test(url) || skipExt ? '' : '.js'));\n url = (url.charAt(0) === '/' || url.match(/^[\\w\\+\\.\\-]+:/) ? '' : config.baseUrl) + url;\n }\n\n return config.urlArgs && !/^blob\\:/.test(url) ?\n url + config.urlArgs(moduleName, url) : url;\n },\n\n //Delegates to req.load. Broken out as a separate function to\n //allow overriding in the optimizer.\n load: function (id, url) {\n req.load(context, id, url);\n },\n\n /**\n * Executes a module callback function. Broken out as a separate function\n * solely to allow the build system to sequence the files in the built\n * layer in the right sequence.\n *\n * @private\n */\n execCb: function (name, callback, args, exports) {\n return callback.apply(exports, args);\n },\n\n /**\n * callback for script loads, used to check status of loading.\n *\n * @param {Event} evt the event from the browser for the script\n * that was loaded.\n */\n onScriptLoad: function (evt) {\n //Using currentTarget instead of target for Firefox 2.0's sake. Not\n //all old browsers will be supported, but this one was easy enough\n //to support and still makes sense.\n if (evt.type === 'load' ||\n (readyRegExp.test((evt.currentTarget || evt.srcElement).readyState))) {\n //Reset interactive script so a script node is not held onto for\n //to long.\n interactiveScript = null;\n\n //Pull out the name of the module and the context.\n var data = getScriptData(evt);\n context.completeLoad(data.id);\n }\n },\n\n /**\n * Callback for script errors.\n */\n onScriptError: function (evt) {\n var data = getScriptData(evt);\n if (!hasPathFallback(data.id)) {\n var parents = [];\n eachProp(registry, function(value, key) {\n if (key.indexOf('_@r') !== 0) {\n each(value.depMaps, function(depMap) {\n if (depMap.id === data.id) {\n parents.push(key);\n return true;\n }\n });\n }\n });\n return onError(makeError('scripterror', 'Script error for \"' + data.id +\n (parents.length ?\n '\", needed by: ' + parents.join(', ') :\n '\"'), evt, [data.id]));\n }\n }\n };\n\n context.require = context.makeRequire();\n return context;\n }\n\n /**\n * Main entry point.\n *\n * If the only argument to require is a string, then the module that\n * is represented by that string is fetched for the appropriate context.\n *\n * If the first argument is an array, then it will be treated as an array\n * of dependency string names to fetch. An optional function callback can\n * be specified to execute when all of those dependencies are available.\n *\n * Make a local req variable to help Caja compliance (it assumes things\n * on a require that are not standardized), and to give a short\n * name for minification/local scope use.\n */\n req = requirejs = function (deps, callback, errback, optional) {\n\n //Find the right context, use default\n var context, config,\n contextName = defContextName;\n\n // Determine if have config object in the call.\n if (!isArray(deps) && typeof deps !== 'string') {\n // deps is a config object\n config = deps;\n if (isArray(callback)) {\n // Adjust args if there are dependencies\n deps = callback;\n callback = errback;\n errback = optional;\n } else {\n deps = [];\n }\n }\n\n if (config && config.context) {\n contextName = config.context;\n }\n\n context = getOwn(contexts, contextName);\n if (!context) {\n context = contexts[contextName] = req.s.newContext(contextName);\n }\n\n if (config) {\n context.configure(config);\n }\n\n return context.require(deps, callback, errback);\n };\n\n /**\n * Support require.config() to make it easier to cooperate with other\n * AMD loaders on globally agreed names.\n */\n req.config = function (config) {\n return req(config);\n };\n\n /**\n * Execute something after the current tick\n * of the event loop. Override for other envs\n * that have a better solution than setTimeout.\n * @param {Function} fn function to execute later.\n */\n req.nextTick = typeof setTimeout !== 'undefined' ? function (fn) {\n setTimeout(fn, 4);\n } : function (fn) { fn(); };\n\n /**\n * Export require as a global, but only if it does not already exist.\n */\n if (!require) {\n require = req;\n }\n\n req.version = version;\n\n //Used to filter out dependencies that are already paths.\n req.jsExtRegExp = /^\\/|:|\\?|\\.js$/;\n req.isBrowser = isBrowser;\n s = req.s = {\n contexts: contexts,\n newContext: newContext\n };\n\n //Create default context.\n req({});\n\n //Exports some context-sensitive methods on global require.\n each([\n 'toUrl',\n 'undef',\n 'defined',\n 'specified'\n ], function (prop) {\n //Reference from contexts instead of early binding to default context,\n //so that during builds, the latest instance of the default context\n //with its config gets used.\n req[prop] = function () {\n var ctx = contexts[defContextName];\n return ctx.require[prop].apply(ctx, arguments);\n };\n });\n\n if (isBrowser) {\n head = s.head = document.getElementsByTagName('head')[0];\n //If BASE tag is in play, using appendChild is a problem for IE6.\n //When that browser dies, this can be removed. Details in this jQuery bug:\n //http://dev.jquery.com/ticket/2709\n baseElement = document.getElementsByTagName('base')[0];\n if (baseElement) {\n head = s.head = baseElement.parentNode;\n }\n }\n\n /**\n * Any errors that require explicitly generates will be passed to this\n * function. Intercept/override it if you want custom error handling.\n * @param {Error} err the error object.\n */\n req.onError = defaultOnError;\n\n /**\n * Creates the node for the load command. Only used in browser envs.\n */\n req.createNode = function (config, moduleName, url) {\n var node = config.xhtml ?\n document.createElementNS('http://www.w3.org/1999/xhtml', 'html:script') :\n document.createElement('script');\n node.type = config.scriptType || 'text/javascript';\n node.charset = 'utf-8';\n node.async = true;\n return node;\n };\n\n /**\n * Does the request to load a module for the browser case.\n * Make this a separate function to allow other environments\n * to override it.\n *\n * @param {Object} context the require context to find state.\n * @param {String} moduleName the name of the module.\n * @param {Object} url the URL to the module.\n */\n req.load = function (context, moduleName, url) {\n var config = (context && context.config) || {},\n node;\n if (isBrowser) {\n //In the browser so use a script tag\n node = req.createNode(config, moduleName, url);\n\n node.setAttribute('data-requirecontext', context.contextName);\n node.setAttribute('data-requiremodule', moduleName);\n\n //Set up load listener. Test attachEvent first because IE9 has\n //a subtle issue in its addEventListener and script onload firings\n //that do not match the behavior of all other browsers with\n //addEventListener support, which fire the onload event for a\n //script right after the script execution. See:\n //https://connect.microsoft.com/IE/feedback/details/648057/script-onload-event-is-not-fired-immediately-after-script-execution\n //UNFORTUNATELY Opera implements attachEvent but does not follow the script\n //script execution mode.\n if (node.attachEvent &&\n //Check if node.attachEvent is artificially added by custom script or\n //natively supported by browser\n //read https://github.com/requirejs/requirejs/issues/187\n //if we can NOT find [native code] then it must NOT natively supported.\n //in IE8, node.attachEvent does not have toString()\n //Note the test for \"[native code\" with no closing brace, see:\n //https://github.com/requirejs/requirejs/issues/273\n !(node.attachEvent.toString && node.attachEvent.toString().indexOf('[native code') < 0) &&\n !isOpera) {\n //Probably IE. IE (at least 6-8) do not fire\n //script onload right after executing the script, so\n //we cannot tie the anonymous define call to a name.\n //However, IE reports the script as being in 'interactive'\n //readyState at the time of the define call.\n useInteractive = true;\n\n node.attachEvent('onreadystatechange', context.onScriptLoad);\n //It would be great to add an error handler here to catch\n //404s in IE9+. However, onreadystatechange will fire before\n //the error handler, so that does not help. If addEventListener\n //is used, then IE will fire error before load, but we cannot\n //use that pathway given the connect.microsoft.com issue\n //mentioned above about not doing the 'script execute,\n //then fire the script load event listener before execute\n //next script' that other browsers do.\n //Best hope: IE10 fixes the issues,\n //and then destroys all installs of IE 6-9.\n //node.attachEvent('onerror', context.onScriptError);\n } else {\n node.addEventListener('load', context.onScriptLoad, false);\n node.addEventListener('error', context.onScriptError, false);\n }\n node.src = url;\n\n //Calling onNodeCreated after all properties on the node have been\n //set, but before it is placed in the DOM.\n if (config.onNodeCreated) {\n config.onNodeCreated(node, config, moduleName, url);\n }\n\n //For some cache cases in IE 6-8, the script executes before the end\n //of the appendChild execution, so to tie an anonymous define\n //call to the module name (which is stored on the node), hold on\n //to a reference to this node, but clear after the DOM insertion.\n currentlyAddingScript = node;\n if (baseElement) {\n head.insertBefore(node, baseElement);\n } else {\n head.appendChild(node);\n }\n currentlyAddingScript = null;\n\n return node;\n } else if (isWebWorker) {\n try {\n //In a web worker, use importScripts. This is not a very\n //efficient use of importScripts, importScripts will block until\n //its script is downloaded and evaluated. However, if web workers\n //are in play, the expectation is that a build has been done so\n //that only one script needs to be loaded anyway. This may need\n //to be reevaluated if other use cases become common.\n\n // Post a task to the event loop to work around a bug in WebKit\n // where the worker gets garbage-collected after calling\n // importScripts(): https://webkit.org/b/153317\n setTimeout(function() {}, 0);\n importScripts(url);\n\n //Account for anonymous modules\n context.completeLoad(moduleName);\n } catch (e) {\n context.onError(makeError('importscripts',\n 'importScripts failed for ' +\n moduleName + ' at ' + url,\n e,\n [moduleName]));\n }\n }\n };\n\n function getInteractiveScript() {\n if (interactiveScript && interactiveScript.readyState === 'interactive') {\n return interactiveScript;\n }\n\n eachReverse(scripts(), function (script) {\n if (script.readyState === 'interactive') {\n return (interactiveScript = script);\n }\n });\n return interactiveScript;\n }\n\n //Look for a data-main script attribute, which could also adjust the baseUrl.\n if (isBrowser && !cfg.skipDataMain) {\n //Figure out baseUrl. Get it from the script tag with require.js in it.\n eachReverse(scripts(), function (script) {\n //Set the 'head' where we can append children by\n //using the script's parent.\n if (!head) {\n head = script.parentNode;\n }\n\n //Look for a data-main attribute to set main script for the page\n //to load. If it is there, the path to data main becomes the\n //baseUrl, if it is not already set.\n dataMain = script.getAttribute('data-main');\n if (dataMain) {\n //Preserve dataMain in case it is a path (i.e. contains '?')\n mainScript = dataMain;\n\n //Set final baseUrl if there is not already an explicit one,\n //but only do so if the data-main value is not a loader plugin\n //module ID.\n if (!cfg.baseUrl && mainScript.indexOf('!') === -1) {\n //Pull off the directory of data-main for use as the\n //baseUrl.\n src = mainScript.split('/');\n mainScript = src.pop();\n subPath = src.length ? src.join('/') + '/' : './';\n\n cfg.baseUrl = subPath;\n }\n\n //Strip off any trailing .js since mainScript is now\n //like a module name.\n mainScript = mainScript.replace(jsSuffixRegExp, '');\n\n //If mainScript is still a path, fall back to dataMain\n if (req.jsExtRegExp.test(mainScript)) {\n mainScript = dataMain;\n }\n\n //Put the data-main script in the files to load.\n cfg.deps = cfg.deps ? cfg.deps.concat(mainScript) : [mainScript];\n\n return true;\n }\n });\n }\n\n /**\n * The function that handles definitions of modules. Differs from\n * require() in that a string for the module should be the first argument,\n * and the function to execute after dependencies are loaded should\n * return a value to define the module corresponding to the first argument's\n * name.\n */\n define = function (name, deps, callback) {\n var node, context;\n\n //Allow for anonymous modules\n if (typeof name !== 'string') {\n //Adjust args appropriately\n callback = deps;\n deps = name;\n name = null;\n }\n\n //This module may not have dependencies\n if (!isArray(deps)) {\n callback = deps;\n deps = null;\n }\n\n //If no name, and callback is a function, then figure out if it a\n //CommonJS thing with dependencies.\n if (!deps && isFunction(callback)) {\n deps = [];\n //Remove comments from the callback string,\n //look for require calls, and pull them into the dependencies,\n //but only if there are function args.\n if (callback.length) {\n callback\n .toString()\n .replace(commentRegExp, commentReplace)\n .replace(cjsRequireRegExp, function (match, dep) {\n deps.push(dep);\n });\n\n //May be a CommonJS thing even without require calls, but still\n //could use exports, and module. Avoid doing exports and module\n //work though if it just needs require.\n //REQUIRES the function to expect the CommonJS variables in the\n //order listed below.\n deps = (callback.length === 1 ? ['require'] : ['require', 'exports', 'module']).concat(deps);\n }\n }\n\n //If in IE 6-8 and hit an anonymous define() call, do the interactive\n //work.\n if (useInteractive) {\n node = currentlyAddingScript || getInteractiveScript();\n if (node) {\n if (!name) {\n name = node.getAttribute('data-requiremodule');\n }\n context = contexts[node.getAttribute('data-requirecontext')];\n }\n }\n\n //Always save off evaluating the def call until the script onload handler.\n //This allows multiple modules to be in a file without prematurely\n //tracing dependencies, and allows for anonymous module support,\n //where the module name is not known until the script onload event\n //occurs. If no context, use the global queue, and get it processed\n //in the onscript load callback.\n if (context) {\n context.defQueue.push([name, deps, callback]);\n context.defQueueMap[name] = true;\n } else {\n globalDefQueue.push([name, deps, callback]);\n }\n };\n\n define.amd = {\n jQuery: true\n };\n\n /**\n * Executes the text. Normally just uses eval, but can be modified\n * to use a better, environment-specific call. Only used for transpiling\n * loader plugins, not for plain JS modules.\n * @param {String} text the text to execute/evaluate.\n */\n req.exec = function (text) {\n /*jslint evil: true */\n return eval(text);\n };\n\n //Set up with config info.\n req(cfg);\n}(this, (typeof setTimeout === 'undefined' ? undefined : setTimeout)));\n\ndefine(\"deps/require\", function(){});\n\n", - "var hyperHTML = (function (global) {\n 'use strict';\n\n var G = document.defaultView;\n\n // Node.CONSTANTS\n // 'cause some engine has no global Node defined\n // (i.e. Node, NativeScript, basicHTML ... )\n var ELEMENT_NODE = 1;\n var TEXT_NODE = 3;\n var COMMENT_NODE = 8;\n var DOCUMENT_FRAGMENT_NODE = 11;\n\n // HTML related constants\n var VOID_ELEMENTS = /^area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|source|track|wbr$/i;\n\n // SVG related constants\n var OWNER_SVG_ELEMENT = 'ownerSVGElement';\n var SVG_NAMESPACE = 'http://www.w3.org/2000/svg';\n\n // Custom Elements / MutationObserver constants\n var CONNECTED = 'connected';\n var DISCONNECTED = 'dis' + CONNECTED;\n\n // hyperHTML related constants\n var EXPANDO = '_hyper: ';\n var SHOULD_USE_TEXT_CONTENT = /^style|textarea$/i;\n var UID = EXPANDO + (Math.random() * new Date() | 0) + ';';\n var UIDC = '<!--' + UID + '-->';\n\n // you know that kind of basics you need to cover\n // your use case only but you don't want to bloat the library?\n // There's even a package in here:\n // https://www.npmjs.com/package/poorlyfills\n\n // used to dispatch simple events\n var Event = G.Event;\n try {\n new Event('Event');\n } catch (o_O) {\n Event = function Event(type) {\n var e = document.createEvent('Event');\n e.initEvent(type, false, false);\n return e;\n };\n }\n\n // used to store template literals\n /* istanbul ignore next */\n var Map = G.Map || function Map() {\n var keys = [],\n values = [];\n return {\n get: function get(obj) {\n return values[keys.indexOf(obj)];\n },\n set: function set(obj, value) {\n values[keys.push(obj) - 1] = value;\n }\n };\n };\n\n // used to store wired content\n var ID = 0;\n var WeakMap = G.WeakMap || function WeakMap() {\n var key = UID + ID++;\n return {\n get: function get(obj) {\n return obj[key];\n },\n set: function set(obj, value) {\n Object.defineProperty(obj, key, {\n configurable: true,\n value: value\n });\n }\n };\n };\n\n // used to store hyper.Components\n var WeakSet = G.WeakSet || function WeakSet() {\n var wm = new WeakMap();\n return {\n add: function add(obj) {\n wm.set(obj, true);\n },\n has: function has(obj) {\n return wm.get(obj) === true;\n }\n };\n };\n\n // used to be sure IE9 or older Androids work as expected\n var isArray = Array.isArray || function (toString) {\n return function (arr) {\n return toString.call(arr) === '[object Array]';\n };\n }({}.toString);\n\n var trim = UID.trim || function () {\n return this.replace(/^\\s+|\\s+$/g, '');\n };\n\n // hyperHTML.Component is a very basic class\n // able to create Custom Elements like components\n // including the ability to listen to connect/disconnect\n // events via onconnect/ondisconnect attributes\n // Components can be created imperatively or declaratively.\n // The main difference is that declared components\n // will not automatically render on setState(...)\n // to simplify state handling on render.\n function Component() {\n return this; // this is needed in Edge !!!\n }\n\n // Component is lazily setup because it needs\n // wire mechanism as lazy content\n function setup(content) {\n // there are various weakly referenced variables in here\n // and mostly are to use Component.for(...) static method.\n var children = new WeakMap();\n var create = Object.create;\n var createEntry = function createEntry(wm, id, component) {\n wm.set(id, component);\n return component;\n };\n var get = function get(Class, info, context, id) {\n var relation = info.get(Class) || relate(Class, info);\n switch (typeof id) {\n case 'object':\n case 'function':\n var wm = relation.w || (relation.w = new WeakMap());\n return wm.get(id) || createEntry(wm, id, new Class(context));\n default:\n var sm = relation.p || (relation.p = create(null));\n return sm[id] || (sm[id] = new Class(context));\n }\n };\n var relate = function relate(Class, info) {\n var relation = { w: null, p: null };\n info.set(Class, relation);\n return relation;\n };\n var set = function set(context) {\n var info = new Map();\n children.set(context, info);\n return info;\n };\n // The Component Class\n Object.defineProperties(Component, {\n // Component.for(context[, id]) is a convenient way\n // to automatically relate data/context to children components\n // If not created yet, the new Component(context) is weakly stored\n // and after that same instance would always be returned.\n for: {\n configurable: true,\n value: function value(context, id) {\n return get(this, children.get(context) || set(context), context, id == null ? 'default' : id);\n }\n }\n });\n Object.defineProperties(Component.prototype, {\n // all events are handled with the component as context\n handleEvent: {\n value: function value(e) {\n var ct = e.currentTarget;\n this['getAttribute' in ct && ct.getAttribute('data-call') || 'on' + e.type](e);\n }\n },\n // components will lazily define html or svg properties\n // as soon as these are invoked within the .render() method\n // Such render() method is not provided by the base class\n // but it must be available through the Component extend.\n // Declared components could implement a\n // render(props) method too and use props as needed.\n html: lazyGetter('html', content),\n svg: lazyGetter('svg', content),\n // the state is a very basic/simple mechanism inspired by Preact\n state: lazyGetter('state', function () {\n return this.defaultState;\n }),\n // it is possible to define a default state that'd be always an object otherwise\n defaultState: {\n get: function get() {\n return {};\n }\n },\n // setting some property state through a new object\n // or a callback, triggers also automatically a render\n // unless explicitly specified to not do so (render === false)\n setState: {\n value: function value(state, render) {\n var target = this.state;\n var source = typeof state === 'function' ? state.call(this, target) : state;\n for (var key in source) {\n target[key] = source[key];\n }if (render !== false) this.render();\n return this;\n }\n }\n });\n }\n\n // instead of a secret key I could've used a WeakMap\n // However, attaching a property directly will result\n // into better performance with thousands of components\n // hanging around, and less memory pressure caused by the WeakMap\n var lazyGetter = function lazyGetter(type, fn) {\n var secret = '_' + type + '$';\n return {\n get: function get() {\n return this[secret] || (this[type] = fn.call(this, type));\n },\n set: function set(value) {\n Object.defineProperty(this, secret, { configurable: true, value: value });\n }\n };\n };\n\n var intents = {};\n var keys = [];\n var hasOwnProperty = intents.hasOwnProperty;\n\n var length = 0;\n\n var Intent = {\n\n // hyperHTML.define('intent', (object, update) => {...})\n // can be used to define a third parts update mechanism\n // when every other known mechanism failed.\n // hyper.define('user', info => info.name);\n // hyper(node)`<p>${{user}}</p>`;\n define: function define(intent, callback) {\n if (!(intent in intents)) {\n length = keys.push(intent);\n }\n intents[intent] = callback;\n },\n\n // this method is used internally as last resort\n // to retrieve a value out of an object\n invoke: function invoke(object, callback) {\n for (var i = 0; i < length; i++) {\n var key = keys[i];\n if (hasOwnProperty.call(object, key)) {\n return intents[key](object[key], callback);\n }\n }\n }\n };\n\n // these are tiny helpers to simplify most common operations needed here\n var create = function create(node, type) {\n return doc(node).createElement(type);\n };\n var doc = function doc(node) {\n return node.ownerDocument || node;\n };\n var fragment = function fragment(node) {\n return doc(node).createDocumentFragment();\n };\n var text = function text(node, _text) {\n return doc(node).createTextNode(_text);\n };\n\n // TODO: I'd love to code-cover RegExp too here\n // these are fundamental for this library\n\n var spaces = ' \\\\f\\\\n\\\\r\\\\t';\n var almostEverything = '[^ ' + spaces + '\\\\/>\"\\'=]+';\n var attrName = '[ ' + spaces + ']+' + almostEverything;\n var tagName = '<([A-Za-z]+[A-Za-z0-9:_-]*)((?:';\n var attrPartials = '(?:=(?:\\'[^\\']*?\\'|\"[^\"]*?\"|<[^>]*?>|' + almostEverything + '))?)';\n\n var attrSeeker = new RegExp(tagName + attrName + attrPartials + '+)([ ' + spaces + ']*/?>)', 'g');\n\n var selfClosing = new RegExp(tagName + attrName + attrPartials + '*)([ ' + spaces + ']*/>)', 'g');\n\n var testFragment = fragment(document);\n\n // DOM4 node.append(...many)\n var hasAppend = 'append' in testFragment;\n\n // detect old browsers without HTMLTemplateElement content support\n var hasContent = 'content' in create(document, 'template');\n\n // IE 11 has problems with cloning templates: it \"forgets\" empty childNodes\n testFragment.appendChild(text(testFragment, 'g'));\n testFragment.appendChild(text(testFragment, ''));\n var hasDoomedCloneNode = testFragment.cloneNode(true).childNodes.length === 1;\n\n // old browsers need to fallback to cloneNode\n // Custom Elements V0 and V1 will work polyfilled\n // but native implementations need importNode instead\n // (specially Chromium and its old V0 implementation)\n var hasImportNode = 'importNode' in document;\n\n // appends an array of nodes\n // to a generic node/fragment\n // When available, uses append passing all arguments at once\n // hoping that's somehow faster, even if append has more checks on type\n var append = hasAppend ? function (node, childNodes) {\n node.append.apply(node, childNodes);\n } : function (node, childNodes) {\n var length = childNodes.length;\n for (var i = 0; i < length; i++) {\n node.appendChild(childNodes[i]);\n }\n };\n\n var findAttributes = new RegExp('(' + attrName + '=)([\\'\"]?)' + UIDC + '\\\\2', 'gi');\n var comments = function comments($0, $1, $2, $3) {\n return '<' + $1 + $2.replace(findAttributes, replaceAttributes) + $3;\n };\n var replaceAttributes = function replaceAttributes($0, $1, $2) {\n return $1 + ($2 || '\"') + UID + ($2 || '\"');\n };\n\n // given a node and a generic HTML content,\n // create either an SVG or an HTML fragment\n // where such content will be injected\n var createFragment = function createFragment(node, html) {\n return (OWNER_SVG_ELEMENT in node ? SVGFragment : HTMLFragment)(node, html.replace(attrSeeker, comments));\n };\n\n // IE/Edge shenanigans proof cloneNode\n // it goes through all nodes manually\n // instead of relying the engine to suddenly\n // merge nodes together\n var cloneNode = hasDoomedCloneNode ? function (node) {\n var clone = node.cloneNode();\n var childNodes = node.childNodes ||\n // this is an excess of caution\n // but some node, in IE, might not\n // have childNodes property.\n // The following fallback ensure working code\n // in older IE without compromising performance\n // or any other browser/engine involved.\n /* istanbul ignore next */\n [];\n var length = childNodes.length;\n for (var i = 0; i < length; i++) {\n clone.appendChild(cloneNode(childNodes[i]));\n }\n return clone;\n } :\n // the following ignore is due code-coverage\n // combination of not having document.importNode\n // but having a working node.cloneNode.\n // This shenario is common on older Android/WebKit browsers\n // but basicHTML here tests just two major cases:\n // with document.importNode or with broken cloneNode.\n /* istanbul ignore next */\n function (node) {\n return node.cloneNode(true);\n };\n\n // used to import html into fragments\n var importNode = hasImportNode ? function (doc$$1, node) {\n return doc$$1.importNode(node, true);\n } : function (doc$$1, node) {\n return cloneNode(node);\n };\n\n // just recycling a one-off array to use slice\n // in every needed place\n var slice = [].slice;\n\n // lazy evaluated, returns the unique identity\n // of a template literal, as tempalte literal itself.\n // By default, ES2015 template literals are unique\n // tag`a${1}z` === tag`a${2}z`\n // even if interpolated values are different\n // the template chunks are in a frozen Array\n // that is identical each time you use the same\n // literal to represent same static content\n // around its own interpolations.\n var unique = function unique(template) {\n return _TL(template);\n };\n\n // TL returns a unique version of the template\n // it needs lazy feature detection\n // (cannot trust literals with transpiled code)\n var _TL = function TL(template) {\n if (\n // TypeScript template literals are not standard\n template.propertyIsEnumerable('raw') ||\n // Firefox < 55 has not standard implementation neither\n /Firefox\\/(\\d+)/.test((G.navigator || {}).userAgent) && parseFloat(RegExp.$1) < 55) {\n // in these cases, address templates once\n var templateObjects = {};\n // but always return the same template\n _TL = function TL(template) {\n var key = '_' + template.join(UID);\n return templateObjects[key] || (templateObjects[key] = template);\n };\n } else {\n // make TL an identity like function\n _TL = function TL(template) {\n return template;\n };\n }\n return _TL(template);\n };\n\n // create document fragments via native template\n // with a fallback for browsers that won't be able\n // to deal with some injected element such <td> or others\n var HTMLFragment = hasContent ? function (node, html) {\n var container = create(node, 'template');\n container.innerHTML = html;\n return container.content;\n } : function (node, html) {\n var container = create(node, 'template');\n var content = fragment(node);\n if (/^[^\\S]*?<(col(?:group)?|t(?:head|body|foot|r|d|h))/i.test(html)) {\n var selector = RegExp.$1;\n container.innerHTML = '<table>' + html + '</table>';\n append(content, slice.call(container.querySelectorAll(selector)));\n } else {\n container.innerHTML = html;\n append(content, slice.call(container.childNodes));\n }\n return content;\n };\n\n // creates SVG fragment with a fallback for IE that needs SVG\n // within the HTML content\n var SVGFragment = hasContent ? function (node, html) {\n var content = fragment(node);\n var container = doc(node).createElementNS(SVG_NAMESPACE, 'svg');\n container.innerHTML = html;\n append(content, slice.call(container.childNodes));\n return content;\n } : function (node, html) {\n var content = fragment(node);\n var container = create(node, 'div');\n container.innerHTML = '<svg xmlns=\"' + SVG_NAMESPACE + '\">' + html + '</svg>';\n append(content, slice.call(container.firstChild.childNodes));\n return content;\n };\n\n function Wire(childNodes) {\n this.childNodes = childNodes;\n this.length = childNodes.length;\n this.first = childNodes[0];\n this.last = childNodes[this.length - 1];\n }\n\n // when a wire is inserted, all its nodes will follow\n Wire.prototype.insert = function insert() {\n var df = fragment(this.first);\n append(df, this.childNodes);\n return df;\n };\n\n // when a wire is removed, all its nodes must be removed as well\n Wire.prototype.remove = function remove() {\n var first = this.first;\n var last = this.last;\n if (this.length === 2) {\n last.parentNode.removeChild(last);\n } else {\n var range = doc(first).createRange();\n range.setStartBefore(this.childNodes[1]);\n range.setEndAfter(last);\n range.deleteContents();\n }\n return first;\n };\n\n // every template literal interpolation indicates\n // a precise target in the DOM the template is representing.\n // `<p id=${'attribute'}>some ${'content'}</p>`\n // hyperHTML finds only once per template literal,\n // hence once per entire application life-cycle,\n // all nodes that are related to interpolations.\n // These nodes are stored as indexes used to retrieve,\n // once per upgrade, nodes that will change on each future update.\n // A path example is [2, 0, 1] representing the operation:\n // node.childNodes[2].childNodes[0].childNodes[1]\n // Attributes are addressed via their owner node and their name.\n var createPath = function createPath(node) {\n var path = [];\n var parentNode = void 0;\n switch (node.nodeType) {\n case ELEMENT_NODE:\n case DOCUMENT_FRAGMENT_NODE:\n parentNode = node;\n break;\n case COMMENT_NODE:\n parentNode = node.parentNode;\n prepend(path, parentNode, node);\n break;\n default:\n parentNode = node.ownerElement;\n break;\n }\n for (node = parentNode; parentNode = parentNode.parentNode; node = parentNode) {\n prepend(path, parentNode, node);\n }\n return path;\n };\n\n var prepend = function prepend(path, parent, node) {\n path.unshift(path.indexOf.call(parent.childNodes, node));\n };\n\n var Path = {\n create: function create(type, node, name) {\n return { type: type, name: name, node: node, path: createPath(node) };\n },\n find: function find(node, path) {\n var length = path.length;\n for (var i = 0; i < length; i++) {\n node = node.childNodes[path[i]];\n }\n return node;\n }\n };\n\n // from https://github.com/developit/preact/blob/33fc697ac11762a1cb6e71e9847670d047af7ce5/src/constants.js\n var IS_NON_DIMENSIONAL = /acit|ex(?:s|g|n|p|$)|rph|ows|mnc|ntw|ine[ch]|zoo|^ord/i;\n\n // style is handled as both string and object\n // even if the target is an SVG element (consistency)\n var Style = (function (node, original, isSVG) {\n if (isSVG) {\n var style = original.cloneNode(true);\n style.value = '';\n node.setAttributeNode(style);\n return update(style, isSVG);\n }\n return update(node.style, isSVG);\n });\n\n // the update takes care or changing/replacing\n // only properties that are different or\n // in case of string, the whole node\n var update = function update(style, isSVG) {\n var oldType = void 0,\n oldValue = void 0;\n return function (newValue) {\n switch (typeof newValue) {\n case 'object':\n if (newValue) {\n if (oldType === 'object') {\n if (!isSVG) {\n if (oldValue !== newValue) {\n for (var key in oldValue) {\n if (!(key in newValue)) {\n style[key] = '';\n }\n }\n }\n }\n } else {\n if (isSVG) style.value = '';else style.cssText = '';\n }\n var info = isSVG ? {} : style;\n for (var _key in newValue) {\n var value = newValue[_key];\n info[_key] = typeof value === 'number' && !IS_NON_DIMENSIONAL.test(_key) ? value + 'px' : value;\n }\n oldType = 'object';\n if (isSVG) style.value = toStyle(oldValue = info);else oldValue = newValue;\n break;\n }\n default:\n if (oldValue != newValue) {\n oldType = 'string';\n oldValue = newValue;\n if (isSVG) style.value = newValue || '';else style.cssText = newValue || '';\n }\n break;\n }\n };\n };\n\n var hyphen = /([^A-Z])([A-Z]+)/g;\n var ized = function ized($0, $1, $2) {\n return $1 + '-' + $2.toLowerCase();\n };\n var toStyle = function toStyle(object) {\n var css = [];\n for (var key in object) {\n css.push(key.replace(hyphen, ized), ':', object[key], ';');\n }\n return css.join('');\n };\n\n /* AUTOMATICALLY IMPORTED, DO NOT MODIFY */\n /*! (c) 2017 Andrea Giammarchi (ISC) */\n\n /**\n * This code is a revisited port of the snabbdom vDOM diffing logic,\n * the same that fuels as fork Vue.js or other libraries.\n * @credits https://github.com/snabbdom/snabbdom\n */\n\n var identity = function identity(O) {\n return O;\n };\n\n var remove = function remove(parentNode, before, after) {\n var range = parentNode.ownerDocument.createRange();\n range.setStartBefore(before);\n range.setEndAfter(after);\n range.deleteContents();\n };\n\n var domdiff = function domdiff(parentNode, // where changes happen\n currentNodes, // Array of current items/nodes\n futureNodes, // Array of future items/nodes\n getNode, // optional way to retrieve a node from an item\n beforeNode // optional item/node to use as insertBefore delimiter\n ) {\n var get = getNode || identity;\n var before = beforeNode == null ? null : get(beforeNode, 0);\n var currentStart = 0,\n futureStart = 0;\n var currentEnd = currentNodes.length - 1;\n var currentStartNode = currentNodes[0];\n var currentEndNode = currentNodes[currentEnd];\n var futureEnd = futureNodes.length - 1;\n var futureStartNode = futureNodes[0];\n var futureEndNode = futureNodes[futureEnd];\n while (currentStart <= currentEnd && futureStart <= futureEnd) {\n if (currentStartNode == null) {\n currentStartNode = currentNodes[++currentStart];\n } else if (currentEndNode == null) {\n currentEndNode = currentNodes[--currentEnd];\n } else if (futureStartNode == null) {\n futureStartNode = futureNodes[++futureStart];\n } else if (futureEndNode == null) {\n futureEndNode = futureNodes[--futureEnd];\n } else if (currentStartNode == futureStartNode) {\n currentStartNode = currentNodes[++currentStart];\n futureStartNode = futureNodes[++futureStart];\n } else if (currentEndNode == futureEndNode) {\n currentEndNode = currentNodes[--currentEnd];\n futureEndNode = futureNodes[--futureEnd];\n } else if (currentStartNode == futureEndNode) {\n parentNode.insertBefore(get(currentStartNode, 1), get(currentEndNode, -0).nextSibling);\n currentStartNode = currentNodes[++currentStart];\n futureEndNode = futureNodes[--futureEnd];\n } else if (currentEndNode == futureStartNode) {\n parentNode.insertBefore(get(currentEndNode, 1), get(currentStartNode, 0));\n currentEndNode = currentNodes[--currentEnd];\n futureStartNode = futureNodes[++futureStart];\n } else {\n var index = currentNodes.indexOf(futureStartNode);\n if (index < 0) {\n parentNode.insertBefore(get(futureStartNode, 1), get(currentStartNode, 0));\n futureStartNode = futureNodes[++futureStart];\n } else {\n var i = index;\n var f = futureStart;\n while (i <= currentEnd && f <= futureEnd && currentNodes[i] === futureNodes[f]) {\n i++;\n f++;\n }\n if (1 < i - index) {\n if (--index === currentStart) {\n parentNode.removeChild(get(currentStartNode, -1));\n } else {\n remove(parentNode, get(currentStartNode, -1), get(currentNodes[index], -1));\n }\n currentStart = i;\n futureStart = f;\n currentStartNode = currentNodes[i];\n futureStartNode = futureNodes[f];\n } else {\n var el = currentNodes[index];\n currentNodes[index] = null;\n parentNode.insertBefore(get(el, 1), get(currentStartNode, 0));\n futureStartNode = futureNodes[++futureStart];\n }\n }\n }\n }\n if (currentStart <= currentEnd || futureStart <= futureEnd) {\n if (currentStart > currentEnd) {\n var pin = futureNodes[futureEnd + 1];\n var place = pin == null ? before : get(pin, 0);\n if (futureStart === futureEnd) {\n parentNode.insertBefore(get(futureNodes[futureStart], 1), place);\n } else {\n var fragment = parentNode.ownerDocument.createDocumentFragment();\n while (futureStart <= futureEnd) {\n fragment.appendChild(get(futureNodes[futureStart++], 1));\n }\n parentNode.insertBefore(fragment, place);\n }\n } else {\n if (currentNodes[currentStart] == null) currentStart++;\n if (currentStart === currentEnd) {\n parentNode.removeChild(get(currentNodes[currentStart], -1));\n } else {\n remove(parentNode, get(currentNodes[currentStart], -1), get(currentNodes[currentEnd], -1));\n }\n }\n }\n return futureNodes;\n };\n\n // hyper.Component have a connected/disconnected\n // mechanism provided by MutationObserver\n // This weak set is used to recognize components\n // as DOM node that needs to trigger connected/disconnected events\n var components = new WeakSet();\n\n // a basic dictionary used to filter already cached attributes\n // while looking for special hyperHTML values.\n function Cache() {}\n Cache.prototype = Object.create(null);\n\n // returns an intent to explicitly inject content as html\n var asHTML = function asHTML(html) {\n return { html: html };\n };\n\n // returns nodes from wires and components\n var asNode = function asNode(item, i) {\n return 'ELEMENT_NODE' in item ? item : item.constructor === Wire ?\n // in the Wire case, the content can be\n // removed, post-pended, inserted, or pre-pended and\n // all these cases are handled by domdiff already\n /* istanbul ignore next */\n 1 / i < 0 ? i ? item.remove() : item.last : i ? item.insert() : item.first : asNode(item.render(), i);\n };\n\n // returns true if domdiff can handle the value\n var canDiff = function canDiff(value) {\n return 'ELEMENT_NODE' in value || value instanceof Wire || value instanceof Component;\n };\n\n // updates are created once per context upgrade\n // within the main render function (../hyper/render.js)\n // These are an Array of callbacks to invoke passing\n // each interpolation value.\n // Updates can be related to any kind of content,\n // attributes, or special text-only cases such <style>\n // elements or <textarea>\n var create$1 = function create$$1(root, paths) {\n var updates = [];\n var length = paths.length;\n for (var i = 0; i < length; i++) {\n var info = paths[i];\n var node = Path.find(root, info.path);\n switch (info.type) {\n case 'any':\n updates.push(setAnyContent(node, []));\n break;\n case 'attr':\n updates.push(setAttribute(node, info.name, info.node));\n break;\n case 'text':\n updates.push(setTextContent(node));\n node.textContent = '';\n break;\n }\n }\n return updates;\n };\n\n // finding all paths is a one-off operation performed\n // when a new template literal is used.\n // The goal is to map all target nodes that will be\n // used to update content/attributes every time\n // the same template literal is used to create content.\n // The result is a list of paths related to the template\n // with all the necessary info to create updates as\n // list of callbacks that target directly affected nodes.\n var find = function find(node, paths, parts) {\n var childNodes = node.childNodes;\n var length = childNodes.length;\n for (var i = 0; i < length; i++) {\n var child = childNodes[i];\n switch (child.nodeType) {\n case ELEMENT_NODE:\n findAttributes$1(child, paths, parts);\n find(child, paths, parts);\n break;\n case COMMENT_NODE:\n if (child.textContent === UID) {\n parts.shift();\n paths.push(\n // basicHTML or other non standard engines\n // might end up having comments in nodes\n // where they shouldn't, hence this check.\n SHOULD_USE_TEXT_CONTENT.test(node.nodeName) ? Path.create('text', node) : Path.create('any', child));\n }\n break;\n case TEXT_NODE:\n // the following ignore is actually covered by browsers\n // only basicHTML ends up on previous COMMENT_NODE case\n // instead of TEXT_NODE because it knows nothing about\n // special style or textarea behavior\n /* istanbul ignore if */\n if (SHOULD_USE_TEXT_CONTENT.test(node.nodeName) && trim.call(child.textContent) === UIDC) {\n parts.shift();\n paths.push(Path.create('text', node));\n }\n break;\n }\n }\n };\n\n // attributes are searched via unique hyperHTML id value.\n // Despite HTML being case insensitive, hyperHTML is able\n // to recognize attributes by name in a caseSensitive way.\n // This plays well with Custom Elements definitions\n // and also with XML-like environments, without trusting\n // the resulting DOM but the template literal as the source of truth.\n // IE/Edge has a funny bug with attributes and these might be duplicated.\n // This is why there is a cache in charge of being sure no duplicated\n // attributes are ever considered in future updates.\n var findAttributes$1 = function findAttributes(node, paths, parts) {\n var cache = new Cache();\n var attributes = node.attributes;\n var array = slice.call(attributes);\n var remove = [];\n var length = array.length;\n for (var i = 0; i < length; i++) {\n var attribute = array[i];\n if (attribute.value === UID) {\n var name = attribute.name;\n // the following ignore is covered by IE\n // and the IE9 double viewBox test\n /* istanbul ignore else */\n if (!(name in cache)) {\n var realName = parts.shift().replace(/^(?:|[\\S\\s]*?\\s)(\\S+?)=['\"]?$/, '$1');\n cache[name] = attributes[realName] ||\n // the following ignore is covered by browsers\n // while basicHTML is already case-sensitive\n /* istanbul ignore next */\n attributes[realName.toLowerCase()];\n paths.push(Path.create('attr', cache[name], realName));\n }\n remove.push(attribute);\n }\n }\n var len = remove.length;\n for (var _i = 0; _i < len; _i++) {\n // Edge HTML bug #16878726\n var _attribute = remove[_i];\n if (/^id$/i.test(_attribute.name)) node.removeAttribute(_attribute.name);\n // standard browsers would work just fine here\n else node.removeAttributeNode(remove[_i]);\n }\n\n // This is a very specific Firefox/Safari issue\n // but since it should be a not so common pattern,\n // it's probably worth patching regardless.\n // Basically, scripts created through strings are death.\n // You need to create fresh new scripts instead.\n // TODO: is there any other node that needs such nonsense?\n var nodeName = node.nodeName;\n if (/^script$/i.test(nodeName)) {\n // this used to be like that\n // const script = createElement(node, nodeName);\n // then Edge arrived and decided that scripts created\n // through template documents aren't worth executing\n // so it became this ... hopefully it won't hurt in the wild\n var script = document.createElement(nodeName);\n for (var _i2 = 0; _i2 < attributes.length; _i2++) {\n script.setAttributeNode(attributes[_i2].cloneNode(true));\n }\n script.textContent = node.textContent;\n node.parentNode.replaceChild(script, node);\n }\n };\n\n // when a Promise is used as interpolation value\n // its result must be parsed once resolved.\n // This callback is in charge of understanding what to do\n // with a returned value once the promise is resolved.\n var invokeAtDistance = function invokeAtDistance(value, callback) {\n callback(value.placeholder);\n if ('text' in value) {\n Promise.resolve(value.text).then(String).then(callback);\n } else if ('any' in value) {\n Promise.resolve(value.any).then(callback);\n } else if ('html' in value) {\n Promise.resolve(value.html).then(asHTML).then(callback);\n } else {\n Promise.resolve(Intent.invoke(value, callback)).then(callback);\n }\n };\n\n // quick and dirty way to check for Promise/ish values\n var isPromise_ish = function isPromise_ish(value) {\n return value != null && 'then' in value;\n };\n\n // in a hyper(node)`<div>${content}</div>` case\n // everything could happen:\n // * it's a JS primitive, stored as text\n // * it's null or undefined, the node should be cleaned\n // * it's a component, update the content by rendering it\n // * it's a promise, update the content once resolved\n // * it's an explicit intent, perform the desired operation\n // * it's an Array, resolve all values if Promises and/or\n // update the node with the resulting list of content\n var setAnyContent = function setAnyContent(node, childNodes) {\n var fastPath = false;\n var oldValue = void 0;\n var anyContent = function anyContent(value) {\n switch (typeof value) {\n case 'string':\n case 'number':\n case 'boolean':\n if (fastPath) {\n if (oldValue !== value) {\n oldValue = value;\n childNodes[0].textContent = value;\n }\n } else {\n fastPath = true;\n oldValue = value;\n childNodes = domdiff(node.parentNode, childNodes, [text(node, value)], asNode, node);\n }\n break;\n case 'object':\n case 'undefined':\n if (value == null) {\n fastPath = false;\n childNodes = domdiff(node.parentNode, childNodes, [], asNode, node);\n break;\n }\n default:\n fastPath = false;\n oldValue = value;\n if (isArray(value)) {\n if (value.length === 0) {\n if (childNodes.length) {\n childNodes = domdiff(node.parentNode, childNodes, [], asNode, node);\n }\n } else {\n switch (typeof value[0]) {\n case 'string':\n case 'number':\n case 'boolean':\n anyContent({ html: value });\n break;\n case 'object':\n if (isArray(value[0])) {\n value = value.concat.apply([], value);\n }\n if (isPromise_ish(value[0])) {\n Promise.all(value).then(anyContent);\n break;\n }\n default:\n childNodes = domdiff(node.parentNode, childNodes, value, asNode, node);\n break;\n }\n }\n } else if (canDiff(value)) {\n childNodes = domdiff(node.parentNode, childNodes, value.nodeType === DOCUMENT_FRAGMENT_NODE ? slice.call(value.childNodes) : [value], asNode, node);\n } else if (isPromise_ish(value)) {\n value.then(anyContent);\n } else if ('placeholder' in value) {\n invokeAtDistance(value, anyContent);\n } else if ('text' in value) {\n anyContent(String(value.text));\n } else if ('any' in value) {\n anyContent(value.any);\n } else if ('html' in value) {\n childNodes = domdiff(node.parentNode, childNodes, slice.call(createFragment(node, [].concat(value.html).join('')).childNodes), asNode, node);\n } else if ('length' in value) {\n anyContent(slice.call(value));\n } else {\n anyContent(Intent.invoke(value, anyContent));\n }\n break;\n }\n };\n return anyContent;\n };\n\n // there are four kind of attributes, and related behavior:\n // * events, with a name starting with `on`, to add/remove event listeners\n // * special, with a name present in their inherited prototype, accessed directly\n // * regular, accessed through get/setAttribute standard DOM methods\n // * style, the only regular attribute that also accepts an object as value\n // so that you can style=${{width: 120}}. In this case, the behavior has been\n // fully inspired by Preact library and its simplicity.\n var setAttribute = function setAttribute(node, name, original) {\n var isSVG = OWNER_SVG_ELEMENT in node;\n var oldValue = void 0;\n // if the attribute is the style one\n // handle it differently from others\n if (name === 'style') {\n return Style(node, original, isSVG);\n }\n // the name is an event one,\n // add/remove event listeners accordingly\n else if (/^on/.test(name)) {\n var type = name.slice(2);\n if (type === CONNECTED || type === DISCONNECTED) {\n if (notObserving) {\n notObserving = false;\n observe();\n }\n components.add(node);\n } else if (name.toLowerCase() in node) {\n type = type.toLowerCase();\n }\n return function (newValue) {\n if (oldValue !== newValue) {\n if (oldValue) node.removeEventListener(type, oldValue, false);\n oldValue = newValue;\n if (newValue) node.addEventListener(type, newValue, false);\n }\n };\n }\n // the attribute is special ('value' in input)\n // and it's not SVG *or* the name is exactly data,\n // in this case assign the value directly\n else if (name === 'data' || !isSVG && name in node) {\n return function (newValue) {\n if (oldValue !== newValue) {\n oldValue = newValue;\n if (node[name] !== newValue) {\n node[name] = newValue;\n if (newValue == null) {\n node.removeAttribute(name);\n }\n }\n }\n };\n }\n // in every other case, use the attribute node as it is\n // update only the value, set it as node only when/if needed\n else {\n var owner = false;\n var attribute = original.cloneNode(true);\n return function (newValue) {\n if (oldValue !== newValue) {\n oldValue = newValue;\n if (attribute.value !== newValue) {\n if (newValue == null) {\n if (owner) {\n owner = false;\n node.removeAttributeNode(attribute);\n }\n attribute.value = newValue;\n } else {\n attribute.value = newValue;\n if (!owner) {\n owner = true;\n node.setAttributeNode(attribute);\n }\n }\n }\n }\n };\n }\n };\n\n // style or textareas don't accept HTML as content\n // it's pointless to transform or analyze anything\n // different from text there but it's worth checking\n // for possible defined intents.\n var setTextContent = function setTextContent(node) {\n var oldValue = void 0;\n var textContent = function textContent(value) {\n if (oldValue !== value) {\n oldValue = value;\n if (typeof value === 'object' && value) {\n if (isPromise_ish(value)) {\n value.then(textContent);\n } else if ('placeholder' in value) {\n invokeAtDistance(value, textContent);\n } else if ('text' in value) {\n textContent(String(value.text));\n } else if ('any' in value) {\n textContent(value.any);\n } else if ('html' in value) {\n textContent([].concat(value.html).join(''));\n } else if ('length' in value) {\n textContent(slice.call(value).join(''));\n } else {\n textContent(Intent.invoke(value, textContent));\n }\n } else {\n node.textContent = value == null ? '' : value;\n }\n }\n };\n return textContent;\n };\n\n var Updates = { create: create$1, find: find };\n\n // hyper.Components might need connected/disconnected notifications\n // used by components and their onconnect/ondisconnect callbacks.\n // When one of these callbacks is encountered,\n // the document starts being observed.\n var notObserving = true;\n function observe() {\n\n // when hyper.Component related DOM nodes\n // are appended or removed from the live tree\n // these might listen to connected/disconnected events\n // This utility is in charge of finding all components\n // involved in the DOM update/change and dispatch\n // related information to them\n var dispatchAll = function dispatchAll(nodes, type) {\n var event = new Event(type);\n var length = nodes.length;\n for (var i = 0; i < length; i++) {\n var node = nodes[i];\n if (node.nodeType === ELEMENT_NODE) {\n dispatchTarget(node, event);\n }\n }\n };\n\n // the way it's done is via the components weak set\n // and recursively looking for nested components too\n var dispatchTarget = function dispatchTarget(node, event) {\n if (components.has(node)) {\n node.dispatchEvent(event);\n }\n\n var children = node.children;\n var length = children.length;\n for (var i = 0; i < length; i++) {\n dispatchTarget(children[i], event);\n }\n };\n\n // The MutationObserver is the best way to implement that\n // but there is a fallback to deprecated DOMNodeInserted/Removed\n // so that even older browsers/engines can help components life-cycle\n try {\n new MutationObserver(function (records) {\n var length = records.length;\n for (var i = 0; i < length; i++) {\n var record = records[i];\n dispatchAll(record.removedNodes, DISCONNECTED);\n dispatchAll(record.addedNodes, CONNECTED);\n }\n }).observe(document, { subtree: true, childList: true });\n } catch (o_O) {\n document.addEventListener('DOMNodeRemoved', function (event) {\n dispatchAll([event.target], DISCONNECTED);\n }, false);\n document.addEventListener('DOMNodeInserted', function (event) {\n dispatchAll([event.target], CONNECTED);\n }, false);\n }\n }\n\n // a weak collection of contexts that\n // are already known to hyperHTML\n var bewitched = new WeakMap();\n\n // the collection of all template literals\n // since these are unique and immutable\n // for the whole application life-cycle\n var templates = new Map();\n\n // better known as hyper.bind(node), the render is\n // the main tag function in charge of fully upgrading\n // or simply updating, contexts used as hyperHTML targets.\n // The `this` context is either a regular DOM node or a fragment.\n function render(template) {\n var wicked = bewitched.get(this);\n if (wicked && wicked.template === unique(template)) {\n update$1.apply(wicked.updates, arguments);\n } else {\n upgrade.apply(this, arguments);\n }\n return this;\n }\n\n // an upgrade is in charge of collecting template info,\n // parse it once, if unknown, to map all interpolations\n // as single DOM callbacks, relate such template\n // to the current context, and render it after cleaning the context up\n function upgrade(template) {\n template = unique(template);\n var info = templates.get(template) || createTemplate.call(this, template);\n var fragment = importNode(this.ownerDocument, info.fragment);\n var updates = Updates.create(fragment, info.paths);\n bewitched.set(this, { template: template, updates: updates });\n update$1.apply(updates, arguments);\n this.textContent = '';\n this.appendChild(fragment);\n }\n\n // an update simply loops over all mapped DOM operations\n function update$1() {\n var length = arguments.length;\n for (var i = 1; i < length; i++) {\n this[i - 1](arguments[i]);\n }\n }\n\n // a template can be used to create a document fragment\n // aware of all interpolations and with a list\n // of paths used to find once those nodes that need updates,\n // no matter if these are attributes, text nodes, or regular one\n function createTemplate(template) {\n var paths = [];\n var html = template.join(UIDC).replace(SC_RE, SC_PLACE);\n var fragment = createFragment(this, html);\n Updates.find(fragment, paths, template.slice());\n var info = { fragment: fragment, paths: paths };\n templates.set(template, info);\n return info;\n }\n\n // some node could be special though, like a custom element\n // with a self closing tag, which should work through these changes.\n var SC_RE = selfClosing;\n var SC_PLACE = function SC_PLACE($0, $1, $2) {\n return VOID_ELEMENTS.test($1) ? $0 : '<' + $1 + $2 + '></' + $1 + '>';\n };\n\n // all wires used per each context\n var wires = new WeakMap();\n\n // A wire is a callback used as tag function\n // to lazily relate a generic object to a template literal.\n // hyper.wire(user)`<div id=user>${user.name}</div>`; => the div#user\n // This provides the ability to have a unique DOM structure\n // related to a unique JS object through a reusable template literal.\n // A wire can specify a type, as svg or html, and also an id\n // via html:id or :id convention. Such :id allows same JS objects\n // to be associated to different DOM structures accordingly with\n // the used template literal without losing previously rendered parts.\n var wire = function wire(obj, type) {\n return obj == null ? content(type || 'html') : weakly(obj, type || 'html');\n };\n\n // A wire content is a virtual reference to one or more nodes.\n // It's represented by either a DOM node, or an Array.\n // In both cases, the wire content role is to simply update\n // all nodes through the list of related callbacks.\n // In few words, a wire content is like an invisible parent node\n // in charge of updating its content like a bound element would do.\n var content = function content(type) {\n var wire = void 0,\n container = void 0,\n content = void 0,\n template = void 0,\n updates = void 0;\n return function (statics) {\n statics = unique(statics);\n var setup = template !== statics;\n if (setup) {\n template = statics;\n content = fragment(document);\n container = type === 'svg' ? document.createElementNS(SVG_NAMESPACE, 'svg') : content;\n updates = render.bind(container);\n }\n updates.apply(null, arguments);\n if (setup) {\n if (type === 'svg') {\n append(content, slice.call(container.childNodes));\n }\n wire = wireContent(content);\n }\n return wire;\n };\n };\n\n // wires are weakly created through objects.\n // Each object can have multiple wires associated\n // and this is thanks to the type + :id feature.\n var weakly = function weakly(obj, type) {\n var i = type.indexOf(':');\n var wire = wires.get(obj);\n var id = type;\n if (-1 < i) {\n id = type.slice(i + 1);\n type = type.slice(0, i) || 'html';\n }\n if (!wire) wires.set(obj, wire = {});\n return wire[id] || (wire[id] = content(type));\n };\n\n // a document fragment loses its nodes as soon\n // as it's appended into another node.\n // This would easily lose wired content\n // so that on a second render call, the parent\n // node wouldn't know which node was there\n // associated to the interpolation.\n // To prevent hyperHTML to forget about wired nodes,\n // these are either returned as Array or, if there's ony one entry,\n // as single referenced node that won't disappear from the fragment.\n // The initial fragment, at this point, would be used as unique reference.\n var wireContent = function wireContent(node) {\n var childNodes = node.childNodes;\n var length = childNodes.length;\n var wireNodes = [];\n for (var i = 0; i < length; i++) {\n var child = childNodes[i];\n if (child.nodeType === ELEMENT_NODE || trim.call(child.textContent).length !== 0) {\n wireNodes.push(child);\n }\n }\n return wireNodes.length === 1 ? wireNodes[0] : new Wire(wireNodes);\n };\n\n /*! (c) Andrea Giammarchi (ISC) */\n\n // all functions are self bound to the right context\n // you can do the following\n // const {bind, wire} = hyperHTML;\n // and use them right away: bind(node)`hello!`;\n var bind = function bind(context) {\n return render.bind(context);\n };\n var define = Intent.define;\n\n hyper.Component = Component;\n hyper.bind = bind;\n hyper.define = define;\n hyper.diff = domdiff;\n hyper.hyper = hyper;\n hyper.wire = wire;\n\n // the wire content is the lazy defined\n // html or svg property of each hyper.Component\n setup(content);\n\n // by default, hyperHTML is a smart function\n // that \"magically\" understands what's the best\n // thing to do with passed arguments\n function hyper(HTML) {\n return arguments.length < 2 ? HTML == null ? content('html') : typeof HTML === 'string' ? hyper.wire(null, HTML) : 'raw' in HTML ? content('html')(HTML) : 'nodeType' in HTML ? hyper.bind(HTML) : weakly(HTML, 'html') : ('raw' in HTML ? content('html') : hyper.wire).apply(null, arguments);\n }\n\n \n \n \n \n \n \n \n\n return hyper;\n\n}(window));\n\ndefine(\"deps/hyperhtml\", function(){});\n\n", - "/*! (C) Andrea Giammarchi - Mit Style License */\nvar URLSearchParams=URLSearchParams||function(){\"use strict\";function URLSearchParams(query){var index,key,value,pairs,i,length,dict=Object.create(null);this[secret]=dict;if(!query)return;if(typeof query===\"string\"){if(query.charAt(0)===\"?\"){query=query.slice(1)}for(pairs=query.split(\"&\"),i=0,length=pairs.length;i<length;i++){value=pairs[i];index=value.indexOf(\"=\");if(-1<index){appendTo(dict,decode(value.slice(0,index)),decode(value.slice(index+1)))}else if(value.length){appendTo(dict,decode(value),\"\")}}}else{if(isArray(query)){for(i=0,length=query.length;i<length;i++){value=query[i];appendTo(dict,value[0],value[1])}}else{for(key in query){appendTo(dict,key,query[key])}}}}var isArray=Array.isArray,URLSearchParamsProto=URLSearchParams.prototype,find=/[!'\\(\\)~]|%20|%00/g,plus=/\\+/g,replace={\"!\":\"%21\",\"'\":\"%27\",\"(\":\"%28\",\")\":\"%29\",\"~\":\"%7E\",\"%20\":\"+\",\"%00\":\"\\0\"},replacer=function(match){return replace[match]},secret=\"__URLSearchParams__:\"+Math.random();function appendTo(dict,name,value){if(name in dict){dict[name].push(\"\"+value)}else{dict[name]=isArray(value)?value:[\"\"+value]}}function decode(str){return decodeURIComponent(str.replace(plus,\" \"))}function encode(str){return encodeURIComponent(str).replace(find,replacer)}URLSearchParamsProto.append=function append(name,value){appendTo(this[secret],name,value)};URLSearchParamsProto[\"delete\"]=function del(name){delete this[secret][name]};URLSearchParamsProto.get=function get(name){var dict=this[secret];return name in dict?dict[name][0]:null};URLSearchParamsProto.getAll=function getAll(name){var dict=this[secret];return name in dict?dict[name].slice(0):[]};URLSearchParamsProto.has=function has(name){return name in this[secret]};URLSearchParamsProto.set=function set(name,value){this[secret][name]=[\"\"+value]};URLSearchParamsProto.forEach=function forEach(callback,thisArg){var dict=this[secret];Object.getOwnPropertyNames(dict).forEach(function(name){dict[name].forEach(function(value){callback.call(thisArg,value,name,this)},this)},this)};URLSearchParamsProto.toJSON=function toJSON(){return{}};URLSearchParamsProto.toString=function toString(){var dict=this[secret],query=[],i,key,name,value;for(key in dict){name=encode(key);for(i=0,value=dict[key];i<value.length;i++){query.push(name+\"=\"+encode(value[i]))}}return query.join(\"&\")};var dP=Object.defineProperty,gOPD=Object.getOwnPropertyDescriptor,createSearchParamsPollute=function(search){function append(name,value){URLSearchParamsProto.append.call(this,name,value);name=this.toString();search.set.call(this._usp,name?\"?\"+name:\"\")}function del(name){URLSearchParamsProto[\"delete\"].call(this,name);name=this.toString();search.set.call(this._usp,name?\"?\"+name:\"\")}function set(name,value){URLSearchParamsProto.set.call(this,name,value);name=this.toString();search.set.call(this._usp,name?\"?\"+name:\"\")}return function(sp,value){sp.append=append;sp[\"delete\"]=del;sp.set=set;return dP(sp,\"_usp\",{configurable:true,writable:true,value:value})}},createSearchParamsCreate=function(polluteSearchParams){return function(obj,sp){dP(obj,\"_searchParams\",{configurable:true,writable:true,value:polluteSearchParams(sp,obj)});return sp}},updateSearchParams=function(sp){var append=sp.append;sp.append=URLSearchParamsProto.append;URLSearchParams.call(sp,sp._usp.search.slice(1));sp.append=append},verifySearchParams=function(obj,Class){if(!(obj instanceof Class))throw new TypeError(\"'searchParams' accessed on an object that \"+\"does not implement interface \"+Class.name)},upgradeClass=function(Class){var ClassProto=Class.prototype,searchParams=gOPD(ClassProto,\"searchParams\"),href=gOPD(ClassProto,\"href\"),search=gOPD(ClassProto,\"search\"),createSearchParams;if(!searchParams&&search&&search.set){createSearchParams=createSearchParamsCreate(createSearchParamsPollute(search));Object.defineProperties(ClassProto,{href:{get:function(){return href.get.call(this)},set:function(value){var sp=this._searchParams;href.set.call(this,value);if(sp)updateSearchParams(sp)}},search:{get:function(){return search.get.call(this)},set:function(value){var sp=this._searchParams;search.set.call(this,value);if(sp)updateSearchParams(sp)}},searchParams:{get:function(){verifySearchParams(this,Class);return this._searchParams||createSearchParams(this,new URLSearchParams(this.search.slice(1)))},set:function(sp){verifySearchParams(this,Class);createSearchParams(this,sp)}}})}};upgradeClass(HTMLAnchorElement);if(/^function|object$/.test(typeof URL)&&URL.prototype)upgradeClass(URL);return URLSearchParams}();(function(URLSearchParamsProto){var iterable=function(){try{return!!Symbol.iterator}catch(error){return false}}();if(!(\"forEach\"in URLSearchParamsProto)){URLSearchParamsProto.forEach=function forEach(callback,thisArg){var names=Object.create(null);this.toString().replace(/=[\\s\\S]*?(?:&|$)/g,\"=\").split(\"=\").forEach(function(name){if(!name.length||name in names)return;(names[name]=this.getAll(name)).forEach(function(value){callback.call(thisArg,value,name,this)},this)},this)}}if(!(\"keys\"in URLSearchParamsProto)){URLSearchParamsProto.keys=function keys(){var items=[];this.forEach(function(value,name){items.push(name)});var iterator={next:function(){var value=items.shift();return{done:value===undefined,value:value}}};if(iterable){iterator[Symbol.iterator]=function(){return iterator}}return iterator}}if(!(\"values\"in URLSearchParamsProto)){URLSearchParamsProto.values=function values(){var items=[];this.forEach(function(value){items.push(value)});var iterator={next:function(){var value=items.shift();return{done:value===undefined,value:value}}};if(iterable){iterator[Symbol.iterator]=function(){return iterator}}return iterator}}if(!(\"entries\"in URLSearchParamsProto)){URLSearchParamsProto.entries=function entries(){var items=[];this.forEach(function(value,name){items.push([name,value])});var iterator={next:function(){var value=items.shift();return{done:value===undefined,value:value}}};if(iterable){iterator[Symbol.iterator]=function(){return iterator}}return iterator}}if(iterable&&!(Symbol.iterator in URLSearchParamsProto)){URLSearchParamsProto[Symbol.iterator]=URLSearchParamsProto.entries}if(!(\"sort\"in URLSearchParamsProto)){URLSearchParamsProto.sort=function sort(){var entries=this.entries(),entry=entries.next(),done=entry.done,keys=[],values=Object.create(null),i,key,value;while(!done){value=entry.value;key=value[0];keys.push(key);if(!(key in values)){values[key]=[]}values[key].push(value[1]);entry=entries.next();done=entry.done}keys.sort();for(i=0;i<keys.length;i++){this[\"delete\"](keys[i])}for(i=0;i<keys.length;i++){key=keys[i];this.append(key,values[key].shift())}}}})(URLSearchParams.prototype);\n\ndefine(\"deps/url-search-params\", function(){});\n\n", - "/**\n * @license domReady 2.0.1 Copyright jQuery Foundation and other contributors.\n * Released under MIT license, http://github.com/requirejs/domReady/LICENSE\n */\n/*jslint */\n/*global require: false, define: false, requirejs: false,\n window: false, clearInterval: false, document: false,\n self: false, setInterval: false */\n\n\ndefine('deps/domReady',[],function () {\n 'use strict';\n\n var isTop, testDiv, scrollIntervalId,\n isBrowser = typeof window !== \"undefined\" && window.document,\n isPageLoaded = !isBrowser,\n doc = isBrowser ? document : null,\n readyCalls = [];\n\n function runCallbacks(callbacks) {\n var i;\n for (i = 0; i < callbacks.length; i += 1) {\n callbacks[i](doc);\n }\n }\n\n function callReady() {\n var callbacks = readyCalls;\n\n if (isPageLoaded) {\n //Call the DOM ready callbacks\n if (callbacks.length) {\n readyCalls = [];\n runCallbacks(callbacks);\n }\n }\n }\n\n /**\n * Sets the page as loaded.\n */\n function pageLoaded() {\n if (!isPageLoaded) {\n isPageLoaded = true;\n if (scrollIntervalId) {\n clearInterval(scrollIntervalId);\n }\n\n callReady();\n }\n }\n\n if (isBrowser) {\n if (document.addEventListener) {\n //Standards. Hooray! Assumption here that if standards based,\n //it knows about DOMContentLoaded.\n document.addEventListener(\"DOMContentLoaded\", pageLoaded, false);\n window.addEventListener(\"load\", pageLoaded, false);\n } else if (window.attachEvent) {\n window.attachEvent(\"onload\", pageLoaded);\n\n testDiv = document.createElement('div');\n try {\n isTop = window.frameElement === null;\n } catch (e) {}\n\n //DOMContentLoaded approximation that uses a doScroll, as found by\n //Diego Perini: http://javascript.nwbox.com/IEContentLoaded/,\n //but modified by other contributors, including jdalton\n if (testDiv.doScroll && isTop && window.external) {\n scrollIntervalId = setInterval(function () {\n try {\n testDiv.doScroll();\n pageLoaded();\n } catch (e) {}\n }, 30);\n }\n }\n\n //Check if document already complete, and if so, just trigger page load\n //listeners. Latest webkit browsers also use \"interactive\", and\n //will fire the onDOMContentLoaded before \"interactive\" but not after\n //entering \"interactive\" or \"complete\". More details:\n //http://dev.w3.org/html5/spec/the-end.html#the-end\n //http://stackoverflow.com/questions/3665561/document-readystate-of-interactive-vs-ondomcontentloaded\n //Hmm, this is more complicated on further use, see \"firing too early\"\n //bug: https://github.com/requirejs/domReady/issues/1\n //so removing the || document.readyState === \"interactive\" test.\n //There is still a window.onload binding that should get fired if\n //DOMContentLoaded is missed.\n if (document.readyState === \"complete\") {\n pageLoaded();\n }\n }\n\n /** START OF PUBLIC API **/\n\n /**\n * Registers a callback for DOM ready. If DOM is already ready, the\n * callback is called immediately.\n * @param {Function} callback\n */\n function domReady(callback) {\n if (isPageLoaded) {\n callback(doc);\n } else {\n readyCalls.push(callback);\n }\n return domReady;\n }\n\n domReady.version = '2.0.1';\n\n /**\n * Loader Plugin API method\n */\n domReady.load = function (name, req, onLoad, config) {\n if (config.isBuild) {\n onLoad(null);\n } else {\n domReady(onLoad);\n }\n };\n\n /** END OF PUBLIC API **/\n\n return domReady;\n});\n\n", - "define('core/pubsubhub',[\"exports\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.pub = pub;\n exports.sub = sub;\n exports.unsub = unsub;\n /**\n * Module core/pubsubhub\n *\n * Returns a singleton that can be used for message broadcasting\n * and message receiving. Replaces legacy \"msg\" code in ReSpec.\n */\n const name = exports.name = \"core/pubsubhub\";\n\n const subscriptions = new Map();\n\n function pub(topic, ...data) {\n if (!subscriptions.has(topic)) {\n return; // Nothing to do...\n }\n Array.from(subscriptions.get(topic)).forEach(cb => cb.apply(undefined, data));\n if (window.parent === window.self) {\n return;\n }\n // If this is an iframe, postMessage parent (used in testing).\n var args = data\n // to structured clonable\n .map(arg => String(JSON.stringify(arg.stack || arg)));\n window.parent.postMessage({ topic, args }, window.parent.location.origin);\n }\n /**\n * Subscribes to a message type.\n *\n * @param {string} topic The topic to subscribe to (e.g., \"start-all\")\n * @param {Function} cb Callback function\n * @param {Boolean} opts.once Add prop \"once\" for single notification.\n * @return {Object} An object that should be considered opaque,\n * used for unsubscribing from messages.\n */\n function sub(topic, cb, opts = { once: false }) {\n if (opts.once) {\n return sub(topic, function wrapper(...args) {\n unsub({ topic, cb: wrapper });\n cb(...args);\n });\n }\n if (subscriptions.has(topic)) {\n subscriptions.get(topic).add(cb);\n } else {\n subscriptions.set(topic, new Set([cb]));\n }\n return { topic, cb };\n }\n /**\n * Unsubscribe from messages.\n *\n * @param {Object} opaque The object that was returned from calling sub()\n */\n function unsub({ topic, cb }) {\n // opaque is whatever is returned by sub()\n const callbacks = subscriptions.get(topic);\n if (!callbacks || !callbacks.has(cb)) {\n console.warn(\"Already unsubscribed:\", topic, cb);\n return false;\n }\n return callbacks.delete(cb);\n }\n\n sub(\"error\", err => {\n console.error(err, err.stack);\n });\n\n sub(\"warn\", str => {\n console.warn(str);\n });\n});\n//# sourceMappingURL=pubsubhub.js.map;\n", - "/**\n * marked - a markdown parser\n * Copyright (c) 2011-2014, Christopher Jeffrey. (MIT Licensed)\n * https://github.com/markedjs/marked\n */\n\n;(function(root) {\n'use strict';\n\n/**\n * Block-Level Grammar\n */\n\nvar block = {\n newline: /^\\n+/,\n code: /^( {4}[^\\n]+\\n*)+/,\n fences: noop,\n hr: /^ {0,3}((?:- *){3,}|(?:_ *){3,}|(?:\\* *){3,})(?:\\n+|$)/,\n heading: /^ *(#{1,6}) *([^\\n]+?) *(?:#+ *)?(?:\\n+|$)/,\n nptable: noop,\n blockquote: /^( {0,3}> ?(paragraph|[^\\n]*)(?:\\n|$))+/,\n list: /^( *)(bull) [\\s\\S]+?(?:hr|def|\\n{2,}(?! )(?!\\1bull )\\n*|\\s*$)/,\n html: '^ {0,3}(?:' // optional indentation\n + '<(script|pre|style)[\\\\s>][\\\\s\\\\S]*?(?:</\\\\1>[^\\\\n]*\\\\n+|$)' // (1)\n + '|comment[^\\\\n]*(\\\\n+|$)' // (2)\n + '|<\\\\?[\\\\s\\\\S]*?\\\\?>\\\\n*' // (3)\n + '|<![A-Z][\\\\s\\\\S]*?>\\\\n*' // (4)\n + '|<!\\\\[CDATA\\\\[[\\\\s\\\\S]*?\\\\]\\\\]>\\\\n*' // (5)\n + '|</?(tag)(?: +|\\\\n|/?>)[\\\\s\\\\S]*?(?:\\\\n{2,}|$)' // (6)\n + '|<(?!script|pre|style)([a-z][\\\\w-]*)(?:attribute)*? */?>(?=\\\\h*\\\\n)[\\\\s\\\\S]*?(?:\\\\n{2,}|$)' // (7) open tag\n + '|</(?!script|pre|style)[a-z][\\\\w-]*\\\\s*>(?=\\\\h*\\\\n)[\\\\s\\\\S]*?(?:\\\\n{2,}|$)' // (7) closing tag\n + ')',\n def: /^ {0,3}\\[(label)\\]: *\\n? *<?([^\\s>]+)>?(?:(?: +\\n? *| *\\n *)(title))? *(?:\\n+|$)/,\n table: noop,\n lheading: /^([^\\n]+)\\n *(=|-){2,} *(?:\\n+|$)/,\n paragraph: /^([^\\n]+(?:\\n(?!hr|heading|lheading| {0,3}>|<\\/?(?:tag)(?: +|\\n|\\/?>)|<(?:script|pre|style|!--))[^\\n]+)*)/,\n text: /^[^\\n]+/\n};\n\nblock._label = /(?!\\s*\\])(?:\\\\[\\[\\]]|[^\\[\\]])+/;\nblock._title = /(?:\"(?:\\\\\"?|[^\"\\\\])*\"|'[^'\\n]*(?:\\n[^'\\n]+)*\\n?'|\\([^()]*\\))/;\nblock.def = edit(block.def)\n .replace('label', block._label)\n .replace('title', block._title)\n .getRegex();\n\nblock.bullet = /(?:[*+-]|\\d+\\.)/;\nblock.item = /^( *)(bull) [^\\n]*(?:\\n(?!\\1bull )[^\\n]*)*/;\nblock.item = edit(block.item, 'gm')\n .replace(/bull/g, block.bullet)\n .getRegex();\n\nblock.list = edit(block.list)\n .replace(/bull/g, block.bullet)\n .replace('hr', '\\\\n+(?=\\\\1?(?:(?:- *){3,}|(?:_ *){3,}|(?:\\\\* *){3,})(?:\\\\n+|$))')\n .replace('def', '\\\\n+(?=' + block.def.source + ')')\n .getRegex();\n\nblock._tag = 'address|article|aside|base|basefont|blockquote|body|caption'\n + '|center|col|colgroup|dd|details|dialog|dir|div|dl|dt|fieldset|figcaption'\n + '|figure|footer|form|frame|frameset|h[1-6]|head|header|hr|html|iframe'\n + '|legend|li|link|main|menu|menuitem|meta|nav|noframes|ol|optgroup|option'\n + '|p|param|section|source|summary|table|tbody|td|tfoot|th|thead|title|tr'\n + '|track|ul';\nblock._comment = /<!--(?!-?>)[\\s\\S]*?-->/;\nblock.html = edit(block.html, 'i')\n .replace('comment', block._comment)\n .replace('tag', block._tag)\n .replace('attribute', / +[a-zA-Z:_][\\w.:-]*(?: *= *\"[^\"\\n]*\"| *= *'[^'\\n]*'| *= *[^\\s\"'=<>`]+)?/)\n .getRegex();\n\nblock.paragraph = edit(block.paragraph)\n .replace('hr', block.hr)\n .replace('heading', block.heading)\n .replace('lheading', block.lheading)\n .replace('tag', block._tag) // pars can be interrupted by type (6) html blocks\n .getRegex();\n\nblock.blockquote = edit(block.blockquote)\n .replace('paragraph', block.paragraph)\n .getRegex();\n\n/**\n * Normal Block Grammar\n */\n\nblock.normal = merge({}, block);\n\n/**\n * GFM Block Grammar\n */\n\nblock.gfm = merge({}, block.normal, {\n fences: /^ *(`{3,}|~{3,})[ \\.]*(\\S+)? *\\n([\\s\\S]*?)\\n? *\\1 *(?:\\n+|$)/,\n paragraph: /^/,\n heading: /^ *(#{1,6}) +([^\\n]+?) *#* *(?:\\n+|$)/\n});\n\nblock.gfm.paragraph = edit(block.paragraph)\n .replace('(?!', '(?!'\n + block.gfm.fences.source.replace('\\\\1', '\\\\2') + '|'\n + block.list.source.replace('\\\\1', '\\\\3') + '|')\n .getRegex();\n\n/**\n * GFM + Tables Block Grammar\n */\n\nblock.tables = merge({}, block.gfm, {\n nptable: /^ *([^|\\n ].*\\|.*)\\n *([-:]+ *\\|[-| :]*)(?:\\n((?:.*[^>\\n ].*(?:\\n|$))*)\\n*|$)/,\n table: /^ *\\|(.+)\\n *\\|?( *[-:]+[-| :]*)(?:\\n((?: *[^>\\n ].*(?:\\n|$))*)\\n*|$)/\n});\n\n/**\n * Pedantic grammar\n */\n\nblock.pedantic = merge({}, block.normal, {\n html: edit(\n '^ *(?:comment *(?:\\\\n|\\\\s*$)'\n + '|<(tag)[\\\\s\\\\S]+?</\\\\1> *(?:\\\\n{2,}|\\\\s*$)' // closed tag\n + '|<tag(?:\"[^\"]*\"|\\'[^\\']*\\'|\\\\s[^\\'\"/>\\\\s]*)*?/?> *(?:\\\\n{2,}|\\\\s*$))')\n .replace('comment', block._comment)\n .replace(/tag/g, '(?!(?:'\n + 'a|em|strong|small|s|cite|q|dfn|abbr|data|time|code|var|samp|kbd|sub'\n + '|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo|span|br|wbr|ins|del|img)'\n + '\\\\b)\\\\w+(?!:|[^\\\\w\\\\s@]*@)\\\\b')\n .getRegex(),\n def: /^ *\\[([^\\]]+)\\]: *<?([^\\s>]+)>?(?: +([\"(][^\\n]+[\")]))? *(?:\\n+|$)/\n});\n\n/**\n * Block Lexer\n */\n\nfunction Lexer(options) {\n this.tokens = [];\n this.tokens.links = {};\n this.options = options || marked.defaults;\n this.rules = block.normal;\n\n if (this.options.pedantic) {\n this.rules = block.pedantic;\n } else if (this.options.gfm) {\n if (this.options.tables) {\n this.rules = block.tables;\n } else {\n this.rules = block.gfm;\n }\n }\n}\n\n/**\n * Expose Block Rules\n */\n\nLexer.rules = block;\n\n/**\n * Static Lex Method\n */\n\nLexer.lex = function(src, options) {\n var lexer = new Lexer(options);\n return lexer.lex(src);\n};\n\n/**\n * Preprocessing\n */\n\nLexer.prototype.lex = function(src) {\n src = src\n .replace(/\\r\\n|\\r/g, '\\n')\n .replace(/\\t/g, ' ')\n .replace(/\\u00a0/g, ' ')\n .replace(/\\u2424/g, '\\n');\n\n return this.token(src, true);\n};\n\n/**\n * Lexing\n */\n\nLexer.prototype.token = function(src, top) {\n src = src.replace(/^ +$/gm, '');\n var next,\n loose,\n cap,\n bull,\n b,\n item,\n space,\n i,\n tag,\n l,\n isordered,\n istask,\n ischecked;\n\n while (src) {\n // newline\n if (cap = this.rules.newline.exec(src)) {\n src = src.substring(cap[0].length);\n if (cap[0].length > 1) {\n this.tokens.push({\n type: 'space'\n });\n }\n }\n\n // code\n if (cap = this.rules.code.exec(src)) {\n src = src.substring(cap[0].length);\n cap = cap[0].replace(/^ {4}/gm, '');\n this.tokens.push({\n type: 'code',\n text: !this.options.pedantic\n ? cap.replace(/\\n+$/, '')\n : cap\n });\n continue;\n }\n\n // fences (gfm)\n if (cap = this.rules.fences.exec(src)) {\n src = src.substring(cap[0].length);\n this.tokens.push({\n type: 'code',\n lang: cap[2],\n text: cap[3] || ''\n });\n continue;\n }\n\n // heading\n if (cap = this.rules.heading.exec(src)) {\n src = src.substring(cap[0].length);\n this.tokens.push({\n type: 'heading',\n depth: cap[1].length,\n text: cap[2]\n });\n continue;\n }\n\n // table no leading pipe (gfm)\n if (top && (cap = this.rules.nptable.exec(src))) {\n item = {\n type: 'table',\n header: splitCells(cap[1].replace(/^ *| *\\| *$/g, '')),\n align: cap[2].replace(/^ *|\\| *$/g, '').split(/ *\\| */),\n cells: cap[3] ? cap[3].replace(/\\n$/, '').split('\\n') : []\n };\n\n if (item.header.length === item.align.length) {\n src = src.substring(cap[0].length);\n\n for (i = 0; i < item.align.length; i++) {\n if (/^ *-+: *$/.test(item.align[i])) {\n item.align[i] = 'right';\n } else if (/^ *:-+: *$/.test(item.align[i])) {\n item.align[i] = 'center';\n } else if (/^ *:-+ *$/.test(item.align[i])) {\n item.align[i] = 'left';\n } else {\n item.align[i] = null;\n }\n }\n\n for (i = 0; i < item.cells.length; i++) {\n item.cells[i] = splitCells(item.cells[i], item.header.length);\n }\n\n this.tokens.push(item);\n\n continue;\n }\n }\n\n // hr\n if (cap = this.rules.hr.exec(src)) {\n src = src.substring(cap[0].length);\n this.tokens.push({\n type: 'hr'\n });\n continue;\n }\n\n // blockquote\n if (cap = this.rules.blockquote.exec(src)) {\n src = src.substring(cap[0].length);\n\n this.tokens.push({\n type: 'blockquote_start'\n });\n\n cap = cap[0].replace(/^ *> ?/gm, '');\n\n // Pass `top` to keep the current\n // \"toplevel\" state. This is exactly\n // how markdown.pl works.\n this.token(cap, top);\n\n this.tokens.push({\n type: 'blockquote_end'\n });\n\n continue;\n }\n\n // list\n if (cap = this.rules.list.exec(src)) {\n src = src.substring(cap[0].length);\n bull = cap[2];\n isordered = bull.length > 1;\n\n this.tokens.push({\n type: 'list_start',\n ordered: isordered,\n start: isordered ? +bull : ''\n });\n\n // Get each top-level item.\n cap = cap[0].match(this.rules.item);\n\n next = false;\n l = cap.length;\n i = 0;\n\n for (; i < l; i++) {\n item = cap[i];\n\n // Remove the list item's bullet\n // so it is seen as the next token.\n space = item.length;\n item = item.replace(/^ *([*+-]|\\d+\\.) +/, '');\n\n // Outdent whatever the\n // list item contains. Hacky.\n if (~item.indexOf('\\n ')) {\n space -= item.length;\n item = !this.options.pedantic\n ? item.replace(new RegExp('^ {1,' + space + '}', 'gm'), '')\n : item.replace(/^ {1,4}/gm, '');\n }\n\n // Determine whether the next list item belongs here.\n // Backpedal if it does not belong in this list.\n if (this.options.smartLists && i !== l - 1) {\n b = block.bullet.exec(cap[i + 1])[0];\n if (bull !== b && !(bull.length > 1 && b.length > 1)) {\n src = cap.slice(i + 1).join('\\n') + src;\n i = l - 1;\n }\n }\n\n // Determine whether item is loose or not.\n // Use: /(^|\\n)(?! )[^\\n]+\\n\\n(?!\\s*$)/\n // for discount behavior.\n loose = next || /\\n\\n(?!\\s*$)/.test(item);\n if (i !== l - 1) {\n next = item.charAt(item.length - 1) === '\\n';\n if (!loose) loose = next;\n }\n\n // Check for task list items\n istask = /^\\[[ xX]\\] /.test(item);\n ischecked = undefined;\n if (istask) {\n ischecked = item[1] !== ' ';\n item = item.replace(/^\\[[ xX]\\] +/, '');\n }\n\n this.tokens.push({\n type: loose\n ? 'loose_item_start'\n : 'list_item_start',\n task: istask,\n checked: ischecked\n });\n\n // Recurse.\n this.token(item, false);\n\n this.tokens.push({\n type: 'list_item_end'\n });\n }\n\n this.tokens.push({\n type: 'list_end'\n });\n\n continue;\n }\n\n // html\n if (cap = this.rules.html.exec(src)) {\n src = src.substring(cap[0].length);\n this.tokens.push({\n type: this.options.sanitize\n ? 'paragraph'\n : 'html',\n pre: !this.options.sanitizer\n && (cap[1] === 'pre' || cap[1] === 'script' || cap[1] === 'style'),\n text: cap[0]\n });\n continue;\n }\n\n // def\n if (top && (cap = this.rules.def.exec(src))) {\n src = src.substring(cap[0].length);\n if (cap[3]) cap[3] = cap[3].substring(1, cap[3].length - 1);\n tag = cap[1].toLowerCase().replace(/\\s+/g, ' ');\n if (!this.tokens.links[tag]) {\n this.tokens.links[tag] = {\n href: cap[2],\n title: cap[3]\n };\n }\n continue;\n }\n\n // table (gfm)\n if (top && (cap = this.rules.table.exec(src))) {\n item = {\n type: 'table',\n header: splitCells(cap[1].replace(/^ *| *\\| *$/g, '')),\n align: cap[2].replace(/^ *|\\| *$/g, '').split(/ *\\| */),\n cells: cap[3] ? cap[3].replace(/(?: *\\| *)?\\n$/, '').split('\\n') : []\n };\n\n if (item.header.length === item.align.length) {\n src = src.substring(cap[0].length);\n\n for (i = 0; i < item.align.length; i++) {\n if (/^ *-+: *$/.test(item.align[i])) {\n item.align[i] = 'right';\n } else if (/^ *:-+: *$/.test(item.align[i])) {\n item.align[i] = 'center';\n } else if (/^ *:-+ *$/.test(item.align[i])) {\n item.align[i] = 'left';\n } else {\n item.align[i] = null;\n }\n }\n\n for (i = 0; i < item.cells.length; i++) {\n item.cells[i] = splitCells(\n item.cells[i].replace(/^ *\\| *| *\\| *$/g, ''),\n item.header.length);\n }\n\n this.tokens.push(item);\n\n continue;\n }\n }\n\n // lheading\n if (cap = this.rules.lheading.exec(src)) {\n src = src.substring(cap[0].length);\n this.tokens.push({\n type: 'heading',\n depth: cap[2] === '=' ? 1 : 2,\n text: cap[1]\n });\n continue;\n }\n\n // top-level paragraph\n if (top && (cap = this.rules.paragraph.exec(src))) {\n src = src.substring(cap[0].length);\n this.tokens.push({\n type: 'paragraph',\n text: cap[1].charAt(cap[1].length - 1) === '\\n'\n ? cap[1].slice(0, -1)\n : cap[1]\n });\n continue;\n }\n\n // text\n if (cap = this.rules.text.exec(src)) {\n // Top-level should never reach here.\n src = src.substring(cap[0].length);\n this.tokens.push({\n type: 'text',\n text: cap[0]\n });\n continue;\n }\n\n if (src) {\n throw new Error('Infinite loop on byte: ' + src.charCodeAt(0));\n }\n }\n\n return this.tokens;\n};\n\n/**\n * Inline-Level Grammar\n */\n\nvar inline = {\n escape: /^\\\\([!\"#$%&'()*+,\\-./:;<=>?@\\[\\]\\\\^_`{|}~])/,\n autolink: /^<(scheme:[^\\s\\x00-\\x1f<>]*|email)>/,\n url: noop,\n tag: '^comment'\n + '|^</[a-zA-Z][\\\\w:-]*\\\\s*>' // self-closing tag\n + '|^<[a-zA-Z][\\\\w-]*(?:attribute)*?\\\\s*/?>' // open tag\n + '|^<\\\\?[\\\\s\\\\S]*?\\\\?>' // processing instruction, e.g. <?php ?>\n + '|^<![a-zA-Z]+\\\\s[\\\\s\\\\S]*?>' // declaration, e.g. <!DOCTYPE html>\n + '|^<!\\\\[CDATA\\\\[[\\\\s\\\\S]*?\\\\]\\\\]>', // CDATA section\n link: /^!?\\[(label)\\]\\(href(?:\\s+(title))?\\s*\\)/,\n reflink: /^!?\\[(label)\\]\\[(?!\\s*\\])((?:\\\\[\\[\\]]?|[^\\[\\]\\\\])+)\\]/,\n nolink: /^!?\\[(?!\\s*\\])((?:\\[[^\\[\\]]*\\]|\\\\[\\[\\]]|[^\\[\\]])*)\\](?:\\[\\])?/,\n strong: /^__([^\\s][\\s\\S]*?[^\\s])__(?!_)|^\\*\\*([^\\s][\\s\\S]*?[^\\s])\\*\\*(?!\\*)|^__([^\\s])__(?!_)|^\\*\\*([^\\s])\\*\\*(?!\\*)/,\n em: /^_([^\\s][\\s\\S]*?[^\\s_])_(?!_)|^_([^\\s_][\\s\\S]*?[^\\s])_(?!_)|^\\*([^\\s][\\s\\S]*?[^\\s*])\\*(?!\\*)|^\\*([^\\s*][\\s\\S]*?[^\\s])\\*(?!\\*)|^_([^\\s_])_(?!_)|^\\*([^\\s*])\\*(?!\\*)/,\n code: /^(`+)\\s*([\\s\\S]*?[^`]?)\\s*\\1(?!`)/,\n br: /^ {2,}\\n(?!\\s*$)/,\n del: noop,\n text: /^[\\s\\S]+?(?=[\\\\<!\\[`*]|\\b_| {2,}\\n|$)/\n};\n\ninline._escapes = /\\\\([!\"#$%&'()*+,\\-./:;<=>?@\\[\\]\\\\^_`{|}~])/g;\n\ninline._scheme = /[a-zA-Z][a-zA-Z0-9+.-]{1,31}/;\ninline._email = /[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+(@)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+(?![-_])/;\ninline.autolink = edit(inline.autolink)\n .replace('scheme', inline._scheme)\n .replace('email', inline._email)\n .getRegex();\n\ninline._attribute = /\\s+[a-zA-Z:_][\\w.:-]*(?:\\s*=\\s*\"[^\"]*\"|\\s*=\\s*'[^']*'|\\s*=\\s*[^\\s\"'=<>`]+)?/;\n\ninline.tag = edit(inline.tag)\n .replace('comment', block._comment)\n .replace('attribute', inline._attribute)\n .getRegex();\n\ninline._label = /(?:\\[[^\\[\\]]*\\]|\\\\[\\[\\]]?|`[^`]*`|[^\\[\\]\\\\])*?/;\ninline._href = /\\s*(<(?:\\\\[<>]?|[^\\s<>\\\\])*>|(?:\\\\[()]?|\\([^\\s\\x00-\\x1f()\\\\]*\\)|[^\\s\\x00-\\x1f()\\\\])*?)/;\ninline._title = /\"(?:\\\\\"?|[^\"\\\\])*\"|'(?:\\\\'?|[^'\\\\])*'|\\((?:\\\\\\)?|[^)\\\\])*\\)/;\n\ninline.link = edit(inline.link)\n .replace('label', inline._label)\n .replace('href', inline._href)\n .replace('title', inline._title)\n .getRegex();\n\ninline.reflink = edit(inline.reflink)\n .replace('label', inline._label)\n .getRegex();\n\n/**\n * Normal Inline Grammar\n */\n\ninline.normal = merge({}, inline);\n\n/**\n * Pedantic Inline Grammar\n */\n\ninline.pedantic = merge({}, inline.normal, {\n strong: /^__(?=\\S)([\\s\\S]*?\\S)__(?!_)|^\\*\\*(?=\\S)([\\s\\S]*?\\S)\\*\\*(?!\\*)/,\n em: /^_(?=\\S)([\\s\\S]*?\\S)_(?!_)|^\\*(?=\\S)([\\s\\S]*?\\S)\\*(?!\\*)/,\n link: edit(/^!?\\[(label)\\]\\((.*?)\\)/)\n .replace('label', inline._label)\n .getRegex(),\n reflink: edit(/^!?\\[(label)\\]\\s*\\[([^\\]]*)\\]/)\n .replace('label', inline._label)\n .getRegex()\n});\n\n/**\n * GFM Inline Grammar\n */\n\ninline.gfm = merge({}, inline.normal, {\n escape: edit(inline.escape).replace('])', '~|])').getRegex(),\n url: edit(/^((?:ftp|https?):\\/\\/|www\\.)(?:[a-zA-Z0-9\\-]+\\.?)+[^\\s<]*|^email/)\n .replace('email', inline._email)\n .getRegex(),\n _backpedal: /(?:[^?!.,:;*_~()&]+|\\([^)]*\\)|&(?![a-zA-Z0-9]+;$)|[?!.,:;*_~)]+(?!$))+/,\n del: /^~~(?=\\S)([\\s\\S]*?\\S)~~/,\n text: edit(inline.text)\n .replace(']|', '~]|')\n .replace('|', '|https?://|ftp://|www\\\\.|[a-zA-Z0-9.!#$%&\\'*+/=?^_`{\\\\|}~-]+@|')\n .getRegex()\n});\n\n/**\n * GFM + Line Breaks Inline Grammar\n */\n\ninline.breaks = merge({}, inline.gfm, {\n br: edit(inline.br).replace('{2,}', '*').getRegex(),\n text: edit(inline.gfm.text).replace('{2,}', '*').getRegex()\n});\n\n/**\n * Inline Lexer & Compiler\n */\n\nfunction InlineLexer(links, options) {\n this.options = options || marked.defaults;\n this.links = links;\n this.rules = inline.normal;\n this.renderer = this.options.renderer || new Renderer();\n this.renderer.options = this.options;\n\n if (!this.links) {\n throw new Error('Tokens array requires a `links` property.');\n }\n\n if (this.options.pedantic) {\n this.rules = inline.pedantic;\n } else if (this.options.gfm) {\n if (this.options.breaks) {\n this.rules = inline.breaks;\n } else {\n this.rules = inline.gfm;\n }\n }\n}\n\n/**\n * Expose Inline Rules\n */\n\nInlineLexer.rules = inline;\n\n/**\n * Static Lexing/Compiling Method\n */\n\nInlineLexer.output = function(src, links, options) {\n var inline = new InlineLexer(links, options);\n return inline.output(src);\n};\n\n/**\n * Lexing/Compiling\n */\n\nInlineLexer.prototype.output = function(src) {\n var out = '',\n link,\n text,\n href,\n title,\n cap;\n\n while (src) {\n // escape\n if (cap = this.rules.escape.exec(src)) {\n src = src.substring(cap[0].length);\n out += cap[1];\n continue;\n }\n\n // autolink\n if (cap = this.rules.autolink.exec(src)) {\n src = src.substring(cap[0].length);\n if (cap[2] === '@') {\n text = escape(this.mangle(cap[1]));\n href = 'mailto:' + text;\n } else {\n text = escape(cap[1]);\n href = text;\n }\n out += this.renderer.link(href, null, text);\n continue;\n }\n\n // url (gfm)\n if (!this.inLink && (cap = this.rules.url.exec(src))) {\n cap[0] = this.rules._backpedal.exec(cap[0])[0];\n src = src.substring(cap[0].length);\n if (cap[2] === '@') {\n text = escape(cap[0]);\n href = 'mailto:' + text;\n } else {\n text = escape(cap[0]);\n if (cap[1] === 'www.') {\n href = 'http://' + text;\n } else {\n href = text;\n }\n }\n out += this.renderer.link(href, null, text);\n continue;\n }\n\n // tag\n if (cap = this.rules.tag.exec(src)) {\n if (!this.inLink && /^<a /i.test(cap[0])) {\n this.inLink = true;\n } else if (this.inLink && /^<\\/a>/i.test(cap[0])) {\n this.inLink = false;\n }\n src = src.substring(cap[0].length);\n out += this.options.sanitize\n ? this.options.sanitizer\n ? this.options.sanitizer(cap[0])\n : escape(cap[0])\n : cap[0]\n continue;\n }\n\n // link\n if (cap = this.rules.link.exec(src)) {\n src = src.substring(cap[0].length);\n this.inLink = true;\n href = cap[2];\n if (this.options.pedantic) {\n link = /^([^'\"]*[^\\s])\\s+(['\"])(.*)\\2/.exec(href);\n\n if (link) {\n href = link[1];\n title = link[3];\n } else {\n title = '';\n }\n } else {\n title = cap[3] ? cap[3].slice(1, -1) : '';\n }\n href = href.trim().replace(/^<([\\s\\S]*)>$/, '$1');\n out += this.outputLink(cap, {\n href: InlineLexer.escapes(href),\n title: InlineLexer.escapes(title)\n });\n this.inLink = false;\n continue;\n }\n\n // reflink, nolink\n if ((cap = this.rules.reflink.exec(src))\n || (cap = this.rules.nolink.exec(src))) {\n src = src.substring(cap[0].length);\n link = (cap[2] || cap[1]).replace(/\\s+/g, ' ');\n link = this.links[link.toLowerCase()];\n if (!link || !link.href) {\n out += cap[0].charAt(0);\n src = cap[0].substring(1) + src;\n continue;\n }\n this.inLink = true;\n out += this.outputLink(cap, link);\n this.inLink = false;\n continue;\n }\n\n // strong\n if (cap = this.rules.strong.exec(src)) {\n src = src.substring(cap[0].length);\n out += this.renderer.strong(this.output(cap[4] || cap[3] || cap[2] || cap[1]));\n continue;\n }\n\n // em\n if (cap = this.rules.em.exec(src)) {\n src = src.substring(cap[0].length);\n out += this.renderer.em(this.output(cap[6] || cap[5] || cap[4] || cap[3] || cap[2] || cap[1]));\n continue;\n }\n\n // code\n if (cap = this.rules.code.exec(src)) {\n src = src.substring(cap[0].length);\n out += this.renderer.codespan(escape(cap[2].trim(), true));\n continue;\n }\n\n // br\n if (cap = this.rules.br.exec(src)) {\n src = src.substring(cap[0].length);\n out += this.renderer.br();\n continue;\n }\n\n // del (gfm)\n if (cap = this.rules.del.exec(src)) {\n src = src.substring(cap[0].length);\n out += this.renderer.del(this.output(cap[1]));\n continue;\n }\n\n // text\n if (cap = this.rules.text.exec(src)) {\n src = src.substring(cap[0].length);\n out += this.renderer.text(escape(this.smartypants(cap[0])));\n continue;\n }\n\n if (src) {\n throw new Error('Infinite loop on byte: ' + src.charCodeAt(0));\n }\n }\n\n return out;\n};\n\nInlineLexer.escapes = function(text) {\n return text ? text.replace(InlineLexer.rules._escapes, '$1') : text;\n}\n\n/**\n * Compile Link\n */\n\nInlineLexer.prototype.outputLink = function(cap, link) {\n var href = link.href,\n title = link.title ? escape(link.title) : null;\n\n return cap[0].charAt(0) !== '!'\n ? this.renderer.link(href, title, this.output(cap[1]))\n : this.renderer.image(href, title, escape(cap[1]));\n};\n\n/**\n * Smartypants Transformations\n */\n\nInlineLexer.prototype.smartypants = function(text) {\n if (!this.options.smartypants) return text;\n return text\n // em-dashes\n .replace(/---/g, '\\u2014')\n // en-dashes\n .replace(/--/g, '\\u2013')\n // opening singles\n .replace(/(^|[-\\u2014/(\\[{\"\\s])'/g, '$1\\u2018')\n // closing singles & apostrophes\n .replace(/'/g, '\\u2019')\n // opening doubles\n .replace(/(^|[-\\u2014/(\\[{\\u2018\\s])\"/g, '$1\\u201c')\n // closing doubles\n .replace(/\"/g, '\\u201d')\n // ellipses\n .replace(/\\.{3}/g, '\\u2026');\n};\n\n/**\n * Mangle Links\n */\n\nInlineLexer.prototype.mangle = function(text) {\n if (!this.options.mangle) return text;\n var out = '',\n l = text.length,\n i = 0,\n ch;\n\n for (; i < l; i++) {\n ch = text.charCodeAt(i);\n if (Math.random() > 0.5) {\n ch = 'x' + ch.toString(16);\n }\n out += '&#' + ch + ';';\n }\n\n return out;\n};\n\n/**\n * Renderer\n */\n\nfunction Renderer(options) {\n this.options = options || marked.defaults;\n}\n\nRenderer.prototype.code = function(code, lang, escaped) {\n if (this.options.highlight) {\n var out = this.options.highlight(code, lang);\n if (out != null && out !== code) {\n escaped = true;\n code = out;\n }\n }\n\n if (!lang) {\n return '<pre><code>'\n + (escaped ? code : escape(code, true))\n + '</code></pre>';\n }\n\n return '<pre><code class=\"'\n + this.options.langPrefix\n + escape(lang, true)\n + '\">'\n + (escaped ? code : escape(code, true))\n + '</code></pre>\\n';\n};\n\nRenderer.prototype.blockquote = function(quote) {\n return '<blockquote>\\n' + quote + '</blockquote>\\n';\n};\n\nRenderer.prototype.html = function(html) {\n return html;\n};\n\nRenderer.prototype.heading = function(text, level, raw) {\n if (this.options.headerIds) {\n return '<h'\n + level\n + ' id=\"'\n + this.options.headerPrefix\n + raw.toLowerCase().replace(/[^\\w]+/g, '-')\n + '\">'\n + text\n + '</h'\n + level\n + '>\\n';\n }\n // ignore IDs\n return '<h' + level + '>' + text + '</h' + level + '>\\n';\n};\n\nRenderer.prototype.hr = function() {\n return this.options.xhtml ? '<hr/>\\n' : '<hr>\\n';\n};\n\nRenderer.prototype.list = function(body, ordered, start) {\n var type = ordered ? 'ol' : 'ul',\n startatt = (ordered && start !== 1) ? (' start=\"' + start + '\"') : '';\n return '<' + type + startatt + '>\\n' + body + '</' + type + '>\\n';\n};\n\nRenderer.prototype.listitem = function(text) {\n return '<li>' + text + '</li>\\n';\n};\n\nRenderer.prototype.checkbox = function(checked) {\n return '<input '\n + (checked ? 'checked=\"\" ' : '')\n + 'disabled=\"\" type=\"checkbox\"'\n + (this.options.xhtml ? ' /' : '')\n + '> ';\n}\n\nRenderer.prototype.paragraph = function(text) {\n return '<p>' + text + '</p>\\n';\n};\n\nRenderer.prototype.table = function(header, body) {\n if (body) body = '<tbody>' + body + '</tbody>';\n\n return '<table>\\n'\n + '<thead>\\n'\n + header\n + '</thead>\\n'\n + body\n + '</table>\\n';\n};\n\nRenderer.prototype.tablerow = function(content) {\n return '<tr>\\n' + content + '</tr>\\n';\n};\n\nRenderer.prototype.tablecell = function(content, flags) {\n var type = flags.header ? 'th' : 'td';\n var tag = flags.align\n ? '<' + type + ' align=\"' + flags.align + '\">'\n : '<' + type + '>';\n return tag + content + '</' + type + '>\\n';\n};\n\n// span level renderer\nRenderer.prototype.strong = function(text) {\n return '<strong>' + text + '</strong>';\n};\n\nRenderer.prototype.em = function(text) {\n return '<em>' + text + '</em>';\n};\n\nRenderer.prototype.codespan = function(text) {\n return '<code>' + text + '</code>';\n};\n\nRenderer.prototype.br = function() {\n return this.options.xhtml ? '<br/>' : '<br>';\n};\n\nRenderer.prototype.del = function(text) {\n return '<del>' + text + '</del>';\n};\n\nRenderer.prototype.link = function(href, title, text) {\n if (this.options.sanitize) {\n try {\n var prot = decodeURIComponent(unescape(href))\n .replace(/[^\\w:]/g, '')\n .toLowerCase();\n } catch (e) {\n return text;\n }\n if (prot.indexOf('javascript:') === 0 || prot.indexOf('vbscript:') === 0 || prot.indexOf('data:') === 0) {\n return text;\n }\n }\n if (this.options.baseUrl && !originIndependentUrl.test(href)) {\n href = resolveUrl(this.options.baseUrl, href);\n }\n try {\n href = encodeURI(href).replace(/%25/g, '%');\n } catch (e) {\n return text;\n }\n var out = '<a href=\"' + escape(href) + '\"';\n if (title) {\n out += ' title=\"' + title + '\"';\n }\n out += '>' + text + '</a>';\n return out;\n};\n\nRenderer.prototype.image = function(href, title, text) {\n if (this.options.baseUrl && !originIndependentUrl.test(href)) {\n href = resolveUrl(this.options.baseUrl, href);\n }\n var out = '<img src=\"' + href + '\" alt=\"' + text + '\"';\n if (title) {\n out += ' title=\"' + title + '\"';\n }\n out += this.options.xhtml ? '/>' : '>';\n return out;\n};\n\nRenderer.prototype.text = function(text) {\n return text;\n};\n\n/**\n * TextRenderer\n * returns only the textual part of the token\n */\n\nfunction TextRenderer() {}\n\n// no need for block level renderers\n\nTextRenderer.prototype.strong =\nTextRenderer.prototype.em =\nTextRenderer.prototype.codespan =\nTextRenderer.prototype.del =\nTextRenderer.prototype.text = function (text) {\n return text;\n}\n\nTextRenderer.prototype.link =\nTextRenderer.prototype.image = function(href, title, text) {\n return '' + text;\n}\n\nTextRenderer.prototype.br = function() {\n return '';\n}\n\n/**\n * Parsing & Compiling\n */\n\nfunction Parser(options) {\n this.tokens = [];\n this.token = null;\n this.options = options || marked.defaults;\n this.options.renderer = this.options.renderer || new Renderer();\n this.renderer = this.options.renderer;\n this.renderer.options = this.options;\n}\n\n/**\n * Static Parse Method\n */\n\nParser.parse = function(src, options) {\n var parser = new Parser(options);\n return parser.parse(src);\n};\n\n/**\n * Parse Loop\n */\n\nParser.prototype.parse = function(src) {\n this.inline = new InlineLexer(src.links, this.options);\n // use an InlineLexer with a TextRenderer to extract pure text\n this.inlineText = new InlineLexer(\n src.links,\n merge({}, this.options, {renderer: new TextRenderer()})\n );\n this.tokens = src.reverse();\n\n var out = '';\n while (this.next()) {\n out += this.tok();\n }\n\n return out;\n};\n\n/**\n * Next Token\n */\n\nParser.prototype.next = function() {\n return this.token = this.tokens.pop();\n};\n\n/**\n * Preview Next Token\n */\n\nParser.prototype.peek = function() {\n return this.tokens[this.tokens.length - 1] || 0;\n};\n\n/**\n * Parse Text Tokens\n */\n\nParser.prototype.parseText = function() {\n var body = this.token.text;\n\n while (this.peek().type === 'text') {\n body += '\\n' + this.next().text;\n }\n\n return this.inline.output(body);\n};\n\n/**\n * Parse Current Token\n */\n\nParser.prototype.tok = function() {\n switch (this.token.type) {\n case 'space': {\n return '';\n }\n case 'hr': {\n return this.renderer.hr();\n }\n case 'heading': {\n return this.renderer.heading(\n this.inline.output(this.token.text),\n this.token.depth,\n unescape(this.inlineText.output(this.token.text)));\n }\n case 'code': {\n return this.renderer.code(this.token.text,\n this.token.lang,\n this.token.escaped);\n }\n case 'table': {\n var header = '',\n body = '',\n i,\n row,\n cell,\n j;\n\n // header\n cell = '';\n for (i = 0; i < this.token.header.length; i++) {\n cell += this.renderer.tablecell(\n this.inline.output(this.token.header[i]),\n { header: true, align: this.token.align[i] }\n );\n }\n header += this.renderer.tablerow(cell);\n\n for (i = 0; i < this.token.cells.length; i++) {\n row = this.token.cells[i];\n\n cell = '';\n for (j = 0; j < row.length; j++) {\n cell += this.renderer.tablecell(\n this.inline.output(row[j]),\n { header: false, align: this.token.align[j] }\n );\n }\n\n body += this.renderer.tablerow(cell);\n }\n return this.renderer.table(header, body);\n }\n case 'blockquote_start': {\n body = '';\n\n while (this.next().type !== 'blockquote_end') {\n body += this.tok();\n }\n\n return this.renderer.blockquote(body);\n }\n case 'list_start': {\n body = '';\n var ordered = this.token.ordered,\n start = this.token.start;\n\n while (this.next().type !== 'list_end') {\n body += this.tok();\n }\n\n return this.renderer.list(body, ordered, start);\n }\n case 'list_item_start': {\n body = '';\n\n if (this.token.task) {\n body += this.renderer.checkbox(this.token.checked);\n }\n\n while (this.next().type !== 'list_item_end') {\n body += this.token.type === 'text'\n ? this.parseText()\n : this.tok();\n }\n\n return this.renderer.listitem(body);\n }\n case 'loose_item_start': {\n body = '';\n\n while (this.next().type !== 'list_item_end') {\n body += this.tok();\n }\n\n return this.renderer.listitem(body);\n }\n case 'html': {\n // TODO parse inline content if parameter markdown=1\n return this.renderer.html(this.token.text);\n }\n case 'paragraph': {\n return this.renderer.paragraph(this.inline.output(this.token.text));\n }\n case 'text': {\n return this.renderer.paragraph(this.parseText());\n }\n }\n};\n\n/**\n * Helpers\n */\n\nfunction escape(html, encode) {\n return html\n .replace(!encode ? /&(?!#?\\w+;)/g : /&/g, '&')\n .replace(/</g, '<')\n .replace(/>/g, '>')\n .replace(/\"/g, '"')\n .replace(/'/g, ''');\n}\n\nfunction unescape(html) {\n // explicitly match decimal, hex, and named HTML entities\n return html.replace(/&(#(?:\\d+)|(?:#x[0-9A-Fa-f]+)|(?:\\w+));?/ig, function(_, n) {\n n = n.toLowerCase();\n if (n === 'colon') return ':';\n if (n.charAt(0) === '#') {\n return n.charAt(1) === 'x'\n ? String.fromCharCode(parseInt(n.substring(2), 16))\n : String.fromCharCode(+n.substring(1));\n }\n return '';\n });\n}\n\nfunction edit(regex, opt) {\n regex = regex.source || regex;\n opt = opt || '';\n return {\n replace: function(name, val) {\n val = val.source || val;\n val = val.replace(/(^|[^\\[])\\^/g, '$1');\n regex = regex.replace(name, val);\n return this;\n },\n getRegex: function() {\n return new RegExp(regex, opt);\n }\n };\n}\n\nfunction resolveUrl(base, href) {\n if (!baseUrls[' ' + base]) {\n // we can ignore everything in base after the last slash of its path component,\n // but we might need to add _that_\n // https://tools.ietf.org/html/rfc3986#section-3\n if (/^[^:]+:\\/*[^/]*$/.test(base)) {\n baseUrls[' ' + base] = base + '/';\n } else {\n baseUrls[' ' + base] = base.replace(/[^/]*$/, '');\n }\n }\n base = baseUrls[' ' + base];\n\n if (href.slice(0, 2) === '//') {\n return base.replace(/:[\\s\\S]*/, ':') + href;\n } else if (href.charAt(0) === '/') {\n return base.replace(/(:\\/*[^/]*)[\\s\\S]*/, '$1') + href;\n } else {\n return base + href;\n }\n}\nvar baseUrls = {};\nvar originIndependentUrl = /^$|^[a-z][a-z0-9+.-]*:|^[?#]/i;\n\nfunction noop() {}\nnoop.exec = noop;\n\nfunction merge(obj) {\n var i = 1,\n target,\n key;\n\n for (; i < arguments.length; i++) {\n target = arguments[i];\n for (key in target) {\n if (Object.prototype.hasOwnProperty.call(target, key)) {\n obj[key] = target[key];\n }\n }\n }\n\n return obj;\n}\n\nfunction splitCells(tableRow, count) {\n var cells = tableRow.replace(/([^\\\\])\\|/g, '$1 |').split(/ +\\| */),\n i = 0;\n\n if (cells.length > count) {\n cells.splice(count);\n } else {\n while (cells.length < count) cells.push('');\n }\n\n for (; i < cells.length; i++) {\n cells[i] = cells[i].replace(/\\\\\\|/g, '|');\n }\n return cells;\n}\n\n/**\n * Marked\n */\n\nfunction marked(src, opt, callback) {\n // throw error in case of non string input\n if (typeof src === 'undefined' || src === null) {\n throw new Error('marked(): input parameter is undefined or null');\n }\n if (typeof src !== 'string') {\n throw new Error('marked(): input parameter is of type '\n + Object.prototype.toString.call(src) + ', string expected');\n }\n\n if (callback || typeof opt === 'function') {\n if (!callback) {\n callback = opt;\n opt = null;\n }\n\n opt = merge({}, marked.defaults, opt || {});\n\n var highlight = opt.highlight,\n tokens,\n pending,\n i = 0;\n\n try {\n tokens = Lexer.lex(src, opt)\n } catch (e) {\n return callback(e);\n }\n\n pending = tokens.length;\n\n var done = function(err) {\n if (err) {\n opt.highlight = highlight;\n return callback(err);\n }\n\n var out;\n\n try {\n out = Parser.parse(tokens, opt);\n } catch (e) {\n err = e;\n }\n\n opt.highlight = highlight;\n\n return err\n ? callback(err)\n : callback(null, out);\n };\n\n if (!highlight || highlight.length < 3) {\n return done();\n }\n\n delete opt.highlight;\n\n if (!pending) return done();\n\n for (; i < tokens.length; i++) {\n (function(token) {\n if (token.type !== 'code') {\n return --pending || done();\n }\n return highlight(token.text, token.lang, function(err, code) {\n if (err) return done(err);\n if (code == null || code === token.text) {\n return --pending || done();\n }\n token.text = code;\n token.escaped = true;\n --pending || done();\n });\n })(tokens[i]);\n }\n\n return;\n }\n try {\n if (opt) opt = merge({}, marked.defaults, opt);\n return Parser.parse(Lexer.lex(src, opt), opt);\n } catch (e) {\n e.message += '\\nPlease report this to https://github.com/markedjs/marked.';\n if ((opt || marked.defaults).silent) {\n return '<p>An error occurred:</p><pre>'\n + escape(e.message + '', true)\n + '</pre>';\n }\n throw e;\n }\n}\n\n/**\n * Options\n */\n\nmarked.options =\nmarked.setOptions = function(opt) {\n merge(marked.defaults, opt);\n return marked;\n};\n\nmarked.getDefaults = function () {\n return {\n baseUrl: null,\n breaks: false,\n gfm: true,\n headerIds: true,\n headerPrefix: '',\n highlight: null,\n langPrefix: 'language-',\n mangle: true,\n pedantic: false,\n renderer: new Renderer(),\n sanitize: false,\n sanitizer: null,\n silent: false,\n smartLists: false,\n smartypants: false,\n tables: true,\n xhtml: false\n };\n}\n\nmarked.defaults = marked.getDefaults();\n\n/**\n * Expose\n */\n\nmarked.Parser = Parser;\nmarked.parser = Parser.parse;\n\nmarked.Renderer = Renderer;\nmarked.TextRenderer = TextRenderer;\n\nmarked.Lexer = Lexer;\nmarked.lexer = Lexer.lex;\n\nmarked.InlineLexer = InlineLexer;\nmarked.inlineLexer = InlineLexer.output;\n\nmarked.parse = marked;\n\nif (typeof module !== 'undefined' && typeof exports === 'object') {\n module.exports = marked;\n} else if (typeof define === 'function' && define.amd) {\n define('deps/marked',[],function() { return marked; });\n} else {\n root.marked = marked;\n}\n})(this || (typeof window !== 'undefined' ? window : global));\n\n", - "define('core/utils',[\"exports\", \"core/pubsubhub\", \"deps/marked\"], function (exports, _pubsubhub, _marked) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.ISODate = exports.name = undefined;\n exports.markdownToHtml = markdownToHtml;\n exports.makeOwnerSwapper = makeOwnerSwapper;\n exports.calculateLeftPad = calculateLeftPad;\n exports.createResourceHint = createResourceHint;\n exports.normalizePadding = normalizePadding;\n exports.removeReSpec = removeReSpec;\n exports.joinAnd = joinAnd;\n exports.xmlEscape = xmlEscape;\n exports.norm = norm;\n exports.semverCompare = semverCompare;\n exports.concatDate = concatDate;\n exports.toShortIsoDate = toShortIsoDate;\n exports.lead0 = lead0;\n exports.parseSimpleDate = parseSimpleDate;\n exports.parseLastModified = parseLastModified;\n exports.humanDate = humanDate;\n exports.isoDate = isoDate;\n exports.toKeyValuePairs = toKeyValuePairs;\n exports.linkCSS = linkCSS;\n exports.runTransforms = runTransforms;\n exports.fetchAndCache = fetchAndCache;\n exports.flatten = flatten;\n\n var _marked2 = _interopRequireDefault(_marked);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n /*jshint browser: true */\n /*globals console*/\n // Module core/utils\n // As the name implies, this contains a ragtag gang of methods that just don't fit\n // anywhere else.\n const name = exports.name = \"core/utils\";\n\n _marked2.default.setOptions({\n sanitize: false,\n gfm: true\n });\n\n const spaceOrTab = /^[\\ |\\t]*/;\n const endsWithSpace = /\\s+$/gm;\n const dashes = /\\-/g;\n const gtEntity = />/gm;\n const ampEntity = /&/gm;\n\n function markdownToHtml(text) {\n const normalizedLeftPad = normalizePadding(text);\n // As markdown is pulled from HTML, > and & are already escaped and\n // so blockquotes aren't picked up by the parser. This fixes it.\n const potentialMarkdown = normalizedLeftPad.replace(gtEntity, \">\").replace(ampEntity, \"&\");\n const result = (0, _marked2.default)(potentialMarkdown);\n return result;\n }\n\n const ISODate = exports.ISODate = new Intl.DateTimeFormat([\"en-ca-iso8601\"], {\n timeZone: \"UTC\",\n year: \"numeric\",\n month: \"2-digit\",\n day: \"2-digit\"\n });\n\n const inlineElems = new Set([\"a\", \"abbr\", \"acronym\", \"b\", \"bdo\", \"big\", \"br\", \"button\", \"cite\", \"code\", \"dfn\", \"em\", \"i\", \"img\", \"input\", \"kbd\", \"label\", \"map\", \"object\", \"q\", \"samp\", \"script\", \"select\", \"small\", \"span\", \"strong\", \"sub\", \"sup\", \"textarea\", \"time\", \"tt\", \"var\"]);\n\n const resourceHints = new Set([\"dns-prefetch\", \"preconnect\", \"preload\", \"prerender\"]);\n\n const fetchDestinations = new Set([\"document\", \"embed\", \"font\", \"image\", \"manifest\", \"media\", \"object\", \"report\", \"script\", \"serviceworker\", \"sharedworker\", \"style\", \"worker\", \"xslt\", \"\"]);\n\n /**\n * Allows a node to be swapped into a different document at\n * some insertion point(Element). This function is useful for\n * opportunistic insertion of DOM nodes into a document, without\n * first knowing if that is the final document where the node will\n * reside.\n *\n * @param {Node} node The node to be swapped.\n * @return {Function} A function that takes a new\n * insertion point (Node). When called,\n * node gets inserted into doc at before a given\n * insertion point (Node) - or just appended, if\n * the element has no children.\n */\n function makeOwnerSwapper(node) {\n if (!node) {\n throw new TypeError(\"Expected instance of Node.\");\n }\n return insertionPoint => {\n insertionPoint.ownerDocument.adoptNode(node);\n if (insertionPoint.firstElementChild) {\n return insertionPoint.insertBefore(node, insertionPoint.firstElementChild);\n }\n insertionPoint.appendChild(node);\n };\n }\n\n function calculateLeftPad(text) {\n if (typeof text !== \"string\") {\n throw new TypeError(\"Invalid input\");\n }\n // Find smallest padding value\n var leftPad = text.split(\"\\n\").filter(item => item).reduce((smallest, item) => {\n // can't go smaller than 0\n if (smallest === 0) {\n return smallest;\n }\n const match = item.match(spaceOrTab)[0] || \"\";\n return Math.min(match.length, smallest);\n }, +Infinity);\n return leftPad === +Infinity ? 0 : leftPad;\n }\n /**\n * Creates a link element that represents a resource hint.\n *\n * @param {Object} opts Configure the resource hint.\n * @param {String} opts.hint The type of hint (see resourceHints).\n * @param {URL|String} opts.href The URL for the resource or origin.\n * @param {String} [opts.corsMode] Optional, the CORS mode to use (see HTML spec).\n * @param {String} [opts.as] Optional, fetch destination type (see fetchDestinations).\n * @param {Bool} [opts.dontRemove] If the hint should remain in the spec after processing.\n * @return {HTMLLinkElement} A link element ready to use.\n */\n function createResourceHint(opts) {\n if (!opts || typeof opts !== \"object\") {\n throw new TypeError(\"Missing options\");\n }\n if (!resourceHints.has(opts.hint)) {\n throw new TypeError(\"Invalid resources hint\");\n }\n const url = new URL(opts.href, document.location);\n const linkElem = document.createElement(\"link\");\n let href = url.href;\n linkElem.rel = opts.hint;\n switch (linkElem.rel) {\n case \"dns-prefetch\":\n case \"preconnect\":\n href = url.origin;\n if (opts.corsMode || url.origin !== document.location.origin) {\n linkElem.crossOrigin = opts.corsMode || \"anonymous\";\n }\n break;\n case \"preload\":\n if (\"as\" in opts && typeof opts.as === \"string\") {\n if (!fetchDestinations.has(opts.as)) {\n console.warn(`Unknown request destination: ${opts.as}`);\n }\n linkElem.setAttribute(\"as\", opts.as);\n }\n break;\n }\n linkElem.href = href;\n if (!opts.dontRemove) {\n linkElem.classList.add(\"removeOnSave\");\n }\n return linkElem;\n }\n\n function normalizePadding(text = \"\") {\n if (!text) {\n return \"\";\n }\n if (typeof text !== \"string\") {\n throw TypeError(\"Invalid input\");\n }\n if (text === \"\\n\") {\n return \"\\n\";\n }\n\n function isTextNode(node) {\n return node !== null && node.nodeType === Node.TEXT_NODE;\n }\n // Force into body\n var parserInput = \"<body>\" + text;\n var doc = new DOMParser().parseFromString(parserInput, \"text/html\");\n // Normalize block level elements children first\n Array.from(doc.body.children).filter(elem => !inlineElems.has(elem.localName)).filter(elem => elem.localName !== \"pre\").filter(elem => elem.localName !== \"table\").forEach(elem => {\n elem.innerHTML = normalizePadding(elem.innerHTML);\n });\n // Normalize root level now\n Array.from(doc.body.childNodes).filter(node => isTextNode(node) && node.textContent.trim() === \"\").forEach(node => node.parentElement.replaceChild(doc.createTextNode(\"\\n\"), node));\n // Normalize text node\n if (!isTextNode(doc.body.firstChild)) {\n Array.from(doc.body.firstChild.children).filter(child => child.localName !== \"table\").forEach(child => {\n child.innerHTML = normalizePadding(child.innerHTML);\n });\n }\n doc.normalize();\n // use the first space as an indicator of how much to chop off the front\n const firstSpace = doc.body.innerText.replace(/^\\ *\\n/, \"\").split(\"\\n\").filter(item => item && item.startsWith(\" \"))[0];\n var chop = firstSpace ? firstSpace.match(/\\ +/)[0].length : 0;\n if (chop) {\n // Chop chop from start, but leave pre elem alone\n Array.from(doc.body.childNodes).filter(node => node.localName !== \"pre\").filter(isTextNode).filter(node => {\n // we care about text next to a block level element\n const prevSib = node.previousElementSibling;\n const nextTo = prevSib ? prevSib.localName : node.parentElement.localName;\n // and we care about text elements that finish on a new line\n return !inlineElems.has(nextTo) || node.textContent.trim().includes(\"\\n\");\n }).reduce((replacer, node) => {\n // We need to retain white space if the text Node is next to an in-line element\n let padding = \"\";\n const prevSib = node.previousElementSibling;\n const nextTo = prevSib ? prevSib.localName : node.parentElement.localName;\n if (/^[\\t\\ ]/.test(node.textContent) && inlineElems.has(nextTo)) {\n padding = node.textContent.match(/^\\s+/)[0];\n }\n node.textContent = padding + node.textContent.replace(replacer, \"\");\n return replacer;\n }, new RegExp(\"^ {1,\" + chop + \"}\", \"gm\"));\n // deal with pre elements... we can chop whitespace from their siblings\n const endsWithSpace = new RegExp(`\\\\ {${chop}}$`, \"gm\");\n Array.from(doc.body.querySelectorAll(\"pre\")).map(elem => elem.previousSibling).filter(isTextNode).reduce((chop, node) => {\n if (endsWithSpace.test(node.textContent)) {\n node.textContent = node.textContent.substr(0, node.textContent.length - chop);\n }\n return chop;\n }, chop);\n }\n const result = endsWithSpace.test(doc.body.innerHTML) ? doc.body.innerHTML.trimRight() + \"\\n\" : doc.body.innerHTML;\n return result;\n }\n\n // RESPEC STUFF\n function removeReSpec(doc) {\n Array.from(doc.querySelectorAll(\".remove, script[data-requiremodule]\")).forEach(elem => {\n elem.remove();\n });\n }\n\n // STRING HELPERS\n // Takes an array and returns a string that separates each of its items with the proper commas and\n // \"and\". The second argument is a mapping function that can convert the items before they are\n // joined\n function joinAnd(array = [], mapper = item => item) {\n const items = array.map(mapper);\n switch (items.length) {\n case 0:\n case 1:\n // \"x\"\n return items.toString();\n case 2:\n // x and y\n return items.join(\" and \");\n default:\n // x, y, and z\n const str = items.join(\", \");\n const lastComma = str.lastIndexOf(\",\");\n return `${str.substr(0, lastComma + 1)} and ${str.slice(lastComma + 2)}`;\n }\n }\n\n // Takes a string, applies some XML escapes, and returns the escaped string.\n // Note that overall using either Handlebars' escaped output or jQuery is much\n // preferred to operating on strings directly.\n function xmlEscape(s) {\n return s.replace(/&/g, \"&\").replace(/>/g, \">\").replace(/\"/g, \""\").replace(/</g, \"<\");\n }\n\n // Trims string at both ends and replaces all other white space with a single space\n function norm(str) {\n return str.trim().replace(/\\s+/g, \" \");\n }\n\n // semverCompare\n // https://github.com/substack/semver-compare\n function semverCompare(a, b) {\n const pa = a.split(\".\");\n const pb = b.split(\".\");\n for (let i = 0; i < 3; i++) {\n const na = Number(pa[i]);\n const nb = Number(pb[i]);\n if (na > nb) return 1;\n if (nb > na) return -1;\n if (!isNaN(na) && isNaN(nb)) return 1;\n if (isNaN(na) && !isNaN(nb)) return -1;\n }\n return 0;\n }\n\n // --- DATE HELPERS -------------------------------------------------------------------------------\n // Takes a Date object and an optional separator and returns the year,month,day representation with\n // the custom separator (defaulting to none) and proper 0-padding\n function concatDate(date, sep = \"\") {\n return ISODate.format(date).replace(dashes, sep);\n }\n\n // formats a date to \"yyyy-mm-dd\"\n function toShortIsoDate(date) {\n return ISODate.format(date);\n }\n\n // takes a string, prepends a \"0\" if it is of length 1, does nothing otherwise\n function lead0(str) {\n return String(str).length === 1 ? \"0\" + str : str;\n }\n\n // takes a YYYY-MM-DD date and returns a Date object for it\n function parseSimpleDate(str) {\n return new Date(str);\n }\n\n // takes what document.lastModified returns and produces a Date object for it\n function parseLastModified(str) {\n if (!str) return new Date();\n return new Date(Date.parse(str));\n }\n\n // given either a Date object or a date in YYYY-MM-DD format,\n // return a human-formatted date suitable for use in a W3C specification\n function humanDate(date = new Date(), lang = document.documentElement.lang || \"en\") {\n if (!(date instanceof Date)) date = new Date(date);\n const langs = [lang, \"en\"];\n const day = date.toLocaleString(langs, {\n day: \"2-digit\",\n timeZone: \"UTC\"\n });\n const month = date.toLocaleString(langs, {\n month: \"long\",\n timeZone: \"UTC\"\n });\n const year = date.toLocaleString(langs, {\n year: \"numeric\",\n timeZone: \"UTC\"\n });\n //date month year\n return `${day} ${month} ${year}`;\n }\n // given either a Date object or a date in YYYY-MM-DD format,\n // return an ISO formatted date suitable for use in a xsd:datetime item\n function isoDate(date) {\n return (date instanceof Date ? date : new Date(date)).toISOString();\n }\n\n // Given an object, it converts it to a key value pair separated by\n // (\"=\", configurable) and a delimiter (\" ,\" configurable).\n // for example, {\"foo\": \"bar\", \"baz\": 1} becomes \"foo=bar, baz=1\"\n function toKeyValuePairs(obj, delimiter = \", \", separator = \"=\") {\n return Array.from(Object.entries(obj)).map(([key, value]) => `${key}${separator}${JSON.stringify(value)}`).join(delimiter);\n }\n\n // STYLE HELPERS\n // take a document and either a link or an array of links to CSS and appends\n // a <link/> element to the head pointing to each\n function linkCSS(doc, styles) {\n const stylesArray = [].concat(styles);\n const frag = stylesArray.map(url => {\n var link = doc.createElement(\"link\");\n link.rel = \"stylesheet\";\n link.href = url;\n return link;\n }).reduce(function (elem, nextLink) {\n elem.appendChild(nextLink);\n return elem;\n }, doc.createDocumentFragment());\n doc.head.appendChild(frag);\n }\n\n // TRANSFORMATIONS\n // Run list of transforms over content and return result.\n // Please note that this is a legacy method that is only kept in order\n // to maintain compatibility\n // with RSv1. It is therefore not tested and not actively supported.\n function runTransforms(content, flist) {\n var args = [this, content];\n var funcArgs = Array.from(arguments);\n funcArgs.shift();\n funcArgs.shift();\n args = args.concat(funcArgs);\n if (flist) {\n var methods = flist.split(/\\s+/);\n for (var j = 0; j < methods.length; j++) {\n var meth = methods[j];\n if (window[meth]) {\n // the initial call passed |this| directly, so we keep it that way\n try {\n content = window[meth].apply(this, args);\n } catch (e) {\n (0, _pubsubhub.pub)(\"warn\", `call to \\`${meth}()\\` failed with: ${e}. See error console for stack trace.`);\n console.error(e);\n }\n }\n }\n }\n return content;\n }\n\n /**\n * Cached request handler\n * @param {Request} request\n * @param {Object} maxAge cache expiration duration in ms. defaults to 24 hours (86400000 ms)\n * @return {Response}\n * if a cached response is available and it's not stale, return it\n * else: request from network, cache and return fresh response.\n * If network fails, return a stale cached version if exists (else throw)\n */\n async function fetchAndCache(request, maxAge = 86400000) {\n if (typeof request === \"string\" || request instanceof URL) {\n request = new Request(request);\n }\n const url = new URL(request.url);\n\n // use data from cache data if valid and render\n let cache;\n let cachedResponse;\n if (\"caches\" in window) {\n try {\n cache = await caches.open(url.origin);\n cachedResponse = await cache.match(request);\n if (cachedResponse && new Date(cachedResponse.headers.get(\"Expires\")) > new Date()) {\n return cachedResponse;\n }\n } catch (err) {\n console.error(\"Failed to use Cache API.\", err);\n }\n }\n\n // otherwise fetch new data and cache\n const response = await fetch(request);\n if (!response.ok) {\n if (cachedResponse) {\n // return stale version\n console.warn(`Returning a stale cached response for ${url}`);\n return cachedResponse;\n }\n }\n\n // cache response\n if (cache) {\n const clonedResponse = response.clone();\n const customHeaders = new Headers(response.headers);\n const expiryDate = new Date(Date.now() + maxAge);\n customHeaders.set(\"Expires\", expiryDate);\n const cacheResponse = new Response((await clonedResponse.blob()), {\n headers: customHeaders\n });\n // put in cache, and forget it (there is no recovery if it throws, but that's ok).\n await cache.put(request, cacheResponse).catch(console.error);\n return await cache.match(request);\n }\n return response;\n }\n\n // --- COLLECTION/ITERABLE HELPERS ---------------\n /**\n * Spreads one iterable into another.\n *\n * @param {Iterable} collector\n * @param {any|Iterable} item\n * @returns {Array}\n */\n function flatten(collector, item) {\n const isObject = typeof item === \"object\";\n const isIterable = Object(item)[Symbol.iterator] && typeof item.values === \"function\";\n const items = !isObject ? [item] : isIterable ? [...item.values()].reduce(flatten, []) : Object.values(item);\n return [...collector, ...items];\n }\n});\n//# sourceMappingURL=utils.js.map;\n", - "define('core/post-process',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.done = exports.name = undefined;\n const name = exports.name = \"core/post-process\"; /**\n * Module core/post-process\n *\n * Corresponds to respecConfig.postProcess and config.afterEnd.\n * - postProcess: an array of functions that get called\n * after processing finishes. This is not recommended and the feature is not\n * tested. Use with care, if you know what you're doing. Chances are you really\n * want to be using a new module with your own profile.\n * - afterEnd: final thing that is called.\n */\n\n\n let doneResolver;\n const done = exports.done = new Promise(resolve => {\n doneResolver = resolve;\n });\n\n (0, _pubsubhub.sub)(\"plugins-done\", async config => {\n const result = [];\n if (Array.isArray(config.postProcess)) {\n const values = await Promise.all(config.postProcess.filter(f => typeof f === \"function\").map(f => Promise.resolve(f(config, document))));\n result.push(...values);\n }\n if (typeof config.afterEnd === \"function\") {\n result.push((await Promise.resolve(config.afterEnd(config, document))));\n }\n doneResolver(result);\n }, { once: true });\n});\n//# sourceMappingURL=post-process.js.map;\n", - "define('core/pre-process',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.done = exports.name = undefined;\n const name = exports.name = \"core/pre-process\"; /**\n * Module core/pre-process\n *\n * Corresponds to respecConfig.preProcess.\n * - preProcess: an array of functions that get called\n * before anything else happens. This is not recommended and the feature is not\n * tested. Use with care, if you know what you're doing. Chances are you really\n * want to be using a new module with your own profile\n */\n\n\n let doneResolver;\n const done = exports.done = new Promise(resolve => {\n doneResolver = resolve;\n });\n\n (0, _pubsubhub.sub)(\"start-all\", async config => {\n const result = [];\n if (Array.isArray(config.preProcess)) {\n const values = await Promise.all(config.preProcess.filter(f => typeof f === \"function\").map(f => Promise.resolve(f(config, document))));\n result.push(...values);\n }\n doneResolver(result);\n }, { once: true });\n});\n//# sourceMappingURL=pre-process.js.map;\n", - "define('core/include-config',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n const name = exports.name = \"core/include-config\"; // Module core/include-config\n // Inject's the document's configuration into the head as JSON.\n\n\n const userConfig = {};\n const amendConfig = newValues => Object.assign(userConfig, newValues);\n\n (0, _pubsubhub.sub)(\"start-all\", amendConfig);\n (0, _pubsubhub.sub)(\"amend-user-config\", amendConfig);\n (0, _pubsubhub.sub)(\"end-all\", () => {\n const script = document.createElement(\"script\");\n script.id = \"initialUserConfig\";\n script.type = \"application/json\";\n script.innerHTML = JSON.stringify(userConfig, null, 2);\n document.head.appendChild(script);\n });\n});\n//# sourceMappingURL=include-config.js.map;\n", - "define('core/override-configuration',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n const name = exports.name = \"core/override-configuration\"; // Module core/override-configuration\n // A helper module that makes it possible to override settings specified in respecConfig\n // by passing them as a query string. This is useful when you just want to make a few\n // tweaks to a document before generating the snapshot, without mucking with the source.\n // For example, you can change the status and date by appending:\n // ?specStatus=LC&publishDate=2012-03-15\n // Note that fields are separated by semicolons and not ampersands.\n // TODO\n // There could probably be a UI for this to make it even simpler.\n\n\n function overrideConfig(config) {\n const searchQuery = document.location.search.replace(/;/g, \"&\");\n const param = new URLSearchParams(searchQuery);\n const overrideProps = Array.from(param.entries()).filter(([key, value]) => !!key && !!value).map(([codedKey, codedValue]) => {\n const key = decodeURIComponent(codedKey);\n const decodedValue = decodeURIComponent(codedValue.replace(/%3D/g, \"=\"));\n let value;\n try {\n value = JSON.parse(decodedValue);\n } catch (err) {\n value = decodedValue;\n }\n return { key, value };\n }).reduce((collector, { key, value }) => {\n collector[key] = value;\n return collector;\n }, {});\n Object.assign(config, overrideProps);\n (0, _pubsubhub.pub)(\"amend-user-config\", overrideProps);\n }\n (0, _pubsubhub.sub)(\"start-all\", overrideConfig, { once: true });\n});\n//# sourceMappingURL=override-configuration.js.map;\n", - "define('core/respec-ready',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n const name = exports.name = \"core/respec-ready\"; /**\n * This Module adds a `respecIsReady` property to the document object.\n * The property returns a promise that settles when ReSpec finishes\n * processing the document.\n */\n\n\n const respecDonePromise = new Promise(resolve => {\n (0, _pubsubhub.sub)(\"end-all\", resolve, { once: true });\n });\n\n Object.defineProperty(document, \"respecIsReady\", {\n get() {\n return respecDonePromise;\n }\n });\n});\n//# sourceMappingURL=respec-ready.js.map;\n", - "define('core/base-runner',[\"exports\", \"core/utils\", \"core/post-process\", \"core/pre-process\", \"core/pubsubhub\", \"core/include-config\", \"core/override-configuration\", \"core/respec-ready\"], function (exports, _utils, _postProcess, _preProcess, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.runAll = runAll;\n const name = exports.name = \"core/base-runner\"; // Module core/base-runner\n // The module in charge of running the whole processing pipeline.\n\n const canMeasure = performance.mark && performance.measure;\n\n function toRunnable(plug) {\n const name = plug.name || \"\";\n if (!name) {\n console.warn(\"Plugin lacks name:\", plug);\n }\n return config => {\n return new Promise(async (resolve, reject) => {\n const timerId = setTimeout(() => {\n const msg = `Plugin ${name} took too long.`;\n console.error(msg, plug);\n reject(new Error(msg));\n }, 15000);\n if (canMeasure) {\n performance.mark(name + \"-start\");\n }\n try {\n // Modern plugins are async or normal functions, take zero or one argument (conf)\n if (plug.run.length <= 1) {\n await plug.run(config);\n resolve();\n } else {\n plug.run(config, document, resolve);\n }\n } catch (err) {\n reject(err);\n } finally {\n clearTimeout(timerId);\n }\n if (canMeasure) {\n performance.mark(name + \"-end\");\n performance.measure(name, name + \"-start\", name + \"-end\");\n }\n });\n };\n }\n\n async function runAll(plugs) {\n (0, _pubsubhub.pub)(\"start-all\", respecConfig);\n if (canMeasure) {\n performance.mark(name + \"-start\");\n }\n await _preProcess.done;\n const runnables = plugs.filter(plug => plug && plug.run).map(toRunnable);\n for (const task of runnables) {\n try {\n await task(respecConfig);\n } catch (err) {\n console.error(err);\n }\n }\n (0, _pubsubhub.pub)(\"plugins-done\", respecConfig);\n await _postProcess.done;\n (0, _pubsubhub.pub)(\"end-all\", respecConfig);\n (0, _utils.removeReSpec)(document);\n if (canMeasure) {\n performance.mark(name + \"-end\");\n performance.measure(name, name + \"-start\", name + \"-end\");\n }\n }\n});\n//# sourceMappingURL=base-runner.js.map;\n", - "/**\n * www.openjs.com/scripts/events/keyboard_shortcuts/\n * Version : 2.01.B\n * By Binny V A\n * License : BSD\n */\n\"use strict\";\nvar shortcut = {\n all_shortcuts: {}, //All the shortcuts are stored in this array\n add: function(shortcut_combination, callback, opt) {\n //Provide a set of default options\n var default_options = {\n type: \"keydown\",\n propagate: false,\n disable_in_input: false,\n target: document,\n keycode: false,\n };\n if (!opt) {\n opt = default_options;\n } else {\n for (var dfo in default_options) {\n if (typeof opt[dfo] == \"undefined\") opt[dfo] = default_options[dfo];\n }\n }\n\n var ele = opt.target;\n if (typeof opt.target == \"string\")\n ele = document.getElementById(opt.target);\n var ths = this;\n shortcut_combination = shortcut_combination.toLowerCase();\n\n //The function to be called at keypress\n var func = function(e) {\n var code;\n e = e || window.event;\n\n if (opt[\"disable_in_input\"]) {\n //Don't enable shortcut keys in Input, Textarea fields\n var element;\n if (e.target) element = e.target;\n else if (e.srcElement) element = e.srcElement;\n if (element.nodeType == 3) element = element.parentNode;\n\n if (element.tagName == \"INPUT\" || element.tagName == \"TEXTAREA\") return;\n }\n\n //Find Which key is pressed\n if (e.keyCode) code = e.keyCode;\n else if (e.which) code = e.which;\n var character = String.fromCharCode(code).toLowerCase();\n\n if (code == 188) character = \",\"; //If the user presses , when the type is onkeydown\n if (code == 190) character = \".\"; //If the user presses , when the type is onkeydown\n\n var keys = shortcut_combination.split(\"+\");\n //Key Pressed - counts the number of valid keypresses - if it is same as the number of keys, the shortcut function is invoked\n var kp = 0;\n\n //Work around for stupid Shift key bug created by using lowercase - as a result the shift+num combination was broken\n var shift_nums = {\n \"`\": \"~\",\n \"1\": \"!\",\n \"2\": \"@\",\n \"3\": \"#\",\n \"4\": \"$\",\n \"5\": \"%\",\n \"6\": \"^\",\n \"7\": \"&\",\n \"8\": \"*\",\n \"9\": \"(\",\n \"0\": \")\",\n \"-\": \"_\",\n \"=\": \"+\",\n \";\": \":\",\n \"'\": '\"',\n \",\": \"<\",\n \".\": \">\",\n \"/\": \"?\",\n \"\\\\\": \"|\",\n };\n //Special Keys - and their codes\n var special_keys = {\n esc: 27,\n escape: 27,\n tab: 9,\n space: 32,\n return: 13,\n enter: 13,\n backspace: 8,\n\n scrolllock: 145,\n scroll_lock: 145,\n scroll: 145,\n capslock: 20,\n caps_lock: 20,\n caps: 20,\n numlock: 144,\n num_lock: 144,\n num: 144,\n\n pause: 19,\n break: 19,\n\n insert: 45,\n home: 36,\n delete: 46,\n end: 35,\n\n pageup: 33,\n page_up: 33,\n pu: 33,\n\n pagedown: 34,\n page_down: 34,\n pd: 34,\n\n left: 37,\n up: 38,\n right: 39,\n down: 40,\n\n f1: 112,\n f2: 113,\n f3: 114,\n f4: 115,\n f5: 116,\n f6: 117,\n f7: 118,\n f8: 119,\n f9: 120,\n f10: 121,\n f11: 122,\n f12: 123,\n };\n\n var modifiers = {\n shift: { wanted: false, pressed: false },\n ctrl: { wanted: false, pressed: false },\n alt: { wanted: false, pressed: false },\n meta: { wanted: false, pressed: false }, //Meta is Mac specific\n };\n\n if (e.ctrlKey) modifiers.ctrl.pressed = true;\n if (e.shiftKey) modifiers.shift.pressed = true;\n if (e.altKey) modifiers.alt.pressed = true;\n if (e.metaKey) modifiers.meta.pressed = true;\n\n for (var i = 0, k; (k = keys[i]), i < keys.length; i++) {\n //Modifiers\n if (k == \"ctrl\" || k == \"control\") {\n kp++;\n modifiers.ctrl.wanted = true;\n } else if (k == \"shift\") {\n kp++;\n modifiers.shift.wanted = true;\n } else if (k == \"alt\") {\n kp++;\n modifiers.alt.wanted = true;\n } else if (k == \"meta\") {\n kp++;\n modifiers.meta.wanted = true;\n } else if (k.length > 1) {\n //If it is a special key\n if (special_keys[k] == code) kp++;\n } else if (opt[\"keycode\"]) {\n if (opt[\"keycode\"] == code) kp++;\n } else {\n //The special keys did not match\n if (character == k) kp++;\n else {\n if (shift_nums[character] && e.shiftKey) {\n //Stupid Shift key bug created by using lowercase\n character = shift_nums[character];\n if (character == k) kp++;\n }\n }\n }\n }\n\n if (\n kp == keys.length &&\n modifiers.ctrl.pressed == modifiers.ctrl.wanted &&\n modifiers.shift.pressed == modifiers.shift.wanted &&\n modifiers.alt.pressed == modifiers.alt.wanted &&\n modifiers.meta.pressed == modifiers.meta.wanted\n ) {\n callback(e);\n\n if (!opt[\"propagate\"]) {\n //Stop the event\n //e.cancelBubble is supported by IE - this will kill the bubbling process.\n e.cancelBubble = true;\n e.returnValue = false;\n\n //e.stopPropagation works in Firefox.\n if (e.stopPropagation) {\n e.stopPropagation();\n e.preventDefault();\n }\n return false;\n }\n }\n };\n this.all_shortcuts[shortcut_combination] = {\n callback: func,\n target: ele,\n event: opt[\"type\"],\n };\n //Attach the function with the event\n if (ele.addEventListener) ele.addEventListener(opt[\"type\"], func, false);\n else if (ele.attachEvent) ele.attachEvent(\"on\" + opt[\"type\"], func);\n else ele[\"on\" + opt[\"type\"]] = func;\n },\n\n //Remove the shortcut - just specify the shortcut and I will remove the binding\n // 'remove':function(shortcut_combination) {\n // shortcut_combination = shortcut_combination.toLowerCase();\n // var binding = this.all_shortcuts[shortcut_combination];\n // delete(this.all_shortcuts[shortcut_combination])\n // if(!binding) return;\n // var type = binding['event'];\n // var ele = binding['target'];\n // var callback = binding['callback'];\n //\n // if(ele.detachEvent) ele.detachEvent('on'+type, callback);\n // else if(ele.removeEventListener) ele.removeEventListener(type, callback, false);\n // else ele['on'+type] = false;\n // }\n};\n\ndefine(\"shortcut\", (function (global) {\n return function () {\n var ret, fn;\n return ret || global.shortcut;\n };\n}(this)));\n\n", - "/**\n * @license text 2.0.15 Copyright jQuery Foundation and other contributors.\n * Released under MIT license, http://github.com/requirejs/text/LICENSE\n */\n/*jslint regexp: true */\n/*global require, XMLHttpRequest, ActiveXObject,\n define, window, process, Packages,\n java, location, Components, FileUtils */\n\ndefine('deps/text',['module'], function (module) {\n 'use strict';\n\n var text, fs, Cc, Ci, xpcIsWindows,\n progIds = ['Msxml2.XMLHTTP', 'Microsoft.XMLHTTP', 'Msxml2.XMLHTTP.4.0'],\n xmlRegExp = /^\\s*<\\?xml(\\s)+version=[\\'\\\"](\\d)*.(\\d)*[\\'\\\"](\\s)*\\?>/im,\n bodyRegExp = /<body[^>]*>\\s*([\\s\\S]+)\\s*<\\/body>/im,\n hasLocation = typeof location !== 'undefined' && location.href,\n defaultProtocol = hasLocation && location.protocol && location.protocol.replace(/\\:/, ''),\n defaultHostName = hasLocation && location.hostname,\n defaultPort = hasLocation && (location.port || undefined),\n buildMap = {},\n masterConfig = (module.config && module.config()) || {};\n\n function useDefault(value, defaultValue) {\n return value === undefined || value === '' ? defaultValue : value;\n }\n\n //Allow for default ports for http and https.\n function isSamePort(protocol1, port1, protocol2, port2) {\n if (port1 === port2) {\n return true;\n } else if (protocol1 === protocol2) {\n if (protocol1 === 'http') {\n return useDefault(port1, '80') === useDefault(port2, '80');\n } else if (protocol1 === 'https') {\n return useDefault(port1, '443') === useDefault(port2, '443');\n }\n }\n return false;\n }\n\n text = {\n version: '2.0.15',\n\n strip: function (content) {\n //Strips <?xml ...?> declarations so that external SVG and XML\n //documents can be added to a document without worry. Also, if the string\n //is an HTML document, only the part inside the body tag is returned.\n if (content) {\n content = content.replace(xmlRegExp, \"\");\n var matches = content.match(bodyRegExp);\n if (matches) {\n content = matches[1];\n }\n } else {\n content = \"\";\n }\n return content;\n },\n\n jsEscape: function (content) {\n return content.replace(/(['\\\\])/g, '\\\\$1')\n .replace(/[\\f]/g, \"\\\\f\")\n .replace(/[\\b]/g, \"\\\\b\")\n .replace(/[\\n]/g, \"\\\\n\")\n .replace(/[\\t]/g, \"\\\\t\")\n .replace(/[\\r]/g, \"\\\\r\")\n .replace(/[\\u2028]/g, \"\\\\u2028\")\n .replace(/[\\u2029]/g, \"\\\\u2029\");\n },\n\n createXhr: masterConfig.createXhr || function () {\n //Would love to dump the ActiveX crap in here. Need IE 6 to die first.\n var xhr, i, progId;\n if (typeof XMLHttpRequest !== \"undefined\") {\n return new XMLHttpRequest();\n } else if (typeof ActiveXObject !== \"undefined\") {\n for (i = 0; i < 3; i += 1) {\n progId = progIds[i];\n try {\n xhr = new ActiveXObject(progId);\n } catch (e) {}\n\n if (xhr) {\n progIds = [progId]; // so faster next time\n break;\n }\n }\n }\n\n return xhr;\n },\n\n /**\n * Parses a resource name into its component parts. Resource names\n * look like: module/name.ext!strip, where the !strip part is\n * optional.\n * @param {String} name the resource name\n * @returns {Object} with properties \"moduleName\", \"ext\" and \"strip\"\n * where strip is a boolean.\n */\n parseName: function (name) {\n var modName, ext, temp,\n strip = false,\n index = name.lastIndexOf(\".\"),\n isRelative = name.indexOf('./') === 0 ||\n name.indexOf('../') === 0;\n\n if (index !== -1 && (!isRelative || index > 1)) {\n modName = name.substring(0, index);\n ext = name.substring(index + 1);\n } else {\n modName = name;\n }\n\n temp = ext || modName;\n index = temp.indexOf(\"!\");\n if (index !== -1) {\n //Pull off the strip arg.\n strip = temp.substring(index + 1) === \"strip\";\n temp = temp.substring(0, index);\n if (ext) {\n ext = temp;\n } else {\n modName = temp;\n }\n }\n\n return {\n moduleName: modName,\n ext: ext,\n strip: strip\n };\n },\n\n xdRegExp: /^((\\w+)\\:)?\\/\\/([^\\/\\\\]+)/,\n\n /**\n * Is an URL on another domain. Only works for browser use, returns\n * false in non-browser environments. Only used to know if an\n * optimized .js version of a text resource should be loaded\n * instead.\n * @param {String} url\n * @returns Boolean\n */\n useXhr: function (url, protocol, hostname, port) {\n var uProtocol, uHostName, uPort,\n match = text.xdRegExp.exec(url);\n if (!match) {\n return true;\n }\n uProtocol = match[2];\n uHostName = match[3];\n\n uHostName = uHostName.split(':');\n uPort = uHostName[1];\n uHostName = uHostName[0];\n\n return (!uProtocol || uProtocol === protocol) &&\n (!uHostName || uHostName.toLowerCase() === hostname.toLowerCase()) &&\n ((!uPort && !uHostName) || isSamePort(uProtocol, uPort, protocol, port));\n },\n\n finishLoad: function (name, strip, content, onLoad) {\n content = strip ? text.strip(content) : content;\n if (masterConfig.isBuild) {\n buildMap[name] = content;\n }\n onLoad(content);\n },\n\n load: function (name, req, onLoad, config) {\n //Name has format: some.module.filext!strip\n //The strip part is optional.\n //if strip is present, then that means only get the string contents\n //inside a body tag in an HTML string. For XML/SVG content it means\n //removing the <?xml ...?> declarations so the content can be inserted\n //into the current doc without problems.\n\n // Do not bother with the work if a build and text will\n // not be inlined.\n if (config && config.isBuild && !config.inlineText) {\n onLoad();\n return;\n }\n\n masterConfig.isBuild = config && config.isBuild;\n\n var parsed = text.parseName(name),\n nonStripName = parsed.moduleName +\n (parsed.ext ? '.' + parsed.ext : ''),\n url = req.toUrl(nonStripName),\n useXhr = (masterConfig.useXhr) ||\n text.useXhr;\n\n // Do not load if it is an empty: url\n if (url.indexOf('empty:') === 0) {\n onLoad();\n return;\n }\n\n //Load the text. Use XHR if possible and in a browser.\n if (!hasLocation || useXhr(url, defaultProtocol, defaultHostName, defaultPort)) {\n text.get(url, function (content) {\n text.finishLoad(name, parsed.strip, content, onLoad);\n }, function (err) {\n if (onLoad.error) {\n onLoad.error(err);\n }\n });\n } else {\n //Need to fetch the resource across domains. Assume\n //the resource has been optimized into a JS module. Fetch\n //by the module name + extension, but do not include the\n //!strip part to avoid file system issues.\n req([nonStripName], function (content) {\n text.finishLoad(parsed.moduleName + '.' + parsed.ext,\n parsed.strip, content, onLoad);\n });\n }\n },\n\n write: function (pluginName, moduleName, write, config) {\n if (buildMap.hasOwnProperty(moduleName)) {\n var content = text.jsEscape(buildMap[moduleName]);\n write.asModule(pluginName + \"!\" + moduleName,\n \"define(function () { return '\" +\n content +\n \"';});\\n\");\n }\n },\n\n writeFile: function (pluginName, moduleName, req, write, config) {\n var parsed = text.parseName(moduleName),\n extPart = parsed.ext ? '.' + parsed.ext : '',\n nonStripName = parsed.moduleName + extPart,\n //Use a '.js' file name so that it indicates it is a\n //script that can be loaded across domains.\n fileName = req.toUrl(parsed.moduleName + extPart) + '.js';\n\n //Leverage own load() method to load plugin value, but only\n //write out values that do not have the strip argument,\n //to avoid any potential issues with ! in file names.\n text.load(nonStripName, req, function (value) {\n //Use own write() method to construct full module value.\n //But need to create shell that translates writeFile's\n //write() to the right interface.\n var textWrite = function (contents) {\n return write(fileName, contents);\n };\n textWrite.asModule = function (moduleName, contents) {\n return write.asModule(moduleName, fileName, contents);\n };\n\n text.write(pluginName, nonStripName, textWrite, config);\n }, config);\n }\n };\n\n if (masterConfig.env === 'node' || (!masterConfig.env &&\n typeof process !== \"undefined\" &&\n process.versions &&\n !!process.versions.node &&\n !process.versions['node-webkit'] &&\n !process.versions['atom-shell'])) {\n //Using special require.nodeRequire, something added by r.js.\n fs = require.nodeRequire('fs');\n\n text.get = function (url, callback, errback) {\n try {\n var file = fs.readFileSync(url, 'utf8');\n //Remove BOM (Byte Mark Order) from utf8 files if it is there.\n if (file[0] === '\\uFEFF') {\n file = file.substring(1);\n }\n callback(file);\n } catch (e) {\n if (errback) {\n errback(e);\n }\n }\n };\n } else if (masterConfig.env === 'xhr' || (!masterConfig.env &&\n text.createXhr())) {\n text.get = function (url, callback, errback, headers) {\n var xhr = text.createXhr(), header;\n xhr.open('GET', url, true);\n\n //Allow plugins direct access to xhr headers\n if (headers) {\n for (header in headers) {\n if (headers.hasOwnProperty(header)) {\n xhr.setRequestHeader(header.toLowerCase(), headers[header]);\n }\n }\n }\n\n //Allow overrides specified in config\n if (masterConfig.onXhr) {\n masterConfig.onXhr(xhr, url);\n }\n\n xhr.onreadystatechange = function (evt) {\n var status, err;\n //Do not explicitly handle errors, those should be\n //visible via console output in the browser.\n if (xhr.readyState === 4) {\n status = xhr.status || 0;\n if (status > 399 && status < 600) {\n //An http 4xx or 5xx error. Signal an error.\n err = new Error(url + ' HTTP status: ' + status);\n err.xhr = xhr;\n if (errback) {\n errback(err);\n }\n } else {\n callback(xhr.responseText);\n }\n\n if (masterConfig.onXhrComplete) {\n masterConfig.onXhrComplete(xhr, url);\n }\n }\n };\n xhr.send(null);\n };\n } else if (masterConfig.env === 'rhino' || (!masterConfig.env &&\n typeof Packages !== 'undefined' && typeof java !== 'undefined')) {\n //Why Java, why is this so awkward?\n text.get = function (url, callback) {\n var stringBuffer, line,\n encoding = \"utf-8\",\n file = new java.io.File(url),\n lineSeparator = java.lang.System.getProperty(\"line.separator\"),\n input = new java.io.BufferedReader(new java.io.InputStreamReader(new java.io.FileInputStream(file), encoding)),\n content = '';\n try {\n stringBuffer = new java.lang.StringBuffer();\n line = input.readLine();\n\n // Byte Order Mark (BOM) - The Unicode Standard, version 3.0, page 324\n // http://www.unicode.org/faq/utf_bom.html\n\n // Note that when we use utf-8, the BOM should appear as \"EF BB BF\", but it doesn't due to this bug in the JDK:\n // http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4508058\n if (line && line.length() && line.charAt(0) === 0xfeff) {\n // Eat the BOM, since we've already found the encoding on this file,\n // and we plan to concatenating this buffer with others; the BOM should\n // only appear at the top of a file.\n line = line.substring(1);\n }\n\n if (line !== null) {\n stringBuffer.append(line);\n }\n\n while ((line = input.readLine()) !== null) {\n stringBuffer.append(lineSeparator);\n stringBuffer.append(line);\n }\n //Make sure we return a JavaScript string and not a Java string.\n content = String(stringBuffer.toString()); //String\n } finally {\n input.close();\n }\n callback(content);\n };\n } else if (masterConfig.env === 'xpconnect' || (!masterConfig.env &&\n typeof Components !== 'undefined' && Components.classes &&\n Components.interfaces)) {\n //Avert your gaze!\n Cc = Components.classes;\n Ci = Components.interfaces;\n Components.utils['import']('resource://gre/modules/FileUtils.jsm');\n xpcIsWindows = ('@mozilla.org/windows-registry-key;1' in Cc);\n\n text.get = function (url, callback) {\n var inStream, convertStream, fileObj,\n readData = {};\n\n if (xpcIsWindows) {\n url = url.replace(/\\//g, '\\\\');\n }\n\n fileObj = new FileUtils.File(url);\n\n //XPCOM, you so crazy\n try {\n inStream = Cc['@mozilla.org/network/file-input-stream;1']\n .createInstance(Ci.nsIFileInputStream);\n inStream.init(fileObj, 1, 0, false);\n\n convertStream = Cc['@mozilla.org/intl/converter-input-stream;1']\n .createInstance(Ci.nsIConverterInputStream);\n convertStream.init(inStream, \"utf-8\", inStream.available(),\n Ci.nsIConverterInputStream.DEFAULT_REPLACEMENT_CHARACTER);\n\n convertStream.readString(inStream.available(), readData);\n convertStream.close();\n inStream.close();\n callback(readData.value);\n } catch (e) {\n throw new Error((fileObj && fileObj.path || '') + ': ' + e);\n }\n };\n }\n return text;\n});\n\n", - "\ndefine('deps/text!ui/ui.css',[],function () { return '#respec-ui {\\n position: fixed;\\n display: flex;\\n flex-direction: row-reverse;\\n top: 20px;\\n right: 20px;\\n width: 202px;\\n text-align: right;\\n z-index: 9000;\\n}\\n\\n#respec-pill,\\n.respec-info-button {\\n background: #fff;\\n height: 2.5em;\\n color: rgb(120, 120, 120);\\n border: 1px solid #ccc;\\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\\n}\\n\\n.respec-info-button {\\n border: none;\\n opacity: 0.75;\\n border-radius: 2em;\\n margin-right: 1em;\\n min-width: 3.5em;\\n}\\n\\n.respec-info-button:focus,\\n.respec-info-button:hover {\\n opacity: 1;\\n transition: opacity 0.2s;\\n}\\n\\n#respec-pill:disabled {\\n font-size: 2.8px;\\n text-indent: -9999em;\\n border-top: 1.1em solid rgba(40, 40, 40, 0.2);\\n border-right: 1.1em solid rgba(40, 40, 40, 0.2);\\n border-bottom: 1.1em solid rgba(40, 40, 40, 0.2);\\n border-left: 1.1em solid #ffffff;\\n transform: translateZ(0);\\n animation: respec-spin 0.5s infinite linear;\\n box-shadow: none;\\n}\\n\\n#respec-pill:disabled,\\n#respec-pill:disabled:after {\\n border-radius: 50%;\\n width: 10em;\\n height: 10em;\\n}\\n\\n@keyframes respec-spin {\\n 0% {\\n transform: rotate(0deg);\\n }\\n 100% {\\n transform: rotate(360deg);\\n }\\n}\\n\\n.respec-hidden {\\n visibility: hidden;\\n opacity: 0;\\n transition: visibility 0s 0.2s, opacity 0.2s linear;\\n}\\n\\n.respec-visible {\\n visibility: visible;\\n opacity: 1;\\n transition: opacity 0.2s linear;\\n}\\n\\n#respec-pill:hover,\\n#respec-pill:focus {\\n color: rgb(0, 0, 0);\\n background-color: rgb(245, 245, 245);\\n transition: color 0.2s;\\n}\\n\\n#respec-menu {\\n position: absolute;\\n margin: 0;\\n padding: 0;\\n font-family: sans-serif;\\n background: #fff;\\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\\n width: 200px;\\n display: none;\\n text-align: left;\\n margin-top: 32px;\\n font-size: 0.8em;\\n}\\n\\n#respec-menu:not([hidden]) {\\n display: block;\\n}\\n\\n#respec-menu li {\\n list-style-type: none;\\n margin: 0;\\n padding: 0;\\n}\\n\\n.respec-save-buttons {\\n display: grid;\\n grid-template-columns: repeat(auto-fill, minmax(47%, 2fr));\\n grid-gap: 0.5cm;\\n padding: 0.5cm;\\n}\\n\\n.respec-save-button:link {\\n padding-top: 16px;\\n color: rgb(240, 240, 240);\\n background: rgb(42, 90, 168);\\n justify-self: stretch;\\n height: 1cm;\\n text-decoration: none;\\n text-align: center;\\n font-size: inherit;\\n border: none;\\n border-radius: 0.2cm;\\n}\\n\\n.respec-save-button:link:hover {\\n color: white;\\n background: rgb(42, 90, 168);\\n padding: 0;\\n margin: 0;\\n border: 0;\\n padding-top: 16px;\\n}\\n\\n#respec-ui button:focus,\\n#respec-pill:focus,\\n.respec-option:focus {\\n outline: 0;\\n outline-style: none;\\n}\\n\\n#respec-pill-error {\\n background-color: red;\\n color: white;\\n}\\n\\n#respec-pill-warning {\\n background-color: orange;\\n color: white;\\n}\\n\\n.respec-warning-list,\\n.respec-error-list {\\n margin: 0;\\n padding: 0;\\n list-style: none;\\n font-family: sans-serif;\\n background-color: rgb(255, 251, 230);\\n font-size: 0.85em;\\n}\\n\\n.respec-warning-list > li,\\n.respec-error-list > li {\\n padding: 0.4em 0.7em;\\n}\\n\\n.respec-warning-list > li::before {\\n content: \"⚠️\";\\n padding-right: 0.5em;\\n}\\n.respec-warning-list p,\\n.respec-error-list p {\\n padding: 0;\\n margin: 0;\\n}\\n\\n.respec-warning-list li {\\n color: rgb(92, 59, 0);\\n border-bottom: thin solid rgb(255, 245, 194);\\n}\\n\\n.respec-error-list,\\n.respec-error-list li {\\n background-color: rgb(255, 240, 240);\\n}\\n\\n.respec-error-list li::before {\\n content: \"💥\";\\n padding-right: 0.5em;\\n}\\n\\n.respec-error-list li {\\n padding: 0.4em 0.7em;\\n color: rgb(92, 59, 0);\\n border-bottom: thin solid rgb(255, 215, 215);\\n}\\n\\n.respec-error-list li > p {\\n margin: 0;\\n padding: 0;\\n display: inline-block;\\n}\\n\\n#respec-overlay {\\n display: block;\\n position: fixed;\\n z-index: 10000;\\n top: 0px;\\n left: 0px;\\n height: 100%;\\n width: 100%;\\n background: #000;\\n}\\n\\n.respec-show-overlay {\\n transition: opacity 0.2s linear;\\n opacity: 0.5;\\n}\\n\\n.respec-hide-overlay {\\n transition: opacity 0.2s linear;\\n opacity: 0;\\n}\\n\\n.respec-modal {\\n display: block;\\n position: fixed;\\n z-index: 11000;\\n margin: auto;\\n top: 10%;\\n background: #fff;\\n border: 5px solid #666;\\n min-width: 20%;\\n width: 79%;\\n padding: 0;\\n max-height: 80%;\\n overflow-y: auto;\\n margin: 0 -0.5cm;\\n}\\n\\n@media screen and (min-width: 78em) {\\n .respec-modal {\\n width: 62%;\\n }\\n}\\n\\n.respec-modal h3 {\\n margin: 0;\\n padding: 0.2em;\\n text-align: center;\\n color: black;\\n background: linear-gradient(\\n to bottom,\\n rgba(238, 238, 238, 1) 0%,\\n rgba(238, 238, 238, 1) 50%,\\n rgba(204, 204, 204, 1) 100%\\n );\\n font-size: 1em;\\n}\\n\\n.respec-modal .inside div p {\\n padding-left: 1cm;\\n}\\n\\n#respec-menu button.respec-option {\\n background: white;\\n padding: 0 0.2cm;\\n border: none;\\n width: 100%;\\n text-align: left;\\n font-size: inherit;\\n padding: 1.2em 1.2em;\\n}\\n\\n#respec-menu button.respec-option:hover,\\n#respec-menu button:focus {\\n background-color: #eeeeee;\\n}\\n\\n.respec-cmd-icon {\\n padding-right: 0.5em;\\n}\\n\\n#respec-ui button.respec-option:last-child {\\n border: none;\\n border-radius: inherit;\\n}\\n\\n.respec-offending-element {\\n display: inline-block;\\n position: relative;\\n background: url(data:image/gif;base64,R0lGODdhBAADAPEAANv///8AAP///wAAACwAAAAABAADAEACBZQjmIAFADs=)\\n bottom repeat-x;\\n}\\n\\n@supports (text-decoration-style: wavy) {\\n .respec-offending-element {\\n background: none;\\n text-decoration-line: underline;\\n text-decoration-style: wavy;\\n text-decoration-color: red;\\n }\\n}\\n\\n.respec-button-copy-paste {\\n position: absolute;\\n display: block;\\n padding: 0px 8px;\\n height: 28px;\\n width: 40px;\\n color: #333;\\n white-space: nowrap;\\n vertical-align: middle;\\n cursor: pointer;\\n background-color: #eee;\\n background-image: linear-gradient(#fcfcfc, #eee);\\n border: 1px solid rgb(144, 184, 222);\\n border-radius: 0px 0px 3px 0;\\n -webkit-user-select: none;\\n -moz-user-select: none;\\n -ms-user-select: none;\\n user-select: none;\\n -webkit-appearance: none;\\n margin: 0px 127px;\\n border-left: 0;\\n}\\n\\np + .respec-button-copy-paste {\\n margin: 1px 127px;\\n}\\n\\n#specref-ui {\\n margin: 0 2%;\\n margin-bottom: 0.5cm;\\n}\\n\\n#specref-ui header {\\n font-size: 0.7em;\\n background-color: #eee;\\n text-align: center;\\n padding: 0.2cm;\\n margin-bottom: 0.5cm;\\n border-radius: 0 0 0.2cm 0.2cm;\\n}\\n\\n#specref-ui header h1 {\\n padding: 0;\\n margin: 0;\\n color: black;\\n}\\n\\n#specref-ui p {\\n padding: 0;\\n margin: 0;\\n font-size: 0.8em;\\n text-align: center;\\n}\\n\\n#specref-ui p.state {\\n margin: 1cm;\\n}\\n\\n#specref-ui .searchcomponent {\\n font-size: 16px;\\n display: grid;\\n grid-template-columns: auto 2cm;\\n}\\n#specref-ui .searchcomponent:focus {\\n}\\n\\n#specref-ui input,\\n#specref-ui button {\\n border: 0;\\n padding: 6px 12px;\\n}\\n\\n#specref-ui label {\\n font-size: 0.6em;\\n grid-column-end: 3;\\n text-align: right;\\n grid-column-start: 1;\\n}\\n\\n#specref-ui input[type=\"search\"] {\\n -webkit-appearance: none;\\n font-size: 16px;\\n border-radius: 0.1cm 0 0 0.1cm;\\n border: 1px solid rgb(204, 204, 204);\\n}\\n\\n#specref-ui button[type=\"submit\"] {\\n color: white;\\n border-radius: 0 0.1cm 0.1cm 0;\\n background-color: rgb(51, 122, 183);\\n}\\n\\n#specref-ui button[type=\"submit\"]:hover {\\n background-color: #286090;\\n border-color: #204d74;\\n}\\n\\n#specref-ui .result-stats {\\n margin: 0;\\n padding: 0;\\n color: rgb(128, 128, 128);\\n font-size: 0.7em;\\n font-weight: bold;\\n}\\n\\n#specref-ui .specref-results {\\n font-size: 0.8em;\\n}\\n\\n#specref-ui .specref-results dd + dt {\\n margin-top: 0.51cm;\\n}\\n\\n#specref-ui .specref-results a {\\n text-transform: capitalize;\\n}\\n#specref-ui .specref-results .authors {\\n display: block;\\n color: #006621;\\n}\\n\\n@media print {\\n #respec-ui {\\n display: none;\\n }\\n}\\n';});\n\n", - "/*!\n * jQuery JavaScript Library v3.3.1 -ajax,-ajax/jsonp,-ajax/load,-ajax/parseXML,-ajax/script,-ajax/var/location,-ajax/var/nonce,-ajax/var/rquery,-ajax/xhr,-manipulation/_evalUrl,-event/ajax,-effects,-effects/Tween,-effects/animatedSelector\n * https://jquery.com/\n *\n * Includes Sizzle.js\n * https://sizzlejs.com/\n *\n * Copyright JS Foundation and other contributors\n * Released under the MIT license\n * https://jquery.org/license\n *\n * Date: 2018-01-20T17:24Z\n */\n( function( global, factory ) {\n\n\t\"use strict\";\n\n\tif ( typeof module === \"object\" && typeof module.exports === \"object\" ) {\n\n\t\t// For CommonJS and CommonJS-like environments where a proper `window`\n\t\t// is present, execute the factory and get jQuery.\n\t\t// For environments that do not have a `window` with a `document`\n\t\t// (such as Node.js), expose a factory as module.exports.\n\t\t// This accentuates the need for the creation of a real `window`.\n\t\t// e.g. var jQuery = require(\"jquery\")(window);\n\t\t// See ticket #14549 for more info.\n\t\tmodule.exports = global.document ?\n\t\t\tfactory( global, true ) :\n\t\t\tfunction( w ) {\n\t\t\t\tif ( !w.document ) {\n\t\t\t\t\tthrow new Error( \"jQuery requires a window with a document\" );\n\t\t\t\t}\n\t\t\t\treturn factory( w );\n\t\t\t};\n\t} else {\n\t\tfactory( global );\n\t}\n\n// Pass this if window is not defined yet\n} )( typeof window !== \"undefined\" ? window : this, function( window, noGlobal ) {\n\n// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1\n// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode\n// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common\n// enough that all such attempts are guarded in a try block.\n\"use strict\";\n\nvar arr = [];\n\nvar document = window.document;\n\nvar getProto = Object.getPrototypeOf;\n\nvar slice = arr.slice;\n\nvar concat = arr.concat;\n\nvar push = arr.push;\n\nvar indexOf = arr.indexOf;\n\nvar class2type = {};\n\nvar toString = class2type.toString;\n\nvar hasOwn = class2type.hasOwnProperty;\n\nvar fnToString = hasOwn.toString;\n\nvar ObjectFunctionString = fnToString.call( Object );\n\nvar support = {};\n\nvar isFunction = function isFunction( obj ) {\n\n // Support: Chrome <=57, Firefox <=52\n // In some browsers, typeof returns \"function\" for HTML <object> elements\n // (i.e., `typeof document.createElement( \"object\" ) === \"function\"`).\n // We don't want to classify *any* DOM node as a function.\n return typeof obj === \"function\" && typeof obj.nodeType !== \"number\";\n };\n\n\nvar isWindow = function isWindow( obj ) {\n\t\treturn obj != null && obj === obj.window;\n\t};\n\n\n\n\n\tvar preservedScriptAttributes = {\n\t\ttype: true,\n\t\tsrc: true,\n\t\tnoModule: true\n\t};\n\n\tfunction DOMEval( code, doc, node ) {\n\t\tdoc = doc || document;\n\n\t\tvar i,\n\t\t\tscript = doc.createElement( \"script\" );\n\n\t\tscript.text = code;\n\t\tif ( node ) {\n\t\t\tfor ( i in preservedScriptAttributes ) {\n\t\t\t\tif ( node[ i ] ) {\n\t\t\t\t\tscript[ i ] = node[ i ];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tdoc.head.appendChild( script ).parentNode.removeChild( script );\n\t}\n\n\nfunction toType( obj ) {\n\tif ( obj == null ) {\n\t\treturn obj + \"\";\n\t}\n\n\t// Support: Android <=2.3 only (functionish RegExp)\n\treturn typeof obj === \"object\" || typeof obj === \"function\" ?\n\t\tclass2type[ toString.call( obj ) ] || \"object\" :\n\t\ttypeof obj;\n}\n/* global Symbol */\n// Defining this global in .eslintrc.json would create a danger of using the global\n// unguarded in another place, it seems safer to define global only for this module\n\n\n\nvar\n\tversion = \"3.3.1 -ajax,-ajax/jsonp,-ajax/load,-ajax/parseXML,-ajax/script,-ajax/var/location,-ajax/var/nonce,-ajax/var/rquery,-ajax/xhr,-manipulation/_evalUrl,-event/ajax,-effects,-effects/Tween,-effects/animatedSelector\",\n\n\t// Define a local copy of jQuery\n\tjQuery = function( selector, context ) {\n\n\t\t// The jQuery object is actually just the init constructor 'enhanced'\n\t\t// Need init if jQuery is called (just allow error to be thrown if not included)\n\t\treturn new jQuery.fn.init( selector, context );\n\t},\n\n\t// Support: Android <=4.0 only\n\t// Make sure we trim BOM and NBSP\n\trtrim = /^[\\s\\uFEFF\\xA0]+|[\\s\\uFEFF\\xA0]+$/g;\n\njQuery.fn = jQuery.prototype = {\n\n\t// The current version of jQuery being used\n\tjquery: version,\n\n\tconstructor: jQuery,\n\n\t// The default length of a jQuery object is 0\n\tlength: 0,\n\n\ttoArray: function() {\n\t\treturn slice.call( this );\n\t},\n\n\t// Get the Nth element in the matched element set OR\n\t// Get the whole matched element set as a clean array\n\tget: function( num ) {\n\n\t\t// Return all the elements in a clean array\n\t\tif ( num == null ) {\n\t\t\treturn slice.call( this );\n\t\t}\n\n\t\t// Return just the one element from the set\n\t\treturn num < 0 ? this[ num + this.length ] : this[ num ];\n\t},\n\n\t// Take an array of elements and push it onto the stack\n\t// (returning the new matched element set)\n\tpushStack: function( elems ) {\n\n\t\t// Build a new jQuery matched element set\n\t\tvar ret = jQuery.merge( this.constructor(), elems );\n\n\t\t// Add the old object onto the stack (as a reference)\n\t\tret.prevObject = this;\n\n\t\t// Return the newly-formed element set\n\t\treturn ret;\n\t},\n\n\t// Execute a callback for every element in the matched set.\n\teach: function( callback ) {\n\t\treturn jQuery.each( this, callback );\n\t},\n\n\tmap: function( callback ) {\n\t\treturn this.pushStack( jQuery.map( this, function( elem, i ) {\n\t\t\treturn callback.call( elem, i, elem );\n\t\t} ) );\n\t},\n\n\tslice: function() {\n\t\treturn this.pushStack( slice.apply( this, arguments ) );\n\t},\n\n\tfirst: function() {\n\t\treturn this.eq( 0 );\n\t},\n\n\tlast: function() {\n\t\treturn this.eq( -1 );\n\t},\n\n\teq: function( i ) {\n\t\tvar len = this.length,\n\t\t\tj = +i + ( i < 0 ? len : 0 );\n\t\treturn this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] );\n\t},\n\n\tend: function() {\n\t\treturn this.prevObject || this.constructor();\n\t},\n\n\t// For internal use only.\n\t// Behaves like an Array's method, not like a jQuery method.\n\tpush: push,\n\tsort: arr.sort,\n\tsplice: arr.splice\n};\n\njQuery.extend = jQuery.fn.extend = function() {\n\tvar options, name, src, copy, copyIsArray, clone,\n\t\ttarget = arguments[ 0 ] || {},\n\t\ti = 1,\n\t\tlength = arguments.length,\n\t\tdeep = false;\n\n\t// Handle a deep copy situation\n\tif ( typeof target === \"boolean\" ) {\n\t\tdeep = target;\n\n\t\t// Skip the boolean and the target\n\t\ttarget = arguments[ i ] || {};\n\t\ti++;\n\t}\n\n\t// Handle case when target is a string or something (possible in deep copy)\n\tif ( typeof target !== \"object\" && !isFunction( target ) ) {\n\t\ttarget = {};\n\t}\n\n\t// Extend jQuery itself if only one argument is passed\n\tif ( i === length ) {\n\t\ttarget = this;\n\t\ti--;\n\t}\n\n\tfor ( ; i < length; i++ ) {\n\n\t\t// Only deal with non-null/undefined values\n\t\tif ( ( options = arguments[ i ] ) != null ) {\n\n\t\t\t// Extend the base object\n\t\t\tfor ( name in options ) {\n\t\t\t\tsrc = target[ name ];\n\t\t\t\tcopy = options[ name ];\n\n\t\t\t\t// Prevent never-ending loop\n\t\t\t\tif ( target === copy ) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\t// Recurse if we're merging plain objects or arrays\n\t\t\t\tif ( deep && copy && ( jQuery.isPlainObject( copy ) ||\n\t\t\t\t\t( copyIsArray = Array.isArray( copy ) ) ) ) {\n\n\t\t\t\t\tif ( copyIsArray ) {\n\t\t\t\t\t\tcopyIsArray = false;\n\t\t\t\t\t\tclone = src && Array.isArray( src ) ? src : [];\n\n\t\t\t\t\t} else {\n\t\t\t\t\t\tclone = src && jQuery.isPlainObject( src ) ? src : {};\n\t\t\t\t\t}\n\n\t\t\t\t\t// Never move original objects, clone them\n\t\t\t\t\ttarget[ name ] = jQuery.extend( deep, clone, copy );\n\n\t\t\t\t// Don't bring in undefined values\n\t\t\t\t} else if ( copy !== undefined ) {\n\t\t\t\t\ttarget[ name ] = copy;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Return the modified object\n\treturn target;\n};\n\njQuery.extend( {\n\n\t// Unique for each copy of jQuery on the page\n\texpando: \"jQuery\" + ( version + Math.random() ).replace( /\\D/g, \"\" ),\n\n\t// Assume jQuery is ready without the ready module\n\tisReady: true,\n\n\terror: function( msg ) {\n\t\tthrow new Error( msg );\n\t},\n\n\tnoop: function() {},\n\n\tisPlainObject: function( obj ) {\n\t\tvar proto, Ctor;\n\n\t\t// Detect obvious negatives\n\t\t// Use toString instead of jQuery.type to catch host objects\n\t\tif ( !obj || toString.call( obj ) !== \"[object Object]\" ) {\n\t\t\treturn false;\n\t\t}\n\n\t\tproto = getProto( obj );\n\n\t\t// Objects with no prototype (e.g., `Object.create( null )`) are plain\n\t\tif ( !proto ) {\n\t\t\treturn true;\n\t\t}\n\n\t\t// Objects with prototype are plain iff they were constructed by a global Object function\n\t\tCtor = hasOwn.call( proto, \"constructor\" ) && proto.constructor;\n\t\treturn typeof Ctor === \"function\" && fnToString.call( Ctor ) === ObjectFunctionString;\n\t},\n\n\tisEmptyObject: function( obj ) {\n\n\t\t/* eslint-disable no-unused-vars */\n\t\t// See https://github.com/eslint/eslint/issues/6125\n\t\tvar name;\n\n\t\tfor ( name in obj ) {\n\t\t\treturn false;\n\t\t}\n\t\treturn true;\n\t},\n\n\t// Evaluates a script in a global context\n\tglobalEval: function( code ) {\n\t\tDOMEval( code );\n\t},\n\n\teach: function( obj, callback ) {\n\t\tvar length, i = 0;\n\n\t\tif ( isArrayLike( obj ) ) {\n\t\t\tlength = obj.length;\n\t\t\tfor ( ; i < length; i++ ) {\n\t\t\t\tif ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t} else {\n\t\t\tfor ( i in obj ) {\n\t\t\t\tif ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn obj;\n\t},\n\n\t// Support: Android <=4.0 only\n\ttrim: function( text ) {\n\t\treturn text == null ?\n\t\t\t\"\" :\n\t\t\t( text + \"\" ).replace( rtrim, \"\" );\n\t},\n\n\t// results is for internal usage only\n\tmakeArray: function( arr, results ) {\n\t\tvar ret = results || [];\n\n\t\tif ( arr != null ) {\n\t\t\tif ( isArrayLike( Object( arr ) ) ) {\n\t\t\t\tjQuery.merge( ret,\n\t\t\t\t\ttypeof arr === \"string\" ?\n\t\t\t\t\t[ arr ] : arr\n\t\t\t\t);\n\t\t\t} else {\n\t\t\t\tpush.call( ret, arr );\n\t\t\t}\n\t\t}\n\n\t\treturn ret;\n\t},\n\n\tinArray: function( elem, arr, i ) {\n\t\treturn arr == null ? -1 : indexOf.call( arr, elem, i );\n\t},\n\n\t// Support: Android <=4.0 only, PhantomJS 1 only\n\t// push.apply(_, arraylike) throws on ancient WebKit\n\tmerge: function( first, second ) {\n\t\tvar len = +second.length,\n\t\t\tj = 0,\n\t\t\ti = first.length;\n\n\t\tfor ( ; j < len; j++ ) {\n\t\t\tfirst[ i++ ] = second[ j ];\n\t\t}\n\n\t\tfirst.length = i;\n\n\t\treturn first;\n\t},\n\n\tgrep: function( elems, callback, invert ) {\n\t\tvar callbackInverse,\n\t\t\tmatches = [],\n\t\t\ti = 0,\n\t\t\tlength = elems.length,\n\t\t\tcallbackExpect = !invert;\n\n\t\t// Go through the array, only saving the items\n\t\t// that pass the validator function\n\t\tfor ( ; i < length; i++ ) {\n\t\t\tcallbackInverse = !callback( elems[ i ], i );\n\t\t\tif ( callbackInverse !== callbackExpect ) {\n\t\t\t\tmatches.push( elems[ i ] );\n\t\t\t}\n\t\t}\n\n\t\treturn matches;\n\t},\n\n\t// arg is for internal usage only\n\tmap: function( elems, callback, arg ) {\n\t\tvar length, value,\n\t\t\ti = 0,\n\t\t\tret = [];\n\n\t\t// Go through the array, translating each of the items to their new values\n\t\tif ( isArrayLike( elems ) ) {\n\t\t\tlength = elems.length;\n\t\t\tfor ( ; i < length; i++ ) {\n\t\t\t\tvalue = callback( elems[ i ], i, arg );\n\n\t\t\t\tif ( value != null ) {\n\t\t\t\t\tret.push( value );\n\t\t\t\t}\n\t\t\t}\n\n\t\t// Go through every key on the object,\n\t\t} else {\n\t\t\tfor ( i in elems ) {\n\t\t\t\tvalue = callback( elems[ i ], i, arg );\n\n\t\t\t\tif ( value != null ) {\n\t\t\t\t\tret.push( value );\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Flatten any nested arrays\n\t\treturn concat.apply( [], ret );\n\t},\n\n\t// A global GUID counter for objects\n\tguid: 1,\n\n\t// jQuery.support is not used in Core but other projects attach their\n\t// properties to it so it needs to exist.\n\tsupport: support\n} );\n\nif ( typeof Symbol === \"function\" ) {\n\tjQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ];\n}\n\n// Populate the class2type map\njQuery.each( \"Boolean Number String Function Array Date RegExp Object Error Symbol\".split( \" \" ),\nfunction( i, name ) {\n\tclass2type[ \"[object \" + name + \"]\" ] = name.toLowerCase();\n} );\n\nfunction isArrayLike( obj ) {\n\n\t// Support: real iOS 8.2 only (not reproducible in simulator)\n\t// `in` check used to prevent JIT error (gh-2145)\n\t// hasOwn isn't used here due to false negatives\n\t// regarding Nodelist length in IE\n\tvar length = !!obj && \"length\" in obj && obj.length,\n\t\ttype = toType( obj );\n\n\tif ( isFunction( obj ) || isWindow( obj ) ) {\n\t\treturn false;\n\t}\n\n\treturn type === \"array\" || length === 0 ||\n\t\ttypeof length === \"number\" && length > 0 && ( length - 1 ) in obj;\n}\nvar Sizzle =\n/*!\n * Sizzle CSS Selector Engine v2.3.3\n * https://sizzlejs.com/\n *\n * Copyright jQuery Foundation and other contributors\n * Released under the MIT license\n * http://jquery.org/license\n *\n * Date: 2016-08-08\n */\n(function( window ) {\n\nvar i,\n\tsupport,\n\tExpr,\n\tgetText,\n\tisXML,\n\ttokenize,\n\tcompile,\n\tselect,\n\toutermostContext,\n\tsortInput,\n\thasDuplicate,\n\n\t// Local document vars\n\tsetDocument,\n\tdocument,\n\tdocElem,\n\tdocumentIsHTML,\n\trbuggyQSA,\n\trbuggyMatches,\n\tmatches,\n\tcontains,\n\n\t// Instance-specific data\n\texpando = \"sizzle\" + 1 * new Date(),\n\tpreferredDoc = window.document,\n\tdirruns = 0,\n\tdone = 0,\n\tclassCache = createCache(),\n\ttokenCache = createCache(),\n\tcompilerCache = createCache(),\n\tsortOrder = function( a, b ) {\n\t\tif ( a === b ) {\n\t\t\thasDuplicate = true;\n\t\t}\n\t\treturn 0;\n\t},\n\n\t// Instance methods\n\thasOwn = ({}).hasOwnProperty,\n\tarr = [],\n\tpop = arr.pop,\n\tpush_native = arr.push,\n\tpush = arr.push,\n\tslice = arr.slice,\n\t// Use a stripped-down indexOf as it's faster than native\n\t// https://jsperf.com/thor-indexof-vs-for/5\n\tindexOf = function( list, elem ) {\n\t\tvar i = 0,\n\t\t\tlen = list.length;\n\t\tfor ( ; i < len; i++ ) {\n\t\t\tif ( list[i] === elem ) {\n\t\t\t\treturn i;\n\t\t\t}\n\t\t}\n\t\treturn -1;\n\t},\n\n\tbooleans = \"checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped\",\n\n\t// Regular expressions\n\n\t// http://www.w3.org/TR/css3-selectors/#whitespace\n\twhitespace = \"[\\\\x20\\\\t\\\\r\\\\n\\\\f]\",\n\n\t// http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier\n\tidentifier = \"(?:\\\\\\\\.|[\\\\w-]|[^\\0-\\\\xa0])+\",\n\n\t// Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors\n\tattributes = \"\\\\[\" + whitespace + \"*(\" + identifier + \")(?:\" + whitespace +\n\t\t// Operator (capture 2)\n\t\t\"*([*^$|!~]?=)\" + whitespace +\n\t\t// \"Attribute values must be CSS identifiers [capture 5] or strings [capture 3 or capture 4]\"\n\t\t\"*(?:'((?:\\\\\\\\.|[^\\\\\\\\'])*)'|\\\"((?:\\\\\\\\.|[^\\\\\\\\\\\"])*)\\\"|(\" + identifier + \"))|)\" + whitespace +\n\t\t\"*\\\\]\",\n\n\tpseudos = \":(\" + identifier + \")(?:\\\\((\" +\n\t\t// To reduce the number of selectors needing tokenize in the preFilter, prefer arguments:\n\t\t// 1. quoted (capture 3; capture 4 or capture 5)\n\t\t\"('((?:\\\\\\\\.|[^\\\\\\\\'])*)'|\\\"((?:\\\\\\\\.|[^\\\\\\\\\\\"])*)\\\")|\" +\n\t\t// 2. simple (capture 6)\n\t\t\"((?:\\\\\\\\.|[^\\\\\\\\()[\\\\]]|\" + attributes + \")*)|\" +\n\t\t// 3. anything else (capture 2)\n\t\t\".*\" +\n\t\t\")\\\\)|)\",\n\n\t// Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter\n\trwhitespace = new RegExp( whitespace + \"+\", \"g\" ),\n\trtrim = new RegExp( \"^\" + whitespace + \"+|((?:^|[^\\\\\\\\])(?:\\\\\\\\.)*)\" + whitespace + \"+$\", \"g\" ),\n\n\trcomma = new RegExp( \"^\" + whitespace + \"*,\" + whitespace + \"*\" ),\n\trcombinators = new RegExp( \"^\" + whitespace + \"*([>+~]|\" + whitespace + \")\" + whitespace + \"*\" ),\n\n\trattributeQuotes = new RegExp( \"=\" + whitespace + \"*([^\\\\]'\\\"]*?)\" + whitespace + \"*\\\\]\", \"g\" ),\n\n\trpseudo = new RegExp( pseudos ),\n\tridentifier = new RegExp( \"^\" + identifier + \"$\" ),\n\n\tmatchExpr = {\n\t\t\"ID\": new RegExp( \"^#(\" + identifier + \")\" ),\n\t\t\"CLASS\": new RegExp( \"^\\\\.(\" + identifier + \")\" ),\n\t\t\"TAG\": new RegExp( \"^(\" + identifier + \"|[*])\" ),\n\t\t\"ATTR\": new RegExp( \"^\" + attributes ),\n\t\t\"PSEUDO\": new RegExp( \"^\" + pseudos ),\n\t\t\"CHILD\": new RegExp( \"^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\\\(\" + whitespace +\n\t\t\t\"*(even|odd|(([+-]|)(\\\\d*)n|)\" + whitespace + \"*(?:([+-]|)\" + whitespace +\n\t\t\t\"*(\\\\d+)|))\" + whitespace + \"*\\\\)|)\", \"i\" ),\n\t\t\"bool\": new RegExp( \"^(?:\" + booleans + \")$\", \"i\" ),\n\t\t// For use in libraries implementing .is()\n\t\t// We use this for POS matching in `select`\n\t\t\"needsContext\": new RegExp( \"^\" + whitespace + \"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\\\(\" +\n\t\t\twhitespace + \"*((?:-\\\\d)?\\\\d*)\" + whitespace + \"*\\\\)|)(?=[^-]|$)\", \"i\" )\n\t},\n\n\trinputs = /^(?:input|select|textarea|button)$/i,\n\trheader = /^h\\d$/i,\n\n\trnative = /^[^{]+\\{\\s*\\[native \\w/,\n\n\t// Easily-parseable/retrievable ID or TAG or CLASS selectors\n\trquickExpr = /^(?:#([\\w-]+)|(\\w+)|\\.([\\w-]+))$/,\n\n\trsibling = /[+~]/,\n\n\t// CSS escapes\n\t// http://www.w3.org/TR/CSS21/syndata.html#escaped-characters\n\trunescape = new RegExp( \"\\\\\\\\([\\\\da-f]{1,6}\" + whitespace + \"?|(\" + whitespace + \")|.)\", \"ig\" ),\n\tfunescape = function( _, escaped, escapedWhitespace ) {\n\t\tvar high = \"0x\" + escaped - 0x10000;\n\t\t// NaN means non-codepoint\n\t\t// Support: Firefox<24\n\t\t// Workaround erroneous numeric interpretation of +\"0x\"\n\t\treturn high !== high || escapedWhitespace ?\n\t\t\tescaped :\n\t\t\thigh < 0 ?\n\t\t\t\t// BMP codepoint\n\t\t\t\tString.fromCharCode( high + 0x10000 ) :\n\t\t\t\t// Supplemental Plane codepoint (surrogate pair)\n\t\t\t\tString.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 );\n\t},\n\n\t// CSS string/identifier serialization\n\t// https://drafts.csswg.org/cssom/#common-serializing-idioms\n\trcssescape = /([\\0-\\x1f\\x7f]|^-?\\d)|^-$|[^\\0-\\x1f\\x7f-\\uFFFF\\w-]/g,\n\tfcssescape = function( ch, asCodePoint ) {\n\t\tif ( asCodePoint ) {\n\n\t\t\t// U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER\n\t\t\tif ( ch === \"\\0\" ) {\n\t\t\t\treturn \"\\uFFFD\";\n\t\t\t}\n\n\t\t\t// Control characters and (dependent upon position) numbers get escaped as code points\n\t\t\treturn ch.slice( 0, -1 ) + \"\\\\\" + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + \" \";\n\t\t}\n\n\t\t// Other potentially-special ASCII characters get backslash-escaped\n\t\treturn \"\\\\\" + ch;\n\t},\n\n\t// Used for iframes\n\t// See setDocument()\n\t// Removing the function wrapper causes a \"Permission Denied\"\n\t// error in IE\n\tunloadHandler = function() {\n\t\tsetDocument();\n\t},\n\n\tdisabledAncestor = addCombinator(\n\t\tfunction( elem ) {\n\t\t\treturn elem.disabled === true && (\"form\" in elem || \"label\" in elem);\n\t\t},\n\t\t{ dir: \"parentNode\", next: \"legend\" }\n\t);\n\n// Optimize for push.apply( _, NodeList )\ntry {\n\tpush.apply(\n\t\t(arr = slice.call( preferredDoc.childNodes )),\n\t\tpreferredDoc.childNodes\n\t);\n\t// Support: Android<4.0\n\t// Detect silently failing push.apply\n\tarr[ preferredDoc.childNodes.length ].nodeType;\n} catch ( e ) {\n\tpush = { apply: arr.length ?\n\n\t\t// Leverage slice if possible\n\t\tfunction( target, els ) {\n\t\t\tpush_native.apply( target, slice.call(els) );\n\t\t} :\n\n\t\t// Support: IE<9\n\t\t// Otherwise append directly\n\t\tfunction( target, els ) {\n\t\t\tvar j = target.length,\n\t\t\t\ti = 0;\n\t\t\t// Can't trust NodeList.length\n\t\t\twhile ( (target[j++] = els[i++]) ) {}\n\t\t\ttarget.length = j - 1;\n\t\t}\n\t};\n}\n\nfunction Sizzle( selector, context, results, seed ) {\n\tvar m, i, elem, nid, match, groups, newSelector,\n\t\tnewContext = context && context.ownerDocument,\n\n\t\t// nodeType defaults to 9, since context defaults to document\n\t\tnodeType = context ? context.nodeType : 9;\n\n\tresults = results || [];\n\n\t// Return early from calls with invalid selector or context\n\tif ( typeof selector !== \"string\" || !selector ||\n\t\tnodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) {\n\n\t\treturn results;\n\t}\n\n\t// Try to shortcut find operations (as opposed to filters) in HTML documents\n\tif ( !seed ) {\n\n\t\tif ( ( context ? context.ownerDocument || context : preferredDoc ) !== document ) {\n\t\t\tsetDocument( context );\n\t\t}\n\t\tcontext = context || document;\n\n\t\tif ( documentIsHTML ) {\n\n\t\t\t// If the selector is sufficiently simple, try using a \"get*By*\" DOM method\n\t\t\t// (excepting DocumentFragment context, where the methods don't exist)\n\t\t\tif ( nodeType !== 11 && (match = rquickExpr.exec( selector )) ) {\n\n\t\t\t\t// ID selector\n\t\t\t\tif ( (m = match[1]) ) {\n\n\t\t\t\t\t// Document context\n\t\t\t\t\tif ( nodeType === 9 ) {\n\t\t\t\t\t\tif ( (elem = context.getElementById( m )) ) {\n\n\t\t\t\t\t\t\t// Support: IE, Opera, Webkit\n\t\t\t\t\t\t\t// TODO: identify versions\n\t\t\t\t\t\t\t// getElementById can match elements by name instead of ID\n\t\t\t\t\t\t\tif ( elem.id === m ) {\n\t\t\t\t\t\t\t\tresults.push( elem );\n\t\t\t\t\t\t\t\treturn results;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\treturn results;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t// Element context\n\t\t\t\t\t} else {\n\n\t\t\t\t\t\t// Support: IE, Opera, Webkit\n\t\t\t\t\t\t// TODO: identify versions\n\t\t\t\t\t\t// getElementById can match elements by name instead of ID\n\t\t\t\t\t\tif ( newContext && (elem = newContext.getElementById( m )) &&\n\t\t\t\t\t\t\tcontains( context, elem ) &&\n\t\t\t\t\t\t\telem.id === m ) {\n\n\t\t\t\t\t\t\tresults.push( elem );\n\t\t\t\t\t\t\treturn results;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t// Type selector\n\t\t\t\t} else if ( match[2] ) {\n\t\t\t\t\tpush.apply( results, context.getElementsByTagName( selector ) );\n\t\t\t\t\treturn results;\n\n\t\t\t\t// Class selector\n\t\t\t\t} else if ( (m = match[3]) && support.getElementsByClassName &&\n\t\t\t\t\tcontext.getElementsByClassName ) {\n\n\t\t\t\t\tpush.apply( results, context.getElementsByClassName( m ) );\n\t\t\t\t\treturn results;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Take advantage of querySelectorAll\n\t\t\tif ( support.qsa &&\n\t\t\t\t!compilerCache[ selector + \" \" ] &&\n\t\t\t\t(!rbuggyQSA || !rbuggyQSA.test( selector )) ) {\n\n\t\t\t\tif ( nodeType !== 1 ) {\n\t\t\t\t\tnewContext = context;\n\t\t\t\t\tnewSelector = selector;\n\n\t\t\t\t// qSA looks outside Element context, which is not what we want\n\t\t\t\t// Thanks to Andrew Dupont for this workaround technique\n\t\t\t\t// Support: IE <=8\n\t\t\t\t// Exclude object elements\n\t\t\t\t} else if ( context.nodeName.toLowerCase() !== \"object\" ) {\n\n\t\t\t\t\t// Capture the context ID, setting it first if necessary\n\t\t\t\t\tif ( (nid = context.getAttribute( \"id\" )) ) {\n\t\t\t\t\t\tnid = nid.replace( rcssescape, fcssescape );\n\t\t\t\t\t} else {\n\t\t\t\t\t\tcontext.setAttribute( \"id\", (nid = expando) );\n\t\t\t\t\t}\n\n\t\t\t\t\t// Prefix every selector in the list\n\t\t\t\t\tgroups = tokenize( selector );\n\t\t\t\t\ti = groups.length;\n\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\tgroups[i] = \"#\" + nid + \" \" + toSelector( groups[i] );\n\t\t\t\t\t}\n\t\t\t\t\tnewSelector = groups.join( \",\" );\n\n\t\t\t\t\t// Expand context for sibling selectors\n\t\t\t\t\tnewContext = rsibling.test( selector ) && testContext( context.parentNode ) ||\n\t\t\t\t\t\tcontext;\n\t\t\t\t}\n\n\t\t\t\tif ( newSelector ) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tpush.apply( results,\n\t\t\t\t\t\t\tnewContext.querySelectorAll( newSelector )\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn results;\n\t\t\t\t\t} catch ( qsaError ) {\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tif ( nid === expando ) {\n\t\t\t\t\t\t\tcontext.removeAttribute( \"id\" );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// All others\n\treturn select( selector.replace( rtrim, \"$1\" ), context, results, seed );\n}\n\n/**\n * Create key-value caches of limited size\n * @returns {function(string, object)} Returns the Object data after storing it on itself with\n *\tproperty name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength)\n *\tdeleting the oldest entry\n */\nfunction createCache() {\n\tvar keys = [];\n\n\tfunction cache( key, value ) {\n\t\t// Use (key + \" \") to avoid collision with native prototype properties (see Issue #157)\n\t\tif ( keys.push( key + \" \" ) > Expr.cacheLength ) {\n\t\t\t// Only keep the most recent entries\n\t\t\tdelete cache[ keys.shift() ];\n\t\t}\n\t\treturn (cache[ key + \" \" ] = value);\n\t}\n\treturn cache;\n}\n\n/**\n * Mark a function for special use by Sizzle\n * @param {Function} fn The function to mark\n */\nfunction markFunction( fn ) {\n\tfn[ expando ] = true;\n\treturn fn;\n}\n\n/**\n * Support testing using an element\n * @param {Function} fn Passed the created element and returns a boolean result\n */\nfunction assert( fn ) {\n\tvar el = document.createElement(\"fieldset\");\n\n\ttry {\n\t\treturn !!fn( el );\n\t} catch (e) {\n\t\treturn false;\n\t} finally {\n\t\t// Remove from its parent by default\n\t\tif ( el.parentNode ) {\n\t\t\tel.parentNode.removeChild( el );\n\t\t}\n\t\t// release memory in IE\n\t\tel = null;\n\t}\n}\n\n/**\n * Adds the same handler for all of the specified attrs\n * @param {String} attrs Pipe-separated list of attributes\n * @param {Function} handler The method that will be applied\n */\nfunction addHandle( attrs, handler ) {\n\tvar arr = attrs.split(\"|\"),\n\t\ti = arr.length;\n\n\twhile ( i-- ) {\n\t\tExpr.attrHandle[ arr[i] ] = handler;\n\t}\n}\n\n/**\n * Checks document order of two siblings\n * @param {Element} a\n * @param {Element} b\n * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b\n */\nfunction siblingCheck( a, b ) {\n\tvar cur = b && a,\n\t\tdiff = cur && a.nodeType === 1 && b.nodeType === 1 &&\n\t\t\ta.sourceIndex - b.sourceIndex;\n\n\t// Use IE sourceIndex if available on both nodes\n\tif ( diff ) {\n\t\treturn diff;\n\t}\n\n\t// Check if b follows a\n\tif ( cur ) {\n\t\twhile ( (cur = cur.nextSibling) ) {\n\t\t\tif ( cur === b ) {\n\t\t\t\treturn -1;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn a ? 1 : -1;\n}\n\n/**\n * Returns a function to use in pseudos for input types\n * @param {String} type\n */\nfunction createInputPseudo( type ) {\n\treturn function( elem ) {\n\t\tvar name = elem.nodeName.toLowerCase();\n\t\treturn name === \"input\" && elem.type === type;\n\t};\n}\n\n/**\n * Returns a function to use in pseudos for buttons\n * @param {String} type\n */\nfunction createButtonPseudo( type ) {\n\treturn function( elem ) {\n\t\tvar name = elem.nodeName.toLowerCase();\n\t\treturn (name === \"input\" || name === \"button\") && elem.type === type;\n\t};\n}\n\n/**\n * Returns a function to use in pseudos for :enabled/:disabled\n * @param {Boolean} disabled true for :disabled; false for :enabled\n */\nfunction createDisabledPseudo( disabled ) {\n\n\t// Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable\n\treturn function( elem ) {\n\n\t\t// Only certain elements can match :enabled or :disabled\n\t\t// https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled\n\t\t// https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled\n\t\tif ( \"form\" in elem ) {\n\n\t\t\t// Check for inherited disabledness on relevant non-disabled elements:\n\t\t\t// * listed form-associated elements in a disabled fieldset\n\t\t\t// https://html.spec.whatwg.org/multipage/forms.html#category-listed\n\t\t\t// https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled\n\t\t\t// * option elements in a disabled optgroup\n\t\t\t// https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled\n\t\t\t// All such elements have a \"form\" property.\n\t\t\tif ( elem.parentNode && elem.disabled === false ) {\n\n\t\t\t\t// Option elements defer to a parent optgroup if present\n\t\t\t\tif ( \"label\" in elem ) {\n\t\t\t\t\tif ( \"label\" in elem.parentNode ) {\n\t\t\t\t\t\treturn elem.parentNode.disabled === disabled;\n\t\t\t\t\t} else {\n\t\t\t\t\t\treturn elem.disabled === disabled;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t// Support: IE 6 - 11\n\t\t\t\t// Use the isDisabled shortcut property to check for disabled fieldset ancestors\n\t\t\t\treturn elem.isDisabled === disabled ||\n\n\t\t\t\t\t// Where there is no isDisabled, check manually\n\t\t\t\t\t/* jshint -W018 */\n\t\t\t\t\telem.isDisabled !== !disabled &&\n\t\t\t\t\t\tdisabledAncestor( elem ) === disabled;\n\t\t\t}\n\n\t\t\treturn elem.disabled === disabled;\n\n\t\t// Try to winnow out elements that can't be disabled before trusting the disabled property.\n\t\t// Some victims get caught in our net (label, legend, menu, track), but it shouldn't\n\t\t// even exist on them, let alone have a boolean value.\n\t\t} else if ( \"label\" in elem ) {\n\t\t\treturn elem.disabled === disabled;\n\t\t}\n\n\t\t// Remaining elements are neither :enabled nor :disabled\n\t\treturn false;\n\t};\n}\n\n/**\n * Returns a function to use in pseudos for positionals\n * @param {Function} fn\n */\nfunction createPositionalPseudo( fn ) {\n\treturn markFunction(function( argument ) {\n\t\targument = +argument;\n\t\treturn markFunction(function( seed, matches ) {\n\t\t\tvar j,\n\t\t\t\tmatchIndexes = fn( [], seed.length, argument ),\n\t\t\t\ti = matchIndexes.length;\n\n\t\t\t// Match elements found at the specified indexes\n\t\t\twhile ( i-- ) {\n\t\t\t\tif ( seed[ (j = matchIndexes[i]) ] ) {\n\t\t\t\t\tseed[j] = !(matches[j] = seed[j]);\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t});\n}\n\n/**\n * Checks a node for validity as a Sizzle context\n * @param {Element|Object=} context\n * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value\n */\nfunction testContext( context ) {\n\treturn context && typeof context.getElementsByTagName !== \"undefined\" && context;\n}\n\n// Expose support vars for convenience\nsupport = Sizzle.support = {};\n\n/**\n * Detects XML nodes\n * @param {Element|Object} elem An element or a document\n * @returns {Boolean} True iff elem is a non-HTML XML node\n */\nisXML = Sizzle.isXML = function( elem ) {\n\t// documentElement is verified for cases where it doesn't yet exist\n\t// (such as loading iframes in IE - #4833)\n\tvar documentElement = elem && (elem.ownerDocument || elem).documentElement;\n\treturn documentElement ? documentElement.nodeName !== \"HTML\" : false;\n};\n\n/**\n * Sets document-related variables once based on the current document\n * @param {Element|Object} [doc] An element or document object to use to set the document\n * @returns {Object} Returns the current document\n */\nsetDocument = Sizzle.setDocument = function( node ) {\n\tvar hasCompare, subWindow,\n\t\tdoc = node ? node.ownerDocument || node : preferredDoc;\n\n\t// Return early if doc is invalid or already selected\n\tif ( doc === document || doc.nodeType !== 9 || !doc.documentElement ) {\n\t\treturn document;\n\t}\n\n\t// Update global variables\n\tdocument = doc;\n\tdocElem = document.documentElement;\n\tdocumentIsHTML = !isXML( document );\n\n\t// Support: IE 9-11, Edge\n\t// Accessing iframe documents after unload throws \"permission denied\" errors (jQuery #13936)\n\tif ( preferredDoc !== document &&\n\t\t(subWindow = document.defaultView) && subWindow.top !== subWindow ) {\n\n\t\t// Support: IE 11, Edge\n\t\tif ( subWindow.addEventListener ) {\n\t\t\tsubWindow.addEventListener( \"unload\", unloadHandler, false );\n\n\t\t// Support: IE 9 - 10 only\n\t\t} else if ( subWindow.attachEvent ) {\n\t\t\tsubWindow.attachEvent( \"onunload\", unloadHandler );\n\t\t}\n\t}\n\n\t/* Attributes\n\t---------------------------------------------------------------------- */\n\n\t// Support: IE<8\n\t// Verify that getAttribute really returns attributes and not properties\n\t// (excepting IE8 booleans)\n\tsupport.attributes = assert(function( el ) {\n\t\tel.className = \"i\";\n\t\treturn !el.getAttribute(\"className\");\n\t});\n\n\t/* getElement(s)By*\n\t---------------------------------------------------------------------- */\n\n\t// Check if getElementsByTagName(\"*\") returns only elements\n\tsupport.getElementsByTagName = assert(function( el ) {\n\t\tel.appendChild( document.createComment(\"\") );\n\t\treturn !el.getElementsByTagName(\"*\").length;\n\t});\n\n\t// Support: IE<9\n\tsupport.getElementsByClassName = rnative.test( document.getElementsByClassName );\n\n\t// Support: IE<10\n\t// Check if getElementById returns elements by name\n\t// The broken getElementById methods don't pick up programmatically-set names,\n\t// so use a roundabout getElementsByName test\n\tsupport.getById = assert(function( el ) {\n\t\tdocElem.appendChild( el ).id = expando;\n\t\treturn !document.getElementsByName || !document.getElementsByName( expando ).length;\n\t});\n\n\t// ID filter and find\n\tif ( support.getById ) {\n\t\tExpr.filter[\"ID\"] = function( id ) {\n\t\t\tvar attrId = id.replace( runescape, funescape );\n\t\t\treturn function( elem ) {\n\t\t\t\treturn elem.getAttribute(\"id\") === attrId;\n\t\t\t};\n\t\t};\n\t\tExpr.find[\"ID\"] = function( id, context ) {\n\t\t\tif ( typeof context.getElementById !== \"undefined\" && documentIsHTML ) {\n\t\t\t\tvar elem = context.getElementById( id );\n\t\t\t\treturn elem ? [ elem ] : [];\n\t\t\t}\n\t\t};\n\t} else {\n\t\tExpr.filter[\"ID\"] = function( id ) {\n\t\t\tvar attrId = id.replace( runescape, funescape );\n\t\t\treturn function( elem ) {\n\t\t\t\tvar node = typeof elem.getAttributeNode !== \"undefined\" &&\n\t\t\t\t\telem.getAttributeNode(\"id\");\n\t\t\t\treturn node && node.value === attrId;\n\t\t\t};\n\t\t};\n\n\t\t// Support: IE 6 - 7 only\n\t\t// getElementById is not reliable as a find shortcut\n\t\tExpr.find[\"ID\"] = function( id, context ) {\n\t\t\tif ( typeof context.getElementById !== \"undefined\" && documentIsHTML ) {\n\t\t\t\tvar node, i, elems,\n\t\t\t\t\telem = context.getElementById( id );\n\n\t\t\t\tif ( elem ) {\n\n\t\t\t\t\t// Verify the id attribute\n\t\t\t\t\tnode = elem.getAttributeNode(\"id\");\n\t\t\t\t\tif ( node && node.value === id ) {\n\t\t\t\t\t\treturn [ elem ];\n\t\t\t\t\t}\n\n\t\t\t\t\t// Fall back on getElementsByName\n\t\t\t\t\telems = context.getElementsByName( id );\n\t\t\t\t\ti = 0;\n\t\t\t\t\twhile ( (elem = elems[i++]) ) {\n\t\t\t\t\t\tnode = elem.getAttributeNode(\"id\");\n\t\t\t\t\t\tif ( node && node.value === id ) {\n\t\t\t\t\t\t\treturn [ elem ];\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn [];\n\t\t\t}\n\t\t};\n\t}\n\n\t// Tag\n\tExpr.find[\"TAG\"] = support.getElementsByTagName ?\n\t\tfunction( tag, context ) {\n\t\t\tif ( typeof context.getElementsByTagName !== \"undefined\" ) {\n\t\t\t\treturn context.getElementsByTagName( tag );\n\n\t\t\t// DocumentFragment nodes don't have gEBTN\n\t\t\t} else if ( support.qsa ) {\n\t\t\t\treturn context.querySelectorAll( tag );\n\t\t\t}\n\t\t} :\n\n\t\tfunction( tag, context ) {\n\t\t\tvar elem,\n\t\t\t\ttmp = [],\n\t\t\t\ti = 0,\n\t\t\t\t// By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too\n\t\t\t\tresults = context.getElementsByTagName( tag );\n\n\t\t\t// Filter out possible comments\n\t\t\tif ( tag === \"*\" ) {\n\t\t\t\twhile ( (elem = results[i++]) ) {\n\t\t\t\t\tif ( elem.nodeType === 1 ) {\n\t\t\t\t\t\ttmp.push( elem );\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn tmp;\n\t\t\t}\n\t\t\treturn results;\n\t\t};\n\n\t// Class\n\tExpr.find[\"CLASS\"] = support.getElementsByClassName && function( className, context ) {\n\t\tif ( typeof context.getElementsByClassName !== \"undefined\" && documentIsHTML ) {\n\t\t\treturn context.getElementsByClassName( className );\n\t\t}\n\t};\n\n\t/* QSA/matchesSelector\n\t---------------------------------------------------------------------- */\n\n\t// QSA and matchesSelector support\n\n\t// matchesSelector(:active) reports false when true (IE9/Opera 11.5)\n\trbuggyMatches = [];\n\n\t// qSa(:focus) reports false when true (Chrome 21)\n\t// We allow this because of a bug in IE8/9 that throws an error\n\t// whenever `document.activeElement` is accessed on an iframe\n\t// So, we allow :focus to pass through QSA all the time to avoid the IE error\n\t// See https://bugs.jquery.com/ticket/13378\n\trbuggyQSA = [];\n\n\tif ( (support.qsa = rnative.test( document.querySelectorAll )) ) {\n\t\t// Build QSA regex\n\t\t// Regex strategy adopted from Diego Perini\n\t\tassert(function( el ) {\n\t\t\t// Select is set to empty string on purpose\n\t\t\t// This is to test IE's treatment of not explicitly\n\t\t\t// setting a boolean content attribute,\n\t\t\t// since its presence should be enough\n\t\t\t// https://bugs.jquery.com/ticket/12359\n\t\t\tdocElem.appendChild( el ).innerHTML = \"<a id='\" + expando + \"'></a>\" +\n\t\t\t\t\"<select id='\" + expando + \"-\\r\\\\' msallowcapture=''>\" +\n\t\t\t\t\"<option selected=''></option></select>\";\n\n\t\t\t// Support: IE8, Opera 11-12.16\n\t\t\t// Nothing should be selected when empty strings follow ^= or $= or *=\n\t\t\t// The test attribute must be unknown in Opera but \"safe\" for WinRT\n\t\t\t// https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section\n\t\t\tif ( el.querySelectorAll(\"[msallowcapture^='']\").length ) {\n\t\t\t\trbuggyQSA.push( \"[*^$]=\" + whitespace + \"*(?:''|\\\"\\\")\" );\n\t\t\t}\n\n\t\t\t// Support: IE8\n\t\t\t// Boolean attributes and \"value\" are not treated correctly\n\t\t\tif ( !el.querySelectorAll(\"[selected]\").length ) {\n\t\t\t\trbuggyQSA.push( \"\\\\[\" + whitespace + \"*(?:value|\" + booleans + \")\" );\n\t\t\t}\n\n\t\t\t// Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+\n\t\t\tif ( !el.querySelectorAll( \"[id~=\" + expando + \"-]\" ).length ) {\n\t\t\t\trbuggyQSA.push(\"~=\");\n\t\t\t}\n\n\t\t\t// Webkit/Opera - :checked should return selected option elements\n\t\t\t// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked\n\t\t\t// IE8 throws error here and will not see later tests\n\t\t\tif ( !el.querySelectorAll(\":checked\").length ) {\n\t\t\t\trbuggyQSA.push(\":checked\");\n\t\t\t}\n\n\t\t\t// Support: Safari 8+, iOS 8+\n\t\t\t// https://bugs.webkit.org/show_bug.cgi?id=136851\n\t\t\t// In-page `selector#id sibling-combinator selector` fails\n\t\t\tif ( !el.querySelectorAll( \"a#\" + expando + \"+*\" ).length ) {\n\t\t\t\trbuggyQSA.push(\".#.+[+~]\");\n\t\t\t}\n\t\t});\n\n\t\tassert(function( el ) {\n\t\t\tel.innerHTML = \"<a href='' disabled='disabled'></a>\" +\n\t\t\t\t\"<select disabled='disabled'><option/></select>\";\n\n\t\t\t// Support: Windows 8 Native Apps\n\t\t\t// The type and name attributes are restricted during .innerHTML assignment\n\t\t\tvar input = document.createElement(\"input\");\n\t\t\tinput.setAttribute( \"type\", \"hidden\" );\n\t\t\tel.appendChild( input ).setAttribute( \"name\", \"D\" );\n\n\t\t\t// Support: IE8\n\t\t\t// Enforce case-sensitivity of name attribute\n\t\t\tif ( el.querySelectorAll(\"[name=d]\").length ) {\n\t\t\t\trbuggyQSA.push( \"name\" + whitespace + \"*[*^$|!~]?=\" );\n\t\t\t}\n\n\t\t\t// FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled)\n\t\t\t// IE8 throws error here and will not see later tests\n\t\t\tif ( el.querySelectorAll(\":enabled\").length !== 2 ) {\n\t\t\t\trbuggyQSA.push( \":enabled\", \":disabled\" );\n\t\t\t}\n\n\t\t\t// Support: IE9-11+\n\t\t\t// IE's :disabled selector does not pick up the children of disabled fieldsets\n\t\t\tdocElem.appendChild( el ).disabled = true;\n\t\t\tif ( el.querySelectorAll(\":disabled\").length !== 2 ) {\n\t\t\t\trbuggyQSA.push( \":enabled\", \":disabled\" );\n\t\t\t}\n\n\t\t\t// Opera 10-11 does not throw on post-comma invalid pseudos\n\t\t\tel.querySelectorAll(\"*,:x\");\n\t\t\trbuggyQSA.push(\",.*:\");\n\t\t});\n\t}\n\n\tif ( (support.matchesSelector = rnative.test( (matches = docElem.matches ||\n\t\tdocElem.webkitMatchesSelector ||\n\t\tdocElem.mozMatchesSelector ||\n\t\tdocElem.oMatchesSelector ||\n\t\tdocElem.msMatchesSelector) )) ) {\n\n\t\tassert(function( el ) {\n\t\t\t// Check to see if it's possible to do matchesSelector\n\t\t\t// on a disconnected node (IE 9)\n\t\t\tsupport.disconnectedMatch = matches.call( el, \"*\" );\n\n\t\t\t// This should fail with an exception\n\t\t\t// Gecko does not error, returns false instead\n\t\t\tmatches.call( el, \"[s!='']:x\" );\n\t\t\trbuggyMatches.push( \"!=\", pseudos );\n\t\t});\n\t}\n\n\trbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join(\"|\") );\n\trbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join(\"|\") );\n\n\t/* Contains\n\t---------------------------------------------------------------------- */\n\thasCompare = rnative.test( docElem.compareDocumentPosition );\n\n\t// Element contains another\n\t// Purposefully self-exclusive\n\t// As in, an element does not contain itself\n\tcontains = hasCompare || rnative.test( docElem.contains ) ?\n\t\tfunction( a, b ) {\n\t\t\tvar adown = a.nodeType === 9 ? a.documentElement : a,\n\t\t\t\tbup = b && b.parentNode;\n\t\t\treturn a === bup || !!( bup && bup.nodeType === 1 && (\n\t\t\t\tadown.contains ?\n\t\t\t\t\tadown.contains( bup ) :\n\t\t\t\t\ta.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16\n\t\t\t));\n\t\t} :\n\t\tfunction( a, b ) {\n\t\t\tif ( b ) {\n\t\t\t\twhile ( (b = b.parentNode) ) {\n\t\t\t\t\tif ( b === a ) {\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn false;\n\t\t};\n\n\t/* Sorting\n\t---------------------------------------------------------------------- */\n\n\t// Document order sorting\n\tsortOrder = hasCompare ?\n\tfunction( a, b ) {\n\n\t\t// Flag for duplicate removal\n\t\tif ( a === b ) {\n\t\t\thasDuplicate = true;\n\t\t\treturn 0;\n\t\t}\n\n\t\t// Sort on method existence if only one input has compareDocumentPosition\n\t\tvar compare = !a.compareDocumentPosition - !b.compareDocumentPosition;\n\t\tif ( compare ) {\n\t\t\treturn compare;\n\t\t}\n\n\t\t// Calculate position if both inputs belong to the same document\n\t\tcompare = ( a.ownerDocument || a ) === ( b.ownerDocument || b ) ?\n\t\t\ta.compareDocumentPosition( b ) :\n\n\t\t\t// Otherwise we know they are disconnected\n\t\t\t1;\n\n\t\t// Disconnected nodes\n\t\tif ( compare & 1 ||\n\t\t\t(!support.sortDetached && b.compareDocumentPosition( a ) === compare) ) {\n\n\t\t\t// Choose the first element that is related to our preferred document\n\t\t\tif ( a === document || a.ownerDocument === preferredDoc && contains(preferredDoc, a) ) {\n\t\t\t\treturn -1;\n\t\t\t}\n\t\t\tif ( b === document || b.ownerDocument === preferredDoc && contains(preferredDoc, b) ) {\n\t\t\t\treturn 1;\n\t\t\t}\n\n\t\t\t// Maintain original order\n\t\t\treturn sortInput ?\n\t\t\t\t( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :\n\t\t\t\t0;\n\t\t}\n\n\t\treturn compare & 4 ? -1 : 1;\n\t} :\n\tfunction( a, b ) {\n\t\t// Exit early if the nodes are identical\n\t\tif ( a === b ) {\n\t\t\thasDuplicate = true;\n\t\t\treturn 0;\n\t\t}\n\n\t\tvar cur,\n\t\t\ti = 0,\n\t\t\taup = a.parentNode,\n\t\t\tbup = b.parentNode,\n\t\t\tap = [ a ],\n\t\t\tbp = [ b ];\n\n\t\t// Parentless nodes are either documents or disconnected\n\t\tif ( !aup || !bup ) {\n\t\t\treturn a === document ? -1 :\n\t\t\t\tb === document ? 1 :\n\t\t\t\taup ? -1 :\n\t\t\t\tbup ? 1 :\n\t\t\t\tsortInput ?\n\t\t\t\t( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :\n\t\t\t\t0;\n\n\t\t// If the nodes are siblings, we can do a quick check\n\t\t} else if ( aup === bup ) {\n\t\t\treturn siblingCheck( a, b );\n\t\t}\n\n\t\t// Otherwise we need full lists of their ancestors for comparison\n\t\tcur = a;\n\t\twhile ( (cur = cur.parentNode) ) {\n\t\t\tap.unshift( cur );\n\t\t}\n\t\tcur = b;\n\t\twhile ( (cur = cur.parentNode) ) {\n\t\t\tbp.unshift( cur );\n\t\t}\n\n\t\t// Walk down the tree looking for a discrepancy\n\t\twhile ( ap[i] === bp[i] ) {\n\t\t\ti++;\n\t\t}\n\n\t\treturn i ?\n\t\t\t// Do a sibling check if the nodes have a common ancestor\n\t\t\tsiblingCheck( ap[i], bp[i] ) :\n\n\t\t\t// Otherwise nodes in our document sort first\n\t\t\tap[i] === preferredDoc ? -1 :\n\t\t\tbp[i] === preferredDoc ? 1 :\n\t\t\t0;\n\t};\n\n\treturn document;\n};\n\nSizzle.matches = function( expr, elements ) {\n\treturn Sizzle( expr, null, null, elements );\n};\n\nSizzle.matchesSelector = function( elem, expr ) {\n\t// Set document vars if needed\n\tif ( ( elem.ownerDocument || elem ) !== document ) {\n\t\tsetDocument( elem );\n\t}\n\n\t// Make sure that attribute selectors are quoted\n\texpr = expr.replace( rattributeQuotes, \"='$1']\" );\n\n\tif ( support.matchesSelector && documentIsHTML &&\n\t\t!compilerCache[ expr + \" \" ] &&\n\t\t( !rbuggyMatches || !rbuggyMatches.test( expr ) ) &&\n\t\t( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) {\n\n\t\ttry {\n\t\t\tvar ret = matches.call( elem, expr );\n\n\t\t\t// IE 9's matchesSelector returns false on disconnected nodes\n\t\t\tif ( ret || support.disconnectedMatch ||\n\t\t\t\t\t// As well, disconnected nodes are said to be in a document\n\t\t\t\t\t// fragment in IE 9\n\t\t\t\t\telem.document && elem.document.nodeType !== 11 ) {\n\t\t\t\treturn ret;\n\t\t\t}\n\t\t} catch (e) {}\n\t}\n\n\treturn Sizzle( expr, document, null, [ elem ] ).length > 0;\n};\n\nSizzle.contains = function( context, elem ) {\n\t// Set document vars if needed\n\tif ( ( context.ownerDocument || context ) !== document ) {\n\t\tsetDocument( context );\n\t}\n\treturn contains( context, elem );\n};\n\nSizzle.attr = function( elem, name ) {\n\t// Set document vars if needed\n\tif ( ( elem.ownerDocument || elem ) !== document ) {\n\t\tsetDocument( elem );\n\t}\n\n\tvar fn = Expr.attrHandle[ name.toLowerCase() ],\n\t\t// Don't get fooled by Object.prototype properties (jQuery #13807)\n\t\tval = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ?\n\t\t\tfn( elem, name, !documentIsHTML ) :\n\t\t\tundefined;\n\n\treturn val !== undefined ?\n\t\tval :\n\t\tsupport.attributes || !documentIsHTML ?\n\t\t\telem.getAttribute( name ) :\n\t\t\t(val = elem.getAttributeNode(name)) && val.specified ?\n\t\t\t\tval.value :\n\t\t\t\tnull;\n};\n\nSizzle.escape = function( sel ) {\n\treturn (sel + \"\").replace( rcssescape, fcssescape );\n};\n\nSizzle.error = function( msg ) {\n\tthrow new Error( \"Syntax error, unrecognized expression: \" + msg );\n};\n\n/**\n * Document sorting and removing duplicates\n * @param {ArrayLike} results\n */\nSizzle.uniqueSort = function( results ) {\n\tvar elem,\n\t\tduplicates = [],\n\t\tj = 0,\n\t\ti = 0;\n\n\t// Unless we *know* we can detect duplicates, assume their presence\n\thasDuplicate = !support.detectDuplicates;\n\tsortInput = !support.sortStable && results.slice( 0 );\n\tresults.sort( sortOrder );\n\n\tif ( hasDuplicate ) {\n\t\twhile ( (elem = results[i++]) ) {\n\t\t\tif ( elem === results[ i ] ) {\n\t\t\t\tj = duplicates.push( i );\n\t\t\t}\n\t\t}\n\t\twhile ( j-- ) {\n\t\t\tresults.splice( duplicates[ j ], 1 );\n\t\t}\n\t}\n\n\t// Clear input after sorting to release objects\n\t// See https://github.com/jquery/sizzle/pull/225\n\tsortInput = null;\n\n\treturn results;\n};\n\n/**\n * Utility function for retrieving the text value of an array of DOM nodes\n * @param {Array|Element} elem\n */\ngetText = Sizzle.getText = function( elem ) {\n\tvar node,\n\t\tret = \"\",\n\t\ti = 0,\n\t\tnodeType = elem.nodeType;\n\n\tif ( !nodeType ) {\n\t\t// If no nodeType, this is expected to be an array\n\t\twhile ( (node = elem[i++]) ) {\n\t\t\t// Do not traverse comment nodes\n\t\t\tret += getText( node );\n\t\t}\n\t} else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) {\n\t\t// Use textContent for elements\n\t\t// innerText usage removed for consistency of new lines (jQuery #11153)\n\t\tif ( typeof elem.textContent === \"string\" ) {\n\t\t\treturn elem.textContent;\n\t\t} else {\n\t\t\t// Traverse its children\n\t\t\tfor ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {\n\t\t\t\tret += getText( elem );\n\t\t\t}\n\t\t}\n\t} else if ( nodeType === 3 || nodeType === 4 ) {\n\t\treturn elem.nodeValue;\n\t}\n\t// Do not include comment or processing instruction nodes\n\n\treturn ret;\n};\n\nExpr = Sizzle.selectors = {\n\n\t// Can be adjusted by the user\n\tcacheLength: 50,\n\n\tcreatePseudo: markFunction,\n\n\tmatch: matchExpr,\n\n\tattrHandle: {},\n\n\tfind: {},\n\n\trelative: {\n\t\t\">\": { dir: \"parentNode\", first: true },\n\t\t\" \": { dir: \"parentNode\" },\n\t\t\"+\": { dir: \"previousSibling\", first: true },\n\t\t\"~\": { dir: \"previousSibling\" }\n\t},\n\n\tpreFilter: {\n\t\t\"ATTR\": function( match ) {\n\t\t\tmatch[1] = match[1].replace( runescape, funescape );\n\n\t\t\t// Move the given value to match[3] whether quoted or unquoted\n\t\t\tmatch[3] = ( match[3] || match[4] || match[5] || \"\" ).replace( runescape, funescape );\n\n\t\t\tif ( match[2] === \"~=\" ) {\n\t\t\t\tmatch[3] = \" \" + match[3] + \" \";\n\t\t\t}\n\n\t\t\treturn match.slice( 0, 4 );\n\t\t},\n\n\t\t\"CHILD\": function( match ) {\n\t\t\t/* matches from matchExpr[\"CHILD\"]\n\t\t\t\t1 type (only|nth|...)\n\t\t\t\t2 what (child|of-type)\n\t\t\t\t3 argument (even|odd|\\d*|\\d*n([+-]\\d+)?|...)\n\t\t\t\t4 xn-component of xn+y argument ([+-]?\\d*n|)\n\t\t\t\t5 sign of xn-component\n\t\t\t\t6 x of xn-component\n\t\t\t\t7 sign of y-component\n\t\t\t\t8 y of y-component\n\t\t\t*/\n\t\t\tmatch[1] = match[1].toLowerCase();\n\n\t\t\tif ( match[1].slice( 0, 3 ) === \"nth\" ) {\n\t\t\t\t// nth-* requires argument\n\t\t\t\tif ( !match[3] ) {\n\t\t\t\t\tSizzle.error( match[0] );\n\t\t\t\t}\n\n\t\t\t\t// numeric x and y parameters for Expr.filter.CHILD\n\t\t\t\t// remember that false/true cast respectively to 0/1\n\t\t\t\tmatch[4] = +( match[4] ? match[5] + (match[6] || 1) : 2 * ( match[3] === \"even\" || match[3] === \"odd\" ) );\n\t\t\t\tmatch[5] = +( ( match[7] + match[8] ) || match[3] === \"odd\" );\n\n\t\t\t// other types prohibit arguments\n\t\t\t} else if ( match[3] ) {\n\t\t\t\tSizzle.error( match[0] );\n\t\t\t}\n\n\t\t\treturn match;\n\t\t},\n\n\t\t\"PSEUDO\": function( match ) {\n\t\t\tvar excess,\n\t\t\t\tunquoted = !match[6] && match[2];\n\n\t\t\tif ( matchExpr[\"CHILD\"].test( match[0] ) ) {\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\t// Accept quoted arguments as-is\n\t\t\tif ( match[3] ) {\n\t\t\t\tmatch[2] = match[4] || match[5] || \"\";\n\n\t\t\t// Strip excess characters from unquoted arguments\n\t\t\t} else if ( unquoted && rpseudo.test( unquoted ) &&\n\t\t\t\t// Get excess from tokenize (recursively)\n\t\t\t\t(excess = tokenize( unquoted, true )) &&\n\t\t\t\t// advance to the next closing parenthesis\n\t\t\t\t(excess = unquoted.indexOf( \")\", unquoted.length - excess ) - unquoted.length) ) {\n\n\t\t\t\t// excess is a negative index\n\t\t\t\tmatch[0] = match[0].slice( 0, excess );\n\t\t\t\tmatch[2] = unquoted.slice( 0, excess );\n\t\t\t}\n\n\t\t\t// Return only captures needed by the pseudo filter method (type and argument)\n\t\t\treturn match.slice( 0, 3 );\n\t\t}\n\t},\n\n\tfilter: {\n\n\t\t\"TAG\": function( nodeNameSelector ) {\n\t\t\tvar nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase();\n\t\t\treturn nodeNameSelector === \"*\" ?\n\t\t\t\tfunction() { return true; } :\n\t\t\t\tfunction( elem ) {\n\t\t\t\t\treturn elem.nodeName && elem.nodeName.toLowerCase() === nodeName;\n\t\t\t\t};\n\t\t},\n\n\t\t\"CLASS\": function( className ) {\n\t\t\tvar pattern = classCache[ className + \" \" ];\n\n\t\t\treturn pattern ||\n\t\t\t\t(pattern = new RegExp( \"(^|\" + whitespace + \")\" + className + \"(\" + whitespace + \"|$)\" )) &&\n\t\t\t\tclassCache( className, function( elem ) {\n\t\t\t\t\treturn pattern.test( typeof elem.className === \"string\" && elem.className || typeof elem.getAttribute !== \"undefined\" && elem.getAttribute(\"class\") || \"\" );\n\t\t\t\t});\n\t\t},\n\n\t\t\"ATTR\": function( name, operator, check ) {\n\t\t\treturn function( elem ) {\n\t\t\t\tvar result = Sizzle.attr( elem, name );\n\n\t\t\t\tif ( result == null ) {\n\t\t\t\t\treturn operator === \"!=\";\n\t\t\t\t}\n\t\t\t\tif ( !operator ) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\n\t\t\t\tresult += \"\";\n\n\t\t\t\treturn operator === \"=\" ? result === check :\n\t\t\t\t\toperator === \"!=\" ? result !== check :\n\t\t\t\t\toperator === \"^=\" ? check && result.indexOf( check ) === 0 :\n\t\t\t\t\toperator === \"*=\" ? check && result.indexOf( check ) > -1 :\n\t\t\t\t\toperator === \"$=\" ? check && result.slice( -check.length ) === check :\n\t\t\t\t\toperator === \"~=\" ? ( \" \" + result.replace( rwhitespace, \" \" ) + \" \" ).indexOf( check ) > -1 :\n\t\t\t\t\toperator === \"|=\" ? result === check || result.slice( 0, check.length + 1 ) === check + \"-\" :\n\t\t\t\t\tfalse;\n\t\t\t};\n\t\t},\n\n\t\t\"CHILD\": function( type, what, argument, first, last ) {\n\t\t\tvar simple = type.slice( 0, 3 ) !== \"nth\",\n\t\t\t\tforward = type.slice( -4 ) !== \"last\",\n\t\t\t\tofType = what === \"of-type\";\n\n\t\t\treturn first === 1 && last === 0 ?\n\n\t\t\t\t// Shortcut for :nth-*(n)\n\t\t\t\tfunction( elem ) {\n\t\t\t\t\treturn !!elem.parentNode;\n\t\t\t\t} :\n\n\t\t\t\tfunction( elem, context, xml ) {\n\t\t\t\t\tvar cache, uniqueCache, outerCache, node, nodeIndex, start,\n\t\t\t\t\t\tdir = simple !== forward ? \"nextSibling\" : \"previousSibling\",\n\t\t\t\t\t\tparent = elem.parentNode,\n\t\t\t\t\t\tname = ofType && elem.nodeName.toLowerCase(),\n\t\t\t\t\t\tuseCache = !xml && !ofType,\n\t\t\t\t\t\tdiff = false;\n\n\t\t\t\t\tif ( parent ) {\n\n\t\t\t\t\t\t// :(first|last|only)-(child|of-type)\n\t\t\t\t\t\tif ( simple ) {\n\t\t\t\t\t\t\twhile ( dir ) {\n\t\t\t\t\t\t\t\tnode = elem;\n\t\t\t\t\t\t\t\twhile ( (node = node[ dir ]) ) {\n\t\t\t\t\t\t\t\t\tif ( ofType ?\n\t\t\t\t\t\t\t\t\t\tnode.nodeName.toLowerCase() === name :\n\t\t\t\t\t\t\t\t\t\tnode.nodeType === 1 ) {\n\n\t\t\t\t\t\t\t\t\t\treturn false;\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t// Reverse direction for :only-* (if we haven't yet done so)\n\t\t\t\t\t\t\t\tstart = dir = type === \"only\" && !start && \"nextSibling\";\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\treturn true;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tstart = [ forward ? parent.firstChild : parent.lastChild ];\n\n\t\t\t\t\t\t// non-xml :nth-child(...) stores cache data on `parent`\n\t\t\t\t\t\tif ( forward && useCache ) {\n\n\t\t\t\t\t\t\t// Seek `elem` from a previously-cached index\n\n\t\t\t\t\t\t\t// ...in a gzip-friendly way\n\t\t\t\t\t\t\tnode = parent;\n\t\t\t\t\t\t\touterCache = node[ expando ] || (node[ expando ] = {});\n\n\t\t\t\t\t\t\t// Support: IE <9 only\n\t\t\t\t\t\t\t// Defend against cloned attroperties (jQuery gh-1709)\n\t\t\t\t\t\t\tuniqueCache = outerCache[ node.uniqueID ] ||\n\t\t\t\t\t\t\t\t(outerCache[ node.uniqueID ] = {});\n\n\t\t\t\t\t\t\tcache = uniqueCache[ type ] || [];\n\t\t\t\t\t\t\tnodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];\n\t\t\t\t\t\t\tdiff = nodeIndex && cache[ 2 ];\n\t\t\t\t\t\t\tnode = nodeIndex && parent.childNodes[ nodeIndex ];\n\n\t\t\t\t\t\t\twhile ( (node = ++nodeIndex && node && node[ dir ] ||\n\n\t\t\t\t\t\t\t\t// Fallback to seeking `elem` from the start\n\t\t\t\t\t\t\t\t(diff = nodeIndex = 0) || start.pop()) ) {\n\n\t\t\t\t\t\t\t\t// When found, cache indexes on `parent` and break\n\t\t\t\t\t\t\t\tif ( node.nodeType === 1 && ++diff && node === elem ) {\n\t\t\t\t\t\t\t\t\tuniqueCache[ type ] = [ dirruns, nodeIndex, diff ];\n\t\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t// Use previously-cached element index if available\n\t\t\t\t\t\t\tif ( useCache ) {\n\t\t\t\t\t\t\t\t// ...in a gzip-friendly way\n\t\t\t\t\t\t\t\tnode = elem;\n\t\t\t\t\t\t\t\touterCache = node[ expando ] || (node[ expando ] = {});\n\n\t\t\t\t\t\t\t\t// Support: IE <9 only\n\t\t\t\t\t\t\t\t// Defend against cloned attroperties (jQuery gh-1709)\n\t\t\t\t\t\t\t\tuniqueCache = outerCache[ node.uniqueID ] ||\n\t\t\t\t\t\t\t\t\t(outerCache[ node.uniqueID ] = {});\n\n\t\t\t\t\t\t\t\tcache = uniqueCache[ type ] || [];\n\t\t\t\t\t\t\t\tnodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];\n\t\t\t\t\t\t\t\tdiff = nodeIndex;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t// xml :nth-child(...)\n\t\t\t\t\t\t\t// or :nth-last-child(...) or :nth(-last)?-of-type(...)\n\t\t\t\t\t\t\tif ( diff === false ) {\n\t\t\t\t\t\t\t\t// Use the same loop as above to seek `elem` from the start\n\t\t\t\t\t\t\t\twhile ( (node = ++nodeIndex && node && node[ dir ] ||\n\t\t\t\t\t\t\t\t\t(diff = nodeIndex = 0) || start.pop()) ) {\n\n\t\t\t\t\t\t\t\t\tif ( ( ofType ?\n\t\t\t\t\t\t\t\t\t\tnode.nodeName.toLowerCase() === name :\n\t\t\t\t\t\t\t\t\t\tnode.nodeType === 1 ) &&\n\t\t\t\t\t\t\t\t\t\t++diff ) {\n\n\t\t\t\t\t\t\t\t\t\t// Cache the index of each encountered element\n\t\t\t\t\t\t\t\t\t\tif ( useCache ) {\n\t\t\t\t\t\t\t\t\t\t\touterCache = node[ expando ] || (node[ expando ] = {});\n\n\t\t\t\t\t\t\t\t\t\t\t// Support: IE <9 only\n\t\t\t\t\t\t\t\t\t\t\t// Defend against cloned attroperties (jQuery gh-1709)\n\t\t\t\t\t\t\t\t\t\t\tuniqueCache = outerCache[ node.uniqueID ] ||\n\t\t\t\t\t\t\t\t\t\t\t\t(outerCache[ node.uniqueID ] = {});\n\n\t\t\t\t\t\t\t\t\t\t\tuniqueCache[ type ] = [ dirruns, diff ];\n\t\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\t\tif ( node === elem ) {\n\t\t\t\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Incorporate the offset, then check against cycle size\n\t\t\t\t\t\tdiff -= last;\n\t\t\t\t\t\treturn diff === first || ( diff % first === 0 && diff / first >= 0 );\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t},\n\n\t\t\"PSEUDO\": function( pseudo, argument ) {\n\t\t\t// pseudo-class names are case-insensitive\n\t\t\t// http://www.w3.org/TR/selectors/#pseudo-classes\n\t\t\t// Prioritize by case sensitivity in case custom pseudos are added with uppercase letters\n\t\t\t// Remember that setFilters inherits from pseudos\n\t\t\tvar args,\n\t\t\t\tfn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] ||\n\t\t\t\t\tSizzle.error( \"unsupported pseudo: \" + pseudo );\n\n\t\t\t// The user may use createPseudo to indicate that\n\t\t\t// arguments are needed to create the filter function\n\t\t\t// just as Sizzle does\n\t\t\tif ( fn[ expando ] ) {\n\t\t\t\treturn fn( argument );\n\t\t\t}\n\n\t\t\t// But maintain support for old signatures\n\t\t\tif ( fn.length > 1 ) {\n\t\t\t\targs = [ pseudo, pseudo, \"\", argument ];\n\t\t\t\treturn Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ?\n\t\t\t\t\tmarkFunction(function( seed, matches ) {\n\t\t\t\t\t\tvar idx,\n\t\t\t\t\t\t\tmatched = fn( seed, argument ),\n\t\t\t\t\t\t\ti = matched.length;\n\t\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\t\tidx = indexOf( seed, matched[i] );\n\t\t\t\t\t\t\tseed[ idx ] = !( matches[ idx ] = matched[i] );\n\t\t\t\t\t\t}\n\t\t\t\t\t}) :\n\t\t\t\t\tfunction( elem ) {\n\t\t\t\t\t\treturn fn( elem, 0, args );\n\t\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn fn;\n\t\t}\n\t},\n\n\tpseudos: {\n\t\t// Potentially complex pseudos\n\t\t\"not\": markFunction(function( selector ) {\n\t\t\t// Trim the selector passed to compile\n\t\t\t// to avoid treating leading and trailing\n\t\t\t// spaces as combinators\n\t\t\tvar input = [],\n\t\t\t\tresults = [],\n\t\t\t\tmatcher = compile( selector.replace( rtrim, \"$1\" ) );\n\n\t\t\treturn matcher[ expando ] ?\n\t\t\t\tmarkFunction(function( seed, matches, context, xml ) {\n\t\t\t\t\tvar elem,\n\t\t\t\t\t\tunmatched = matcher( seed, null, xml, [] ),\n\t\t\t\t\t\ti = seed.length;\n\n\t\t\t\t\t// Match elements unmatched by `matcher`\n\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\tif ( (elem = unmatched[i]) ) {\n\t\t\t\t\t\t\tseed[i] = !(matches[i] = elem);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}) :\n\t\t\t\tfunction( elem, context, xml ) {\n\t\t\t\t\tinput[0] = elem;\n\t\t\t\t\tmatcher( input, null, xml, results );\n\t\t\t\t\t// Don't keep the element (issue #299)\n\t\t\t\t\tinput[0] = null;\n\t\t\t\t\treturn !results.pop();\n\t\t\t\t};\n\t\t}),\n\n\t\t\"has\": markFunction(function( selector ) {\n\t\t\treturn function( elem ) {\n\t\t\t\treturn Sizzle( selector, elem ).length > 0;\n\t\t\t};\n\t\t}),\n\n\t\t\"contains\": markFunction(function( text ) {\n\t\t\ttext = text.replace( runescape, funescape );\n\t\t\treturn function( elem ) {\n\t\t\t\treturn ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1;\n\t\t\t};\n\t\t}),\n\n\t\t// \"Whether an element is represented by a :lang() selector\n\t\t// is based solely on the element's language value\n\t\t// being equal to the identifier C,\n\t\t// or beginning with the identifier C immediately followed by \"-\".\n\t\t// The matching of C against the element's language value is performed case-insensitively.\n\t\t// The identifier C does not have to be a valid language name.\"\n\t\t// http://www.w3.org/TR/selectors/#lang-pseudo\n\t\t\"lang\": markFunction( function( lang ) {\n\t\t\t// lang value must be a valid identifier\n\t\t\tif ( !ridentifier.test(lang || \"\") ) {\n\t\t\t\tSizzle.error( \"unsupported lang: \" + lang );\n\t\t\t}\n\t\t\tlang = lang.replace( runescape, funescape ).toLowerCase();\n\t\t\treturn function( elem ) {\n\t\t\t\tvar elemLang;\n\t\t\t\tdo {\n\t\t\t\t\tif ( (elemLang = documentIsHTML ?\n\t\t\t\t\t\telem.lang :\n\t\t\t\t\t\telem.getAttribute(\"xml:lang\") || elem.getAttribute(\"lang\")) ) {\n\n\t\t\t\t\t\telemLang = elemLang.toLowerCase();\n\t\t\t\t\t\treturn elemLang === lang || elemLang.indexOf( lang + \"-\" ) === 0;\n\t\t\t\t\t}\n\t\t\t\t} while ( (elem = elem.parentNode) && elem.nodeType === 1 );\n\t\t\t\treturn false;\n\t\t\t};\n\t\t}),\n\n\t\t// Miscellaneous\n\t\t\"target\": function( elem ) {\n\t\t\tvar hash = window.location && window.location.hash;\n\t\t\treturn hash && hash.slice( 1 ) === elem.id;\n\t\t},\n\n\t\t\"root\": function( elem ) {\n\t\t\treturn elem === docElem;\n\t\t},\n\n\t\t\"focus\": function( elem ) {\n\t\t\treturn elem === document.activeElement && (!document.hasFocus || document.hasFocus()) && !!(elem.type || elem.href || ~elem.tabIndex);\n\t\t},\n\n\t\t// Boolean properties\n\t\t\"enabled\": createDisabledPseudo( false ),\n\t\t\"disabled\": createDisabledPseudo( true ),\n\n\t\t\"checked\": function( elem ) {\n\t\t\t// In CSS3, :checked should return both checked and selected elements\n\t\t\t// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked\n\t\t\tvar nodeName = elem.nodeName.toLowerCase();\n\t\t\treturn (nodeName === \"input\" && !!elem.checked) || (nodeName === \"option\" && !!elem.selected);\n\t\t},\n\n\t\t\"selected\": function( elem ) {\n\t\t\t// Accessing this property makes selected-by-default\n\t\t\t// options in Safari work properly\n\t\t\tif ( elem.parentNode ) {\n\t\t\t\telem.parentNode.selectedIndex;\n\t\t\t}\n\n\t\t\treturn elem.selected === true;\n\t\t},\n\n\t\t// Contents\n\t\t\"empty\": function( elem ) {\n\t\t\t// http://www.w3.org/TR/selectors/#empty-pseudo\n\t\t\t// :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5),\n\t\t\t// but not by others (comment: 8; processing instruction: 7; etc.)\n\t\t\t// nodeType < 6 works because attributes (2) do not appear as children\n\t\t\tfor ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {\n\t\t\t\tif ( elem.nodeType < 6 ) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn true;\n\t\t},\n\n\t\t\"parent\": function( elem ) {\n\t\t\treturn !Expr.pseudos[\"empty\"]( elem );\n\t\t},\n\n\t\t// Element/input types\n\t\t\"header\": function( elem ) {\n\t\t\treturn rheader.test( elem.nodeName );\n\t\t},\n\n\t\t\"input\": function( elem ) {\n\t\t\treturn rinputs.test( elem.nodeName );\n\t\t},\n\n\t\t\"button\": function( elem ) {\n\t\t\tvar name = elem.nodeName.toLowerCase();\n\t\t\treturn name === \"input\" && elem.type === \"button\" || name === \"button\";\n\t\t},\n\n\t\t\"text\": function( elem ) {\n\t\t\tvar attr;\n\t\t\treturn elem.nodeName.toLowerCase() === \"input\" &&\n\t\t\t\telem.type === \"text\" &&\n\n\t\t\t\t// Support: IE<8\n\t\t\t\t// New HTML5 attribute values (e.g., \"search\") appear with elem.type === \"text\"\n\t\t\t\t( (attr = elem.getAttribute(\"type\")) == null || attr.toLowerCase() === \"text\" );\n\t\t},\n\n\t\t// Position-in-collection\n\t\t\"first\": createPositionalPseudo(function() {\n\t\t\treturn [ 0 ];\n\t\t}),\n\n\t\t\"last\": createPositionalPseudo(function( matchIndexes, length ) {\n\t\t\treturn [ length - 1 ];\n\t\t}),\n\n\t\t\"eq\": createPositionalPseudo(function( matchIndexes, length, argument ) {\n\t\t\treturn [ argument < 0 ? argument + length : argument ];\n\t\t}),\n\n\t\t\"even\": createPositionalPseudo(function( matchIndexes, length ) {\n\t\t\tvar i = 0;\n\t\t\tfor ( ; i < length; i += 2 ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t}),\n\n\t\t\"odd\": createPositionalPseudo(function( matchIndexes, length ) {\n\t\t\tvar i = 1;\n\t\t\tfor ( ; i < length; i += 2 ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t}),\n\n\t\t\"lt\": createPositionalPseudo(function( matchIndexes, length, argument ) {\n\t\t\tvar i = argument < 0 ? argument + length : argument;\n\t\t\tfor ( ; --i >= 0; ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t}),\n\n\t\t\"gt\": createPositionalPseudo(function( matchIndexes, length, argument ) {\n\t\t\tvar i = argument < 0 ? argument + length : argument;\n\t\t\tfor ( ; ++i < length; ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t})\n\t}\n};\n\nExpr.pseudos[\"nth\"] = Expr.pseudos[\"eq\"];\n\n// Add button/input type pseudos\nfor ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) {\n\tExpr.pseudos[ i ] = createInputPseudo( i );\n}\nfor ( i in { submit: true, reset: true } ) {\n\tExpr.pseudos[ i ] = createButtonPseudo( i );\n}\n\n// Easy API for creating new setFilters\nfunction setFilters() {}\nsetFilters.prototype = Expr.filters = Expr.pseudos;\nExpr.setFilters = new setFilters();\n\ntokenize = Sizzle.tokenize = function( selector, parseOnly ) {\n\tvar matched, match, tokens, type,\n\t\tsoFar, groups, preFilters,\n\t\tcached = tokenCache[ selector + \" \" ];\n\n\tif ( cached ) {\n\t\treturn parseOnly ? 0 : cached.slice( 0 );\n\t}\n\n\tsoFar = selector;\n\tgroups = [];\n\tpreFilters = Expr.preFilter;\n\n\twhile ( soFar ) {\n\n\t\t// Comma and first run\n\t\tif ( !matched || (match = rcomma.exec( soFar )) ) {\n\t\t\tif ( match ) {\n\t\t\t\t// Don't consume trailing commas as valid\n\t\t\t\tsoFar = soFar.slice( match[0].length ) || soFar;\n\t\t\t}\n\t\t\tgroups.push( (tokens = []) );\n\t\t}\n\n\t\tmatched = false;\n\n\t\t// Combinators\n\t\tif ( (match = rcombinators.exec( soFar )) ) {\n\t\t\tmatched = match.shift();\n\t\t\ttokens.push({\n\t\t\t\tvalue: matched,\n\t\t\t\t// Cast descendant combinators to space\n\t\t\t\ttype: match[0].replace( rtrim, \" \" )\n\t\t\t});\n\t\t\tsoFar = soFar.slice( matched.length );\n\t\t}\n\n\t\t// Filters\n\t\tfor ( type in Expr.filter ) {\n\t\t\tif ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] ||\n\t\t\t\t(match = preFilters[ type ]( match ))) ) {\n\t\t\t\tmatched = match.shift();\n\t\t\t\ttokens.push({\n\t\t\t\t\tvalue: matched,\n\t\t\t\t\ttype: type,\n\t\t\t\t\tmatches: match\n\t\t\t\t});\n\t\t\t\tsoFar = soFar.slice( matched.length );\n\t\t\t}\n\t\t}\n\n\t\tif ( !matched ) {\n\t\t\tbreak;\n\t\t}\n\t}\n\n\t// Return the length of the invalid excess\n\t// if we're just parsing\n\t// Otherwise, throw an error or return tokens\n\treturn parseOnly ?\n\t\tsoFar.length :\n\t\tsoFar ?\n\t\t\tSizzle.error( selector ) :\n\t\t\t// Cache the tokens\n\t\t\ttokenCache( selector, groups ).slice( 0 );\n};\n\nfunction toSelector( tokens ) {\n\tvar i = 0,\n\t\tlen = tokens.length,\n\t\tselector = \"\";\n\tfor ( ; i < len; i++ ) {\n\t\tselector += tokens[i].value;\n\t}\n\treturn selector;\n}\n\nfunction addCombinator( matcher, combinator, base ) {\n\tvar dir = combinator.dir,\n\t\tskip = combinator.next,\n\t\tkey = skip || dir,\n\t\tcheckNonElements = base && key === \"parentNode\",\n\t\tdoneName = done++;\n\n\treturn combinator.first ?\n\t\t// Check against closest ancestor/preceding element\n\t\tfunction( elem, context, xml ) {\n\t\t\twhile ( (elem = elem[ dir ]) ) {\n\t\t\t\tif ( elem.nodeType === 1 || checkNonElements ) {\n\t\t\t\t\treturn matcher( elem, context, xml );\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn false;\n\t\t} :\n\n\t\t// Check against all ancestor/preceding elements\n\t\tfunction( elem, context, xml ) {\n\t\t\tvar oldCache, uniqueCache, outerCache,\n\t\t\t\tnewCache = [ dirruns, doneName ];\n\n\t\t\t// We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching\n\t\t\tif ( xml ) {\n\t\t\t\twhile ( (elem = elem[ dir ]) ) {\n\t\t\t\t\tif ( elem.nodeType === 1 || checkNonElements ) {\n\t\t\t\t\t\tif ( matcher( elem, context, xml ) ) {\n\t\t\t\t\t\t\treturn true;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\twhile ( (elem = elem[ dir ]) ) {\n\t\t\t\t\tif ( elem.nodeType === 1 || checkNonElements ) {\n\t\t\t\t\t\touterCache = elem[ expando ] || (elem[ expando ] = {});\n\n\t\t\t\t\t\t// Support: IE <9 only\n\t\t\t\t\t\t// Defend against cloned attroperties (jQuery gh-1709)\n\t\t\t\t\t\tuniqueCache = outerCache[ elem.uniqueID ] || (outerCache[ elem.uniqueID ] = {});\n\n\t\t\t\t\t\tif ( skip && skip === elem.nodeName.toLowerCase() ) {\n\t\t\t\t\t\t\telem = elem[ dir ] || elem;\n\t\t\t\t\t\t} else if ( (oldCache = uniqueCache[ key ]) &&\n\t\t\t\t\t\t\toldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) {\n\n\t\t\t\t\t\t\t// Assign to newCache so results back-propagate to previous elements\n\t\t\t\t\t\t\treturn (newCache[ 2 ] = oldCache[ 2 ]);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t// Reuse newcache so results back-propagate to previous elements\n\t\t\t\t\t\t\tuniqueCache[ key ] = newCache;\n\n\t\t\t\t\t\t\t// A match means we're done; a fail means we have to keep checking\n\t\t\t\t\t\t\tif ( (newCache[ 2 ] = matcher( elem, context, xml )) ) {\n\t\t\t\t\t\t\t\treturn true;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn false;\n\t\t};\n}\n\nfunction elementMatcher( matchers ) {\n\treturn matchers.length > 1 ?\n\t\tfunction( elem, context, xml ) {\n\t\t\tvar i = matchers.length;\n\t\t\twhile ( i-- ) {\n\t\t\t\tif ( !matchers[i]( elem, context, xml ) ) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn true;\n\t\t} :\n\t\tmatchers[0];\n}\n\nfunction multipleContexts( selector, contexts, results ) {\n\tvar i = 0,\n\t\tlen = contexts.length;\n\tfor ( ; i < len; i++ ) {\n\t\tSizzle( selector, contexts[i], results );\n\t}\n\treturn results;\n}\n\nfunction condense( unmatched, map, filter, context, xml ) {\n\tvar elem,\n\t\tnewUnmatched = [],\n\t\ti = 0,\n\t\tlen = unmatched.length,\n\t\tmapped = map != null;\n\n\tfor ( ; i < len; i++ ) {\n\t\tif ( (elem = unmatched[i]) ) {\n\t\t\tif ( !filter || filter( elem, context, xml ) ) {\n\t\t\t\tnewUnmatched.push( elem );\n\t\t\t\tif ( mapped ) {\n\t\t\t\t\tmap.push( i );\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\treturn newUnmatched;\n}\n\nfunction setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) {\n\tif ( postFilter && !postFilter[ expando ] ) {\n\t\tpostFilter = setMatcher( postFilter );\n\t}\n\tif ( postFinder && !postFinder[ expando ] ) {\n\t\tpostFinder = setMatcher( postFinder, postSelector );\n\t}\n\treturn markFunction(function( seed, results, context, xml ) {\n\t\tvar temp, i, elem,\n\t\t\tpreMap = [],\n\t\t\tpostMap = [],\n\t\t\tpreexisting = results.length,\n\n\t\t\t// Get initial elements from seed or context\n\t\t\telems = seed || multipleContexts( selector || \"*\", context.nodeType ? [ context ] : context, [] ),\n\n\t\t\t// Prefilter to get matcher input, preserving a map for seed-results synchronization\n\t\t\tmatcherIn = preFilter && ( seed || !selector ) ?\n\t\t\t\tcondense( elems, preMap, preFilter, context, xml ) :\n\t\t\t\telems,\n\n\t\t\tmatcherOut = matcher ?\n\t\t\t\t// If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results,\n\t\t\t\tpostFinder || ( seed ? preFilter : preexisting || postFilter ) ?\n\n\t\t\t\t\t// ...intermediate processing is necessary\n\t\t\t\t\t[] :\n\n\t\t\t\t\t// ...otherwise use results directly\n\t\t\t\t\tresults :\n\t\t\t\tmatcherIn;\n\n\t\t// Find primary matches\n\t\tif ( matcher ) {\n\t\t\tmatcher( matcherIn, matcherOut, context, xml );\n\t\t}\n\n\t\t// Apply postFilter\n\t\tif ( postFilter ) {\n\t\t\ttemp = condense( matcherOut, postMap );\n\t\t\tpostFilter( temp, [], context, xml );\n\n\t\t\t// Un-match failing elements by moving them back to matcherIn\n\t\t\ti = temp.length;\n\t\t\twhile ( i-- ) {\n\t\t\t\tif ( (elem = temp[i]) ) {\n\t\t\t\t\tmatcherOut[ postMap[i] ] = !(matcherIn[ postMap[i] ] = elem);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif ( seed ) {\n\t\t\tif ( postFinder || preFilter ) {\n\t\t\t\tif ( postFinder ) {\n\t\t\t\t\t// Get the final matcherOut by condensing this intermediate into postFinder contexts\n\t\t\t\t\ttemp = [];\n\t\t\t\t\ti = matcherOut.length;\n\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\tif ( (elem = matcherOut[i]) ) {\n\t\t\t\t\t\t\t// Restore matcherIn since elem is not yet a final match\n\t\t\t\t\t\t\ttemp.push( (matcherIn[i] = elem) );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tpostFinder( null, (matcherOut = []), temp, xml );\n\t\t\t\t}\n\n\t\t\t\t// Move matched elements from seed to results to keep them synchronized\n\t\t\t\ti = matcherOut.length;\n\t\t\t\twhile ( i-- ) {\n\t\t\t\t\tif ( (elem = matcherOut[i]) &&\n\t\t\t\t\t\t(temp = postFinder ? indexOf( seed, elem ) : preMap[i]) > -1 ) {\n\n\t\t\t\t\t\tseed[temp] = !(results[temp] = elem);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t// Add elements to results, through postFinder if defined\n\t\t} else {\n\t\t\tmatcherOut = condense(\n\t\t\t\tmatcherOut === results ?\n\t\t\t\t\tmatcherOut.splice( preexisting, matcherOut.length ) :\n\t\t\t\t\tmatcherOut\n\t\t\t);\n\t\t\tif ( postFinder ) {\n\t\t\t\tpostFinder( null, results, matcherOut, xml );\n\t\t\t} else {\n\t\t\t\tpush.apply( results, matcherOut );\n\t\t\t}\n\t\t}\n\t});\n}\n\nfunction matcherFromTokens( tokens ) {\n\tvar checkContext, matcher, j,\n\t\tlen = tokens.length,\n\t\tleadingRelative = Expr.relative[ tokens[0].type ],\n\t\timplicitRelative = leadingRelative || Expr.relative[\" \"],\n\t\ti = leadingRelative ? 1 : 0,\n\n\t\t// The foundational matcher ensures that elements are reachable from top-level context(s)\n\t\tmatchContext = addCombinator( function( elem ) {\n\t\t\treturn elem === checkContext;\n\t\t}, implicitRelative, true ),\n\t\tmatchAnyContext = addCombinator( function( elem ) {\n\t\t\treturn indexOf( checkContext, elem ) > -1;\n\t\t}, implicitRelative, true ),\n\t\tmatchers = [ function( elem, context, xml ) {\n\t\t\tvar ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || (\n\t\t\t\t(checkContext = context).nodeType ?\n\t\t\t\t\tmatchContext( elem, context, xml ) :\n\t\t\t\t\tmatchAnyContext( elem, context, xml ) );\n\t\t\t// Avoid hanging onto element (issue #299)\n\t\t\tcheckContext = null;\n\t\t\treturn ret;\n\t\t} ];\n\n\tfor ( ; i < len; i++ ) {\n\t\tif ( (matcher = Expr.relative[ tokens[i].type ]) ) {\n\t\t\tmatchers = [ addCombinator(elementMatcher( matchers ), matcher) ];\n\t\t} else {\n\t\t\tmatcher = Expr.filter[ tokens[i].type ].apply( null, tokens[i].matches );\n\n\t\t\t// Return special upon seeing a positional matcher\n\t\t\tif ( matcher[ expando ] ) {\n\t\t\t\t// Find the next relative operator (if any) for proper handling\n\t\t\t\tj = ++i;\n\t\t\t\tfor ( ; j < len; j++ ) {\n\t\t\t\t\tif ( Expr.relative[ tokens[j].type ] ) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn setMatcher(\n\t\t\t\t\ti > 1 && elementMatcher( matchers ),\n\t\t\t\t\ti > 1 && toSelector(\n\t\t\t\t\t\t// If the preceding token was a descendant combinator, insert an implicit any-element `*`\n\t\t\t\t\t\ttokens.slice( 0, i - 1 ).concat({ value: tokens[ i - 2 ].type === \" \" ? \"*\" : \"\" })\n\t\t\t\t\t).replace( rtrim, \"$1\" ),\n\t\t\t\t\tmatcher,\n\t\t\t\t\ti < j && matcherFromTokens( tokens.slice( i, j ) ),\n\t\t\t\t\tj < len && matcherFromTokens( (tokens = tokens.slice( j )) ),\n\t\t\t\t\tj < len && toSelector( tokens )\n\t\t\t\t);\n\t\t\t}\n\t\t\tmatchers.push( matcher );\n\t\t}\n\t}\n\n\treturn elementMatcher( matchers );\n}\n\nfunction matcherFromGroupMatchers( elementMatchers, setMatchers ) {\n\tvar bySet = setMatchers.length > 0,\n\t\tbyElement = elementMatchers.length > 0,\n\t\tsuperMatcher = function( seed, context, xml, results, outermost ) {\n\t\t\tvar elem, j, matcher,\n\t\t\t\tmatchedCount = 0,\n\t\t\t\ti = \"0\",\n\t\t\t\tunmatched = seed && [],\n\t\t\t\tsetMatched = [],\n\t\t\t\tcontextBackup = outermostContext,\n\t\t\t\t// We must always have either seed elements or outermost context\n\t\t\t\telems = seed || byElement && Expr.find[\"TAG\"]( \"*\", outermost ),\n\t\t\t\t// Use integer dirruns iff this is the outermost matcher\n\t\t\t\tdirrunsUnique = (dirruns += contextBackup == null ? 1 : Math.random() || 0.1),\n\t\t\t\tlen = elems.length;\n\n\t\t\tif ( outermost ) {\n\t\t\t\toutermostContext = context === document || context || outermost;\n\t\t\t}\n\n\t\t\t// Add elements passing elementMatchers directly to results\n\t\t\t// Support: IE<9, Safari\n\t\t\t// Tolerate NodeList properties (IE: \"length\"; Safari: <number>) matching elements by id\n\t\t\tfor ( ; i !== len && (elem = elems[i]) != null; i++ ) {\n\t\t\t\tif ( byElement && elem ) {\n\t\t\t\t\tj = 0;\n\t\t\t\t\tif ( !context && elem.ownerDocument !== document ) {\n\t\t\t\t\t\tsetDocument( elem );\n\t\t\t\t\t\txml = !documentIsHTML;\n\t\t\t\t\t}\n\t\t\t\t\twhile ( (matcher = elementMatchers[j++]) ) {\n\t\t\t\t\t\tif ( matcher( elem, context || document, xml) ) {\n\t\t\t\t\t\t\tresults.push( elem );\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tif ( outermost ) {\n\t\t\t\t\t\tdirruns = dirrunsUnique;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t// Track unmatched elements for set filters\n\t\t\t\tif ( bySet ) {\n\t\t\t\t\t// They will have gone through all possible matchers\n\t\t\t\t\tif ( (elem = !matcher && elem) ) {\n\t\t\t\t\t\tmatchedCount--;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Lengthen the array for every element, matched or not\n\t\t\t\t\tif ( seed ) {\n\t\t\t\t\t\tunmatched.push( elem );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// `i` is now the count of elements visited above, and adding it to `matchedCount`\n\t\t\t// makes the latter nonnegative.\n\t\t\tmatchedCount += i;\n\n\t\t\t// Apply set filters to unmatched elements\n\t\t\t// NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount`\n\t\t\t// equals `i`), unless we didn't visit _any_ elements in the above loop because we have\n\t\t\t// no element matchers and no seed.\n\t\t\t// Incrementing an initially-string \"0\" `i` allows `i` to remain a string only in that\n\t\t\t// case, which will result in a \"00\" `matchedCount` that differs from `i` but is also\n\t\t\t// numerically zero.\n\t\t\tif ( bySet && i !== matchedCount ) {\n\t\t\t\tj = 0;\n\t\t\t\twhile ( (matcher = setMatchers[j++]) ) {\n\t\t\t\t\tmatcher( unmatched, setMatched, context, xml );\n\t\t\t\t}\n\n\t\t\t\tif ( seed ) {\n\t\t\t\t\t// Reintegrate element matches to eliminate the need for sorting\n\t\t\t\t\tif ( matchedCount > 0 ) {\n\t\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\t\tif ( !(unmatched[i] || setMatched[i]) ) {\n\t\t\t\t\t\t\t\tsetMatched[i] = pop.call( results );\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Discard index placeholder values to get only actual matches\n\t\t\t\t\tsetMatched = condense( setMatched );\n\t\t\t\t}\n\n\t\t\t\t// Add matches to results\n\t\t\t\tpush.apply( results, setMatched );\n\n\t\t\t\t// Seedless set matches succeeding multiple successful matchers stipulate sorting\n\t\t\t\tif ( outermost && !seed && setMatched.length > 0 &&\n\t\t\t\t\t( matchedCount + setMatchers.length ) > 1 ) {\n\n\t\t\t\t\tSizzle.uniqueSort( results );\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Override manipulation of globals by nested matchers\n\t\t\tif ( outermost ) {\n\t\t\t\tdirruns = dirrunsUnique;\n\t\t\t\toutermostContext = contextBackup;\n\t\t\t}\n\n\t\t\treturn unmatched;\n\t\t};\n\n\treturn bySet ?\n\t\tmarkFunction( superMatcher ) :\n\t\tsuperMatcher;\n}\n\ncompile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) {\n\tvar i,\n\t\tsetMatchers = [],\n\t\telementMatchers = [],\n\t\tcached = compilerCache[ selector + \" \" ];\n\n\tif ( !cached ) {\n\t\t// Generate a function of recursive functions that can be used to check each element\n\t\tif ( !match ) {\n\t\t\tmatch = tokenize( selector );\n\t\t}\n\t\ti = match.length;\n\t\twhile ( i-- ) {\n\t\t\tcached = matcherFromTokens( match[i] );\n\t\t\tif ( cached[ expando ] ) {\n\t\t\t\tsetMatchers.push( cached );\n\t\t\t} else {\n\t\t\t\telementMatchers.push( cached );\n\t\t\t}\n\t\t}\n\n\t\t// Cache the compiled function\n\t\tcached = compilerCache( selector, matcherFromGroupMatchers( elementMatchers, setMatchers ) );\n\n\t\t// Save selector and tokenization\n\t\tcached.selector = selector;\n\t}\n\treturn cached;\n};\n\n/**\n * A low-level selection function that works with Sizzle's compiled\n * selector functions\n * @param {String|Function} selector A selector or a pre-compiled\n * selector function built with Sizzle.compile\n * @param {Element} context\n * @param {Array} [results]\n * @param {Array} [seed] A set of elements to match against\n */\nselect = Sizzle.select = function( selector, context, results, seed ) {\n\tvar i, tokens, token, type, find,\n\t\tcompiled = typeof selector === \"function\" && selector,\n\t\tmatch = !seed && tokenize( (selector = compiled.selector || selector) );\n\n\tresults = results || [];\n\n\t// Try to minimize operations if there is only one selector in the list and no seed\n\t// (the latter of which guarantees us context)\n\tif ( match.length === 1 ) {\n\n\t\t// Reduce context if the leading compound selector is an ID\n\t\ttokens = match[0] = match[0].slice( 0 );\n\t\tif ( tokens.length > 2 && (token = tokens[0]).type === \"ID\" &&\n\t\t\t\tcontext.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[1].type ] ) {\n\n\t\t\tcontext = ( Expr.find[\"ID\"]( token.matches[0].replace(runescape, funescape), context ) || [] )[0];\n\t\t\tif ( !context ) {\n\t\t\t\treturn results;\n\n\t\t\t// Precompiled matchers will still verify ancestry, so step up a level\n\t\t\t} else if ( compiled ) {\n\t\t\t\tcontext = context.parentNode;\n\t\t\t}\n\n\t\t\tselector = selector.slice( tokens.shift().value.length );\n\t\t}\n\n\t\t// Fetch a seed set for right-to-left matching\n\t\ti = matchExpr[\"needsContext\"].test( selector ) ? 0 : tokens.length;\n\t\twhile ( i-- ) {\n\t\t\ttoken = tokens[i];\n\n\t\t\t// Abort if we hit a combinator\n\t\t\tif ( Expr.relative[ (type = token.type) ] ) {\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tif ( (find = Expr.find[ type ]) ) {\n\t\t\t\t// Search, expanding context for leading sibling combinators\n\t\t\t\tif ( (seed = find(\n\t\t\t\t\ttoken.matches[0].replace( runescape, funescape ),\n\t\t\t\t\trsibling.test( tokens[0].type ) && testContext( context.parentNode ) || context\n\t\t\t\t)) ) {\n\n\t\t\t\t\t// If seed is empty or no tokens remain, we can return early\n\t\t\t\t\ttokens.splice( i, 1 );\n\t\t\t\t\tselector = seed.length && toSelector( tokens );\n\t\t\t\t\tif ( !selector ) {\n\t\t\t\t\t\tpush.apply( results, seed );\n\t\t\t\t\t\treturn results;\n\t\t\t\t\t}\n\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Compile and execute a filtering function if one is not provided\n\t// Provide `match` to avoid retokenization if we modified the selector above\n\t( compiled || compile( selector, match ) )(\n\t\tseed,\n\t\tcontext,\n\t\t!documentIsHTML,\n\t\tresults,\n\t\t!context || rsibling.test( selector ) && testContext( context.parentNode ) || context\n\t);\n\treturn results;\n};\n\n// One-time assignments\n\n// Sort stability\nsupport.sortStable = expando.split(\"\").sort( sortOrder ).join(\"\") === expando;\n\n// Support: Chrome 14-35+\n// Always assume duplicates if they aren't passed to the comparison function\nsupport.detectDuplicates = !!hasDuplicate;\n\n// Initialize against the default document\nsetDocument();\n\n// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27)\n// Detached nodes confoundingly follow *each other*\nsupport.sortDetached = assert(function( el ) {\n\t// Should return 1, but returns 4 (following)\n\treturn el.compareDocumentPosition( document.createElement(\"fieldset\") ) & 1;\n});\n\n// Support: IE<8\n// Prevent attribute/property \"interpolation\"\n// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx\nif ( !assert(function( el ) {\n\tel.innerHTML = \"<a href='#'></a>\";\n\treturn el.firstChild.getAttribute(\"href\") === \"#\" ;\n}) ) {\n\taddHandle( \"type|href|height|width\", function( elem, name, isXML ) {\n\t\tif ( !isXML ) {\n\t\t\treturn elem.getAttribute( name, name.toLowerCase() === \"type\" ? 1 : 2 );\n\t\t}\n\t});\n}\n\n// Support: IE<9\n// Use defaultValue in place of getAttribute(\"value\")\nif ( !support.attributes || !assert(function( el ) {\n\tel.innerHTML = \"<input/>\";\n\tel.firstChild.setAttribute( \"value\", \"\" );\n\treturn el.firstChild.getAttribute( \"value\" ) === \"\";\n}) ) {\n\taddHandle( \"value\", function( elem, name, isXML ) {\n\t\tif ( !isXML && elem.nodeName.toLowerCase() === \"input\" ) {\n\t\t\treturn elem.defaultValue;\n\t\t}\n\t});\n}\n\n// Support: IE<9\n// Use getAttributeNode to fetch booleans when getAttribute lies\nif ( !assert(function( el ) {\n\treturn el.getAttribute(\"disabled\") == null;\n}) ) {\n\taddHandle( booleans, function( elem, name, isXML ) {\n\t\tvar val;\n\t\tif ( !isXML ) {\n\t\t\treturn elem[ name ] === true ? name.toLowerCase() :\n\t\t\t\t\t(val = elem.getAttributeNode( name )) && val.specified ?\n\t\t\t\t\tval.value :\n\t\t\t\tnull;\n\t\t}\n\t});\n}\n\nreturn Sizzle;\n\n})( window );\n\n\n\njQuery.find = Sizzle;\njQuery.expr = Sizzle.selectors;\n\n// Deprecated\njQuery.expr[ \":\" ] = jQuery.expr.pseudos;\njQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort;\njQuery.text = Sizzle.getText;\njQuery.isXMLDoc = Sizzle.isXML;\njQuery.contains = Sizzle.contains;\njQuery.escapeSelector = Sizzle.escape;\n\n\n\n\nvar dir = function( elem, dir, until ) {\n\tvar matched = [],\n\t\ttruncate = until !== undefined;\n\n\twhile ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) {\n\t\tif ( elem.nodeType === 1 ) {\n\t\t\tif ( truncate && jQuery( elem ).is( until ) ) {\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tmatched.push( elem );\n\t\t}\n\t}\n\treturn matched;\n};\n\n\nvar siblings = function( n, elem ) {\n\tvar matched = [];\n\n\tfor ( ; n; n = n.nextSibling ) {\n\t\tif ( n.nodeType === 1 && n !== elem ) {\n\t\t\tmatched.push( n );\n\t\t}\n\t}\n\n\treturn matched;\n};\n\n\nvar rneedsContext = jQuery.expr.match.needsContext;\n\n\n\nfunction nodeName( elem, name ) {\n\n return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase();\n\n};\nvar rsingleTag = ( /^<([a-z][^\\/\\0>:\\x20\\t\\r\\n\\f]*)[\\x20\\t\\r\\n\\f]*\\/?>(?:<\\/\\1>|)$/i );\n\n\n\n// Implement the identical functionality for filter and not\nfunction winnow( elements, qualifier, not ) {\n\tif ( isFunction( qualifier ) ) {\n\t\treturn jQuery.grep( elements, function( elem, i ) {\n\t\t\treturn !!qualifier.call( elem, i, elem ) !== not;\n\t\t} );\n\t}\n\n\t// Single element\n\tif ( qualifier.nodeType ) {\n\t\treturn jQuery.grep( elements, function( elem ) {\n\t\t\treturn ( elem === qualifier ) !== not;\n\t\t} );\n\t}\n\n\t// Arraylike of elements (jQuery, arguments, Array)\n\tif ( typeof qualifier !== \"string\" ) {\n\t\treturn jQuery.grep( elements, function( elem ) {\n\t\t\treturn ( indexOf.call( qualifier, elem ) > -1 ) !== not;\n\t\t} );\n\t}\n\n\t// Filtered directly for both simple and complex selectors\n\treturn jQuery.filter( qualifier, elements, not );\n}\n\njQuery.filter = function( expr, elems, not ) {\n\tvar elem = elems[ 0 ];\n\n\tif ( not ) {\n\t\texpr = \":not(\" + expr + \")\";\n\t}\n\n\tif ( elems.length === 1 && elem.nodeType === 1 ) {\n\t\treturn jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : [];\n\t}\n\n\treturn jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) {\n\t\treturn elem.nodeType === 1;\n\t} ) );\n};\n\njQuery.fn.extend( {\n\tfind: function( selector ) {\n\t\tvar i, ret,\n\t\t\tlen = this.length,\n\t\t\tself = this;\n\n\t\tif ( typeof selector !== \"string\" ) {\n\t\t\treturn this.pushStack( jQuery( selector ).filter( function() {\n\t\t\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\t\t\tif ( jQuery.contains( self[ i ], this ) ) {\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} ) );\n\t\t}\n\n\t\tret = this.pushStack( [] );\n\n\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\tjQuery.find( selector, self[ i ], ret );\n\t\t}\n\n\t\treturn len > 1 ? jQuery.uniqueSort( ret ) : ret;\n\t},\n\tfilter: function( selector ) {\n\t\treturn this.pushStack( winnow( this, selector || [], false ) );\n\t},\n\tnot: function( selector ) {\n\t\treturn this.pushStack( winnow( this, selector || [], true ) );\n\t},\n\tis: function( selector ) {\n\t\treturn !!winnow(\n\t\t\tthis,\n\n\t\t\t// If this is a positional/relative selector, check membership in the returned set\n\t\t\t// so $(\"p:first\").is(\"p:last\") won't return true for a doc with two \"p\".\n\t\t\ttypeof selector === \"string\" && rneedsContext.test( selector ) ?\n\t\t\t\tjQuery( selector ) :\n\t\t\t\tselector || [],\n\t\t\tfalse\n\t\t).length;\n\t}\n} );\n\n\n// Initialize a jQuery object\n\n\n// A central reference to the root jQuery(document)\nvar rootjQuery,\n\n\t// A simple way to check for HTML strings\n\t// Prioritize #id over <tag> to avoid XSS via location.hash (#9521)\n\t// Strict HTML recognition (#11290: must start with <)\n\t// Shortcut simple #id case for speed\n\trquickExpr = /^(?:\\s*(<[\\w\\W]+>)[^>]*|#([\\w-]+))$/,\n\n\tinit = jQuery.fn.init = function( selector, context, root ) {\n\t\tvar match, elem;\n\n\t\t// HANDLE: $(\"\"), $(null), $(undefined), $(false)\n\t\tif ( !selector ) {\n\t\t\treturn this;\n\t\t}\n\n\t\t// Method init() accepts an alternate rootjQuery\n\t\t// so migrate can support jQuery.sub (gh-2101)\n\t\troot = root || rootjQuery;\n\n\t\t// Handle HTML strings\n\t\tif ( typeof selector === \"string\" ) {\n\t\t\tif ( selector[ 0 ] === \"<\" &&\n\t\t\t\tselector[ selector.length - 1 ] === \">\" &&\n\t\t\t\tselector.length >= 3 ) {\n\n\t\t\t\t// Assume that strings that start and end with <> are HTML and skip the regex check\n\t\t\t\tmatch = [ null, selector, null ];\n\n\t\t\t} else {\n\t\t\t\tmatch = rquickExpr.exec( selector );\n\t\t\t}\n\n\t\t\t// Match html or make sure no context is specified for #id\n\t\t\tif ( match && ( match[ 1 ] || !context ) ) {\n\n\t\t\t\t// HANDLE: $(html) -> $(array)\n\t\t\t\tif ( match[ 1 ] ) {\n\t\t\t\t\tcontext = context instanceof jQuery ? context[ 0 ] : context;\n\n\t\t\t\t\t// Option to run scripts is true for back-compat\n\t\t\t\t\t// Intentionally let the error be thrown if parseHTML is not present\n\t\t\t\t\tjQuery.merge( this, jQuery.parseHTML(\n\t\t\t\t\t\tmatch[ 1 ],\n\t\t\t\t\t\tcontext && context.nodeType ? context.ownerDocument || context : document,\n\t\t\t\t\t\ttrue\n\t\t\t\t\t) );\n\n\t\t\t\t\t// HANDLE: $(html, props)\n\t\t\t\t\tif ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) {\n\t\t\t\t\t\tfor ( match in context ) {\n\n\t\t\t\t\t\t\t// Properties of context are called as methods if possible\n\t\t\t\t\t\t\tif ( isFunction( this[ match ] ) ) {\n\t\t\t\t\t\t\t\tthis[ match ]( context[ match ] );\n\n\t\t\t\t\t\t\t// ...and otherwise set as attributes\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\tthis.attr( match, context[ match ] );\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\treturn this;\n\n\t\t\t\t// HANDLE: $(#id)\n\t\t\t\t} else {\n\t\t\t\t\telem = document.getElementById( match[ 2 ] );\n\n\t\t\t\t\tif ( elem ) {\n\n\t\t\t\t\t\t// Inject the element directly into the jQuery object\n\t\t\t\t\t\tthis[ 0 ] = elem;\n\t\t\t\t\t\tthis.length = 1;\n\t\t\t\t\t}\n\t\t\t\t\treturn this;\n\t\t\t\t}\n\n\t\t\t// HANDLE: $(expr, $(...))\n\t\t\t} else if ( !context || context.jquery ) {\n\t\t\t\treturn ( context || root ).find( selector );\n\n\t\t\t// HANDLE: $(expr, context)\n\t\t\t// (which is just equivalent to: $(context).find(expr)\n\t\t\t} else {\n\t\t\t\treturn this.constructor( context ).find( selector );\n\t\t\t}\n\n\t\t// HANDLE: $(DOMElement)\n\t\t} else if ( selector.nodeType ) {\n\t\t\tthis[ 0 ] = selector;\n\t\t\tthis.length = 1;\n\t\t\treturn this;\n\n\t\t// HANDLE: $(function)\n\t\t// Shortcut for document ready\n\t\t} else if ( isFunction( selector ) ) {\n\t\t\treturn root.ready !== undefined ?\n\t\t\t\troot.ready( selector ) :\n\n\t\t\t\t// Execute immediately if ready is not present\n\t\t\t\tselector( jQuery );\n\t\t}\n\n\t\treturn jQuery.makeArray( selector, this );\n\t};\n\n// Give the init function the jQuery prototype for later instantiation\ninit.prototype = jQuery.fn;\n\n// Initialize central reference\nrootjQuery = jQuery( document );\n\n\nvar rparentsprev = /^(?:parents|prev(?:Until|All))/,\n\n\t// Methods guaranteed to produce a unique set when starting from a unique set\n\tguaranteedUnique = {\n\t\tchildren: true,\n\t\tcontents: true,\n\t\tnext: true,\n\t\tprev: true\n\t};\n\njQuery.fn.extend( {\n\thas: function( target ) {\n\t\tvar targets = jQuery( target, this ),\n\t\t\tl = targets.length;\n\n\t\treturn this.filter( function() {\n\t\t\tvar i = 0;\n\t\t\tfor ( ; i < l; i++ ) {\n\t\t\t\tif ( jQuery.contains( this, targets[ i ] ) ) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t}\n\t\t} );\n\t},\n\n\tclosest: function( selectors, context ) {\n\t\tvar cur,\n\t\t\ti = 0,\n\t\t\tl = this.length,\n\t\t\tmatched = [],\n\t\t\ttargets = typeof selectors !== \"string\" && jQuery( selectors );\n\n\t\t// Positional selectors never match, since there's no _selection_ context\n\t\tif ( !rneedsContext.test( selectors ) ) {\n\t\t\tfor ( ; i < l; i++ ) {\n\t\t\t\tfor ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) {\n\n\t\t\t\t\t// Always skip document fragments\n\t\t\t\t\tif ( cur.nodeType < 11 && ( targets ?\n\t\t\t\t\t\ttargets.index( cur ) > -1 :\n\n\t\t\t\t\t\t// Don't pass non-elements to Sizzle\n\t\t\t\t\t\tcur.nodeType === 1 &&\n\t\t\t\t\t\t\tjQuery.find.matchesSelector( cur, selectors ) ) ) {\n\n\t\t\t\t\t\tmatched.push( cur );\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched );\n\t},\n\n\t// Determine the position of an element within the set\n\tindex: function( elem ) {\n\n\t\t// No argument, return index in parent\n\t\tif ( !elem ) {\n\t\t\treturn ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1;\n\t\t}\n\n\t\t// Index in selector\n\t\tif ( typeof elem === \"string\" ) {\n\t\t\treturn indexOf.call( jQuery( elem ), this[ 0 ] );\n\t\t}\n\n\t\t// Locate the position of the desired element\n\t\treturn indexOf.call( this,\n\n\t\t\t// If it receives a jQuery object, the first element is used\n\t\t\telem.jquery ? elem[ 0 ] : elem\n\t\t);\n\t},\n\n\tadd: function( selector, context ) {\n\t\treturn this.pushStack(\n\t\t\tjQuery.uniqueSort(\n\t\t\t\tjQuery.merge( this.get(), jQuery( selector, context ) )\n\t\t\t)\n\t\t);\n\t},\n\n\taddBack: function( selector ) {\n\t\treturn this.add( selector == null ?\n\t\t\tthis.prevObject : this.prevObject.filter( selector )\n\t\t);\n\t}\n} );\n\nfunction sibling( cur, dir ) {\n\twhile ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {}\n\treturn cur;\n}\n\njQuery.each( {\n\tparent: function( elem ) {\n\t\tvar parent = elem.parentNode;\n\t\treturn parent && parent.nodeType !== 11 ? parent : null;\n\t},\n\tparents: function( elem ) {\n\t\treturn dir( elem, \"parentNode\" );\n\t},\n\tparentsUntil: function( elem, i, until ) {\n\t\treturn dir( elem, \"parentNode\", until );\n\t},\n\tnext: function( elem ) {\n\t\treturn sibling( elem, \"nextSibling\" );\n\t},\n\tprev: function( elem ) {\n\t\treturn sibling( elem, \"previousSibling\" );\n\t},\n\tnextAll: function( elem ) {\n\t\treturn dir( elem, \"nextSibling\" );\n\t},\n\tprevAll: function( elem ) {\n\t\treturn dir( elem, \"previousSibling\" );\n\t},\n\tnextUntil: function( elem, i, until ) {\n\t\treturn dir( elem, \"nextSibling\", until );\n\t},\n\tprevUntil: function( elem, i, until ) {\n\t\treturn dir( elem, \"previousSibling\", until );\n\t},\n\tsiblings: function( elem ) {\n\t\treturn siblings( ( elem.parentNode || {} ).firstChild, elem );\n\t},\n\tchildren: function( elem ) {\n\t\treturn siblings( elem.firstChild );\n\t},\n\tcontents: function( elem ) {\n if ( nodeName( elem, \"iframe\" ) ) {\n return elem.contentDocument;\n }\n\n // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only\n // Treat the template element as a regular one in browsers that\n // don't support it.\n if ( nodeName( elem, \"template\" ) ) {\n elem = elem.content || elem;\n }\n\n return jQuery.merge( [], elem.childNodes );\n\t}\n}, function( name, fn ) {\n\tjQuery.fn[ name ] = function( until, selector ) {\n\t\tvar matched = jQuery.map( this, fn, until );\n\n\t\tif ( name.slice( -5 ) !== \"Until\" ) {\n\t\t\tselector = until;\n\t\t}\n\n\t\tif ( selector && typeof selector === \"string\" ) {\n\t\t\tmatched = jQuery.filter( selector, matched );\n\t\t}\n\n\t\tif ( this.length > 1 ) {\n\n\t\t\t// Remove duplicates\n\t\t\tif ( !guaranteedUnique[ name ] ) {\n\t\t\t\tjQuery.uniqueSort( matched );\n\t\t\t}\n\n\t\t\t// Reverse order for parents* and prev-derivatives\n\t\t\tif ( rparentsprev.test( name ) ) {\n\t\t\t\tmatched.reverse();\n\t\t\t}\n\t\t}\n\n\t\treturn this.pushStack( matched );\n\t};\n} );\nvar rnothtmlwhite = ( /[^\\x20\\t\\r\\n\\f]+/g );\n\n\n\n// Convert String-formatted options into Object-formatted ones\nfunction createOptions( options ) {\n\tvar object = {};\n\tjQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) {\n\t\tobject[ flag ] = true;\n\t} );\n\treturn object;\n}\n\n/*\n * Create a callback list using the following parameters:\n *\n *\toptions: an optional list of space-separated options that will change how\n *\t\t\tthe callback list behaves or a more traditional option object\n *\n * By default a callback list will act like an event callback list and can be\n * \"fired\" multiple times.\n *\n * Possible options:\n *\n *\tonce:\t\t\twill ensure the callback list can only be fired once (like a Deferred)\n *\n *\tmemory:\t\t\twill keep track of previous values and will call any callback added\n *\t\t\t\t\tafter the list has been fired right away with the latest \"memorized\"\n *\t\t\t\t\tvalues (like a Deferred)\n *\n *\tunique:\t\t\twill ensure a callback can only be added once (no duplicate in the list)\n *\n *\tstopOnFalse:\tinterrupt callings when a callback returns false\n *\n */\njQuery.Callbacks = function( options ) {\n\n\t// Convert options from String-formatted to Object-formatted if needed\n\t// (we check in cache first)\n\toptions = typeof options === \"string\" ?\n\t\tcreateOptions( options ) :\n\t\tjQuery.extend( {}, options );\n\n\tvar // Flag to know if list is currently firing\n\t\tfiring,\n\n\t\t// Last fire value for non-forgettable lists\n\t\tmemory,\n\n\t\t// Flag to know if list was already fired\n\t\tfired,\n\n\t\t// Flag to prevent firing\n\t\tlocked,\n\n\t\t// Actual callback list\n\t\tlist = [],\n\n\t\t// Queue of execution data for repeatable lists\n\t\tqueue = [],\n\n\t\t// Index of currently firing callback (modified by add/remove as needed)\n\t\tfiringIndex = -1,\n\n\t\t// Fire callbacks\n\t\tfire = function() {\n\n\t\t\t// Enforce single-firing\n\t\t\tlocked = locked || options.once;\n\n\t\t\t// Execute callbacks for all pending executions,\n\t\t\t// respecting firingIndex overrides and runtime changes\n\t\t\tfired = firing = true;\n\t\t\tfor ( ; queue.length; firingIndex = -1 ) {\n\t\t\t\tmemory = queue.shift();\n\t\t\t\twhile ( ++firingIndex < list.length ) {\n\n\t\t\t\t\t// Run callback and check for early termination\n\t\t\t\t\tif ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false &&\n\t\t\t\t\t\toptions.stopOnFalse ) {\n\n\t\t\t\t\t\t// Jump to end and forget the data so .add doesn't re-fire\n\t\t\t\t\t\tfiringIndex = list.length;\n\t\t\t\t\t\tmemory = false;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Forget the data if we're done with it\n\t\t\tif ( !options.memory ) {\n\t\t\t\tmemory = false;\n\t\t\t}\n\n\t\t\tfiring = false;\n\n\t\t\t// Clean up if we're done firing for good\n\t\t\tif ( locked ) {\n\n\t\t\t\t// Keep an empty list if we have data for future add calls\n\t\t\t\tif ( memory ) {\n\t\t\t\t\tlist = [];\n\n\t\t\t\t// Otherwise, this object is spent\n\t\t\t\t} else {\n\t\t\t\t\tlist = \"\";\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\n\t\t// Actual Callbacks object\n\t\tself = {\n\n\t\t\t// Add a callback or a collection of callbacks to the list\n\t\t\tadd: function() {\n\t\t\t\tif ( list ) {\n\n\t\t\t\t\t// If we have memory from a past run, we should fire after adding\n\t\t\t\t\tif ( memory && !firing ) {\n\t\t\t\t\t\tfiringIndex = list.length - 1;\n\t\t\t\t\t\tqueue.push( memory );\n\t\t\t\t\t}\n\n\t\t\t\t\t( function add( args ) {\n\t\t\t\t\t\tjQuery.each( args, function( _, arg ) {\n\t\t\t\t\t\t\tif ( isFunction( arg ) ) {\n\t\t\t\t\t\t\t\tif ( !options.unique || !self.has( arg ) ) {\n\t\t\t\t\t\t\t\t\tlist.push( arg );\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t} else if ( arg && arg.length && toType( arg ) !== \"string\" ) {\n\n\t\t\t\t\t\t\t\t// Inspect recursively\n\t\t\t\t\t\t\t\tadd( arg );\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} );\n\t\t\t\t\t} )( arguments );\n\n\t\t\t\t\tif ( memory && !firing ) {\n\t\t\t\t\t\tfire();\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn this;\n\t\t\t},\n\n\t\t\t// Remove a callback from the list\n\t\t\tremove: function() {\n\t\t\t\tjQuery.each( arguments, function( _, arg ) {\n\t\t\t\t\tvar index;\n\t\t\t\t\twhile ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) {\n\t\t\t\t\t\tlist.splice( index, 1 );\n\n\t\t\t\t\t\t// Handle firing indexes\n\t\t\t\t\t\tif ( index <= firingIndex ) {\n\t\t\t\t\t\t\tfiringIndex--;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t} );\n\t\t\t\treturn this;\n\t\t\t},\n\n\t\t\t// Check if a given callback is in the list.\n\t\t\t// If no argument is given, return whether or not list has callbacks attached.\n\t\t\thas: function( fn ) {\n\t\t\t\treturn fn ?\n\t\t\t\t\tjQuery.inArray( fn, list ) > -1 :\n\t\t\t\t\tlist.length > 0;\n\t\t\t},\n\n\t\t\t// Remove all callbacks from the list\n\t\t\tempty: function() {\n\t\t\t\tif ( list ) {\n\t\t\t\t\tlist = [];\n\t\t\t\t}\n\t\t\t\treturn this;\n\t\t\t},\n\n\t\t\t// Disable .fire and .add\n\t\t\t// Abort any current/pending executions\n\t\t\t// Clear all callbacks and values\n\t\t\tdisable: function() {\n\t\t\t\tlocked = queue = [];\n\t\t\t\tlist = memory = \"\";\n\t\t\t\treturn this;\n\t\t\t},\n\t\t\tdisabled: function() {\n\t\t\t\treturn !list;\n\t\t\t},\n\n\t\t\t// Disable .fire\n\t\t\t// Also disable .add unless we have memory (since it would have no effect)\n\t\t\t// Abort any pending executions\n\t\t\tlock: function() {\n\t\t\t\tlocked = queue = [];\n\t\t\t\tif ( !memory && !firing ) {\n\t\t\t\t\tlist = memory = \"\";\n\t\t\t\t}\n\t\t\t\treturn this;\n\t\t\t},\n\t\t\tlocked: function() {\n\t\t\t\treturn !!locked;\n\t\t\t},\n\n\t\t\t// Call all callbacks with the given context and arguments\n\t\t\tfireWith: function( context, args ) {\n\t\t\t\tif ( !locked ) {\n\t\t\t\t\targs = args || [];\n\t\t\t\t\targs = [ context, args.slice ? args.slice() : args ];\n\t\t\t\t\tqueue.push( args );\n\t\t\t\t\tif ( !firing ) {\n\t\t\t\t\t\tfire();\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn this;\n\t\t\t},\n\n\t\t\t// Call all the callbacks with the given arguments\n\t\t\tfire: function() {\n\t\t\t\tself.fireWith( this, arguments );\n\t\t\t\treturn this;\n\t\t\t},\n\n\t\t\t// To know if the callbacks have already been called at least once\n\t\t\tfired: function() {\n\t\t\t\treturn !!fired;\n\t\t\t}\n\t\t};\n\n\treturn self;\n};\n\n\nfunction Identity( v ) {\n\treturn v;\n}\nfunction Thrower( ex ) {\n\tthrow ex;\n}\n\nfunction adoptValue( value, resolve, reject, noValue ) {\n\tvar method;\n\n\ttry {\n\n\t\t// Check for promise aspect first to privilege synchronous behavior\n\t\tif ( value && isFunction( ( method = value.promise ) ) ) {\n\t\t\tmethod.call( value ).done( resolve ).fail( reject );\n\n\t\t// Other thenables\n\t\t} else if ( value && isFunction( ( method = value.then ) ) ) {\n\t\t\tmethod.call( value, resolve, reject );\n\n\t\t// Other non-thenables\n\t\t} else {\n\n\t\t\t// Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer:\n\t\t\t// * false: [ value ].slice( 0 ) => resolve( value )\n\t\t\t// * true: [ value ].slice( 1 ) => resolve()\n\t\t\tresolve.apply( undefined, [ value ].slice( noValue ) );\n\t\t}\n\n\t// For Promises/A+, convert exceptions into rejections\n\t// Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in\n\t// Deferred#then to conditionally suppress rejection.\n\t} catch ( value ) {\n\n\t\t// Support: Android 4.0 only\n\t\t// Strict mode functions invoked without .call/.apply get global-object context\n\t\treject.apply( undefined, [ value ] );\n\t}\n}\n\njQuery.extend( {\n\n\tDeferred: function( func ) {\n\t\tvar tuples = [\n\n\t\t\t\t// action, add listener, callbacks,\n\t\t\t\t// ... .then handlers, argument index, [final state]\n\t\t\t\t[ \"notify\", \"progress\", jQuery.Callbacks( \"memory\" ),\n\t\t\t\t\tjQuery.Callbacks( \"memory\" ), 2 ],\n\t\t\t\t[ \"resolve\", \"done\", jQuery.Callbacks( \"once memory\" ),\n\t\t\t\t\tjQuery.Callbacks( \"once memory\" ), 0, \"resolved\" ],\n\t\t\t\t[ \"reject\", \"fail\", jQuery.Callbacks( \"once memory\" ),\n\t\t\t\t\tjQuery.Callbacks( \"once memory\" ), 1, \"rejected\" ]\n\t\t\t],\n\t\t\tstate = \"pending\",\n\t\t\tpromise = {\n\t\t\t\tstate: function() {\n\t\t\t\t\treturn state;\n\t\t\t\t},\n\t\t\t\talways: function() {\n\t\t\t\t\tdeferred.done( arguments ).fail( arguments );\n\t\t\t\t\treturn this;\n\t\t\t\t},\n\t\t\t\t\"catch\": function( fn ) {\n\t\t\t\t\treturn promise.then( null, fn );\n\t\t\t\t},\n\n\t\t\t\t// Keep pipe for back-compat\n\t\t\t\tpipe: function( /* fnDone, fnFail, fnProgress */ ) {\n\t\t\t\t\tvar fns = arguments;\n\n\t\t\t\t\treturn jQuery.Deferred( function( newDefer ) {\n\t\t\t\t\t\tjQuery.each( tuples, function( i, tuple ) {\n\n\t\t\t\t\t\t\t// Map tuples (progress, done, fail) to arguments (done, fail, progress)\n\t\t\t\t\t\t\tvar fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ];\n\n\t\t\t\t\t\t\t// deferred.progress(function() { bind to newDefer or newDefer.notify })\n\t\t\t\t\t\t\t// deferred.done(function() { bind to newDefer or newDefer.resolve })\n\t\t\t\t\t\t\t// deferred.fail(function() { bind to newDefer or newDefer.reject })\n\t\t\t\t\t\t\tdeferred[ tuple[ 1 ] ]( function() {\n\t\t\t\t\t\t\t\tvar returned = fn && fn.apply( this, arguments );\n\t\t\t\t\t\t\t\tif ( returned && isFunction( returned.promise ) ) {\n\t\t\t\t\t\t\t\t\treturned.promise()\n\t\t\t\t\t\t\t\t\t\t.progress( newDefer.notify )\n\t\t\t\t\t\t\t\t\t\t.done( newDefer.resolve )\n\t\t\t\t\t\t\t\t\t\t.fail( newDefer.reject );\n\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\tnewDefer[ tuple[ 0 ] + \"With\" ](\n\t\t\t\t\t\t\t\t\t\tthis,\n\t\t\t\t\t\t\t\t\t\tfn ? [ returned ] : arguments\n\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t} );\n\t\t\t\t\t\t} );\n\t\t\t\t\t\tfns = null;\n\t\t\t\t\t} ).promise();\n\t\t\t\t},\n\t\t\t\tthen: function( onFulfilled, onRejected, onProgress ) {\n\t\t\t\t\tvar maxDepth = 0;\n\t\t\t\t\tfunction resolve( depth, deferred, handler, special ) {\n\t\t\t\t\t\treturn function() {\n\t\t\t\t\t\t\tvar that = this,\n\t\t\t\t\t\t\t\targs = arguments,\n\t\t\t\t\t\t\t\tmightThrow = function() {\n\t\t\t\t\t\t\t\t\tvar returned, then;\n\n\t\t\t\t\t\t\t\t\t// Support: Promises/A+ section 2.3.3.3.3\n\t\t\t\t\t\t\t\t\t// https://promisesaplus.com/#point-59\n\t\t\t\t\t\t\t\t\t// Ignore double-resolution attempts\n\t\t\t\t\t\t\t\t\tif ( depth < maxDepth ) {\n\t\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\treturned = handler.apply( that, args );\n\n\t\t\t\t\t\t\t\t\t// Support: Promises/A+ section 2.3.1\n\t\t\t\t\t\t\t\t\t// https://promisesaplus.com/#point-48\n\t\t\t\t\t\t\t\t\tif ( returned === deferred.promise() ) {\n\t\t\t\t\t\t\t\t\t\tthrow new TypeError( \"Thenable self-resolution\" );\n\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\t// Support: Promises/A+ sections 2.3.3.1, 3.5\n\t\t\t\t\t\t\t\t\t// https://promisesaplus.com/#point-54\n\t\t\t\t\t\t\t\t\t// https://promisesaplus.com/#point-75\n\t\t\t\t\t\t\t\t\t// Retrieve `then` only once\n\t\t\t\t\t\t\t\t\tthen = returned &&\n\n\t\t\t\t\t\t\t\t\t\t// Support: Promises/A+ section 2.3.4\n\t\t\t\t\t\t\t\t\t\t// https://promisesaplus.com/#point-64\n\t\t\t\t\t\t\t\t\t\t// Only check objects and functions for thenability\n\t\t\t\t\t\t\t\t\t\t( typeof returned === \"object\" ||\n\t\t\t\t\t\t\t\t\t\t\ttypeof returned === \"function\" ) &&\n\t\t\t\t\t\t\t\t\t\treturned.then;\n\n\t\t\t\t\t\t\t\t\t// Handle a returned thenable\n\t\t\t\t\t\t\t\t\tif ( isFunction( then ) ) {\n\n\t\t\t\t\t\t\t\t\t\t// Special processors (notify) just wait for resolution\n\t\t\t\t\t\t\t\t\t\tif ( special ) {\n\t\t\t\t\t\t\t\t\t\t\tthen.call(\n\t\t\t\t\t\t\t\t\t\t\t\treturned,\n\t\t\t\t\t\t\t\t\t\t\t\tresolve( maxDepth, deferred, Identity, special ),\n\t\t\t\t\t\t\t\t\t\t\t\tresolve( maxDepth, deferred, Thrower, special )\n\t\t\t\t\t\t\t\t\t\t\t);\n\n\t\t\t\t\t\t\t\t\t\t// Normal processors (resolve) also hook into progress\n\t\t\t\t\t\t\t\t\t\t} else {\n\n\t\t\t\t\t\t\t\t\t\t\t// ...and disregard older resolution values\n\t\t\t\t\t\t\t\t\t\t\tmaxDepth++;\n\n\t\t\t\t\t\t\t\t\t\t\tthen.call(\n\t\t\t\t\t\t\t\t\t\t\t\treturned,\n\t\t\t\t\t\t\t\t\t\t\t\tresolve( maxDepth, deferred, Identity, special ),\n\t\t\t\t\t\t\t\t\t\t\t\tresolve( maxDepth, deferred, Thrower, special ),\n\t\t\t\t\t\t\t\t\t\t\t\tresolve( maxDepth, deferred, Identity,\n\t\t\t\t\t\t\t\t\t\t\t\t\tdeferred.notifyWith )\n\t\t\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\t// Handle all other returned values\n\t\t\t\t\t\t\t\t\t} else {\n\n\t\t\t\t\t\t\t\t\t\t// Only substitute handlers pass on context\n\t\t\t\t\t\t\t\t\t\t// and multiple values (non-spec behavior)\n\t\t\t\t\t\t\t\t\t\tif ( handler !== Identity ) {\n\t\t\t\t\t\t\t\t\t\t\tthat = undefined;\n\t\t\t\t\t\t\t\t\t\t\targs = [ returned ];\n\t\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\t\t// Process the value(s)\n\t\t\t\t\t\t\t\t\t\t// Default process is resolve\n\t\t\t\t\t\t\t\t\t\t( special || deferred.resolveWith )( that, args );\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t},\n\n\t\t\t\t\t\t\t\t// Only normal processors (resolve) catch and reject exceptions\n\t\t\t\t\t\t\t\tprocess = special ?\n\t\t\t\t\t\t\t\t\tmightThrow :\n\t\t\t\t\t\t\t\t\tfunction() {\n\t\t\t\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\t\t\t\tmightThrow();\n\t\t\t\t\t\t\t\t\t\t} catch ( e ) {\n\n\t\t\t\t\t\t\t\t\t\t\tif ( jQuery.Deferred.exceptionHook ) {\n\t\t\t\t\t\t\t\t\t\t\t\tjQuery.Deferred.exceptionHook( e,\n\t\t\t\t\t\t\t\t\t\t\t\t\tprocess.stackTrace );\n\t\t\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\t\t\t// Support: Promises/A+ section 2.3.3.3.4.1\n\t\t\t\t\t\t\t\t\t\t\t// https://promisesaplus.com/#point-61\n\t\t\t\t\t\t\t\t\t\t\t// Ignore post-resolution exceptions\n\t\t\t\t\t\t\t\t\t\t\tif ( depth + 1 >= maxDepth ) {\n\n\t\t\t\t\t\t\t\t\t\t\t\t// Only substitute handlers pass on context\n\t\t\t\t\t\t\t\t\t\t\t\t// and multiple values (non-spec behavior)\n\t\t\t\t\t\t\t\t\t\t\t\tif ( handler !== Thrower ) {\n\t\t\t\t\t\t\t\t\t\t\t\t\tthat = undefined;\n\t\t\t\t\t\t\t\t\t\t\t\t\targs = [ e ];\n\t\t\t\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\t\t\t\tdeferred.rejectWith( that, args );\n\t\t\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\t};\n\n\t\t\t\t\t\t\t// Support: Promises/A+ section 2.3.3.3.1\n\t\t\t\t\t\t\t// https://promisesaplus.com/#point-57\n\t\t\t\t\t\t\t// Re-resolve promises immediately to dodge false rejection from\n\t\t\t\t\t\t\t// subsequent errors\n\t\t\t\t\t\t\tif ( depth ) {\n\t\t\t\t\t\t\t\tprocess();\n\t\t\t\t\t\t\t} else {\n\n\t\t\t\t\t\t\t\t// Call an optional hook to record the stack, in case of exception\n\t\t\t\t\t\t\t\t// since it's otherwise lost when execution goes async\n\t\t\t\t\t\t\t\tif ( jQuery.Deferred.getStackHook ) {\n\t\t\t\t\t\t\t\t\tprocess.stackTrace = jQuery.Deferred.getStackHook();\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\twindow.setTimeout( process );\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\n\t\t\t\t\treturn jQuery.Deferred( function( newDefer ) {\n\n\t\t\t\t\t\t// progress_handlers.add( ... )\n\t\t\t\t\t\ttuples[ 0 ][ 3 ].add(\n\t\t\t\t\t\t\tresolve(\n\t\t\t\t\t\t\t\t0,\n\t\t\t\t\t\t\t\tnewDefer,\n\t\t\t\t\t\t\t\tisFunction( onProgress ) ?\n\t\t\t\t\t\t\t\t\tonProgress :\n\t\t\t\t\t\t\t\t\tIdentity,\n\t\t\t\t\t\t\t\tnewDefer.notifyWith\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t);\n\n\t\t\t\t\t\t// fulfilled_handlers.add( ... )\n\t\t\t\t\t\ttuples[ 1 ][ 3 ].add(\n\t\t\t\t\t\t\tresolve(\n\t\t\t\t\t\t\t\t0,\n\t\t\t\t\t\t\t\tnewDefer,\n\t\t\t\t\t\t\t\tisFunction( onFulfilled ) ?\n\t\t\t\t\t\t\t\t\tonFulfilled :\n\t\t\t\t\t\t\t\t\tIdentity\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t);\n\n\t\t\t\t\t\t// rejected_handlers.add( ... )\n\t\t\t\t\t\ttuples[ 2 ][ 3 ].add(\n\t\t\t\t\t\t\tresolve(\n\t\t\t\t\t\t\t\t0,\n\t\t\t\t\t\t\t\tnewDefer,\n\t\t\t\t\t\t\t\tisFunction( onRejected ) ?\n\t\t\t\t\t\t\t\t\tonRejected :\n\t\t\t\t\t\t\t\t\tThrower\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t);\n\t\t\t\t\t} ).promise();\n\t\t\t\t},\n\n\t\t\t\t// Get a promise for this deferred\n\t\t\t\t// If obj is provided, the promise aspect is added to the object\n\t\t\t\tpromise: function( obj ) {\n\t\t\t\t\treturn obj != null ? jQuery.extend( obj, promise ) : promise;\n\t\t\t\t}\n\t\t\t},\n\t\t\tdeferred = {};\n\n\t\t// Add list-specific methods\n\t\tjQuery.each( tuples, function( i, tuple ) {\n\t\t\tvar list = tuple[ 2 ],\n\t\t\t\tstateString = tuple[ 5 ];\n\n\t\t\t// promise.progress = list.add\n\t\t\t// promise.done = list.add\n\t\t\t// promise.fail = list.add\n\t\t\tpromise[ tuple[ 1 ] ] = list.add;\n\n\t\t\t// Handle state\n\t\t\tif ( stateString ) {\n\t\t\t\tlist.add(\n\t\t\t\t\tfunction() {\n\n\t\t\t\t\t\t// state = \"resolved\" (i.e., fulfilled)\n\t\t\t\t\t\t// state = \"rejected\"\n\t\t\t\t\t\tstate = stateString;\n\t\t\t\t\t},\n\n\t\t\t\t\t// rejected_callbacks.disable\n\t\t\t\t\t// fulfilled_callbacks.disable\n\t\t\t\t\ttuples[ 3 - i ][ 2 ].disable,\n\n\t\t\t\t\t// rejected_handlers.disable\n\t\t\t\t\t// fulfilled_handlers.disable\n\t\t\t\t\ttuples[ 3 - i ][ 3 ].disable,\n\n\t\t\t\t\t// progress_callbacks.lock\n\t\t\t\t\ttuples[ 0 ][ 2 ].lock,\n\n\t\t\t\t\t// progress_handlers.lock\n\t\t\t\t\ttuples[ 0 ][ 3 ].lock\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// progress_handlers.fire\n\t\t\t// fulfilled_handlers.fire\n\t\t\t// rejected_handlers.fire\n\t\t\tlist.add( tuple[ 3 ].fire );\n\n\t\t\t// deferred.notify = function() { deferred.notifyWith(...) }\n\t\t\t// deferred.resolve = function() { deferred.resolveWith(...) }\n\t\t\t// deferred.reject = function() { deferred.rejectWith(...) }\n\t\t\tdeferred[ tuple[ 0 ] ] = function() {\n\t\t\t\tdeferred[ tuple[ 0 ] + \"With\" ]( this === deferred ? undefined : this, arguments );\n\t\t\t\treturn this;\n\t\t\t};\n\n\t\t\t// deferred.notifyWith = list.fireWith\n\t\t\t// deferred.resolveWith = list.fireWith\n\t\t\t// deferred.rejectWith = list.fireWith\n\t\t\tdeferred[ tuple[ 0 ] + \"With\" ] = list.fireWith;\n\t\t} );\n\n\t\t// Make the deferred a promise\n\t\tpromise.promise( deferred );\n\n\t\t// Call given func if any\n\t\tif ( func ) {\n\t\t\tfunc.call( deferred, deferred );\n\t\t}\n\n\t\t// All done!\n\t\treturn deferred;\n\t},\n\n\t// Deferred helper\n\twhen: function( singleValue ) {\n\t\tvar\n\n\t\t\t// count of uncompleted subordinates\n\t\t\tremaining = arguments.length,\n\n\t\t\t// count of unprocessed arguments\n\t\t\ti = remaining,\n\n\t\t\t// subordinate fulfillment data\n\t\t\tresolveContexts = Array( i ),\n\t\t\tresolveValues = slice.call( arguments ),\n\n\t\t\t// the master Deferred\n\t\t\tmaster = jQuery.Deferred(),\n\n\t\t\t// subordinate callback factory\n\t\t\tupdateFunc = function( i ) {\n\t\t\t\treturn function( value ) {\n\t\t\t\t\tresolveContexts[ i ] = this;\n\t\t\t\t\tresolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value;\n\t\t\t\t\tif ( !( --remaining ) ) {\n\t\t\t\t\t\tmaster.resolveWith( resolveContexts, resolveValues );\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t};\n\n\t\t// Single- and empty arguments are adopted like Promise.resolve\n\t\tif ( remaining <= 1 ) {\n\t\t\tadoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject,\n\t\t\t\t!remaining );\n\n\t\t\t// Use .then() to unwrap secondary thenables (cf. gh-3000)\n\t\t\tif ( master.state() === \"pending\" ||\n\t\t\t\tisFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) {\n\n\t\t\t\treturn master.then();\n\t\t\t}\n\t\t}\n\n\t\t// Multiple arguments are aggregated like Promise.all array elements\n\t\twhile ( i-- ) {\n\t\t\tadoptValue( resolveValues[ i ], updateFunc( i ), master.reject );\n\t\t}\n\n\t\treturn master.promise();\n\t}\n} );\n\n\n// These usually indicate a programmer mistake during development,\n// warn about them ASAP rather than swallowing them by default.\nvar rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;\n\njQuery.Deferred.exceptionHook = function( error, stack ) {\n\n\t// Support: IE 8 - 9 only\n\t// Console exists when dev tools are open, which can happen at any time\n\tif ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) {\n\t\twindow.console.warn( \"jQuery.Deferred exception: \" + error.message, error.stack, stack );\n\t}\n};\n\n\n\n\njQuery.readyException = function( error ) {\n\twindow.setTimeout( function() {\n\t\tthrow error;\n\t} );\n};\n\n\n\n\n// The deferred used on DOM ready\nvar readyList = jQuery.Deferred();\n\njQuery.fn.ready = function( fn ) {\n\n\treadyList\n\t\t.then( fn )\n\n\t\t// Wrap jQuery.readyException in a function so that the lookup\n\t\t// happens at the time of error handling instead of callback\n\t\t// registration.\n\t\t.catch( function( error ) {\n\t\t\tjQuery.readyException( error );\n\t\t} );\n\n\treturn this;\n};\n\njQuery.extend( {\n\n\t// Is the DOM ready to be used? Set to true once it occurs.\n\tisReady: false,\n\n\t// A counter to track how many items to wait for before\n\t// the ready event fires. See #6781\n\treadyWait: 1,\n\n\t// Handle when the DOM is ready\n\tready: function( wait ) {\n\n\t\t// Abort if there are pending holds or we're already ready\n\t\tif ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Remember that the DOM is ready\n\t\tjQuery.isReady = true;\n\n\t\t// If a normal DOM Ready event fired, decrement, and wait if need be\n\t\tif ( wait !== true && --jQuery.readyWait > 0 ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// If there are functions bound, to execute\n\t\treadyList.resolveWith( document, [ jQuery ] );\n\t}\n} );\n\njQuery.ready.then = readyList.then;\n\n// The ready event handler and self cleanup method\nfunction completed() {\n\tdocument.removeEventListener( \"DOMContentLoaded\", completed );\n\twindow.removeEventListener( \"load\", completed );\n\tjQuery.ready();\n}\n\n// Catch cases where $(document).ready() is called\n// after the browser event has already occurred.\n// Support: IE <=9 - 10 only\n// Older IE sometimes signals \"interactive\" too soon\nif ( document.readyState === \"complete\" ||\n\t( document.readyState !== \"loading\" && !document.documentElement.doScroll ) ) {\n\n\t// Handle it asynchronously to allow scripts the opportunity to delay ready\n\twindow.setTimeout( jQuery.ready );\n\n} else {\n\n\t// Use the handy event callback\n\tdocument.addEventListener( \"DOMContentLoaded\", completed );\n\n\t// A fallback to window.onload, that will always work\n\twindow.addEventListener( \"load\", completed );\n}\n\n\n\n\n// Multifunctional method to get and set values of a collection\n// The value/s can optionally be executed if it's a function\nvar access = function( elems, fn, key, value, chainable, emptyGet, raw ) {\n\tvar i = 0,\n\t\tlen = elems.length,\n\t\tbulk = key == null;\n\n\t// Sets many values\n\tif ( toType( key ) === \"object\" ) {\n\t\tchainable = true;\n\t\tfor ( i in key ) {\n\t\t\taccess( elems, fn, i, key[ i ], true, emptyGet, raw );\n\t\t}\n\n\t// Sets one value\n\t} else if ( value !== undefined ) {\n\t\tchainable = true;\n\n\t\tif ( !isFunction( value ) ) {\n\t\t\traw = true;\n\t\t}\n\n\t\tif ( bulk ) {\n\n\t\t\t// Bulk operations run against the entire set\n\t\t\tif ( raw ) {\n\t\t\t\tfn.call( elems, value );\n\t\t\t\tfn = null;\n\n\t\t\t// ...except when executing function values\n\t\t\t} else {\n\t\t\t\tbulk = fn;\n\t\t\t\tfn = function( elem, key, value ) {\n\t\t\t\t\treturn bulk.call( jQuery( elem ), value );\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\n\t\tif ( fn ) {\n\t\t\tfor ( ; i < len; i++ ) {\n\t\t\t\tfn(\n\t\t\t\t\telems[ i ], key, raw ?\n\t\t\t\t\tvalue :\n\t\t\t\t\tvalue.call( elems[ i ], i, fn( elems[ i ], key ) )\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t}\n\n\tif ( chainable ) {\n\t\treturn elems;\n\t}\n\n\t// Gets\n\tif ( bulk ) {\n\t\treturn fn.call( elems );\n\t}\n\n\treturn len ? fn( elems[ 0 ], key ) : emptyGet;\n};\n\n\n// Matches dashed string for camelizing\nvar rmsPrefix = /^-ms-/,\n\trdashAlpha = /-([a-z])/g;\n\n// Used by camelCase as callback to replace()\nfunction fcamelCase( all, letter ) {\n\treturn letter.toUpperCase();\n}\n\n// Convert dashed to camelCase; used by the css and data modules\n// Support: IE <=9 - 11, Edge 12 - 15\n// Microsoft forgot to hump their vendor prefix (#9572)\nfunction camelCase( string ) {\n\treturn string.replace( rmsPrefix, \"ms-\" ).replace( rdashAlpha, fcamelCase );\n}\nvar acceptData = function( owner ) {\n\n\t// Accepts only:\n\t// - Node\n\t// - Node.ELEMENT_NODE\n\t// - Node.DOCUMENT_NODE\n\t// - Object\n\t// - Any\n\treturn owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType );\n};\n\n\n\n\nfunction Data() {\n\tthis.expando = jQuery.expando + Data.uid++;\n}\n\nData.uid = 1;\n\nData.prototype = {\n\n\tcache: function( owner ) {\n\n\t\t// Check if the owner object already has a cache\n\t\tvar value = owner[ this.expando ];\n\n\t\t// If not, create one\n\t\tif ( !value ) {\n\t\t\tvalue = {};\n\n\t\t\t// We can accept data for non-element nodes in modern browsers,\n\t\t\t// but we should not, see #8335.\n\t\t\t// Always return an empty object.\n\t\t\tif ( acceptData( owner ) ) {\n\n\t\t\t\t// If it is a node unlikely to be stringify-ed or looped over\n\t\t\t\t// use plain assignment\n\t\t\t\tif ( owner.nodeType ) {\n\t\t\t\t\towner[ this.expando ] = value;\n\n\t\t\t\t// Otherwise secure it in a non-enumerable property\n\t\t\t\t// configurable must be true to allow the property to be\n\t\t\t\t// deleted when data is removed\n\t\t\t\t} else {\n\t\t\t\t\tObject.defineProperty( owner, this.expando, {\n\t\t\t\t\t\tvalue: value,\n\t\t\t\t\t\tconfigurable: true\n\t\t\t\t\t} );\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn value;\n\t},\n\tset: function( owner, data, value ) {\n\t\tvar prop,\n\t\t\tcache = this.cache( owner );\n\n\t\t// Handle: [ owner, key, value ] args\n\t\t// Always use camelCase key (gh-2257)\n\t\tif ( typeof data === \"string\" ) {\n\t\t\tcache[ camelCase( data ) ] = value;\n\n\t\t// Handle: [ owner, { properties } ] args\n\t\t} else {\n\n\t\t\t// Copy the properties one-by-one to the cache object\n\t\t\tfor ( prop in data ) {\n\t\t\t\tcache[ camelCase( prop ) ] = data[ prop ];\n\t\t\t}\n\t\t}\n\t\treturn cache;\n\t},\n\tget: function( owner, key ) {\n\t\treturn key === undefined ?\n\t\t\tthis.cache( owner ) :\n\n\t\t\t// Always use camelCase key (gh-2257)\n\t\t\towner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ];\n\t},\n\taccess: function( owner, key, value ) {\n\n\t\t// In cases where either:\n\t\t//\n\t\t// 1. No key was specified\n\t\t// 2. A string key was specified, but no value provided\n\t\t//\n\t\t// Take the \"read\" path and allow the get method to determine\n\t\t// which value to return, respectively either:\n\t\t//\n\t\t// 1. The entire cache object\n\t\t// 2. The data stored at the key\n\t\t//\n\t\tif ( key === undefined ||\n\t\t\t\t( ( key && typeof key === \"string\" ) && value === undefined ) ) {\n\n\t\t\treturn this.get( owner, key );\n\t\t}\n\n\t\t// When the key is not a string, or both a key and value\n\t\t// are specified, set or extend (existing objects) with either:\n\t\t//\n\t\t// 1. An object of properties\n\t\t// 2. A key and value\n\t\t//\n\t\tthis.set( owner, key, value );\n\n\t\t// Since the \"set\" path can have two possible entry points\n\t\t// return the expected data based on which path was taken[*]\n\t\treturn value !== undefined ? value : key;\n\t},\n\tremove: function( owner, key ) {\n\t\tvar i,\n\t\t\tcache = owner[ this.expando ];\n\n\t\tif ( cache === undefined ) {\n\t\t\treturn;\n\t\t}\n\n\t\tif ( key !== undefined ) {\n\n\t\t\t// Support array or space separated string of keys\n\t\t\tif ( Array.isArray( key ) ) {\n\n\t\t\t\t// If key is an array of keys...\n\t\t\t\t// We always set camelCase keys, so remove that.\n\t\t\t\tkey = key.map( camelCase );\n\t\t\t} else {\n\t\t\t\tkey = camelCase( key );\n\n\t\t\t\t// If a key with the spaces exists, use it.\n\t\t\t\t// Otherwise, create an array by matching non-whitespace\n\t\t\t\tkey = key in cache ?\n\t\t\t\t\t[ key ] :\n\t\t\t\t\t( key.match( rnothtmlwhite ) || [] );\n\t\t\t}\n\n\t\t\ti = key.length;\n\n\t\t\twhile ( i-- ) {\n\t\t\t\tdelete cache[ key[ i ] ];\n\t\t\t}\n\t\t}\n\n\t\t// Remove the expando if there's no more data\n\t\tif ( key === undefined || jQuery.isEmptyObject( cache ) ) {\n\n\t\t\t// Support: Chrome <=35 - 45\n\t\t\t// Webkit & Blink performance suffers when deleting properties\n\t\t\t// from DOM nodes, so set to undefined instead\n\t\t\t// https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted)\n\t\t\tif ( owner.nodeType ) {\n\t\t\t\towner[ this.expando ] = undefined;\n\t\t\t} else {\n\t\t\t\tdelete owner[ this.expando ];\n\t\t\t}\n\t\t}\n\t},\n\thasData: function( owner ) {\n\t\tvar cache = owner[ this.expando ];\n\t\treturn cache !== undefined && !jQuery.isEmptyObject( cache );\n\t}\n};\nvar dataPriv = new Data();\n\nvar dataUser = new Data();\n\n\n\n//\tImplementation Summary\n//\n//\t1. Enforce API surface and semantic compatibility with 1.9.x branch\n//\t2. Improve the module's maintainability by reducing the storage\n//\t\tpaths to a single mechanism.\n//\t3. Use the same single mechanism to support \"private\" and \"user\" data.\n//\t4. _Never_ expose \"private\" data to user code (TODO: Drop _data, _removeData)\n//\t5. Avoid exposing implementation details on user objects (eg. expando properties)\n//\t6. Provide a clear path for implementation upgrade to WeakMap in 2014\n\nvar rbrace = /^(?:\\{[\\w\\W]*\\}|\\[[\\w\\W]*\\])$/,\n\trmultiDash = /[A-Z]/g;\n\nfunction getData( data ) {\n\tif ( data === \"true\" ) {\n\t\treturn true;\n\t}\n\n\tif ( data === \"false\" ) {\n\t\treturn false;\n\t}\n\n\tif ( data === \"null\" ) {\n\t\treturn null;\n\t}\n\n\t// Only convert to a number if it doesn't change the string\n\tif ( data === +data + \"\" ) {\n\t\treturn +data;\n\t}\n\n\tif ( rbrace.test( data ) ) {\n\t\treturn JSON.parse( data );\n\t}\n\n\treturn data;\n}\n\nfunction dataAttr( elem, key, data ) {\n\tvar name;\n\n\t// If nothing was found internally, try to fetch any\n\t// data from the HTML5 data-* attribute\n\tif ( data === undefined && elem.nodeType === 1 ) {\n\t\tname = \"data-\" + key.replace( rmultiDash, \"-$&\" ).toLowerCase();\n\t\tdata = elem.getAttribute( name );\n\n\t\tif ( typeof data === \"string\" ) {\n\t\t\ttry {\n\t\t\t\tdata = getData( data );\n\t\t\t} catch ( e ) {}\n\n\t\t\t// Make sure we set the data so it isn't changed later\n\t\t\tdataUser.set( elem, key, data );\n\t\t} else {\n\t\t\tdata = undefined;\n\t\t}\n\t}\n\treturn data;\n}\n\njQuery.extend( {\n\thasData: function( elem ) {\n\t\treturn dataUser.hasData( elem ) || dataPriv.hasData( elem );\n\t},\n\n\tdata: function( elem, name, data ) {\n\t\treturn dataUser.access( elem, name, data );\n\t},\n\n\tremoveData: function( elem, name ) {\n\t\tdataUser.remove( elem, name );\n\t},\n\n\t// TODO: Now that all calls to _data and _removeData have been replaced\n\t// with direct calls to dataPriv methods, these can be deprecated.\n\t_data: function( elem, name, data ) {\n\t\treturn dataPriv.access( elem, name, data );\n\t},\n\n\t_removeData: function( elem, name ) {\n\t\tdataPriv.remove( elem, name );\n\t}\n} );\n\njQuery.fn.extend( {\n\tdata: function( key, value ) {\n\t\tvar i, name, data,\n\t\t\telem = this[ 0 ],\n\t\t\tattrs = elem && elem.attributes;\n\n\t\t// Gets all values\n\t\tif ( key === undefined ) {\n\t\t\tif ( this.length ) {\n\t\t\t\tdata = dataUser.get( elem );\n\n\t\t\t\tif ( elem.nodeType === 1 && !dataPriv.get( elem, \"hasDataAttrs\" ) ) {\n\t\t\t\t\ti = attrs.length;\n\t\t\t\t\twhile ( i-- ) {\n\n\t\t\t\t\t\t// Support: IE 11 only\n\t\t\t\t\t\t// The attrs elements can be null (#14894)\n\t\t\t\t\t\tif ( attrs[ i ] ) {\n\t\t\t\t\t\t\tname = attrs[ i ].name;\n\t\t\t\t\t\t\tif ( name.indexOf( \"data-\" ) === 0 ) {\n\t\t\t\t\t\t\t\tname = camelCase( name.slice( 5 ) );\n\t\t\t\t\t\t\t\tdataAttr( elem, name, data[ name ] );\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tdataPriv.set( elem, \"hasDataAttrs\", true );\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn data;\n\t\t}\n\n\t\t// Sets multiple values\n\t\tif ( typeof key === \"object\" ) {\n\t\t\treturn this.each( function() {\n\t\t\t\tdataUser.set( this, key );\n\t\t\t} );\n\t\t}\n\n\t\treturn access( this, function( value ) {\n\t\t\tvar data;\n\n\t\t\t// The calling jQuery object (element matches) is not empty\n\t\t\t// (and therefore has an element appears at this[ 0 ]) and the\n\t\t\t// `value` parameter was not undefined. An empty jQuery object\n\t\t\t// will result in `undefined` for elem = this[ 0 ] which will\n\t\t\t// throw an exception if an attempt to read a data cache is made.\n\t\t\tif ( elem && value === undefined ) {\n\n\t\t\t\t// Attempt to get data from the cache\n\t\t\t\t// The key will always be camelCased in Data\n\t\t\t\tdata = dataUser.get( elem, key );\n\t\t\t\tif ( data !== undefined ) {\n\t\t\t\t\treturn data;\n\t\t\t\t}\n\n\t\t\t\t// Attempt to \"discover\" the data in\n\t\t\t\t// HTML5 custom data-* attrs\n\t\t\t\tdata = dataAttr( elem, key );\n\t\t\t\tif ( data !== undefined ) {\n\t\t\t\t\treturn data;\n\t\t\t\t}\n\n\t\t\t\t// We tried really hard, but the data doesn't exist.\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Set the data...\n\t\t\tthis.each( function() {\n\n\t\t\t\t// We always store the camelCased key\n\t\t\t\tdataUser.set( this, key, value );\n\t\t\t} );\n\t\t}, null, value, arguments.length > 1, null, true );\n\t},\n\n\tremoveData: function( key ) {\n\t\treturn this.each( function() {\n\t\t\tdataUser.remove( this, key );\n\t\t} );\n\t}\n} );\n\n\njQuery.extend( {\n\tqueue: function( elem, type, data ) {\n\t\tvar queue;\n\n\t\tif ( elem ) {\n\t\t\ttype = ( type || \"fx\" ) + \"queue\";\n\t\t\tqueue = dataPriv.get( elem, type );\n\n\t\t\t// Speed up dequeue by getting out quickly if this is just a lookup\n\t\t\tif ( data ) {\n\t\t\t\tif ( !queue || Array.isArray( data ) ) {\n\t\t\t\t\tqueue = dataPriv.access( elem, type, jQuery.makeArray( data ) );\n\t\t\t\t} else {\n\t\t\t\t\tqueue.push( data );\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn queue || [];\n\t\t}\n\t},\n\n\tdequeue: function( elem, type ) {\n\t\ttype = type || \"fx\";\n\n\t\tvar queue = jQuery.queue( elem, type ),\n\t\t\tstartLength = queue.length,\n\t\t\tfn = queue.shift(),\n\t\t\thooks = jQuery._queueHooks( elem, type ),\n\t\t\tnext = function() {\n\t\t\t\tjQuery.dequeue( elem, type );\n\t\t\t};\n\n\t\t// If the fx queue is dequeued, always remove the progress sentinel\n\t\tif ( fn === \"inprogress\" ) {\n\t\t\tfn = queue.shift();\n\t\t\tstartLength--;\n\t\t}\n\n\t\tif ( fn ) {\n\n\t\t\t// Add a progress sentinel to prevent the fx queue from being\n\t\t\t// automatically dequeued\n\t\t\tif ( type === \"fx\" ) {\n\t\t\t\tqueue.unshift( \"inprogress\" );\n\t\t\t}\n\n\t\t\t// Clear up the last queue stop function\n\t\t\tdelete hooks.stop;\n\t\t\tfn.call( elem, next, hooks );\n\t\t}\n\n\t\tif ( !startLength && hooks ) {\n\t\t\thooks.empty.fire();\n\t\t}\n\t},\n\n\t// Not public - generate a queueHooks object, or return the current one\n\t_queueHooks: function( elem, type ) {\n\t\tvar key = type + \"queueHooks\";\n\t\treturn dataPriv.get( elem, key ) || dataPriv.access( elem, key, {\n\t\t\tempty: jQuery.Callbacks( \"once memory\" ).add( function() {\n\t\t\t\tdataPriv.remove( elem, [ type + \"queue\", key ] );\n\t\t\t} )\n\t\t} );\n\t}\n} );\n\njQuery.fn.extend( {\n\tqueue: function( type, data ) {\n\t\tvar setter = 2;\n\n\t\tif ( typeof type !== \"string\" ) {\n\t\t\tdata = type;\n\t\t\ttype = \"fx\";\n\t\t\tsetter--;\n\t\t}\n\n\t\tif ( arguments.length < setter ) {\n\t\t\treturn jQuery.queue( this[ 0 ], type );\n\t\t}\n\n\t\treturn data === undefined ?\n\t\t\tthis :\n\t\t\tthis.each( function() {\n\t\t\t\tvar queue = jQuery.queue( this, type, data );\n\n\t\t\t\t// Ensure a hooks for this queue\n\t\t\t\tjQuery._queueHooks( this, type );\n\n\t\t\t\tif ( type === \"fx\" && queue[ 0 ] !== \"inprogress\" ) {\n\t\t\t\t\tjQuery.dequeue( this, type );\n\t\t\t\t}\n\t\t\t} );\n\t},\n\tdequeue: function( type ) {\n\t\treturn this.each( function() {\n\t\t\tjQuery.dequeue( this, type );\n\t\t} );\n\t},\n\tclearQueue: function( type ) {\n\t\treturn this.queue( type || \"fx\", [] );\n\t},\n\n\t// Get a promise resolved when queues of a certain type\n\t// are emptied (fx is the type by default)\n\tpromise: function( type, obj ) {\n\t\tvar tmp,\n\t\t\tcount = 1,\n\t\t\tdefer = jQuery.Deferred(),\n\t\t\telements = this,\n\t\t\ti = this.length,\n\t\t\tresolve = function() {\n\t\t\t\tif ( !( --count ) ) {\n\t\t\t\t\tdefer.resolveWith( elements, [ elements ] );\n\t\t\t\t}\n\t\t\t};\n\n\t\tif ( typeof type !== \"string\" ) {\n\t\t\tobj = type;\n\t\t\ttype = undefined;\n\t\t}\n\t\ttype = type || \"fx\";\n\n\t\twhile ( i-- ) {\n\t\t\ttmp = dataPriv.get( elements[ i ], type + \"queueHooks\" );\n\t\t\tif ( tmp && tmp.empty ) {\n\t\t\t\tcount++;\n\t\t\t\ttmp.empty.add( resolve );\n\t\t\t}\n\t\t}\n\t\tresolve();\n\t\treturn defer.promise( obj );\n\t}\n} );\nvar pnum = ( /[+-]?(?:\\d*\\.|)\\d+(?:[eE][+-]?\\d+|)/ ).source;\n\nvar rcssNum = new RegExp( \"^(?:([+-])=|)(\" + pnum + \")([a-z%]*)$\", \"i\" );\n\n\nvar cssExpand = [ \"Top\", \"Right\", \"Bottom\", \"Left\" ];\n\nvar isHiddenWithinTree = function( elem, el ) {\n\n\t\t// isHiddenWithinTree might be called from jQuery#filter function;\n\t\t// in that case, element will be second argument\n\t\telem = el || elem;\n\n\t\t// Inline style trumps all\n\t\treturn elem.style.display === \"none\" ||\n\t\t\telem.style.display === \"\" &&\n\n\t\t\t// Otherwise, check computed style\n\t\t\t// Support: Firefox <=43 - 45\n\t\t\t// Disconnected elements can have computed display: none, so first confirm that elem is\n\t\t\t// in the document.\n\t\t\tjQuery.contains( elem.ownerDocument, elem ) &&\n\n\t\t\tjQuery.css( elem, \"display\" ) === \"none\";\n\t};\n\nvar swap = function( elem, options, callback, args ) {\n\tvar ret, name,\n\t\told = {};\n\n\t// Remember the old values, and insert the new ones\n\tfor ( name in options ) {\n\t\told[ name ] = elem.style[ name ];\n\t\telem.style[ name ] = options[ name ];\n\t}\n\n\tret = callback.apply( elem, args || [] );\n\n\t// Revert the old values\n\tfor ( name in options ) {\n\t\telem.style[ name ] = old[ name ];\n\t}\n\n\treturn ret;\n};\n\n\n\n\nfunction adjustCSS( elem, prop, valueParts, tween ) {\n\tvar adjusted, scale,\n\t\tmaxIterations = 20,\n\t\tcurrentValue = tween ?\n\t\t\tfunction() {\n\t\t\t\treturn tween.cur();\n\t\t\t} :\n\t\t\tfunction() {\n\t\t\t\treturn jQuery.css( elem, prop, \"\" );\n\t\t\t},\n\t\tinitial = currentValue(),\n\t\tunit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? \"\" : \"px\" ),\n\n\t\t// Starting value computation is required for potential unit mismatches\n\t\tinitialInUnit = ( jQuery.cssNumber[ prop ] || unit !== \"px\" && +initial ) &&\n\t\t\trcssNum.exec( jQuery.css( elem, prop ) );\n\n\tif ( initialInUnit && initialInUnit[ 3 ] !== unit ) {\n\n\t\t// Support: Firefox <=54\n\t\t// Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144)\n\t\tinitial = initial / 2;\n\n\t\t// Trust units reported by jQuery.css\n\t\tunit = unit || initialInUnit[ 3 ];\n\n\t\t// Iteratively approximate from a nonzero starting point\n\t\tinitialInUnit = +initial || 1;\n\n\t\twhile ( maxIterations-- ) {\n\n\t\t\t// Evaluate and update our best guess (doubling guesses that zero out).\n\t\t\t// Finish if the scale equals or crosses 1 (making the old*new product non-positive).\n\t\t\tjQuery.style( elem, prop, initialInUnit + unit );\n\t\t\tif ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) {\n\t\t\t\tmaxIterations = 0;\n\t\t\t}\n\t\t\tinitialInUnit = initialInUnit / scale;\n\n\t\t}\n\n\t\tinitialInUnit = initialInUnit * 2;\n\t\tjQuery.style( elem, prop, initialInUnit + unit );\n\n\t\t// Make sure we update the tween properties later on\n\t\tvalueParts = valueParts || [];\n\t}\n\n\tif ( valueParts ) {\n\t\tinitialInUnit = +initialInUnit || +initial || 0;\n\n\t\t// Apply relative offset (+=/-=) if specified\n\t\tadjusted = valueParts[ 1 ] ?\n\t\t\tinitialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] :\n\t\t\t+valueParts[ 2 ];\n\t\tif ( tween ) {\n\t\t\ttween.unit = unit;\n\t\t\ttween.start = initialInUnit;\n\t\t\ttween.end = adjusted;\n\t\t}\n\t}\n\treturn adjusted;\n}\n\n\nvar defaultDisplayMap = {};\n\nfunction getDefaultDisplay( elem ) {\n\tvar temp,\n\t\tdoc = elem.ownerDocument,\n\t\tnodeName = elem.nodeName,\n\t\tdisplay = defaultDisplayMap[ nodeName ];\n\n\tif ( display ) {\n\t\treturn display;\n\t}\n\n\ttemp = doc.body.appendChild( doc.createElement( nodeName ) );\n\tdisplay = jQuery.css( temp, \"display\" );\n\n\ttemp.parentNode.removeChild( temp );\n\n\tif ( display === \"none\" ) {\n\t\tdisplay = \"block\";\n\t}\n\tdefaultDisplayMap[ nodeName ] = display;\n\n\treturn display;\n}\n\nfunction showHide( elements, show ) {\n\tvar display, elem,\n\t\tvalues = [],\n\t\tindex = 0,\n\t\tlength = elements.length;\n\n\t// Determine new display value for elements that need to change\n\tfor ( ; index < length; index++ ) {\n\t\telem = elements[ index ];\n\t\tif ( !elem.style ) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tdisplay = elem.style.display;\n\t\tif ( show ) {\n\n\t\t\t// Since we force visibility upon cascade-hidden elements, an immediate (and slow)\n\t\t\t// check is required in this first loop unless we have a nonempty display value (either\n\t\t\t// inline or about-to-be-restored)\n\t\t\tif ( display === \"none\" ) {\n\t\t\t\tvalues[ index ] = dataPriv.get( elem, \"display\" ) || null;\n\t\t\t\tif ( !values[ index ] ) {\n\t\t\t\t\telem.style.display = \"\";\n\t\t\t\t}\n\t\t\t}\n\t\t\tif ( elem.style.display === \"\" && isHiddenWithinTree( elem ) ) {\n\t\t\t\tvalues[ index ] = getDefaultDisplay( elem );\n\t\t\t}\n\t\t} else {\n\t\t\tif ( display !== \"none\" ) {\n\t\t\t\tvalues[ index ] = \"none\";\n\n\t\t\t\t// Remember what we're overwriting\n\t\t\t\tdataPriv.set( elem, \"display\", display );\n\t\t\t}\n\t\t}\n\t}\n\n\t// Set the display of the elements in a second loop to avoid constant reflow\n\tfor ( index = 0; index < length; index++ ) {\n\t\tif ( values[ index ] != null ) {\n\t\t\telements[ index ].style.display = values[ index ];\n\t\t}\n\t}\n\n\treturn elements;\n}\n\njQuery.fn.extend( {\n\tshow: function() {\n\t\treturn showHide( this, true );\n\t},\n\thide: function() {\n\t\treturn showHide( this );\n\t},\n\ttoggle: function( state ) {\n\t\tif ( typeof state === \"boolean\" ) {\n\t\t\treturn state ? this.show() : this.hide();\n\t\t}\n\n\t\treturn this.each( function() {\n\t\t\tif ( isHiddenWithinTree( this ) ) {\n\t\t\t\tjQuery( this ).show();\n\t\t\t} else {\n\t\t\t\tjQuery( this ).hide();\n\t\t\t}\n\t\t} );\n\t}\n} );\nvar rcheckableType = ( /^(?:checkbox|radio)$/i );\n\nvar rtagName = ( /<([a-z][^\\/\\0>\\x20\\t\\r\\n\\f]+)/i );\n\nvar rscriptType = ( /^$|^module$|\\/(?:java|ecma)script/i );\n\n\n\n// We have to close these tags to support XHTML (#13200)\nvar wrapMap = {\n\n\t// Support: IE <=9 only\n\toption: [ 1, \"<select multiple='multiple'>\", \"</select>\" ],\n\n\t// XHTML parsers do not magically insert elements in the\n\t// same way that tag soup parsers do. So we cannot shorten\n\t// this by omitting <tbody> or other required elements.\n\tthead: [ 1, \"<table>\", \"</table>\" ],\n\tcol: [ 2, \"<table><colgroup>\", \"</colgroup></table>\" ],\n\ttr: [ 2, \"<table><tbody>\", \"</tbody></table>\" ],\n\ttd: [ 3, \"<table><tbody><tr>\", \"</tr></tbody></table>\" ],\n\n\t_default: [ 0, \"\", \"\" ]\n};\n\n// Support: IE <=9 only\nwrapMap.optgroup = wrapMap.option;\n\nwrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead;\nwrapMap.th = wrapMap.td;\n\n\nfunction getAll( context, tag ) {\n\n\t// Support: IE <=9 - 11 only\n\t// Use typeof to avoid zero-argument method invocation on host objects (#15151)\n\tvar ret;\n\n\tif ( typeof context.getElementsByTagName !== \"undefined\" ) {\n\t\tret = context.getElementsByTagName( tag || \"*\" );\n\n\t} else if ( typeof context.querySelectorAll !== \"undefined\" ) {\n\t\tret = context.querySelectorAll( tag || \"*\" );\n\n\t} else {\n\t\tret = [];\n\t}\n\n\tif ( tag === undefined || tag && nodeName( context, tag ) ) {\n\t\treturn jQuery.merge( [ context ], ret );\n\t}\n\n\treturn ret;\n}\n\n\n// Mark scripts as having already been evaluated\nfunction setGlobalEval( elems, refElements ) {\n\tvar i = 0,\n\t\tl = elems.length;\n\n\tfor ( ; i < l; i++ ) {\n\t\tdataPriv.set(\n\t\t\telems[ i ],\n\t\t\t\"globalEval\",\n\t\t\t!refElements || dataPriv.get( refElements[ i ], \"globalEval\" )\n\t\t);\n\t}\n}\n\n\nvar rhtml = /<|&#?\\w+;/;\n\nfunction buildFragment( elems, context, scripts, selection, ignored ) {\n\tvar elem, tmp, tag, wrap, contains, j,\n\t\tfragment = context.createDocumentFragment(),\n\t\tnodes = [],\n\t\ti = 0,\n\t\tl = elems.length;\n\n\tfor ( ; i < l; i++ ) {\n\t\telem = elems[ i ];\n\n\t\tif ( elem || elem === 0 ) {\n\n\t\t\t// Add nodes directly\n\t\t\tif ( toType( elem ) === \"object\" ) {\n\n\t\t\t\t// Support: Android <=4.0 only, PhantomJS 1 only\n\t\t\t\t// push.apply(_, arraylike) throws on ancient WebKit\n\t\t\t\tjQuery.merge( nodes, elem.nodeType ? [ elem ] : elem );\n\n\t\t\t// Convert non-html into a text node\n\t\t\t} else if ( !rhtml.test( elem ) ) {\n\t\t\t\tnodes.push( context.createTextNode( elem ) );\n\n\t\t\t// Convert html into DOM nodes\n\t\t\t} else {\n\t\t\t\ttmp = tmp || fragment.appendChild( context.createElement( \"div\" ) );\n\n\t\t\t\t// Deserialize a standard representation\n\t\t\t\ttag = ( rtagName.exec( elem ) || [ \"\", \"\" ] )[ 1 ].toLowerCase();\n\t\t\t\twrap = wrapMap[ tag ] || wrapMap._default;\n\t\t\t\ttmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ];\n\n\t\t\t\t// Descend through wrappers to the right content\n\t\t\t\tj = wrap[ 0 ];\n\t\t\t\twhile ( j-- ) {\n\t\t\t\t\ttmp = tmp.lastChild;\n\t\t\t\t}\n\n\t\t\t\t// Support: Android <=4.0 only, PhantomJS 1 only\n\t\t\t\t// push.apply(_, arraylike) throws on ancient WebKit\n\t\t\t\tjQuery.merge( nodes, tmp.childNodes );\n\n\t\t\t\t// Remember the top-level container\n\t\t\t\ttmp = fragment.firstChild;\n\n\t\t\t\t// Ensure the created nodes are orphaned (#12392)\n\t\t\t\ttmp.textContent = \"\";\n\t\t\t}\n\t\t}\n\t}\n\n\t// Remove wrapper from fragment\n\tfragment.textContent = \"\";\n\n\ti = 0;\n\twhile ( ( elem = nodes[ i++ ] ) ) {\n\n\t\t// Skip elements already in the context collection (trac-4087)\n\t\tif ( selection && jQuery.inArray( elem, selection ) > -1 ) {\n\t\t\tif ( ignored ) {\n\t\t\t\tignored.push( elem );\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tcontains = jQuery.contains( elem.ownerDocument, elem );\n\n\t\t// Append to fragment\n\t\ttmp = getAll( fragment.appendChild( elem ), \"script\" );\n\n\t\t// Preserve script evaluation history\n\t\tif ( contains ) {\n\t\t\tsetGlobalEval( tmp );\n\t\t}\n\n\t\t// Capture executables\n\t\tif ( scripts ) {\n\t\t\tj = 0;\n\t\t\twhile ( ( elem = tmp[ j++ ] ) ) {\n\t\t\t\tif ( rscriptType.test( elem.type || \"\" ) ) {\n\t\t\t\t\tscripts.push( elem );\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\treturn fragment;\n}\n\n\n( function() {\n\tvar fragment = document.createDocumentFragment(),\n\t\tdiv = fragment.appendChild( document.createElement( \"div\" ) ),\n\t\tinput = document.createElement( \"input\" );\n\n\t// Support: Android 4.0 - 4.3 only\n\t// Check state lost if the name is set (#11217)\n\t// Support: Windows Web Apps (WWA)\n\t// `name` and `type` must use .setAttribute for WWA (#14901)\n\tinput.setAttribute( \"type\", \"radio\" );\n\tinput.setAttribute( \"checked\", \"checked\" );\n\tinput.setAttribute( \"name\", \"t\" );\n\n\tdiv.appendChild( input );\n\n\t// Support: Android <=4.1 only\n\t// Older WebKit doesn't clone checked state correctly in fragments\n\tsupport.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked;\n\n\t// Support: IE <=11 only\n\t// Make sure textarea (and checkbox) defaultValue is properly cloned\n\tdiv.innerHTML = \"<textarea>x</textarea>\";\n\tsupport.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue;\n} )();\nvar documentElement = document.documentElement;\n\n\n\nvar\n\trkeyEvent = /^key/,\n\trmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/,\n\trtypenamespace = /^([^.]*)(?:\\.(.+)|)/;\n\nfunction returnTrue() {\n\treturn true;\n}\n\nfunction returnFalse() {\n\treturn false;\n}\n\n// Support: IE <=9 only\n// See #13393 for more info\nfunction safeActiveElement() {\n\ttry {\n\t\treturn document.activeElement;\n\t} catch ( err ) { }\n}\n\nfunction on( elem, types, selector, data, fn, one ) {\n\tvar origFn, type;\n\n\t// Types can be a map of types/handlers\n\tif ( typeof types === \"object\" ) {\n\n\t\t// ( types-Object, selector, data )\n\t\tif ( typeof selector !== \"string\" ) {\n\n\t\t\t// ( types-Object, data )\n\t\t\tdata = data || selector;\n\t\t\tselector = undefined;\n\t\t}\n\t\tfor ( type in types ) {\n\t\t\ton( elem, type, selector, data, types[ type ], one );\n\t\t}\n\t\treturn elem;\n\t}\n\n\tif ( data == null && fn == null ) {\n\n\t\t// ( types, fn )\n\t\tfn = selector;\n\t\tdata = selector = undefined;\n\t} else if ( fn == null ) {\n\t\tif ( typeof selector === \"string\" ) {\n\n\t\t\t// ( types, selector, fn )\n\t\t\tfn = data;\n\t\t\tdata = undefined;\n\t\t} else {\n\n\t\t\t// ( types, data, fn )\n\t\t\tfn = data;\n\t\t\tdata = selector;\n\t\t\tselector = undefined;\n\t\t}\n\t}\n\tif ( fn === false ) {\n\t\tfn = returnFalse;\n\t} else if ( !fn ) {\n\t\treturn elem;\n\t}\n\n\tif ( one === 1 ) {\n\t\torigFn = fn;\n\t\tfn = function( event ) {\n\n\t\t\t// Can use an empty set, since event contains the info\n\t\t\tjQuery().off( event );\n\t\t\treturn origFn.apply( this, arguments );\n\t\t};\n\n\t\t// Use same guid so caller can remove using origFn\n\t\tfn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ );\n\t}\n\treturn elem.each( function() {\n\t\tjQuery.event.add( this, types, fn, data, selector );\n\t} );\n}\n\n/*\n * Helper functions for managing events -- not part of the public interface.\n * Props to Dean Edwards' addEvent library for many of the ideas.\n */\njQuery.event = {\n\n\tglobal: {},\n\n\tadd: function( elem, types, handler, data, selector ) {\n\n\t\tvar handleObjIn, eventHandle, tmp,\n\t\t\tevents, t, handleObj,\n\t\t\tspecial, handlers, type, namespaces, origType,\n\t\t\telemData = dataPriv.get( elem );\n\n\t\t// Don't attach events to noData or text/comment nodes (but allow plain objects)\n\t\tif ( !elemData ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Caller can pass in an object of custom data in lieu of the handler\n\t\tif ( handler.handler ) {\n\t\t\thandleObjIn = handler;\n\t\t\thandler = handleObjIn.handler;\n\t\t\tselector = handleObjIn.selector;\n\t\t}\n\n\t\t// Ensure that invalid selectors throw exceptions at attach time\n\t\t// Evaluate against documentElement in case elem is a non-element node (e.g., document)\n\t\tif ( selector ) {\n\t\t\tjQuery.find.matchesSelector( documentElement, selector );\n\t\t}\n\n\t\t// Make sure that the handler has a unique ID, used to find/remove it later\n\t\tif ( !handler.guid ) {\n\t\t\thandler.guid = jQuery.guid++;\n\t\t}\n\n\t\t// Init the element's event structure and main handler, if this is the first\n\t\tif ( !( events = elemData.events ) ) {\n\t\t\tevents = elemData.events = {};\n\t\t}\n\t\tif ( !( eventHandle = elemData.handle ) ) {\n\t\t\teventHandle = elemData.handle = function( e ) {\n\n\t\t\t\t// Discard the second event of a jQuery.event.trigger() and\n\t\t\t\t// when an event is called after a page has unloaded\n\t\t\t\treturn typeof jQuery !== \"undefined\" && jQuery.event.triggered !== e.type ?\n\t\t\t\t\tjQuery.event.dispatch.apply( elem, arguments ) : undefined;\n\t\t\t};\n\t\t}\n\n\t\t// Handle multiple events separated by a space\n\t\ttypes = ( types || \"\" ).match( rnothtmlwhite ) || [ \"\" ];\n\t\tt = types.length;\n\t\twhile ( t-- ) {\n\t\t\ttmp = rtypenamespace.exec( types[ t ] ) || [];\n\t\t\ttype = origType = tmp[ 1 ];\n\t\t\tnamespaces = ( tmp[ 2 ] || \"\" ).split( \".\" ).sort();\n\n\t\t\t// There *must* be a type, no attaching namespace-only handlers\n\t\t\tif ( !type ) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// If event changes its type, use the special event handlers for the changed type\n\t\t\tspecial = jQuery.event.special[ type ] || {};\n\n\t\t\t// If selector defined, determine special event api type, otherwise given type\n\t\t\ttype = ( selector ? special.delegateType : special.bindType ) || type;\n\n\t\t\t// Update special based on newly reset type\n\t\t\tspecial = jQuery.event.special[ type ] || {};\n\n\t\t\t// handleObj is passed to all event handlers\n\t\t\thandleObj = jQuery.extend( {\n\t\t\t\ttype: type,\n\t\t\t\torigType: origType,\n\t\t\t\tdata: data,\n\t\t\t\thandler: handler,\n\t\t\t\tguid: handler.guid,\n\t\t\t\tselector: selector,\n\t\t\t\tneedsContext: selector && jQuery.expr.match.needsContext.test( selector ),\n\t\t\t\tnamespace: namespaces.join( \".\" )\n\t\t\t}, handleObjIn );\n\n\t\t\t// Init the event handler queue if we're the first\n\t\t\tif ( !( handlers = events[ type ] ) ) {\n\t\t\t\thandlers = events[ type ] = [];\n\t\t\t\thandlers.delegateCount = 0;\n\n\t\t\t\t// Only use addEventListener if the special events handler returns false\n\t\t\t\tif ( !special.setup ||\n\t\t\t\t\tspecial.setup.call( elem, data, namespaces, eventHandle ) === false ) {\n\n\t\t\t\t\tif ( elem.addEventListener ) {\n\t\t\t\t\t\telem.addEventListener( type, eventHandle );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif ( special.add ) {\n\t\t\t\tspecial.add.call( elem, handleObj );\n\n\t\t\t\tif ( !handleObj.handler.guid ) {\n\t\t\t\t\thandleObj.handler.guid = handler.guid;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Add to the element's handler list, delegates in front\n\t\t\tif ( selector ) {\n\t\t\t\thandlers.splice( handlers.delegateCount++, 0, handleObj );\n\t\t\t} else {\n\t\t\t\thandlers.push( handleObj );\n\t\t\t}\n\n\t\t\t// Keep track of which events have ever been used, for event optimization\n\t\t\tjQuery.event.global[ type ] = true;\n\t\t}\n\n\t},\n\n\t// Detach an event or set of events from an element\n\tremove: function( elem, types, handler, selector, mappedTypes ) {\n\n\t\tvar j, origCount, tmp,\n\t\t\tevents, t, handleObj,\n\t\t\tspecial, handlers, type, namespaces, origType,\n\t\t\telemData = dataPriv.hasData( elem ) && dataPriv.get( elem );\n\n\t\tif ( !elemData || !( events = elemData.events ) ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Once for each type.namespace in types; type may be omitted\n\t\ttypes = ( types || \"\" ).match( rnothtmlwhite ) || [ \"\" ];\n\t\tt = types.length;\n\t\twhile ( t-- ) {\n\t\t\ttmp = rtypenamespace.exec( types[ t ] ) || [];\n\t\t\ttype = origType = tmp[ 1 ];\n\t\t\tnamespaces = ( tmp[ 2 ] || \"\" ).split( \".\" ).sort();\n\n\t\t\t// Unbind all events (on this namespace, if provided) for the element\n\t\t\tif ( !type ) {\n\t\t\t\tfor ( type in events ) {\n\t\t\t\t\tjQuery.event.remove( elem, type + types[ t ], handler, selector, true );\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tspecial = jQuery.event.special[ type ] || {};\n\t\t\ttype = ( selector ? special.delegateType : special.bindType ) || type;\n\t\t\thandlers = events[ type ] || [];\n\t\t\ttmp = tmp[ 2 ] &&\n\t\t\t\tnew RegExp( \"(^|\\\\.)\" + namespaces.join( \"\\\\.(?:.*\\\\.|)\" ) + \"(\\\\.|$)\" );\n\n\t\t\t// Remove matching events\n\t\t\torigCount = j = handlers.length;\n\t\t\twhile ( j-- ) {\n\t\t\t\thandleObj = handlers[ j ];\n\n\t\t\t\tif ( ( mappedTypes || origType === handleObj.origType ) &&\n\t\t\t\t\t( !handler || handler.guid === handleObj.guid ) &&\n\t\t\t\t\t( !tmp || tmp.test( handleObj.namespace ) ) &&\n\t\t\t\t\t( !selector || selector === handleObj.selector ||\n\t\t\t\t\t\tselector === \"**\" && handleObj.selector ) ) {\n\t\t\t\t\thandlers.splice( j, 1 );\n\n\t\t\t\t\tif ( handleObj.selector ) {\n\t\t\t\t\t\thandlers.delegateCount--;\n\t\t\t\t\t}\n\t\t\t\t\tif ( special.remove ) {\n\t\t\t\t\t\tspecial.remove.call( elem, handleObj );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Remove generic event handler if we removed something and no more handlers exist\n\t\t\t// (avoids potential for endless recursion during removal of special event handlers)\n\t\t\tif ( origCount && !handlers.length ) {\n\t\t\t\tif ( !special.teardown ||\n\t\t\t\t\tspecial.teardown.call( elem, namespaces, elemData.handle ) === false ) {\n\n\t\t\t\t\tjQuery.removeEvent( elem, type, elemData.handle );\n\t\t\t\t}\n\n\t\t\t\tdelete events[ type ];\n\t\t\t}\n\t\t}\n\n\t\t// Remove data and the expando if it's no longer used\n\t\tif ( jQuery.isEmptyObject( events ) ) {\n\t\t\tdataPriv.remove( elem, \"handle events\" );\n\t\t}\n\t},\n\n\tdispatch: function( nativeEvent ) {\n\n\t\t// Make a writable jQuery.Event from the native event object\n\t\tvar event = jQuery.event.fix( nativeEvent );\n\n\t\tvar i, j, ret, matched, handleObj, handlerQueue,\n\t\t\targs = new Array( arguments.length ),\n\t\t\thandlers = ( dataPriv.get( this, \"events\" ) || {} )[ event.type ] || [],\n\t\t\tspecial = jQuery.event.special[ event.type ] || {};\n\n\t\t// Use the fix-ed jQuery.Event rather than the (read-only) native event\n\t\targs[ 0 ] = event;\n\n\t\tfor ( i = 1; i < arguments.length; i++ ) {\n\t\t\targs[ i ] = arguments[ i ];\n\t\t}\n\n\t\tevent.delegateTarget = this;\n\n\t\t// Call the preDispatch hook for the mapped type, and let it bail if desired\n\t\tif ( special.preDispatch && special.preDispatch.call( this, event ) === false ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Determine handlers\n\t\thandlerQueue = jQuery.event.handlers.call( this, event, handlers );\n\n\t\t// Run delegates first; they may want to stop propagation beneath us\n\t\ti = 0;\n\t\twhile ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) {\n\t\t\tevent.currentTarget = matched.elem;\n\n\t\t\tj = 0;\n\t\t\twhile ( ( handleObj = matched.handlers[ j++ ] ) &&\n\t\t\t\t!event.isImmediatePropagationStopped() ) {\n\n\t\t\t\t// Triggered event must either 1) have no namespace, or 2) have namespace(s)\n\t\t\t\t// a subset or equal to those in the bound event (both can have no namespace).\n\t\t\t\tif ( !event.rnamespace || event.rnamespace.test( handleObj.namespace ) ) {\n\n\t\t\t\t\tevent.handleObj = handleObj;\n\t\t\t\t\tevent.data = handleObj.data;\n\n\t\t\t\t\tret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle ||\n\t\t\t\t\t\thandleObj.handler ).apply( matched.elem, args );\n\n\t\t\t\t\tif ( ret !== undefined ) {\n\t\t\t\t\t\tif ( ( event.result = ret ) === false ) {\n\t\t\t\t\t\t\tevent.preventDefault();\n\t\t\t\t\t\t\tevent.stopPropagation();\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Call the postDispatch hook for the mapped type\n\t\tif ( special.postDispatch ) {\n\t\t\tspecial.postDispatch.call( this, event );\n\t\t}\n\n\t\treturn event.result;\n\t},\n\n\thandlers: function( event, handlers ) {\n\t\tvar i, handleObj, sel, matchedHandlers, matchedSelectors,\n\t\t\thandlerQueue = [],\n\t\t\tdelegateCount = handlers.delegateCount,\n\t\t\tcur = event.target;\n\n\t\t// Find delegate handlers\n\t\tif ( delegateCount &&\n\n\t\t\t// Support: IE <=9\n\t\t\t// Black-hole SVG <use> instance trees (trac-13180)\n\t\t\tcur.nodeType &&\n\n\t\t\t// Support: Firefox <=42\n\t\t\t// Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861)\n\t\t\t// https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click\n\t\t\t// Support: IE 11 only\n\t\t\t// ...but not arrow key \"clicks\" of radio inputs, which can have `button` -1 (gh-2343)\n\t\t\t!( event.type === \"click\" && event.button >= 1 ) ) {\n\n\t\t\tfor ( ; cur !== this; cur = cur.parentNode || this ) {\n\n\t\t\t\t// Don't check non-elements (#13208)\n\t\t\t\t// Don't process clicks on disabled elements (#6911, #8165, #11382, #11764)\n\t\t\t\tif ( cur.nodeType === 1 && !( event.type === \"click\" && cur.disabled === true ) ) {\n\t\t\t\t\tmatchedHandlers = [];\n\t\t\t\t\tmatchedSelectors = {};\n\t\t\t\t\tfor ( i = 0; i < delegateCount; i++ ) {\n\t\t\t\t\t\thandleObj = handlers[ i ];\n\n\t\t\t\t\t\t// Don't conflict with Object.prototype properties (#13203)\n\t\t\t\t\t\tsel = handleObj.selector + \" \";\n\n\t\t\t\t\t\tif ( matchedSelectors[ sel ] === undefined ) {\n\t\t\t\t\t\t\tmatchedSelectors[ sel ] = handleObj.needsContext ?\n\t\t\t\t\t\t\t\tjQuery( sel, this ).index( cur ) > -1 :\n\t\t\t\t\t\t\t\tjQuery.find( sel, this, null, [ cur ] ).length;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif ( matchedSelectors[ sel ] ) {\n\t\t\t\t\t\t\tmatchedHandlers.push( handleObj );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tif ( matchedHandlers.length ) {\n\t\t\t\t\t\thandlerQueue.push( { elem: cur, handlers: matchedHandlers } );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Add the remaining (directly-bound) handlers\n\t\tcur = this;\n\t\tif ( delegateCount < handlers.length ) {\n\t\t\thandlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } );\n\t\t}\n\n\t\treturn handlerQueue;\n\t},\n\n\taddProp: function( name, hook ) {\n\t\tObject.defineProperty( jQuery.Event.prototype, name, {\n\t\t\tenumerable: true,\n\t\t\tconfigurable: true,\n\n\t\t\tget: isFunction( hook ) ?\n\t\t\t\tfunction() {\n\t\t\t\t\tif ( this.originalEvent ) {\n\t\t\t\t\t\t\treturn hook( this.originalEvent );\n\t\t\t\t\t}\n\t\t\t\t} :\n\t\t\t\tfunction() {\n\t\t\t\t\tif ( this.originalEvent ) {\n\t\t\t\t\t\t\treturn this.originalEvent[ name ];\n\t\t\t\t\t}\n\t\t\t\t},\n\n\t\t\tset: function( value ) {\n\t\t\t\tObject.defineProperty( this, name, {\n\t\t\t\t\tenumerable: true,\n\t\t\t\t\tconfigurable: true,\n\t\t\t\t\twritable: true,\n\t\t\t\t\tvalue: value\n\t\t\t\t} );\n\t\t\t}\n\t\t} );\n\t},\n\n\tfix: function( originalEvent ) {\n\t\treturn originalEvent[ jQuery.expando ] ?\n\t\t\toriginalEvent :\n\t\t\tnew jQuery.Event( originalEvent );\n\t},\n\n\tspecial: {\n\t\tload: {\n\n\t\t\t// Prevent triggered image.load events from bubbling to window.load\n\t\t\tnoBubble: true\n\t\t},\n\t\tfocus: {\n\n\t\t\t// Fire native event if possible so blur/focus sequence is correct\n\t\t\ttrigger: function() {\n\t\t\t\tif ( this !== safeActiveElement() && this.focus ) {\n\t\t\t\t\tthis.focus();\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\t\t\tdelegateType: \"focusin\"\n\t\t},\n\t\tblur: {\n\t\t\ttrigger: function() {\n\t\t\t\tif ( this === safeActiveElement() && this.blur ) {\n\t\t\t\t\tthis.blur();\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\t\t\tdelegateType: \"focusout\"\n\t\t},\n\t\tclick: {\n\n\t\t\t// For checkbox, fire native event so checked state will be right\n\t\t\ttrigger: function() {\n\t\t\t\tif ( this.type === \"checkbox\" && this.click && nodeName( this, \"input\" ) ) {\n\t\t\t\t\tthis.click();\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\n\t\t\t// For cross-browser consistency, don't fire native .click() on links\n\t\t\t_default: function( event ) {\n\t\t\t\treturn nodeName( event.target, \"a\" );\n\t\t\t}\n\t\t},\n\n\t\tbeforeunload: {\n\t\t\tpostDispatch: function( event ) {\n\n\t\t\t\t// Support: Firefox 20+\n\t\t\t\t// Firefox doesn't alert if the returnValue field is not set.\n\t\t\t\tif ( event.result !== undefined && event.originalEvent ) {\n\t\t\t\t\tevent.originalEvent.returnValue = event.result;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n};\n\njQuery.removeEvent = function( elem, type, handle ) {\n\n\t// This \"if\" is needed for plain objects\n\tif ( elem.removeEventListener ) {\n\t\telem.removeEventListener( type, handle );\n\t}\n};\n\njQuery.Event = function( src, props ) {\n\n\t// Allow instantiation without the 'new' keyword\n\tif ( !( this instanceof jQuery.Event ) ) {\n\t\treturn new jQuery.Event( src, props );\n\t}\n\n\t// Event object\n\tif ( src && src.type ) {\n\t\tthis.originalEvent = src;\n\t\tthis.type = src.type;\n\n\t\t// Events bubbling up the document may have been marked as prevented\n\t\t// by a handler lower down the tree; reflect the correct value.\n\t\tthis.isDefaultPrevented = src.defaultPrevented ||\n\t\t\t\tsrc.defaultPrevented === undefined &&\n\n\t\t\t\t// Support: Android <=2.3 only\n\t\t\t\tsrc.returnValue === false ?\n\t\t\treturnTrue :\n\t\t\treturnFalse;\n\n\t\t// Create target properties\n\t\t// Support: Safari <=6 - 7 only\n\t\t// Target should not be a text node (#504, #13143)\n\t\tthis.target = ( src.target && src.target.nodeType === 3 ) ?\n\t\t\tsrc.target.parentNode :\n\t\t\tsrc.target;\n\n\t\tthis.currentTarget = src.currentTarget;\n\t\tthis.relatedTarget = src.relatedTarget;\n\n\t// Event type\n\t} else {\n\t\tthis.type = src;\n\t}\n\n\t// Put explicitly provided properties onto the event object\n\tif ( props ) {\n\t\tjQuery.extend( this, props );\n\t}\n\n\t// Create a timestamp if incoming event doesn't have one\n\tthis.timeStamp = src && src.timeStamp || Date.now();\n\n\t// Mark it as fixed\n\tthis[ jQuery.expando ] = true;\n};\n\n// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding\n// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html\njQuery.Event.prototype = {\n\tconstructor: jQuery.Event,\n\tisDefaultPrevented: returnFalse,\n\tisPropagationStopped: returnFalse,\n\tisImmediatePropagationStopped: returnFalse,\n\tisSimulated: false,\n\n\tpreventDefault: function() {\n\t\tvar e = this.originalEvent;\n\n\t\tthis.isDefaultPrevented = returnTrue;\n\n\t\tif ( e && !this.isSimulated ) {\n\t\t\te.preventDefault();\n\t\t}\n\t},\n\tstopPropagation: function() {\n\t\tvar e = this.originalEvent;\n\n\t\tthis.isPropagationStopped = returnTrue;\n\n\t\tif ( e && !this.isSimulated ) {\n\t\t\te.stopPropagation();\n\t\t}\n\t},\n\tstopImmediatePropagation: function() {\n\t\tvar e = this.originalEvent;\n\n\t\tthis.isImmediatePropagationStopped = returnTrue;\n\n\t\tif ( e && !this.isSimulated ) {\n\t\t\te.stopImmediatePropagation();\n\t\t}\n\n\t\tthis.stopPropagation();\n\t}\n};\n\n// Includes all common event props including KeyEvent and MouseEvent specific props\njQuery.each( {\n\taltKey: true,\n\tbubbles: true,\n\tcancelable: true,\n\tchangedTouches: true,\n\tctrlKey: true,\n\tdetail: true,\n\teventPhase: true,\n\tmetaKey: true,\n\tpageX: true,\n\tpageY: true,\n\tshiftKey: true,\n\tview: true,\n\t\"char\": true,\n\tcharCode: true,\n\tkey: true,\n\tkeyCode: true,\n\tbutton: true,\n\tbuttons: true,\n\tclientX: true,\n\tclientY: true,\n\toffsetX: true,\n\toffsetY: true,\n\tpointerId: true,\n\tpointerType: true,\n\tscreenX: true,\n\tscreenY: true,\n\ttargetTouches: true,\n\ttoElement: true,\n\ttouches: true,\n\n\twhich: function( event ) {\n\t\tvar button = event.button;\n\n\t\t// Add which for key events\n\t\tif ( event.which == null && rkeyEvent.test( event.type ) ) {\n\t\t\treturn event.charCode != null ? event.charCode : event.keyCode;\n\t\t}\n\n\t\t// Add which for click: 1 === left; 2 === middle; 3 === right\n\t\tif ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) {\n\t\t\tif ( button & 1 ) {\n\t\t\t\treturn 1;\n\t\t\t}\n\n\t\t\tif ( button & 2 ) {\n\t\t\t\treturn 3;\n\t\t\t}\n\n\t\t\tif ( button & 4 ) {\n\t\t\t\treturn 2;\n\t\t\t}\n\n\t\t\treturn 0;\n\t\t}\n\n\t\treturn event.which;\n\t}\n}, jQuery.event.addProp );\n\n// Create mouseenter/leave events using mouseover/out and event-time checks\n// so that event delegation works in jQuery.\n// Do the same for pointerenter/pointerleave and pointerover/pointerout\n//\n// Support: Safari 7 only\n// Safari sends mouseenter too often; see:\n// https://bugs.chromium.org/p/chromium/issues/detail?id=470258\n// for the description of the bug (it existed in older Chrome versions as well).\njQuery.each( {\n\tmouseenter: \"mouseover\",\n\tmouseleave: \"mouseout\",\n\tpointerenter: \"pointerover\",\n\tpointerleave: \"pointerout\"\n}, function( orig, fix ) {\n\tjQuery.event.special[ orig ] = {\n\t\tdelegateType: fix,\n\t\tbindType: fix,\n\n\t\thandle: function( event ) {\n\t\t\tvar ret,\n\t\t\t\ttarget = this,\n\t\t\t\trelated = event.relatedTarget,\n\t\t\t\thandleObj = event.handleObj;\n\n\t\t\t// For mouseenter/leave call the handler if related is outside the target.\n\t\t\t// NB: No relatedTarget if the mouse left/entered the browser window\n\t\t\tif ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) {\n\t\t\t\tevent.type = handleObj.origType;\n\t\t\t\tret = handleObj.handler.apply( this, arguments );\n\t\t\t\tevent.type = fix;\n\t\t\t}\n\t\t\treturn ret;\n\t\t}\n\t};\n} );\n\njQuery.fn.extend( {\n\n\ton: function( types, selector, data, fn ) {\n\t\treturn on( this, types, selector, data, fn );\n\t},\n\tone: function( types, selector, data, fn ) {\n\t\treturn on( this, types, selector, data, fn, 1 );\n\t},\n\toff: function( types, selector, fn ) {\n\t\tvar handleObj, type;\n\t\tif ( types && types.preventDefault && types.handleObj ) {\n\n\t\t\t// ( event ) dispatched jQuery.Event\n\t\t\thandleObj = types.handleObj;\n\t\t\tjQuery( types.delegateTarget ).off(\n\t\t\t\thandleObj.namespace ?\n\t\t\t\t\thandleObj.origType + \".\" + handleObj.namespace :\n\t\t\t\t\thandleObj.origType,\n\t\t\t\thandleObj.selector,\n\t\t\t\thandleObj.handler\n\t\t\t);\n\t\t\treturn this;\n\t\t}\n\t\tif ( typeof types === \"object\" ) {\n\n\t\t\t// ( types-object [, selector] )\n\t\t\tfor ( type in types ) {\n\t\t\t\tthis.off( type, selector, types[ type ] );\n\t\t\t}\n\t\t\treturn this;\n\t\t}\n\t\tif ( selector === false || typeof selector === \"function\" ) {\n\n\t\t\t// ( types [, fn] )\n\t\t\tfn = selector;\n\t\t\tselector = undefined;\n\t\t}\n\t\tif ( fn === false ) {\n\t\t\tfn = returnFalse;\n\t\t}\n\t\treturn this.each( function() {\n\t\t\tjQuery.event.remove( this, types, fn, selector );\n\t\t} );\n\t}\n} );\n\n\nvar\n\n\t/* eslint-disable max-len */\n\n\t// See https://github.com/eslint/eslint/issues/3229\n\trxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([a-z][^\\/\\0>\\x20\\t\\r\\n\\f]*)[^>]*)\\/>/gi,\n\n\t/* eslint-enable */\n\n\t// Support: IE <=10 - 11, Edge 12 - 13 only\n\t// In IE/Edge using regex groups here causes severe slowdowns.\n\t// See https://connect.microsoft.com/IE/feedback/details/1736512/\n\trnoInnerhtml = /<script|<style|<link/i,\n\n\t// checked=\"checked\" or checked\n\trchecked = /checked\\s*(?:[^=]|=\\s*.checked.)/i,\n\trcleanScript = /^\\s*<!(?:\\[CDATA\\[|--)|(?:\\]\\]|--)>\\s*$/g;\n\n// Prefer a tbody over its parent table for containing new rows\nfunction manipulationTarget( elem, content ) {\n\tif ( nodeName( elem, \"table\" ) &&\n\t\tnodeName( content.nodeType !== 11 ? content : content.firstChild, \"tr\" ) ) {\n\n\t\treturn jQuery( elem ).children( \"tbody\" )[ 0 ] || elem;\n\t}\n\n\treturn elem;\n}\n\n// Replace/restore the type attribute of script elements for safe DOM manipulation\nfunction disableScript( elem ) {\n\telem.type = ( elem.getAttribute( \"type\" ) !== null ) + \"/\" + elem.type;\n\treturn elem;\n}\nfunction restoreScript( elem ) {\n\tif ( ( elem.type || \"\" ).slice( 0, 5 ) === \"true/\" ) {\n\t\telem.type = elem.type.slice( 5 );\n\t} else {\n\t\telem.removeAttribute( \"type\" );\n\t}\n\n\treturn elem;\n}\n\nfunction cloneCopyEvent( src, dest ) {\n\tvar i, l, type, pdataOld, pdataCur, udataOld, udataCur, events;\n\n\tif ( dest.nodeType !== 1 ) {\n\t\treturn;\n\t}\n\n\t// 1. Copy private data: events, handlers, etc.\n\tif ( dataPriv.hasData( src ) ) {\n\t\tpdataOld = dataPriv.access( src );\n\t\tpdataCur = dataPriv.set( dest, pdataOld );\n\t\tevents = pdataOld.events;\n\n\t\tif ( events ) {\n\t\t\tdelete pdataCur.handle;\n\t\t\tpdataCur.events = {};\n\n\t\t\tfor ( type in events ) {\n\t\t\t\tfor ( i = 0, l = events[ type ].length; i < l; i++ ) {\n\t\t\t\t\tjQuery.event.add( dest, type, events[ type ][ i ] );\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// 2. Copy user data\n\tif ( dataUser.hasData( src ) ) {\n\t\tudataOld = dataUser.access( src );\n\t\tudataCur = jQuery.extend( {}, udataOld );\n\n\t\tdataUser.set( dest, udataCur );\n\t}\n}\n\n// Fix IE bugs, see support tests\nfunction fixInput( src, dest ) {\n\tvar nodeName = dest.nodeName.toLowerCase();\n\n\t// Fails to persist the checked state of a cloned checkbox or radio button.\n\tif ( nodeName === \"input\" && rcheckableType.test( src.type ) ) {\n\t\tdest.checked = src.checked;\n\n\t// Fails to return the selected option to the default selected state when cloning options\n\t} else if ( nodeName === \"input\" || nodeName === \"textarea\" ) {\n\t\tdest.defaultValue = src.defaultValue;\n\t}\n}\n\nfunction domManip( collection, args, callback, ignored ) {\n\n\t// Flatten any nested arrays\n\targs = concat.apply( [], args );\n\n\tvar fragment, first, scripts, hasScripts, node, doc,\n\t\ti = 0,\n\t\tl = collection.length,\n\t\tiNoClone = l - 1,\n\t\tvalue = args[ 0 ],\n\t\tvalueIsFunction = isFunction( value );\n\n\t// We can't cloneNode fragments that contain checked, in WebKit\n\tif ( valueIsFunction ||\n\t\t\t( l > 1 && typeof value === \"string\" &&\n\t\t\t\t!support.checkClone && rchecked.test( value ) ) ) {\n\t\treturn collection.each( function( index ) {\n\t\t\tvar self = collection.eq( index );\n\t\t\tif ( valueIsFunction ) {\n\t\t\t\targs[ 0 ] = value.call( this, index, self.html() );\n\t\t\t}\n\t\t\tdomManip( self, args, callback, ignored );\n\t\t} );\n\t}\n\n\tif ( l ) {\n\t\tfragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored );\n\t\tfirst = fragment.firstChild;\n\n\t\tif ( fragment.childNodes.length === 1 ) {\n\t\t\tfragment = first;\n\t\t}\n\n\t\t// Require either new content or an interest in ignored elements to invoke the callback\n\t\tif ( first || ignored ) {\n\t\t\tscripts = jQuery.map( getAll( fragment, \"script\" ), disableScript );\n\t\t\thasScripts = scripts.length;\n\n\t\t\t// Use the original fragment for the last item\n\t\t\t// instead of the first because it can end up\n\t\t\t// being emptied incorrectly in certain situations (#8070).\n\t\t\tfor ( ; i < l; i++ ) {\n\t\t\t\tnode = fragment;\n\n\t\t\t\tif ( i !== iNoClone ) {\n\t\t\t\t\tnode = jQuery.clone( node, true, true );\n\n\t\t\t\t\t// Keep references to cloned scripts for later restoration\n\t\t\t\t\tif ( hasScripts ) {\n\n\t\t\t\t\t\t// Support: Android <=4.0 only, PhantomJS 1 only\n\t\t\t\t\t\t// push.apply(_, arraylike) throws on ancient WebKit\n\t\t\t\t\t\tjQuery.merge( scripts, getAll( node, \"script\" ) );\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tcallback.call( collection[ i ], node, i );\n\t\t\t}\n\n\t\t\tif ( hasScripts ) {\n\t\t\t\tdoc = scripts[ scripts.length - 1 ].ownerDocument;\n\n\t\t\t\t// Reenable scripts\n\t\t\t\tjQuery.map( scripts, restoreScript );\n\n\t\t\t\t// Evaluate executable scripts on first document insertion\n\t\t\t\tfor ( i = 0; i < hasScripts; i++ ) {\n\t\t\t\t\tnode = scripts[ i ];\n\t\t\t\t\tif ( rscriptType.test( node.type || \"\" ) &&\n\t\t\t\t\t\t!dataPriv.access( node, \"globalEval\" ) &&\n\t\t\t\t\t\tjQuery.contains( doc, node ) ) {\n\n\t\t\t\t\t\tif ( node.src && ( node.type || \"\" ).toLowerCase() !== \"module\" ) {\n\n\t\t\t\t\t\t\t// Optional AJAX dependency, but won't run scripts if not present\n\t\t\t\t\t\t\tif ( jQuery._evalUrl ) {\n\t\t\t\t\t\t\t\tjQuery._evalUrl( node.src );\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tDOMEval( node.textContent.replace( rcleanScript, \"\" ), doc, node );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\treturn collection;\n}\n\nfunction remove( elem, selector, keepData ) {\n\tvar node,\n\t\tnodes = selector ? jQuery.filter( selector, elem ) : elem,\n\t\ti = 0;\n\n\tfor ( ; ( node = nodes[ i ] ) != null; i++ ) {\n\t\tif ( !keepData && node.nodeType === 1 ) {\n\t\t\tjQuery.cleanData( getAll( node ) );\n\t\t}\n\n\t\tif ( node.parentNode ) {\n\t\t\tif ( keepData && jQuery.contains( node.ownerDocument, node ) ) {\n\t\t\t\tsetGlobalEval( getAll( node, \"script\" ) );\n\t\t\t}\n\t\t\tnode.parentNode.removeChild( node );\n\t\t}\n\t}\n\n\treturn elem;\n}\n\njQuery.extend( {\n\thtmlPrefilter: function( html ) {\n\t\treturn html.replace( rxhtmlTag, \"<$1></$2>\" );\n\t},\n\n\tclone: function( elem, dataAndEvents, deepDataAndEvents ) {\n\t\tvar i, l, srcElements, destElements,\n\t\t\tclone = elem.cloneNode( true ),\n\t\t\tinPage = jQuery.contains( elem.ownerDocument, elem );\n\n\t\t// Fix IE cloning issues\n\t\tif ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) &&\n\t\t\t\t!jQuery.isXMLDoc( elem ) ) {\n\n\t\t\t// We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2\n\t\t\tdestElements = getAll( clone );\n\t\t\tsrcElements = getAll( elem );\n\n\t\t\tfor ( i = 0, l = srcElements.length; i < l; i++ ) {\n\t\t\t\tfixInput( srcElements[ i ], destElements[ i ] );\n\t\t\t}\n\t\t}\n\n\t\t// Copy the events from the original to the clone\n\t\tif ( dataAndEvents ) {\n\t\t\tif ( deepDataAndEvents ) {\n\t\t\t\tsrcElements = srcElements || getAll( elem );\n\t\t\t\tdestElements = destElements || getAll( clone );\n\n\t\t\t\tfor ( i = 0, l = srcElements.length; i < l; i++ ) {\n\t\t\t\t\tcloneCopyEvent( srcElements[ i ], destElements[ i ] );\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tcloneCopyEvent( elem, clone );\n\t\t\t}\n\t\t}\n\n\t\t// Preserve script evaluation history\n\t\tdestElements = getAll( clone, \"script\" );\n\t\tif ( destElements.length > 0 ) {\n\t\t\tsetGlobalEval( destElements, !inPage && getAll( elem, \"script\" ) );\n\t\t}\n\n\t\t// Return the cloned set\n\t\treturn clone;\n\t},\n\n\tcleanData: function( elems ) {\n\t\tvar data, elem, type,\n\t\t\tspecial = jQuery.event.special,\n\t\t\ti = 0;\n\n\t\tfor ( ; ( elem = elems[ i ] ) !== undefined; i++ ) {\n\t\t\tif ( acceptData( elem ) ) {\n\t\t\t\tif ( ( data = elem[ dataPriv.expando ] ) ) {\n\t\t\t\t\tif ( data.events ) {\n\t\t\t\t\t\tfor ( type in data.events ) {\n\t\t\t\t\t\t\tif ( special[ type ] ) {\n\t\t\t\t\t\t\t\tjQuery.event.remove( elem, type );\n\n\t\t\t\t\t\t\t// This is a shortcut to avoid jQuery.event.remove's overhead\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\tjQuery.removeEvent( elem, type, data.handle );\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Support: Chrome <=35 - 45+\n\t\t\t\t\t// Assign undefined instead of using delete, see Data#remove\n\t\t\t\t\telem[ dataPriv.expando ] = undefined;\n\t\t\t\t}\n\t\t\t\tif ( elem[ dataUser.expando ] ) {\n\n\t\t\t\t\t// Support: Chrome <=35 - 45+\n\t\t\t\t\t// Assign undefined instead of using delete, see Data#remove\n\t\t\t\t\telem[ dataUser.expando ] = undefined;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n} );\n\njQuery.fn.extend( {\n\tdetach: function( selector ) {\n\t\treturn remove( this, selector, true );\n\t},\n\n\tremove: function( selector ) {\n\t\treturn remove( this, selector );\n\t},\n\n\ttext: function( value ) {\n\t\treturn access( this, function( value ) {\n\t\t\treturn value === undefined ?\n\t\t\t\tjQuery.text( this ) :\n\t\t\t\tthis.empty().each( function() {\n\t\t\t\t\tif ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {\n\t\t\t\t\t\tthis.textContent = value;\n\t\t\t\t\t}\n\t\t\t\t} );\n\t\t}, null, value, arguments.length );\n\t},\n\n\tappend: function() {\n\t\treturn domManip( this, arguments, function( elem ) {\n\t\t\tif ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {\n\t\t\t\tvar target = manipulationTarget( this, elem );\n\t\t\t\ttarget.appendChild( elem );\n\t\t\t}\n\t\t} );\n\t},\n\n\tprepend: function() {\n\t\treturn domManip( this, arguments, function( elem ) {\n\t\t\tif ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {\n\t\t\t\tvar target = manipulationTarget( this, elem );\n\t\t\t\ttarget.insertBefore( elem, target.firstChild );\n\t\t\t}\n\t\t} );\n\t},\n\n\tbefore: function() {\n\t\treturn domManip( this, arguments, function( elem ) {\n\t\t\tif ( this.parentNode ) {\n\t\t\t\tthis.parentNode.insertBefore( elem, this );\n\t\t\t}\n\t\t} );\n\t},\n\n\tafter: function() {\n\t\treturn domManip( this, arguments, function( elem ) {\n\t\t\tif ( this.parentNode ) {\n\t\t\t\tthis.parentNode.insertBefore( elem, this.nextSibling );\n\t\t\t}\n\t\t} );\n\t},\n\n\tempty: function() {\n\t\tvar elem,\n\t\t\ti = 0;\n\n\t\tfor ( ; ( elem = this[ i ] ) != null; i++ ) {\n\t\t\tif ( elem.nodeType === 1 ) {\n\n\t\t\t\t// Prevent memory leaks\n\t\t\t\tjQuery.cleanData( getAll( elem, false ) );\n\n\t\t\t\t// Remove any remaining nodes\n\t\t\t\telem.textContent = \"\";\n\t\t\t}\n\t\t}\n\n\t\treturn this;\n\t},\n\n\tclone: function( dataAndEvents, deepDataAndEvents ) {\n\t\tdataAndEvents = dataAndEvents == null ? false : dataAndEvents;\n\t\tdeepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents;\n\n\t\treturn this.map( function() {\n\t\t\treturn jQuery.clone( this, dataAndEvents, deepDataAndEvents );\n\t\t} );\n\t},\n\n\thtml: function( value ) {\n\t\treturn access( this, function( value ) {\n\t\t\tvar elem = this[ 0 ] || {},\n\t\t\t\ti = 0,\n\t\t\t\tl = this.length;\n\n\t\t\tif ( value === undefined && elem.nodeType === 1 ) {\n\t\t\t\treturn elem.innerHTML;\n\t\t\t}\n\n\t\t\t// See if we can take a shortcut and just use innerHTML\n\t\t\tif ( typeof value === \"string\" && !rnoInnerhtml.test( value ) &&\n\t\t\t\t!wrapMap[ ( rtagName.exec( value ) || [ \"\", \"\" ] )[ 1 ].toLowerCase() ] ) {\n\n\t\t\t\tvalue = jQuery.htmlPrefilter( value );\n\n\t\t\t\ttry {\n\t\t\t\t\tfor ( ; i < l; i++ ) {\n\t\t\t\t\t\telem = this[ i ] || {};\n\n\t\t\t\t\t\t// Remove element nodes and prevent memory leaks\n\t\t\t\t\t\tif ( elem.nodeType === 1 ) {\n\t\t\t\t\t\t\tjQuery.cleanData( getAll( elem, false ) );\n\t\t\t\t\t\t\telem.innerHTML = value;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\telem = 0;\n\n\t\t\t\t// If using innerHTML throws an exception, use the fallback method\n\t\t\t\t} catch ( e ) {}\n\t\t\t}\n\n\t\t\tif ( elem ) {\n\t\t\t\tthis.empty().append( value );\n\t\t\t}\n\t\t}, null, value, arguments.length );\n\t},\n\n\treplaceWith: function() {\n\t\tvar ignored = [];\n\n\t\t// Make the changes, replacing each non-ignored context element with the new content\n\t\treturn domManip( this, arguments, function( elem ) {\n\t\t\tvar parent = this.parentNode;\n\n\t\t\tif ( jQuery.inArray( this, ignored ) < 0 ) {\n\t\t\t\tjQuery.cleanData( getAll( this ) );\n\t\t\t\tif ( parent ) {\n\t\t\t\t\tparent.replaceChild( elem, this );\n\t\t\t\t}\n\t\t\t}\n\n\t\t// Force callback invocation\n\t\t}, ignored );\n\t}\n} );\n\njQuery.each( {\n\tappendTo: \"append\",\n\tprependTo: \"prepend\",\n\tinsertBefore: \"before\",\n\tinsertAfter: \"after\",\n\treplaceAll: \"replaceWith\"\n}, function( name, original ) {\n\tjQuery.fn[ name ] = function( selector ) {\n\t\tvar elems,\n\t\t\tret = [],\n\t\t\tinsert = jQuery( selector ),\n\t\t\tlast = insert.length - 1,\n\t\t\ti = 0;\n\n\t\tfor ( ; i <= last; i++ ) {\n\t\t\telems = i === last ? this : this.clone( true );\n\t\t\tjQuery( insert[ i ] )[ original ]( elems );\n\n\t\t\t// Support: Android <=4.0 only, PhantomJS 1 only\n\t\t\t// .get() because push.apply(_, arraylike) throws on ancient WebKit\n\t\t\tpush.apply( ret, elems.get() );\n\t\t}\n\n\t\treturn this.pushStack( ret );\n\t};\n} );\nvar rnumnonpx = new RegExp( \"^(\" + pnum + \")(?!px)[a-z%]+$\", \"i\" );\n\nvar getStyles = function( elem ) {\n\n\t\t// Support: IE <=11 only, Firefox <=30 (#15098, #14150)\n\t\t// IE throws on elements created in popups\n\t\t// FF meanwhile throws on frame elements through \"defaultView.getComputedStyle\"\n\t\tvar view = elem.ownerDocument.defaultView;\n\n\t\tif ( !view || !view.opener ) {\n\t\t\tview = window;\n\t\t}\n\n\t\treturn view.getComputedStyle( elem );\n\t};\n\nvar rboxStyle = new RegExp( cssExpand.join( \"|\" ), \"i\" );\n\n\n\n( function() {\n\n\t// Executing both pixelPosition & boxSizingReliable tests require only one layout\n\t// so they're executed at the same time to save the second computation.\n\tfunction computeStyleTests() {\n\n\t\t// This is a singleton, we need to execute it only once\n\t\tif ( !div ) {\n\t\t\treturn;\n\t\t}\n\n\t\tcontainer.style.cssText = \"position:absolute;left:-11111px;width:60px;\" +\n\t\t\t\"margin-top:1px;padding:0;border:0\";\n\t\tdiv.style.cssText =\n\t\t\t\"position:relative;display:block;box-sizing:border-box;overflow:scroll;\" +\n\t\t\t\"margin:auto;border:1px;padding:1px;\" +\n\t\t\t\"width:60%;top:1%\";\n\t\tdocumentElement.appendChild( container ).appendChild( div );\n\n\t\tvar divStyle = window.getComputedStyle( div );\n\t\tpixelPositionVal = divStyle.top !== \"1%\";\n\n\t\t// Support: Android 4.0 - 4.3 only, Firefox <=3 - 44\n\t\treliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12;\n\n\t\t// Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3\n\t\t// Some styles come back with percentage values, even though they shouldn't\n\t\tdiv.style.right = \"60%\";\n\t\tpixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36;\n\n\t\t// Support: IE 9 - 11 only\n\t\t// Detect misreporting of content dimensions for box-sizing:border-box elements\n\t\tboxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36;\n\n\t\t// Support: IE 9 only\n\t\t// Detect overflow:scroll screwiness (gh-3699)\n\t\tdiv.style.position = \"absolute\";\n\t\tscrollboxSizeVal = div.offsetWidth === 36 || \"absolute\";\n\n\t\tdocumentElement.removeChild( container );\n\n\t\t// Nullify the div so it wouldn't be stored in the memory and\n\t\t// it will also be a sign that checks already performed\n\t\tdiv = null;\n\t}\n\n\tfunction roundPixelMeasures( measure ) {\n\t\treturn Math.round( parseFloat( measure ) );\n\t}\n\n\tvar pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal,\n\t\treliableMarginLeftVal,\n\t\tcontainer = document.createElement( \"div\" ),\n\t\tdiv = document.createElement( \"div\" );\n\n\t// Finish early in limited (non-browser) environments\n\tif ( !div.style ) {\n\t\treturn;\n\t}\n\n\t// Support: IE <=9 - 11 only\n\t// Style of cloned element affects source element cloned (#8908)\n\tdiv.style.backgroundClip = \"content-box\";\n\tdiv.cloneNode( true ).style.backgroundClip = \"\";\n\tsupport.clearCloneStyle = div.style.backgroundClip === \"content-box\";\n\n\tjQuery.extend( support, {\n\t\tboxSizingReliable: function() {\n\t\t\tcomputeStyleTests();\n\t\t\treturn boxSizingReliableVal;\n\t\t},\n\t\tpixelBoxStyles: function() {\n\t\t\tcomputeStyleTests();\n\t\t\treturn pixelBoxStylesVal;\n\t\t},\n\t\tpixelPosition: function() {\n\t\t\tcomputeStyleTests();\n\t\t\treturn pixelPositionVal;\n\t\t},\n\t\treliableMarginLeft: function() {\n\t\t\tcomputeStyleTests();\n\t\t\treturn reliableMarginLeftVal;\n\t\t},\n\t\tscrollboxSize: function() {\n\t\t\tcomputeStyleTests();\n\t\t\treturn scrollboxSizeVal;\n\t\t}\n\t} );\n} )();\n\n\nfunction curCSS( elem, name, computed ) {\n\tvar width, minWidth, maxWidth, ret,\n\n\t\t// Support: Firefox 51+\n\t\t// Retrieving style before computed somehow\n\t\t// fixes an issue with getting wrong values\n\t\t// on detached elements\n\t\tstyle = elem.style;\n\n\tcomputed = computed || getStyles( elem );\n\n\t// getPropertyValue is needed for:\n\t// .css('filter') (IE 9 only, #12537)\n\t// .css('--customProperty) (#3144)\n\tif ( computed ) {\n\t\tret = computed.getPropertyValue( name ) || computed[ name ];\n\n\t\tif ( ret === \"\" && !jQuery.contains( elem.ownerDocument, elem ) ) {\n\t\t\tret = jQuery.style( elem, name );\n\t\t}\n\n\t\t// A tribute to the \"awesome hack by Dean Edwards\"\n\t\t// Android Browser returns percentage for some values,\n\t\t// but width seems to be reliably pixels.\n\t\t// This is against the CSSOM draft spec:\n\t\t// https://drafts.csswg.org/cssom/#resolved-values\n\t\tif ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) {\n\n\t\t\t// Remember the original values\n\t\t\twidth = style.width;\n\t\t\tminWidth = style.minWidth;\n\t\t\tmaxWidth = style.maxWidth;\n\n\t\t\t// Put in the new values to get a computed value out\n\t\t\tstyle.minWidth = style.maxWidth = style.width = ret;\n\t\t\tret = computed.width;\n\n\t\t\t// Revert the changed values\n\t\t\tstyle.width = width;\n\t\t\tstyle.minWidth = minWidth;\n\t\t\tstyle.maxWidth = maxWidth;\n\t\t}\n\t}\n\n\treturn ret !== undefined ?\n\n\t\t// Support: IE <=9 - 11 only\n\t\t// IE returns zIndex value as an integer.\n\t\tret + \"\" :\n\t\tret;\n}\n\n\nfunction addGetHookIf( conditionFn, hookFn ) {\n\n\t// Define the hook, we'll check on the first run if it's really needed.\n\treturn {\n\t\tget: function() {\n\t\t\tif ( conditionFn() ) {\n\n\t\t\t\t// Hook not needed (or it's not possible to use it due\n\t\t\t\t// to missing dependency), remove it.\n\t\t\t\tdelete this.get;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Hook needed; redefine it so that the support test is not executed again.\n\t\t\treturn ( this.get = hookFn ).apply( this, arguments );\n\t\t}\n\t};\n}\n\n\nvar\n\n\t// Swappable if display is none or starts with table\n\t// except \"table\", \"table-cell\", or \"table-caption\"\n\t// See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display\n\trdisplayswap = /^(none|table(?!-c[ea]).+)/,\n\trcustomProp = /^--/,\n\tcssShow = { position: \"absolute\", visibility: \"hidden\", display: \"block\" },\n\tcssNormalTransform = {\n\t\tletterSpacing: \"0\",\n\t\tfontWeight: \"400\"\n\t},\n\n\tcssPrefixes = [ \"Webkit\", \"Moz\", \"ms\" ],\n\temptyStyle = document.createElement( \"div\" ).style;\n\n// Return a css property mapped to a potentially vendor prefixed property\nfunction vendorPropName( name ) {\n\n\t// Shortcut for names that are not vendor prefixed\n\tif ( name in emptyStyle ) {\n\t\treturn name;\n\t}\n\n\t// Check for vendor prefixed names\n\tvar capName = name[ 0 ].toUpperCase() + name.slice( 1 ),\n\t\ti = cssPrefixes.length;\n\n\twhile ( i-- ) {\n\t\tname = cssPrefixes[ i ] + capName;\n\t\tif ( name in emptyStyle ) {\n\t\t\treturn name;\n\t\t}\n\t}\n}\n\n// Return a property mapped along what jQuery.cssProps suggests or to\n// a vendor prefixed property.\nfunction finalPropName( name ) {\n\tvar ret = jQuery.cssProps[ name ];\n\tif ( !ret ) {\n\t\tret = jQuery.cssProps[ name ] = vendorPropName( name ) || name;\n\t}\n\treturn ret;\n}\n\nfunction setPositiveNumber( elem, value, subtract ) {\n\n\t// Any relative (+/-) values have already been\n\t// normalized at this point\n\tvar matches = rcssNum.exec( value );\n\treturn matches ?\n\n\t\t// Guard against undefined \"subtract\", e.g., when used as in cssHooks\n\t\tMath.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || \"px\" ) :\n\t\tvalue;\n}\n\nfunction boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) {\n\tvar i = dimension === \"width\" ? 1 : 0,\n\t\textra = 0,\n\t\tdelta = 0;\n\n\t// Adjustment may not be necessary\n\tif ( box === ( isBorderBox ? \"border\" : \"content\" ) ) {\n\t\treturn 0;\n\t}\n\n\tfor ( ; i < 4; i += 2 ) {\n\n\t\t// Both box models exclude margin\n\t\tif ( box === \"margin\" ) {\n\t\t\tdelta += jQuery.css( elem, box + cssExpand[ i ], true, styles );\n\t\t}\n\n\t\t// If we get here with a content-box, we're seeking \"padding\" or \"border\" or \"margin\"\n\t\tif ( !isBorderBox ) {\n\n\t\t\t// Add padding\n\t\t\tdelta += jQuery.css( elem, \"padding\" + cssExpand[ i ], true, styles );\n\n\t\t\t// For \"border\" or \"margin\", add border\n\t\t\tif ( box !== \"padding\" ) {\n\t\t\t\tdelta += jQuery.css( elem, \"border\" + cssExpand[ i ] + \"Width\", true, styles );\n\n\t\t\t// But still keep track of it otherwise\n\t\t\t} else {\n\t\t\t\textra += jQuery.css( elem, \"border\" + cssExpand[ i ] + \"Width\", true, styles );\n\t\t\t}\n\n\t\t// If we get here with a border-box (content + padding + border), we're seeking \"content\" or\n\t\t// \"padding\" or \"margin\"\n\t\t} else {\n\n\t\t\t// For \"content\", subtract padding\n\t\t\tif ( box === \"content\" ) {\n\t\t\t\tdelta -= jQuery.css( elem, \"padding\" + cssExpand[ i ], true, styles );\n\t\t\t}\n\n\t\t\t// For \"content\" or \"padding\", subtract border\n\t\t\tif ( box !== \"margin\" ) {\n\t\t\t\tdelta -= jQuery.css( elem, \"border\" + cssExpand[ i ] + \"Width\", true, styles );\n\t\t\t}\n\t\t}\n\t}\n\n\t// Account for positive content-box scroll gutter when requested by providing computedVal\n\tif ( !isBorderBox && computedVal >= 0 ) {\n\n\t\t// offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border\n\t\t// Assuming integer scroll gutter, subtract the rest and round down\n\t\tdelta += Math.max( 0, Math.ceil(\n\t\t\telem[ \"offset\" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] -\n\t\t\tcomputedVal -\n\t\t\tdelta -\n\t\t\textra -\n\t\t\t0.5\n\t\t) );\n\t}\n\n\treturn delta;\n}\n\nfunction getWidthOrHeight( elem, dimension, extra ) {\n\n\t// Start with computed style\n\tvar styles = getStyles( elem ),\n\t\tval = curCSS( elem, dimension, styles ),\n\t\tisBorderBox = jQuery.css( elem, \"boxSizing\", false, styles ) === \"border-box\",\n\t\tvalueIsBorderBox = isBorderBox;\n\n\t// Support: Firefox <=54\n\t// Return a confounding non-pixel value or feign ignorance, as appropriate.\n\tif ( rnumnonpx.test( val ) ) {\n\t\tif ( !extra ) {\n\t\t\treturn val;\n\t\t}\n\t\tval = \"auto\";\n\t}\n\n\t// Check for style in case a browser which returns unreliable values\n\t// for getComputedStyle silently falls back to the reliable elem.style\n\tvalueIsBorderBox = valueIsBorderBox &&\n\t\t( support.boxSizingReliable() || val === elem.style[ dimension ] );\n\n\t// Fall back to offsetWidth/offsetHeight when value is \"auto\"\n\t// This happens for inline elements with no explicit setting (gh-3571)\n\t// Support: Android <=4.1 - 4.3 only\n\t// Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602)\n\tif ( val === \"auto\" ||\n\t\t!parseFloat( val ) && jQuery.css( elem, \"display\", false, styles ) === \"inline\" ) {\n\n\t\tval = elem[ \"offset\" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ];\n\n\t\t// offsetWidth/offsetHeight provide border-box values\n\t\tvalueIsBorderBox = true;\n\t}\n\n\t// Normalize \"\" and auto\n\tval = parseFloat( val ) || 0;\n\n\t// Adjust for the element's box model\n\treturn ( val +\n\t\tboxModelAdjustment(\n\t\t\telem,\n\t\t\tdimension,\n\t\t\textra || ( isBorderBox ? \"border\" : \"content\" ),\n\t\t\tvalueIsBorderBox,\n\t\t\tstyles,\n\n\t\t\t// Provide the current computed size to request scroll gutter calculation (gh-3589)\n\t\t\tval\n\t\t)\n\t) + \"px\";\n}\n\njQuery.extend( {\n\n\t// Add in style property hooks for overriding the default\n\t// behavior of getting and setting a style property\n\tcssHooks: {\n\t\topacity: {\n\t\t\tget: function( elem, computed ) {\n\t\t\t\tif ( computed ) {\n\n\t\t\t\t\t// We should always get a number back from opacity\n\t\t\t\t\tvar ret = curCSS( elem, \"opacity\" );\n\t\t\t\t\treturn ret === \"\" ? \"1\" : ret;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t},\n\n\t// Don't automatically add \"px\" to these possibly-unitless properties\n\tcssNumber: {\n\t\t\"animationIterationCount\": true,\n\t\t\"columnCount\": true,\n\t\t\"fillOpacity\": true,\n\t\t\"flexGrow\": true,\n\t\t\"flexShrink\": true,\n\t\t\"fontWeight\": true,\n\t\t\"lineHeight\": true,\n\t\t\"opacity\": true,\n\t\t\"order\": true,\n\t\t\"orphans\": true,\n\t\t\"widows\": true,\n\t\t\"zIndex\": true,\n\t\t\"zoom\": true\n\t},\n\n\t// Add in properties whose names you wish to fix before\n\t// setting or getting the value\n\tcssProps: {},\n\n\t// Get and set the style property on a DOM Node\n\tstyle: function( elem, name, value, extra ) {\n\n\t\t// Don't set styles on text and comment nodes\n\t\tif ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Make sure that we're working with the right name\n\t\tvar ret, type, hooks,\n\t\t\torigName = camelCase( name ),\n\t\t\tisCustomProp = rcustomProp.test( name ),\n\t\t\tstyle = elem.style;\n\n\t\t// Make sure that we're working with the right name. We don't\n\t\t// want to query the value if it is a CSS custom property\n\t\t// since they are user-defined.\n\t\tif ( !isCustomProp ) {\n\t\t\tname = finalPropName( origName );\n\t\t}\n\n\t\t// Gets hook for the prefixed version, then unprefixed version\n\t\thooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];\n\n\t\t// Check if we're setting a value\n\t\tif ( value !== undefined ) {\n\t\t\ttype = typeof value;\n\n\t\t\t// Convert \"+=\" or \"-=\" to relative numbers (#7345)\n\t\t\tif ( type === \"string\" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) {\n\t\t\t\tvalue = adjustCSS( elem, name, ret );\n\n\t\t\t\t// Fixes bug #9237\n\t\t\t\ttype = \"number\";\n\t\t\t}\n\n\t\t\t// Make sure that null and NaN values aren't set (#7116)\n\t\t\tif ( value == null || value !== value ) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// If a number was passed in, add the unit (except for certain CSS properties)\n\t\t\tif ( type === \"number\" ) {\n\t\t\t\tvalue += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? \"\" : \"px\" );\n\t\t\t}\n\n\t\t\t// background-* props affect original clone's values\n\t\t\tif ( !support.clearCloneStyle && value === \"\" && name.indexOf( \"background\" ) === 0 ) {\n\t\t\t\tstyle[ name ] = \"inherit\";\n\t\t\t}\n\n\t\t\t// If a hook was provided, use that value, otherwise just set the specified value\n\t\t\tif ( !hooks || !( \"set\" in hooks ) ||\n\t\t\t\t( value = hooks.set( elem, value, extra ) ) !== undefined ) {\n\n\t\t\t\tif ( isCustomProp ) {\n\t\t\t\t\tstyle.setProperty( name, value );\n\t\t\t\t} else {\n\t\t\t\t\tstyle[ name ] = value;\n\t\t\t\t}\n\t\t\t}\n\n\t\t} else {\n\n\t\t\t// If a hook was provided get the non-computed value from there\n\t\t\tif ( hooks && \"get\" in hooks &&\n\t\t\t\t( ret = hooks.get( elem, false, extra ) ) !== undefined ) {\n\n\t\t\t\treturn ret;\n\t\t\t}\n\n\t\t\t// Otherwise just get the value from the style object\n\t\t\treturn style[ name ];\n\t\t}\n\t},\n\n\tcss: function( elem, name, extra, styles ) {\n\t\tvar val, num, hooks,\n\t\t\torigName = camelCase( name ),\n\t\t\tisCustomProp = rcustomProp.test( name );\n\n\t\t// Make sure that we're working with the right name. We don't\n\t\t// want to modify the value if it is a CSS custom property\n\t\t// since they are user-defined.\n\t\tif ( !isCustomProp ) {\n\t\t\tname = finalPropName( origName );\n\t\t}\n\n\t\t// Try prefixed name followed by the unprefixed name\n\t\thooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];\n\n\t\t// If a hook was provided get the computed value from there\n\t\tif ( hooks && \"get\" in hooks ) {\n\t\t\tval = hooks.get( elem, true, extra );\n\t\t}\n\n\t\t// Otherwise, if a way to get the computed value exists, use that\n\t\tif ( val === undefined ) {\n\t\t\tval = curCSS( elem, name, styles );\n\t\t}\n\n\t\t// Convert \"normal\" to computed value\n\t\tif ( val === \"normal\" && name in cssNormalTransform ) {\n\t\t\tval = cssNormalTransform[ name ];\n\t\t}\n\n\t\t// Make numeric if forced or a qualifier was provided and val looks numeric\n\t\tif ( extra === \"\" || extra ) {\n\t\t\tnum = parseFloat( val );\n\t\t\treturn extra === true || isFinite( num ) ? num || 0 : val;\n\t\t}\n\n\t\treturn val;\n\t}\n} );\n\njQuery.each( [ \"height\", \"width\" ], function( i, dimension ) {\n\tjQuery.cssHooks[ dimension ] = {\n\t\tget: function( elem, computed, extra ) {\n\t\t\tif ( computed ) {\n\n\t\t\t\t// Certain elements can have dimension info if we invisibly show them\n\t\t\t\t// but it must have a current display style that would benefit\n\t\t\t\treturn rdisplayswap.test( jQuery.css( elem, \"display\" ) ) &&\n\n\t\t\t\t\t// Support: Safari 8+\n\t\t\t\t\t// Table columns in Safari have non-zero offsetWidth & zero\n\t\t\t\t\t// getBoundingClientRect().width unless display is changed.\n\t\t\t\t\t// Support: IE <=11 only\n\t\t\t\t\t// Running getBoundingClientRect on a disconnected node\n\t\t\t\t\t// in IE throws an error.\n\t\t\t\t\t( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ?\n\t\t\t\t\t\tswap( elem, cssShow, function() {\n\t\t\t\t\t\t\treturn getWidthOrHeight( elem, dimension, extra );\n\t\t\t\t\t\t} ) :\n\t\t\t\t\t\tgetWidthOrHeight( elem, dimension, extra );\n\t\t\t}\n\t\t},\n\n\t\tset: function( elem, value, extra ) {\n\t\t\tvar matches,\n\t\t\t\tstyles = getStyles( elem ),\n\t\t\t\tisBorderBox = jQuery.css( elem, \"boxSizing\", false, styles ) === \"border-box\",\n\t\t\t\tsubtract = extra && boxModelAdjustment(\n\t\t\t\t\telem,\n\t\t\t\t\tdimension,\n\t\t\t\t\textra,\n\t\t\t\t\tisBorderBox,\n\t\t\t\t\tstyles\n\t\t\t\t);\n\n\t\t\t// Account for unreliable border-box dimensions by comparing offset* to computed and\n\t\t\t// faking a content-box to get border and padding (gh-3699)\n\t\t\tif ( isBorderBox && support.scrollboxSize() === styles.position ) {\n\t\t\t\tsubtract -= Math.ceil(\n\t\t\t\t\telem[ \"offset\" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] -\n\t\t\t\t\tparseFloat( styles[ dimension ] ) -\n\t\t\t\t\tboxModelAdjustment( elem, dimension, \"border\", false, styles ) -\n\t\t\t\t\t0.5\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// Convert to pixels if value adjustment is needed\n\t\t\tif ( subtract && ( matches = rcssNum.exec( value ) ) &&\n\t\t\t\t( matches[ 3 ] || \"px\" ) !== \"px\" ) {\n\n\t\t\t\telem.style[ dimension ] = value;\n\t\t\t\tvalue = jQuery.css( elem, dimension );\n\t\t\t}\n\n\t\t\treturn setPositiveNumber( elem, value, subtract );\n\t\t}\n\t};\n} );\n\njQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft,\n\tfunction( elem, computed ) {\n\t\tif ( computed ) {\n\t\t\treturn ( parseFloat( curCSS( elem, \"marginLeft\" ) ) ||\n\t\t\t\telem.getBoundingClientRect().left -\n\t\t\t\t\tswap( elem, { marginLeft: 0 }, function() {\n\t\t\t\t\t\treturn elem.getBoundingClientRect().left;\n\t\t\t\t\t} )\n\t\t\t\t) + \"px\";\n\t\t}\n\t}\n);\n\n// These hooks are used by animate to expand properties\njQuery.each( {\n\tmargin: \"\",\n\tpadding: \"\",\n\tborder: \"Width\"\n}, function( prefix, suffix ) {\n\tjQuery.cssHooks[ prefix + suffix ] = {\n\t\texpand: function( value ) {\n\t\t\tvar i = 0,\n\t\t\t\texpanded = {},\n\n\t\t\t\t// Assumes a single number if not a string\n\t\t\t\tparts = typeof value === \"string\" ? value.split( \" \" ) : [ value ];\n\n\t\t\tfor ( ; i < 4; i++ ) {\n\t\t\t\texpanded[ prefix + cssExpand[ i ] + suffix ] =\n\t\t\t\t\tparts[ i ] || parts[ i - 2 ] || parts[ 0 ];\n\t\t\t}\n\n\t\t\treturn expanded;\n\t\t}\n\t};\n\n\tif ( prefix !== \"margin\" ) {\n\t\tjQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber;\n\t}\n} );\n\njQuery.fn.extend( {\n\tcss: function( name, value ) {\n\t\treturn access( this, function( elem, name, value ) {\n\t\t\tvar styles, len,\n\t\t\t\tmap = {},\n\t\t\t\ti = 0;\n\n\t\t\tif ( Array.isArray( name ) ) {\n\t\t\t\tstyles = getStyles( elem );\n\t\t\t\tlen = name.length;\n\n\t\t\t\tfor ( ; i < len; i++ ) {\n\t\t\t\t\tmap[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles );\n\t\t\t\t}\n\n\t\t\t\treturn map;\n\t\t\t}\n\n\t\t\treturn value !== undefined ?\n\t\t\t\tjQuery.style( elem, name, value ) :\n\t\t\t\tjQuery.css( elem, name );\n\t\t}, name, value, arguments.length > 1 );\n\t}\n} );\n\n\n// Based off of the plugin by Clint Helfers, with permission.\n// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/\njQuery.fn.delay = function( time, type ) {\n\ttime = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time;\n\ttype = type || \"fx\";\n\n\treturn this.queue( type, function( next, hooks ) {\n\t\tvar timeout = window.setTimeout( next, time );\n\t\thooks.stop = function() {\n\t\t\twindow.clearTimeout( timeout );\n\t\t};\n\t} );\n};\n\n\n( function() {\n\tvar input = document.createElement( \"input\" ),\n\t\tselect = document.createElement( \"select\" ),\n\t\topt = select.appendChild( document.createElement( \"option\" ) );\n\n\tinput.type = \"checkbox\";\n\n\t// Support: Android <=4.3 only\n\t// Default value for a checkbox should be \"on\"\n\tsupport.checkOn = input.value !== \"\";\n\n\t// Support: IE <=11 only\n\t// Must access selectedIndex to make default options select\n\tsupport.optSelected = opt.selected;\n\n\t// Support: IE <=11 only\n\t// An input loses its value after becoming a radio\n\tinput = document.createElement( \"input\" );\n\tinput.value = \"t\";\n\tinput.type = \"radio\";\n\tsupport.radioValue = input.value === \"t\";\n} )();\n\n\nvar boolHook,\n\tattrHandle = jQuery.expr.attrHandle;\n\njQuery.fn.extend( {\n\tattr: function( name, value ) {\n\t\treturn access( this, jQuery.attr, name, value, arguments.length > 1 );\n\t},\n\n\tremoveAttr: function( name ) {\n\t\treturn this.each( function() {\n\t\t\tjQuery.removeAttr( this, name );\n\t\t} );\n\t}\n} );\n\njQuery.extend( {\n\tattr: function( elem, name, value ) {\n\t\tvar ret, hooks,\n\t\t\tnType = elem.nodeType;\n\n\t\t// Don't get/set attributes on text, comment and attribute nodes\n\t\tif ( nType === 3 || nType === 8 || nType === 2 ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Fallback to prop when attributes are not supported\n\t\tif ( typeof elem.getAttribute === \"undefined\" ) {\n\t\t\treturn jQuery.prop( elem, name, value );\n\t\t}\n\n\t\t// Attribute hooks are determined by the lowercase version\n\t\t// Grab necessary hook if one is defined\n\t\tif ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {\n\t\t\thooks = jQuery.attrHooks[ name.toLowerCase() ] ||\n\t\t\t\t( jQuery.expr.match.bool.test( name ) ? boolHook : undefined );\n\t\t}\n\n\t\tif ( value !== undefined ) {\n\t\t\tif ( value === null ) {\n\t\t\t\tjQuery.removeAttr( elem, name );\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tif ( hooks && \"set\" in hooks &&\n\t\t\t\t( ret = hooks.set( elem, value, name ) ) !== undefined ) {\n\t\t\t\treturn ret;\n\t\t\t}\n\n\t\t\telem.setAttribute( name, value + \"\" );\n\t\t\treturn value;\n\t\t}\n\n\t\tif ( hooks && \"get\" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {\n\t\t\treturn ret;\n\t\t}\n\n\t\tret = jQuery.find.attr( elem, name );\n\n\t\t// Non-existent attributes return null, we normalize to undefined\n\t\treturn ret == null ? undefined : ret;\n\t},\n\n\tattrHooks: {\n\t\ttype: {\n\t\t\tset: function( elem, value ) {\n\t\t\t\tif ( !support.radioValue && value === \"radio\" &&\n\t\t\t\t\tnodeName( elem, \"input\" ) ) {\n\t\t\t\t\tvar val = elem.value;\n\t\t\t\t\telem.setAttribute( \"type\", value );\n\t\t\t\t\tif ( val ) {\n\t\t\t\t\t\telem.value = val;\n\t\t\t\t\t}\n\t\t\t\t\treturn value;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t},\n\n\tremoveAttr: function( elem, value ) {\n\t\tvar name,\n\t\t\ti = 0,\n\n\t\t\t// Attribute names can contain non-HTML whitespace characters\n\t\t\t// https://html.spec.whatwg.org/multipage/syntax.html#attributes-2\n\t\t\tattrNames = value && value.match( rnothtmlwhite );\n\n\t\tif ( attrNames && elem.nodeType === 1 ) {\n\t\t\twhile ( ( name = attrNames[ i++ ] ) ) {\n\t\t\t\telem.removeAttribute( name );\n\t\t\t}\n\t\t}\n\t}\n} );\n\n// Hooks for boolean attributes\nboolHook = {\n\tset: function( elem, value, name ) {\n\t\tif ( value === false ) {\n\n\t\t\t// Remove boolean attributes when set to false\n\t\t\tjQuery.removeAttr( elem, name );\n\t\t} else {\n\t\t\telem.setAttribute( name, name );\n\t\t}\n\t\treturn name;\n\t}\n};\n\njQuery.each( jQuery.expr.match.bool.source.match( /\\w+/g ), function( i, name ) {\n\tvar getter = attrHandle[ name ] || jQuery.find.attr;\n\n\tattrHandle[ name ] = function( elem, name, isXML ) {\n\t\tvar ret, handle,\n\t\t\tlowercaseName = name.toLowerCase();\n\n\t\tif ( !isXML ) {\n\n\t\t\t// Avoid an infinite loop by temporarily removing this function from the getter\n\t\t\thandle = attrHandle[ lowercaseName ];\n\t\t\tattrHandle[ lowercaseName ] = ret;\n\t\t\tret = getter( elem, name, isXML ) != null ?\n\t\t\t\tlowercaseName :\n\t\t\t\tnull;\n\t\t\tattrHandle[ lowercaseName ] = handle;\n\t\t}\n\t\treturn ret;\n\t};\n} );\n\n\n\n\nvar rfocusable = /^(?:input|select|textarea|button)$/i,\n\trclickable = /^(?:a|area)$/i;\n\njQuery.fn.extend( {\n\tprop: function( name, value ) {\n\t\treturn access( this, jQuery.prop, name, value, arguments.length > 1 );\n\t},\n\n\tremoveProp: function( name ) {\n\t\treturn this.each( function() {\n\t\t\tdelete this[ jQuery.propFix[ name ] || name ];\n\t\t} );\n\t}\n} );\n\njQuery.extend( {\n\tprop: function( elem, name, value ) {\n\t\tvar ret, hooks,\n\t\t\tnType = elem.nodeType;\n\n\t\t// Don't get/set properties on text, comment and attribute nodes\n\t\tif ( nType === 3 || nType === 8 || nType === 2 ) {\n\t\t\treturn;\n\t\t}\n\n\t\tif ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {\n\n\t\t\t// Fix name and attach hooks\n\t\t\tname = jQuery.propFix[ name ] || name;\n\t\t\thooks = jQuery.propHooks[ name ];\n\t\t}\n\n\t\tif ( value !== undefined ) {\n\t\t\tif ( hooks && \"set\" in hooks &&\n\t\t\t\t( ret = hooks.set( elem, value, name ) ) !== undefined ) {\n\t\t\t\treturn ret;\n\t\t\t}\n\n\t\t\treturn ( elem[ name ] = value );\n\t\t}\n\n\t\tif ( hooks && \"get\" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {\n\t\t\treturn ret;\n\t\t}\n\n\t\treturn elem[ name ];\n\t},\n\n\tpropHooks: {\n\t\ttabIndex: {\n\t\t\tget: function( elem ) {\n\n\t\t\t\t// Support: IE <=9 - 11 only\n\t\t\t\t// elem.tabIndex doesn't always return the\n\t\t\t\t// correct value when it hasn't been explicitly set\n\t\t\t\t// https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/\n\t\t\t\t// Use proper attribute retrieval(#12072)\n\t\t\t\tvar tabindex = jQuery.find.attr( elem, \"tabindex\" );\n\n\t\t\t\tif ( tabindex ) {\n\t\t\t\t\treturn parseInt( tabindex, 10 );\n\t\t\t\t}\n\n\t\t\t\tif (\n\t\t\t\t\trfocusable.test( elem.nodeName ) ||\n\t\t\t\t\trclickable.test( elem.nodeName ) &&\n\t\t\t\t\telem.href\n\t\t\t\t) {\n\t\t\t\t\treturn 0;\n\t\t\t\t}\n\n\t\t\t\treturn -1;\n\t\t\t}\n\t\t}\n\t},\n\n\tpropFix: {\n\t\t\"for\": \"htmlFor\",\n\t\t\"class\": \"className\"\n\t}\n} );\n\n// Support: IE <=11 only\n// Accessing the selectedIndex property\n// forces the browser to respect setting selected\n// on the option\n// The getter ensures a default option is selected\n// when in an optgroup\n// eslint rule \"no-unused-expressions\" is disabled for this code\n// since it considers such accessions noop\nif ( !support.optSelected ) {\n\tjQuery.propHooks.selected = {\n\t\tget: function( elem ) {\n\n\t\t\t/* eslint no-unused-expressions: \"off\" */\n\n\t\t\tvar parent = elem.parentNode;\n\t\t\tif ( parent && parent.parentNode ) {\n\t\t\t\tparent.parentNode.selectedIndex;\n\t\t\t}\n\t\t\treturn null;\n\t\t},\n\t\tset: function( elem ) {\n\n\t\t\t/* eslint no-unused-expressions: \"off\" */\n\n\t\t\tvar parent = elem.parentNode;\n\t\t\tif ( parent ) {\n\t\t\t\tparent.selectedIndex;\n\n\t\t\t\tif ( parent.parentNode ) {\n\t\t\t\t\tparent.parentNode.selectedIndex;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t};\n}\n\njQuery.each( [\n\t\"tabIndex\",\n\t\"readOnly\",\n\t\"maxLength\",\n\t\"cellSpacing\",\n\t\"cellPadding\",\n\t\"rowSpan\",\n\t\"colSpan\",\n\t\"useMap\",\n\t\"frameBorder\",\n\t\"contentEditable\"\n], function() {\n\tjQuery.propFix[ this.toLowerCase() ] = this;\n} );\n\n\n\n\n\t// Strip and collapse whitespace according to HTML spec\n\t// https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace\n\tfunction stripAndCollapse( value ) {\n\t\tvar tokens = value.match( rnothtmlwhite ) || [];\n\t\treturn tokens.join( \" \" );\n\t}\n\n\nfunction getClass( elem ) {\n\treturn elem.getAttribute && elem.getAttribute( \"class\" ) || \"\";\n}\n\nfunction classesToArray( value ) {\n\tif ( Array.isArray( value ) ) {\n\t\treturn value;\n\t}\n\tif ( typeof value === \"string\" ) {\n\t\treturn value.match( rnothtmlwhite ) || [];\n\t}\n\treturn [];\n}\n\njQuery.fn.extend( {\n\taddClass: function( value ) {\n\t\tvar classes, elem, cur, curValue, clazz, j, finalValue,\n\t\t\ti = 0;\n\n\t\tif ( isFunction( value ) ) {\n\t\t\treturn this.each( function( j ) {\n\t\t\t\tjQuery( this ).addClass( value.call( this, j, getClass( this ) ) );\n\t\t\t} );\n\t\t}\n\n\t\tclasses = classesToArray( value );\n\n\t\tif ( classes.length ) {\n\t\t\twhile ( ( elem = this[ i++ ] ) ) {\n\t\t\t\tcurValue = getClass( elem );\n\t\t\t\tcur = elem.nodeType === 1 && ( \" \" + stripAndCollapse( curValue ) + \" \" );\n\n\t\t\t\tif ( cur ) {\n\t\t\t\t\tj = 0;\n\t\t\t\t\twhile ( ( clazz = classes[ j++ ] ) ) {\n\t\t\t\t\t\tif ( cur.indexOf( \" \" + clazz + \" \" ) < 0 ) {\n\t\t\t\t\t\t\tcur += clazz + \" \";\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Only assign if different to avoid unneeded rendering.\n\t\t\t\t\tfinalValue = stripAndCollapse( cur );\n\t\t\t\t\tif ( curValue !== finalValue ) {\n\t\t\t\t\t\telem.setAttribute( \"class\", finalValue );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn this;\n\t},\n\n\tremoveClass: function( value ) {\n\t\tvar classes, elem, cur, curValue, clazz, j, finalValue,\n\t\t\ti = 0;\n\n\t\tif ( isFunction( value ) ) {\n\t\t\treturn this.each( function( j ) {\n\t\t\t\tjQuery( this ).removeClass( value.call( this, j, getClass( this ) ) );\n\t\t\t} );\n\t\t}\n\n\t\tif ( !arguments.length ) {\n\t\t\treturn this.attr( \"class\", \"\" );\n\t\t}\n\n\t\tclasses = classesToArray( value );\n\n\t\tif ( classes.length ) {\n\t\t\twhile ( ( elem = this[ i++ ] ) ) {\n\t\t\t\tcurValue = getClass( elem );\n\n\t\t\t\t// This expression is here for better compressibility (see addClass)\n\t\t\t\tcur = elem.nodeType === 1 && ( \" \" + stripAndCollapse( curValue ) + \" \" );\n\n\t\t\t\tif ( cur ) {\n\t\t\t\t\tj = 0;\n\t\t\t\t\twhile ( ( clazz = classes[ j++ ] ) ) {\n\n\t\t\t\t\t\t// Remove *all* instances\n\t\t\t\t\t\twhile ( cur.indexOf( \" \" + clazz + \" \" ) > -1 ) {\n\t\t\t\t\t\t\tcur = cur.replace( \" \" + clazz + \" \", \" \" );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Only assign if different to avoid unneeded rendering.\n\t\t\t\t\tfinalValue = stripAndCollapse( cur );\n\t\t\t\t\tif ( curValue !== finalValue ) {\n\t\t\t\t\t\telem.setAttribute( \"class\", finalValue );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn this;\n\t},\n\n\ttoggleClass: function( value, stateVal ) {\n\t\tvar type = typeof value,\n\t\t\tisValidValue = type === \"string\" || Array.isArray( value );\n\n\t\tif ( typeof stateVal === \"boolean\" && isValidValue ) {\n\t\t\treturn stateVal ? this.addClass( value ) : this.removeClass( value );\n\t\t}\n\n\t\tif ( isFunction( value ) ) {\n\t\t\treturn this.each( function( i ) {\n\t\t\t\tjQuery( this ).toggleClass(\n\t\t\t\t\tvalue.call( this, i, getClass( this ), stateVal ),\n\t\t\t\t\tstateVal\n\t\t\t\t);\n\t\t\t} );\n\t\t}\n\n\t\treturn this.each( function() {\n\t\t\tvar className, i, self, classNames;\n\n\t\t\tif ( isValidValue ) {\n\n\t\t\t\t// Toggle individual class names\n\t\t\t\ti = 0;\n\t\t\t\tself = jQuery( this );\n\t\t\t\tclassNames = classesToArray( value );\n\n\t\t\t\twhile ( ( className = classNames[ i++ ] ) ) {\n\n\t\t\t\t\t// Check each className given, space separated list\n\t\t\t\t\tif ( self.hasClass( className ) ) {\n\t\t\t\t\t\tself.removeClass( className );\n\t\t\t\t\t} else {\n\t\t\t\t\t\tself.addClass( className );\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t// Toggle whole class name\n\t\t\t} else if ( value === undefined || type === \"boolean\" ) {\n\t\t\t\tclassName = getClass( this );\n\t\t\t\tif ( className ) {\n\n\t\t\t\t\t// Store className if set\n\t\t\t\t\tdataPriv.set( this, \"__className__\", className );\n\t\t\t\t}\n\n\t\t\t\t// If the element has a class name or if we're passed `false`,\n\t\t\t\t// then remove the whole classname (if there was one, the above saved it).\n\t\t\t\t// Otherwise bring back whatever was previously saved (if anything),\n\t\t\t\t// falling back to the empty string if nothing was stored.\n\t\t\t\tif ( this.setAttribute ) {\n\t\t\t\t\tthis.setAttribute( \"class\",\n\t\t\t\t\t\tclassName || value === false ?\n\t\t\t\t\t\t\"\" :\n\t\t\t\t\t\tdataPriv.get( this, \"__className__\" ) || \"\"\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t} );\n\t},\n\n\thasClass: function( selector ) {\n\t\tvar className, elem,\n\t\t\ti = 0;\n\n\t\tclassName = \" \" + selector + \" \";\n\t\twhile ( ( elem = this[ i++ ] ) ) {\n\t\t\tif ( elem.nodeType === 1 &&\n\t\t\t\t( \" \" + stripAndCollapse( getClass( elem ) ) + \" \" ).indexOf( className ) > -1 ) {\n\t\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\n\t\treturn false;\n\t}\n} );\n\n\n\n\nvar rreturn = /\\r/g;\n\njQuery.fn.extend( {\n\tval: function( value ) {\n\t\tvar hooks, ret, valueIsFunction,\n\t\t\telem = this[ 0 ];\n\n\t\tif ( !arguments.length ) {\n\t\t\tif ( elem ) {\n\t\t\t\thooks = jQuery.valHooks[ elem.type ] ||\n\t\t\t\t\tjQuery.valHooks[ elem.nodeName.toLowerCase() ];\n\n\t\t\t\tif ( hooks &&\n\t\t\t\t\t\"get\" in hooks &&\n\t\t\t\t\t( ret = hooks.get( elem, \"value\" ) ) !== undefined\n\t\t\t\t) {\n\t\t\t\t\treturn ret;\n\t\t\t\t}\n\n\t\t\t\tret = elem.value;\n\n\t\t\t\t// Handle most common string cases\n\t\t\t\tif ( typeof ret === \"string\" ) {\n\t\t\t\t\treturn ret.replace( rreturn, \"\" );\n\t\t\t\t}\n\n\t\t\t\t// Handle cases where value is null/undef or number\n\t\t\t\treturn ret == null ? \"\" : ret;\n\t\t\t}\n\n\t\t\treturn;\n\t\t}\n\n\t\tvalueIsFunction = isFunction( value );\n\n\t\treturn this.each( function( i ) {\n\t\t\tvar val;\n\n\t\t\tif ( this.nodeType !== 1 ) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tif ( valueIsFunction ) {\n\t\t\t\tval = value.call( this, i, jQuery( this ).val() );\n\t\t\t} else {\n\t\t\t\tval = value;\n\t\t\t}\n\n\t\t\t// Treat null/undefined as \"\"; convert numbers to string\n\t\t\tif ( val == null ) {\n\t\t\t\tval = \"\";\n\n\t\t\t} else if ( typeof val === \"number\" ) {\n\t\t\t\tval += \"\";\n\n\t\t\t} else if ( Array.isArray( val ) ) {\n\t\t\t\tval = jQuery.map( val, function( value ) {\n\t\t\t\t\treturn value == null ? \"\" : value + \"\";\n\t\t\t\t} );\n\t\t\t}\n\n\t\t\thooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ];\n\n\t\t\t// If set returns undefined, fall back to normal setting\n\t\t\tif ( !hooks || !( \"set\" in hooks ) || hooks.set( this, val, \"value\" ) === undefined ) {\n\t\t\t\tthis.value = val;\n\t\t\t}\n\t\t} );\n\t}\n} );\n\njQuery.extend( {\n\tvalHooks: {\n\t\toption: {\n\t\t\tget: function( elem ) {\n\n\t\t\t\tvar val = jQuery.find.attr( elem, \"value\" );\n\t\t\t\treturn val != null ?\n\t\t\t\t\tval :\n\n\t\t\t\t\t// Support: IE <=10 - 11 only\n\t\t\t\t\t// option.text throws exceptions (#14686, #14858)\n\t\t\t\t\t// Strip and collapse whitespace\n\t\t\t\t\t// https://html.spec.whatwg.org/#strip-and-collapse-whitespace\n\t\t\t\t\tstripAndCollapse( jQuery.text( elem ) );\n\t\t\t}\n\t\t},\n\t\tselect: {\n\t\t\tget: function( elem ) {\n\t\t\t\tvar value, option, i,\n\t\t\t\t\toptions = elem.options,\n\t\t\t\t\tindex = elem.selectedIndex,\n\t\t\t\t\tone = elem.type === \"select-one\",\n\t\t\t\t\tvalues = one ? null : [],\n\t\t\t\t\tmax = one ? index + 1 : options.length;\n\n\t\t\t\tif ( index < 0 ) {\n\t\t\t\t\ti = max;\n\n\t\t\t\t} else {\n\t\t\t\t\ti = one ? index : 0;\n\t\t\t\t}\n\n\t\t\t\t// Loop through all the selected options\n\t\t\t\tfor ( ; i < max; i++ ) {\n\t\t\t\t\toption = options[ i ];\n\n\t\t\t\t\t// Support: IE <=9 only\n\t\t\t\t\t// IE8-9 doesn't update selected after form reset (#2551)\n\t\t\t\t\tif ( ( option.selected || i === index ) &&\n\n\t\t\t\t\t\t\t// Don't return options that are disabled or in a disabled optgroup\n\t\t\t\t\t\t\t!option.disabled &&\n\t\t\t\t\t\t\t( !option.parentNode.disabled ||\n\t\t\t\t\t\t\t\t!nodeName( option.parentNode, \"optgroup\" ) ) ) {\n\n\t\t\t\t\t\t// Get the specific value for the option\n\t\t\t\t\t\tvalue = jQuery( option ).val();\n\n\t\t\t\t\t\t// We don't need an array for one selects\n\t\t\t\t\t\tif ( one ) {\n\t\t\t\t\t\t\treturn value;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Multi-Selects return an array\n\t\t\t\t\t\tvalues.push( value );\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn values;\n\t\t\t},\n\n\t\t\tset: function( elem, value ) {\n\t\t\t\tvar optionSet, option,\n\t\t\t\t\toptions = elem.options,\n\t\t\t\t\tvalues = jQuery.makeArray( value ),\n\t\t\t\t\ti = options.length;\n\n\t\t\t\twhile ( i-- ) {\n\t\t\t\t\toption = options[ i ];\n\n\t\t\t\t\t/* eslint-disable no-cond-assign */\n\n\t\t\t\t\tif ( option.selected =\n\t\t\t\t\t\tjQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1\n\t\t\t\t\t) {\n\t\t\t\t\t\toptionSet = true;\n\t\t\t\t\t}\n\n\t\t\t\t\t/* eslint-enable no-cond-assign */\n\t\t\t\t}\n\n\t\t\t\t// Force browsers to behave consistently when non-matching value is set\n\t\t\t\tif ( !optionSet ) {\n\t\t\t\t\telem.selectedIndex = -1;\n\t\t\t\t}\n\t\t\t\treturn values;\n\t\t\t}\n\t\t}\n\t}\n} );\n\n// Radios and checkboxes getter/setter\njQuery.each( [ \"radio\", \"checkbox\" ], function() {\n\tjQuery.valHooks[ this ] = {\n\t\tset: function( elem, value ) {\n\t\t\tif ( Array.isArray( value ) ) {\n\t\t\t\treturn ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 );\n\t\t\t}\n\t\t}\n\t};\n\tif ( !support.checkOn ) {\n\t\tjQuery.valHooks[ this ].get = function( elem ) {\n\t\t\treturn elem.getAttribute( \"value\" ) === null ? \"on\" : elem.value;\n\t\t};\n\t}\n} );\n\n\n\n\n// Return jQuery for attributes-only inclusion\n\n\nsupport.focusin = \"onfocusin\" in window;\n\n\nvar rfocusMorph = /^(?:focusinfocus|focusoutblur)$/,\n\tstopPropagationCallback = function( e ) {\n\t\te.stopPropagation();\n\t};\n\njQuery.extend( jQuery.event, {\n\n\ttrigger: function( event, data, elem, onlyHandlers ) {\n\n\t\tvar i, cur, tmp, bubbleType, ontype, handle, special, lastElement,\n\t\t\teventPath = [ elem || document ],\n\t\t\ttype = hasOwn.call( event, \"type\" ) ? event.type : event,\n\t\t\tnamespaces = hasOwn.call( event, \"namespace\" ) ? event.namespace.split( \".\" ) : [];\n\n\t\tcur = lastElement = tmp = elem = elem || document;\n\n\t\t// Don't do events on text and comment nodes\n\t\tif ( elem.nodeType === 3 || elem.nodeType === 8 ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// focus/blur morphs to focusin/out; ensure we're not firing them right now\n\t\tif ( rfocusMorph.test( type + jQuery.event.triggered ) ) {\n\t\t\treturn;\n\t\t}\n\n\t\tif ( type.indexOf( \".\" ) > -1 ) {\n\n\t\t\t// Namespaced trigger; create a regexp to match event type in handle()\n\t\t\tnamespaces = type.split( \".\" );\n\t\t\ttype = namespaces.shift();\n\t\t\tnamespaces.sort();\n\t\t}\n\t\tontype = type.indexOf( \":\" ) < 0 && \"on\" + type;\n\n\t\t// Caller can pass in a jQuery.Event object, Object, or just an event type string\n\t\tevent = event[ jQuery.expando ] ?\n\t\t\tevent :\n\t\t\tnew jQuery.Event( type, typeof event === \"object\" && event );\n\n\t\t// Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true)\n\t\tevent.isTrigger = onlyHandlers ? 2 : 3;\n\t\tevent.namespace = namespaces.join( \".\" );\n\t\tevent.rnamespace = event.namespace ?\n\t\t\tnew RegExp( \"(^|\\\\.)\" + namespaces.join( \"\\\\.(?:.*\\\\.|)\" ) + \"(\\\\.|$)\" ) :\n\t\t\tnull;\n\n\t\t// Clean up the event in case it is being reused\n\t\tevent.result = undefined;\n\t\tif ( !event.target ) {\n\t\t\tevent.target = elem;\n\t\t}\n\n\t\t// Clone any incoming data and prepend the event, creating the handler arg list\n\t\tdata = data == null ?\n\t\t\t[ event ] :\n\t\t\tjQuery.makeArray( data, [ event ] );\n\n\t\t// Allow special events to draw outside the lines\n\t\tspecial = jQuery.event.special[ type ] || {};\n\t\tif ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Determine event propagation path in advance, per W3C events spec (#9951)\n\t\t// Bubble up to document, then to window; watch for a global ownerDocument var (#9724)\n\t\tif ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) {\n\n\t\t\tbubbleType = special.delegateType || type;\n\t\t\tif ( !rfocusMorph.test( bubbleType + type ) ) {\n\t\t\t\tcur = cur.parentNode;\n\t\t\t}\n\t\t\tfor ( ; cur; cur = cur.parentNode ) {\n\t\t\t\teventPath.push( cur );\n\t\t\t\ttmp = cur;\n\t\t\t}\n\n\t\t\t// Only add window if we got to document (e.g., not plain obj or detached DOM)\n\t\t\tif ( tmp === ( elem.ownerDocument || document ) ) {\n\t\t\t\teventPath.push( tmp.defaultView || tmp.parentWindow || window );\n\t\t\t}\n\t\t}\n\n\t\t// Fire handlers on the event path\n\t\ti = 0;\n\t\twhile ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) {\n\t\t\tlastElement = cur;\n\t\t\tevent.type = i > 1 ?\n\t\t\t\tbubbleType :\n\t\t\t\tspecial.bindType || type;\n\n\t\t\t// jQuery handler\n\t\t\thandle = ( dataPriv.get( cur, \"events\" ) || {} )[ event.type ] &&\n\t\t\t\tdataPriv.get( cur, \"handle\" );\n\t\t\tif ( handle ) {\n\t\t\t\thandle.apply( cur, data );\n\t\t\t}\n\n\t\t\t// Native handler\n\t\t\thandle = ontype && cur[ ontype ];\n\t\t\tif ( handle && handle.apply && acceptData( cur ) ) {\n\t\t\t\tevent.result = handle.apply( cur, data );\n\t\t\t\tif ( event.result === false ) {\n\t\t\t\t\tevent.preventDefault();\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tevent.type = type;\n\n\t\t// If nobody prevented the default action, do it now\n\t\tif ( !onlyHandlers && !event.isDefaultPrevented() ) {\n\n\t\t\tif ( ( !special._default ||\n\t\t\t\tspecial._default.apply( eventPath.pop(), data ) === false ) &&\n\t\t\t\tacceptData( elem ) ) {\n\n\t\t\t\t// Call a native DOM method on the target with the same name as the event.\n\t\t\t\t// Don't do default actions on window, that's where global variables be (#6170)\n\t\t\t\tif ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) {\n\n\t\t\t\t\t// Don't re-trigger an onFOO event when we call its FOO() method\n\t\t\t\t\ttmp = elem[ ontype ];\n\n\t\t\t\t\tif ( tmp ) {\n\t\t\t\t\t\telem[ ontype ] = null;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Prevent re-triggering of the same event, since we already bubbled it above\n\t\t\t\t\tjQuery.event.triggered = type;\n\n\t\t\t\t\tif ( event.isPropagationStopped() ) {\n\t\t\t\t\t\tlastElement.addEventListener( type, stopPropagationCallback );\n\t\t\t\t\t}\n\n\t\t\t\t\telem[ type ]();\n\n\t\t\t\t\tif ( event.isPropagationStopped() ) {\n\t\t\t\t\t\tlastElement.removeEventListener( type, stopPropagationCallback );\n\t\t\t\t\t}\n\n\t\t\t\t\tjQuery.event.triggered = undefined;\n\n\t\t\t\t\tif ( tmp ) {\n\t\t\t\t\t\telem[ ontype ] = tmp;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn event.result;\n\t},\n\n\t// Piggyback on a donor event to simulate a different one\n\t// Used only for `focus(in | out)` events\n\tsimulate: function( type, elem, event ) {\n\t\tvar e = jQuery.extend(\n\t\t\tnew jQuery.Event(),\n\t\t\tevent,\n\t\t\t{\n\t\t\t\ttype: type,\n\t\t\t\tisSimulated: true\n\t\t\t}\n\t\t);\n\n\t\tjQuery.event.trigger( e, null, elem );\n\t}\n\n} );\n\njQuery.fn.extend( {\n\n\ttrigger: function( type, data ) {\n\t\treturn this.each( function() {\n\t\t\tjQuery.event.trigger( type, data, this );\n\t\t} );\n\t},\n\ttriggerHandler: function( type, data ) {\n\t\tvar elem = this[ 0 ];\n\t\tif ( elem ) {\n\t\t\treturn jQuery.event.trigger( type, data, elem, true );\n\t\t}\n\t}\n} );\n\n\n// Support: Firefox <=44\n// Firefox doesn't have focus(in | out) events\n// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787\n//\n// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1\n// focus(in | out) events fire after focus & blur events,\n// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order\n// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857\nif ( !support.focusin ) {\n\tjQuery.each( { focus: \"focusin\", blur: \"focusout\" }, function( orig, fix ) {\n\n\t\t// Attach a single capturing handler on the document while someone wants focusin/focusout\n\t\tvar handler = function( event ) {\n\t\t\tjQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) );\n\t\t};\n\n\t\tjQuery.event.special[ fix ] = {\n\t\t\tsetup: function() {\n\t\t\t\tvar doc = this.ownerDocument || this,\n\t\t\t\t\tattaches = dataPriv.access( doc, fix );\n\n\t\t\t\tif ( !attaches ) {\n\t\t\t\t\tdoc.addEventListener( orig, handler, true );\n\t\t\t\t}\n\t\t\t\tdataPriv.access( doc, fix, ( attaches || 0 ) + 1 );\n\t\t\t},\n\t\t\tteardown: function() {\n\t\t\t\tvar doc = this.ownerDocument || this,\n\t\t\t\t\tattaches = dataPriv.access( doc, fix ) - 1;\n\n\t\t\t\tif ( !attaches ) {\n\t\t\t\t\tdoc.removeEventListener( orig, handler, true );\n\t\t\t\t\tdataPriv.remove( doc, fix );\n\n\t\t\t\t} else {\n\t\t\t\t\tdataPriv.access( doc, fix, attaches );\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\t} );\n}\n\n\nvar\n\trbracket = /\\[\\]$/,\n\trCRLF = /\\r?\\n/g,\n\trsubmitterTypes = /^(?:submit|button|image|reset|file)$/i,\n\trsubmittable = /^(?:input|select|textarea|keygen)/i;\n\nfunction buildParams( prefix, obj, traditional, add ) {\n\tvar name;\n\n\tif ( Array.isArray( obj ) ) {\n\n\t\t// Serialize array item.\n\t\tjQuery.each( obj, function( i, v ) {\n\t\t\tif ( traditional || rbracket.test( prefix ) ) {\n\n\t\t\t\t// Treat each array item as a scalar.\n\t\t\t\tadd( prefix, v );\n\n\t\t\t} else {\n\n\t\t\t\t// Item is non-scalar (array or object), encode its numeric index.\n\t\t\t\tbuildParams(\n\t\t\t\t\tprefix + \"[\" + ( typeof v === \"object\" && v != null ? i : \"\" ) + \"]\",\n\t\t\t\t\tv,\n\t\t\t\t\ttraditional,\n\t\t\t\t\tadd\n\t\t\t\t);\n\t\t\t}\n\t\t} );\n\n\t} else if ( !traditional && toType( obj ) === \"object\" ) {\n\n\t\t// Serialize object item.\n\t\tfor ( name in obj ) {\n\t\t\tbuildParams( prefix + \"[\" + name + \"]\", obj[ name ], traditional, add );\n\t\t}\n\n\t} else {\n\n\t\t// Serialize scalar item.\n\t\tadd( prefix, obj );\n\t}\n}\n\n// Serialize an array of form elements or a set of\n// key/values into a query string\njQuery.param = function( a, traditional ) {\n\tvar prefix,\n\t\ts = [],\n\t\tadd = function( key, valueOrFunction ) {\n\n\t\t\t// If value is a function, invoke it and use its return value\n\t\t\tvar value = isFunction( valueOrFunction ) ?\n\t\t\t\tvalueOrFunction() :\n\t\t\t\tvalueOrFunction;\n\n\t\t\ts[ s.length ] = encodeURIComponent( key ) + \"=\" +\n\t\t\t\tencodeURIComponent( value == null ? \"\" : value );\n\t\t};\n\n\t// If an array was passed in, assume that it is an array of form elements.\n\tif ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) {\n\n\t\t// Serialize the form elements\n\t\tjQuery.each( a, function() {\n\t\t\tadd( this.name, this.value );\n\t\t} );\n\n\t} else {\n\n\t\t// If traditional, encode the \"old\" way (the way 1.3.2 or older\n\t\t// did it), otherwise encode params recursively.\n\t\tfor ( prefix in a ) {\n\t\t\tbuildParams( prefix, a[ prefix ], traditional, add );\n\t\t}\n\t}\n\n\t// Return the resulting serialization\n\treturn s.join( \"&\" );\n};\n\njQuery.fn.extend( {\n\tserialize: function() {\n\t\treturn jQuery.param( this.serializeArray() );\n\t},\n\tserializeArray: function() {\n\t\treturn this.map( function() {\n\n\t\t\t// Can add propHook for \"elements\" to filter or add form elements\n\t\t\tvar elements = jQuery.prop( this, \"elements\" );\n\t\t\treturn elements ? jQuery.makeArray( elements ) : this;\n\t\t} )\n\t\t.filter( function() {\n\t\t\tvar type = this.type;\n\n\t\t\t// Use .is( \":disabled\" ) so that fieldset[disabled] works\n\t\t\treturn this.name && !jQuery( this ).is( \":disabled\" ) &&\n\t\t\t\trsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) &&\n\t\t\t\t( this.checked || !rcheckableType.test( type ) );\n\t\t} )\n\t\t.map( function( i, elem ) {\n\t\t\tvar val = jQuery( this ).val();\n\n\t\t\tif ( val == null ) {\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\tif ( Array.isArray( val ) ) {\n\t\t\t\treturn jQuery.map( val, function( val ) {\n\t\t\t\t\treturn { name: elem.name, value: val.replace( rCRLF, \"\\r\\n\" ) };\n\t\t\t\t} );\n\t\t\t}\n\n\t\t\treturn { name: elem.name, value: val.replace( rCRLF, \"\\r\\n\" ) };\n\t\t} ).get();\n\t}\n} );\n\n\njQuery.fn.extend( {\n\twrapAll: function( html ) {\n\t\tvar wrap;\n\n\t\tif ( this[ 0 ] ) {\n\t\t\tif ( isFunction( html ) ) {\n\t\t\t\thtml = html.call( this[ 0 ] );\n\t\t\t}\n\n\t\t\t// The elements to wrap the target around\n\t\t\twrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true );\n\n\t\t\tif ( this[ 0 ].parentNode ) {\n\t\t\t\twrap.insertBefore( this[ 0 ] );\n\t\t\t}\n\n\t\t\twrap.map( function() {\n\t\t\t\tvar elem = this;\n\n\t\t\t\twhile ( elem.firstElementChild ) {\n\t\t\t\t\telem = elem.firstElementChild;\n\t\t\t\t}\n\n\t\t\t\treturn elem;\n\t\t\t} ).append( this );\n\t\t}\n\n\t\treturn this;\n\t},\n\n\twrapInner: function( html ) {\n\t\tif ( isFunction( html ) ) {\n\t\t\treturn this.each( function( i ) {\n\t\t\t\tjQuery( this ).wrapInner( html.call( this, i ) );\n\t\t\t} );\n\t\t}\n\n\t\treturn this.each( function() {\n\t\t\tvar self = jQuery( this ),\n\t\t\t\tcontents = self.contents();\n\n\t\t\tif ( contents.length ) {\n\t\t\t\tcontents.wrapAll( html );\n\n\t\t\t} else {\n\t\t\t\tself.append( html );\n\t\t\t}\n\t\t} );\n\t},\n\n\twrap: function( html ) {\n\t\tvar htmlIsFunction = isFunction( html );\n\n\t\treturn this.each( function( i ) {\n\t\t\tjQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html );\n\t\t} );\n\t},\n\n\tunwrap: function( selector ) {\n\t\tthis.parent( selector ).not( \"body\" ).each( function() {\n\t\t\tjQuery( this ).replaceWith( this.childNodes );\n\t\t} );\n\t\treturn this;\n\t}\n} );\n\n\njQuery.expr.pseudos.hidden = function( elem ) {\n\treturn !jQuery.expr.pseudos.visible( elem );\n};\njQuery.expr.pseudos.visible = function( elem ) {\n\treturn !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length );\n};\n\n\n\n\n// Support: Safari 8 only\n// In Safari 8 documents created via document.implementation.createHTMLDocument\n// collapse sibling forms: the second one becomes a child of the first one.\n// Because of that, this security measure has to be disabled in Safari 8.\n// https://bugs.webkit.org/show_bug.cgi?id=137337\nsupport.createHTMLDocument = ( function() {\n\tvar body = document.implementation.createHTMLDocument( \"\" ).body;\n\tbody.innerHTML = \"<form></form><form></form>\";\n\treturn body.childNodes.length === 2;\n} )();\n\n\n// Argument \"data\" should be string of html\n// context (optional): If specified, the fragment will be created in this context,\n// defaults to document\n// keepScripts (optional): If true, will include scripts passed in the html string\njQuery.parseHTML = function( data, context, keepScripts ) {\n\tif ( typeof data !== \"string\" ) {\n\t\treturn [];\n\t}\n\tif ( typeof context === \"boolean\" ) {\n\t\tkeepScripts = context;\n\t\tcontext = false;\n\t}\n\n\tvar base, parsed, scripts;\n\n\tif ( !context ) {\n\n\t\t// Stop scripts or inline event handlers from being executed immediately\n\t\t// by using document.implementation\n\t\tif ( support.createHTMLDocument ) {\n\t\t\tcontext = document.implementation.createHTMLDocument( \"\" );\n\n\t\t\t// Set the base href for the created document\n\t\t\t// so any parsed elements with URLs\n\t\t\t// are based on the document's URL (gh-2965)\n\t\t\tbase = context.createElement( \"base\" );\n\t\t\tbase.href = document.location.href;\n\t\t\tcontext.head.appendChild( base );\n\t\t} else {\n\t\t\tcontext = document;\n\t\t}\n\t}\n\n\tparsed = rsingleTag.exec( data );\n\tscripts = !keepScripts && [];\n\n\t// Single tag\n\tif ( parsed ) {\n\t\treturn [ context.createElement( parsed[ 1 ] ) ];\n\t}\n\n\tparsed = buildFragment( [ data ], context, scripts );\n\n\tif ( scripts && scripts.length ) {\n\t\tjQuery( scripts ).remove();\n\t}\n\n\treturn jQuery.merge( [], parsed.childNodes );\n};\n\n\njQuery.offset = {\n\tsetOffset: function( elem, options, i ) {\n\t\tvar curPosition, curLeft, curCSSTop, curTop, curOffset, curCSSLeft, calculatePosition,\n\t\t\tposition = jQuery.css( elem, \"position\" ),\n\t\t\tcurElem = jQuery( elem ),\n\t\t\tprops = {};\n\n\t\t// Set position first, in-case top/left are set even on static elem\n\t\tif ( position === \"static\" ) {\n\t\t\telem.style.position = \"relative\";\n\t\t}\n\n\t\tcurOffset = curElem.offset();\n\t\tcurCSSTop = jQuery.css( elem, \"top\" );\n\t\tcurCSSLeft = jQuery.css( elem, \"left\" );\n\t\tcalculatePosition = ( position === \"absolute\" || position === \"fixed\" ) &&\n\t\t\t( curCSSTop + curCSSLeft ).indexOf( \"auto\" ) > -1;\n\n\t\t// Need to be able to calculate position if either\n\t\t// top or left is auto and position is either absolute or fixed\n\t\tif ( calculatePosition ) {\n\t\t\tcurPosition = curElem.position();\n\t\t\tcurTop = curPosition.top;\n\t\t\tcurLeft = curPosition.left;\n\n\t\t} else {\n\t\t\tcurTop = parseFloat( curCSSTop ) || 0;\n\t\t\tcurLeft = parseFloat( curCSSLeft ) || 0;\n\t\t}\n\n\t\tif ( isFunction( options ) ) {\n\n\t\t\t// Use jQuery.extend here to allow modification of coordinates argument (gh-1848)\n\t\t\toptions = options.call( elem, i, jQuery.extend( {}, curOffset ) );\n\t\t}\n\n\t\tif ( options.top != null ) {\n\t\t\tprops.top = ( options.top - curOffset.top ) + curTop;\n\t\t}\n\t\tif ( options.left != null ) {\n\t\t\tprops.left = ( options.left - curOffset.left ) + curLeft;\n\t\t}\n\n\t\tif ( \"using\" in options ) {\n\t\t\toptions.using.call( elem, props );\n\n\t\t} else {\n\t\t\tcurElem.css( props );\n\t\t}\n\t}\n};\n\njQuery.fn.extend( {\n\n\t// offset() relates an element's border box to the document origin\n\toffset: function( options ) {\n\n\t\t// Preserve chaining for setter\n\t\tif ( arguments.length ) {\n\t\t\treturn options === undefined ?\n\t\t\t\tthis :\n\t\t\t\tthis.each( function( i ) {\n\t\t\t\t\tjQuery.offset.setOffset( this, options, i );\n\t\t\t\t} );\n\t\t}\n\n\t\tvar rect, win,\n\t\t\telem = this[ 0 ];\n\n\t\tif ( !elem ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Return zeros for disconnected and hidden (display: none) elements (gh-2310)\n\t\t// Support: IE <=11 only\n\t\t// Running getBoundingClientRect on a\n\t\t// disconnected node in IE throws an error\n\t\tif ( !elem.getClientRects().length ) {\n\t\t\treturn { top: 0, left: 0 };\n\t\t}\n\n\t\t// Get document-relative position by adding viewport scroll to viewport-relative gBCR\n\t\trect = elem.getBoundingClientRect();\n\t\twin = elem.ownerDocument.defaultView;\n\t\treturn {\n\t\t\ttop: rect.top + win.pageYOffset,\n\t\t\tleft: rect.left + win.pageXOffset\n\t\t};\n\t},\n\n\t// position() relates an element's margin box to its offset parent's padding box\n\t// This corresponds to the behavior of CSS absolute positioning\n\tposition: function() {\n\t\tif ( !this[ 0 ] ) {\n\t\t\treturn;\n\t\t}\n\n\t\tvar offsetParent, offset, doc,\n\t\t\telem = this[ 0 ],\n\t\t\tparentOffset = { top: 0, left: 0 };\n\n\t\t// position:fixed elements are offset from the viewport, which itself always has zero offset\n\t\tif ( jQuery.css( elem, \"position\" ) === \"fixed\" ) {\n\n\t\t\t// Assume position:fixed implies availability of getBoundingClientRect\n\t\t\toffset = elem.getBoundingClientRect();\n\n\t\t} else {\n\t\t\toffset = this.offset();\n\n\t\t\t// Account for the *real* offset parent, which can be the document or its root element\n\t\t\t// when a statically positioned element is identified\n\t\t\tdoc = elem.ownerDocument;\n\t\t\toffsetParent = elem.offsetParent || doc.documentElement;\n\t\t\twhile ( offsetParent &&\n\t\t\t\t( offsetParent === doc.body || offsetParent === doc.documentElement ) &&\n\t\t\t\tjQuery.css( offsetParent, \"position\" ) === \"static\" ) {\n\n\t\t\t\toffsetParent = offsetParent.parentNode;\n\t\t\t}\n\t\t\tif ( offsetParent && offsetParent !== elem && offsetParent.nodeType === 1 ) {\n\n\t\t\t\t// Incorporate borders into its offset, since they are outside its content origin\n\t\t\t\tparentOffset = jQuery( offsetParent ).offset();\n\t\t\t\tparentOffset.top += jQuery.css( offsetParent, \"borderTopWidth\", true );\n\t\t\t\tparentOffset.left += jQuery.css( offsetParent, \"borderLeftWidth\", true );\n\t\t\t}\n\t\t}\n\n\t\t// Subtract parent offsets and element margins\n\t\treturn {\n\t\t\ttop: offset.top - parentOffset.top - jQuery.css( elem, \"marginTop\", true ),\n\t\t\tleft: offset.left - parentOffset.left - jQuery.css( elem, \"marginLeft\", true )\n\t\t};\n\t},\n\n\t// This method will return documentElement in the following cases:\n\t// 1) For the element inside the iframe without offsetParent, this method will return\n\t// documentElement of the parent window\n\t// 2) For the hidden or detached element\n\t// 3) For body or html element, i.e. in case of the html node - it will return itself\n\t//\n\t// but those exceptions were never presented as a real life use-cases\n\t// and might be considered as more preferable results.\n\t//\n\t// This logic, however, is not guaranteed and can change at any point in the future\n\toffsetParent: function() {\n\t\treturn this.map( function() {\n\t\t\tvar offsetParent = this.offsetParent;\n\n\t\t\twhile ( offsetParent && jQuery.css( offsetParent, \"position\" ) === \"static\" ) {\n\t\t\t\toffsetParent = offsetParent.offsetParent;\n\t\t\t}\n\n\t\t\treturn offsetParent || documentElement;\n\t\t} );\n\t}\n} );\n\n// Create scrollLeft and scrollTop methods\njQuery.each( { scrollLeft: \"pageXOffset\", scrollTop: \"pageYOffset\" }, function( method, prop ) {\n\tvar top = \"pageYOffset\" === prop;\n\n\tjQuery.fn[ method ] = function( val ) {\n\t\treturn access( this, function( elem, method, val ) {\n\n\t\t\t// Coalesce documents and windows\n\t\t\tvar win;\n\t\t\tif ( isWindow( elem ) ) {\n\t\t\t\twin = elem;\n\t\t\t} else if ( elem.nodeType === 9 ) {\n\t\t\t\twin = elem.defaultView;\n\t\t\t}\n\n\t\t\tif ( val === undefined ) {\n\t\t\t\treturn win ? win[ prop ] : elem[ method ];\n\t\t\t}\n\n\t\t\tif ( win ) {\n\t\t\t\twin.scrollTo(\n\t\t\t\t\t!top ? val : win.pageXOffset,\n\t\t\t\t\ttop ? val : win.pageYOffset\n\t\t\t\t);\n\n\t\t\t} else {\n\t\t\t\telem[ method ] = val;\n\t\t\t}\n\t\t}, method, val, arguments.length );\n\t};\n} );\n\n// Support: Safari <=7 - 9.1, Chrome <=37 - 49\n// Add the top/left cssHooks using jQuery.fn.position\n// Webkit bug: https://bugs.webkit.org/show_bug.cgi?id=29084\n// Blink bug: https://bugs.chromium.org/p/chromium/issues/detail?id=589347\n// getComputedStyle returns percent when specified for top/left/bottom/right;\n// rather than make the css module depend on the offset module, just check for it here\njQuery.each( [ \"top\", \"left\" ], function( i, prop ) {\n\tjQuery.cssHooks[ prop ] = addGetHookIf( support.pixelPosition,\n\t\tfunction( elem, computed ) {\n\t\t\tif ( computed ) {\n\t\t\t\tcomputed = curCSS( elem, prop );\n\n\t\t\t\t// If curCSS returns percentage, fallback to offset\n\t\t\t\treturn rnumnonpx.test( computed ) ?\n\t\t\t\t\tjQuery( elem ).position()[ prop ] + \"px\" :\n\t\t\t\t\tcomputed;\n\t\t\t}\n\t\t}\n\t);\n} );\n\n\n// Create innerHeight, innerWidth, height, width, outerHeight and outerWidth methods\njQuery.each( { Height: \"height\", Width: \"width\" }, function( name, type ) {\n\tjQuery.each( { padding: \"inner\" + name, content: type, \"\": \"outer\" + name },\n\t\tfunction( defaultExtra, funcName ) {\n\n\t\t// Margin is only for outerHeight, outerWidth\n\t\tjQuery.fn[ funcName ] = function( margin, value ) {\n\t\t\tvar chainable = arguments.length && ( defaultExtra || typeof margin !== \"boolean\" ),\n\t\t\t\textra = defaultExtra || ( margin === true || value === true ? \"margin\" : \"border\" );\n\n\t\t\treturn access( this, function( elem, type, value ) {\n\t\t\t\tvar doc;\n\n\t\t\t\tif ( isWindow( elem ) ) {\n\n\t\t\t\t\t// $( window ).outerWidth/Height return w/h including scrollbars (gh-1729)\n\t\t\t\t\treturn funcName.indexOf( \"outer\" ) === 0 ?\n\t\t\t\t\t\telem[ \"inner\" + name ] :\n\t\t\t\t\t\telem.document.documentElement[ \"client\" + name ];\n\t\t\t\t}\n\n\t\t\t\t// Get document width or height\n\t\t\t\tif ( elem.nodeType === 9 ) {\n\t\t\t\t\tdoc = elem.documentElement;\n\n\t\t\t\t\t// Either scroll[Width/Height] or offset[Width/Height] or client[Width/Height],\n\t\t\t\t\t// whichever is greatest\n\t\t\t\t\treturn Math.max(\n\t\t\t\t\t\telem.body[ \"scroll\" + name ], doc[ \"scroll\" + name ],\n\t\t\t\t\t\telem.body[ \"offset\" + name ], doc[ \"offset\" + name ],\n\t\t\t\t\t\tdoc[ \"client\" + name ]\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\treturn value === undefined ?\n\n\t\t\t\t\t// Get width or height on the element, requesting but not forcing parseFloat\n\t\t\t\t\tjQuery.css( elem, type, extra ) :\n\n\t\t\t\t\t// Set width or height on the element\n\t\t\t\t\tjQuery.style( elem, type, value, extra );\n\t\t\t}, type, chainable ? margin : undefined, chainable );\n\t\t};\n\t} );\n} );\n\n\njQuery.each( ( \"blur focus focusin focusout resize scroll click dblclick \" +\n\t\"mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave \" +\n\t\"change select submit keydown keypress keyup contextmenu\" ).split( \" \" ),\n\tfunction( i, name ) {\n\n\t// Handle event binding\n\tjQuery.fn[ name ] = function( data, fn ) {\n\t\treturn arguments.length > 0 ?\n\t\t\tthis.on( name, null, data, fn ) :\n\t\t\tthis.trigger( name );\n\t};\n} );\n\njQuery.fn.extend( {\n\thover: function( fnOver, fnOut ) {\n\t\treturn this.mouseenter( fnOver ).mouseleave( fnOut || fnOver );\n\t}\n} );\n\n\n\n\njQuery.fn.extend( {\n\n\tbind: function( types, data, fn ) {\n\t\treturn this.on( types, null, data, fn );\n\t},\n\tunbind: function( types, fn ) {\n\t\treturn this.off( types, null, fn );\n\t},\n\n\tdelegate: function( selector, types, data, fn ) {\n\t\treturn this.on( types, selector, data, fn );\n\t},\n\tundelegate: function( selector, types, fn ) {\n\n\t\t// ( namespace ) or ( selector, types [, fn] )\n\t\treturn arguments.length === 1 ?\n\t\t\tthis.off( selector, \"**\" ) :\n\t\t\tthis.off( types, selector || \"**\", fn );\n\t}\n} );\n\n// Bind a function to a context, optionally partially applying any\n// arguments.\n// jQuery.proxy is deprecated to promote standards (specifically Function#bind)\n// However, it is not slated for removal any time soon\njQuery.proxy = function( fn, context ) {\n\tvar tmp, args, proxy;\n\n\tif ( typeof context === \"string\" ) {\n\t\ttmp = fn[ context ];\n\t\tcontext = fn;\n\t\tfn = tmp;\n\t}\n\n\t// Quick check to determine if target is callable, in the spec\n\t// this throws a TypeError, but we will just return undefined.\n\tif ( !isFunction( fn ) ) {\n\t\treturn undefined;\n\t}\n\n\t// Simulated bind\n\targs = slice.call( arguments, 2 );\n\tproxy = function() {\n\t\treturn fn.apply( context || this, args.concat( slice.call( arguments ) ) );\n\t};\n\n\t// Set the guid of unique handler to the same of original handler, so it can be removed\n\tproxy.guid = fn.guid = fn.guid || jQuery.guid++;\n\n\treturn proxy;\n};\n\njQuery.holdReady = function( hold ) {\n\tif ( hold ) {\n\t\tjQuery.readyWait++;\n\t} else {\n\t\tjQuery.ready( true );\n\t}\n};\njQuery.isArray = Array.isArray;\njQuery.parseJSON = JSON.parse;\njQuery.nodeName = nodeName;\njQuery.isFunction = isFunction;\njQuery.isWindow = isWindow;\njQuery.camelCase = camelCase;\njQuery.type = toType;\n\njQuery.now = Date.now;\n\njQuery.isNumeric = function( obj ) {\n\n\t// As of jQuery 3.0, isNumeric is limited to\n\t// strings and numbers (primitives or objects)\n\t// that can be coerced to finite numbers (gh-2662)\n\tvar type = jQuery.type( obj );\n\treturn ( type === \"number\" || type === \"string\" ) &&\n\n\t\t// parseFloat NaNs numeric-cast false positives (\"\")\n\t\t// ...but misinterprets leading-number strings, particularly hex literals (\"0x...\")\n\t\t// subtraction forces infinities to NaN\n\t\t!isNaN( obj - parseFloat( obj ) );\n};\n\n\n\n\n// Register as a named AMD module, since jQuery can be concatenated with other\n// files that may use define, but not via a proper concatenation script that\n// understands anonymous AMD modules. A named AMD is safest and most robust\n// way to register. Lowercase jquery is used because AMD module names are\n// derived from file names, and jQuery is normally delivered in a lowercase\n// file name. Do this after creating the global so that if an AMD module wants\n// to call noConflict to hide this version of jQuery, it will work.\n\n// Note that for maximum portability, libraries that are not jQuery should\n// declare themselves as anonymous modules, and avoid setting a global if an\n// AMD loader is present. jQuery is a special case. For more information, see\n// https://github.com/jrburke/requirejs/wiki/Updating-existing-libraries#wiki-anon\n\nif ( typeof define === \"function\" && define.amd ) {\n\tdefine( \"jquery\", [], function() {\n\t\treturn jQuery;\n\t} );\n}\n\n\n\n\nvar\n\n\t// Map over jQuery in case of overwrite\n\t_jQuery = window.jQuery,\n\n\t// Map over the $ in case of overwrite\n\t_$ = window.$;\n\njQuery.noConflict = function( deep ) {\n\tif ( window.$ === jQuery ) {\n\t\twindow.$ = _$;\n\t}\n\n\tif ( deep && window.jQuery === jQuery ) {\n\t\twindow.jQuery = _jQuery;\n\t}\n\n\treturn jQuery;\n};\n\n// Expose jQuery and $ identifiers, even in AMD\n// (#7102#comment:10, https://github.com/jquery/jquery/pull/557)\n// and CommonJS for browser emulators (#13566)\nif ( !noGlobal ) {\n\twindow.jQuery = window.$ = jQuery;\n}\n\n\n\n\nreturn jQuery;\n} );\n\ndefine(\"deps/jquery\", function(){});\n\n", - "define('core/jquery-enhanced',[\"exports\", \"core/pubsubhub\", \"core/utils\", \"deps/jquery\"], function (exports, _pubsubhub, _utils) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n const name = exports.name = \"core/jquery-enhanced\";\n\n window.$ = $;\n\n // --- JQUERY EXTRAS -----------------------------------------------------------------------\n // Applies to any jQuery object containing elements, changes their name to the one give, and\n // return a jQuery object containing the new elements\n window.$.fn.renameElement = function (name) {\n var arr = [];\n this.each(function () {\n var $newEl = $(this.ownerDocument.createElement(name));\n // I forget why this didn't work, maybe try again\n // $newEl.attr($(this).attr());\n for (var i = 0, n = this.attributes.length; i < n; i++) {\n var at = this.attributes[i];\n try {\n $newEl[0].setAttributeNS(at.namespaceURI, at.name, at.value);\n } catch (err) {\n var msg = \"Your HTML markup is malformed. Error in: \\n\";\n msg += \"```HTML\\n\" + this.outerHTML + \"\\n```\";\n (0, _pubsubhub.pub)(\"error\", msg);\n break; // no point in continuing with this element\n }\n }\n $(this).contents().appendTo($newEl);\n $(this).replaceWith($newEl);\n arr.push($newEl[0]);\n });\n return $(arr);\n };\n\n // For any element, returns an array of title strings that applies\n // the algorithm used for determining the\n // actual title of a <dfn> element (but can apply to other as well).\n //\n // if args.isDefinition is true, then the element is a definition, not a\n // reference to a definition. Any @title or @lt will be replaced with\n // @data-lt to be consistent with Bikeshed / Shepherd.\n //\n // This method now *prefers* the data-lt attribute for the list of\n // titles. That attribute is added by this method to dfn elements, so\n // subsequent calls to this method will return the data-lt based list.\n //\n // This method will publish a warning if a title is used on a definition\n // instead of an @lt (as per specprod mailing list discussion).\n window.$.fn.getDfnTitles = function (args) {\n var theAttr = \"\";\n var titleString = \"\";\n var normalizedText = \"\";\n //data-lt-noDefault avoid using the text content of a definition\n //in the definition list.\n if (this.attr(\"data-lt-noDefault\") === undefined) {\n normalizedText = (0, _utils.norm)(this.text()).toLowerCase();\n }\n if (this.attr(\"data-lt\")) {\n theAttr = this.attr(\"data-lt\") ? \"data-lt\" : \"lt\";\n // prefer @data-lt for the list of title aliases\n titleString = this.attr(theAttr).toLowerCase();\n if (normalizedText !== \"\") {\n // Use the definition itself, so to avoid\n // having to declare the definition twice.\n if (!titleString.startsWith(`${normalizedText}|`)) {\n titleString = titleString + \"|\" + normalizedText;\n }\n }\n } else if (this.contents().length === 1 && this.children(\"abbr, acronym\").length === 1 && this.find(\":first-child\").attr(\"title\")) {\n titleString = this.find(\":first-child\").attr(\"title\");\n } else {\n titleString = this.text() === '\"\"' ? \"the-empty-string\" : this.text();\n }\n // now we have a string of one or more titles\n titleString = (0, _utils.norm)(titleString).toLowerCase();\n if (args && args.isDefinition === true) {\n // if it came from an attribute, replace that with data-lt as per contract with Shepherd\n if (theAttr) {\n this.attr(\"data-lt\", titleString);\n }\n if (theAttr !== \"data-lt\") {\n this.removeAttr(theAttr);\n }\n // if there is no pre-defined type, assume it is a 'dfn'\n if (!this.attr(\"dfn-type\")) {\n this.attr(\"data-dfn-type\", \"dfn\");\n } else {\n this.attr(\"data-dfn-type\", this.attr(\"dfn-type\"));\n this.removeAttr(\"dfn-type\");\n }\n }\n const titles = titleString.split(\"|\").filter(item => item !== \"\").reduce((collector, item) => collector.add(item), new Set());\n return [...titles];\n };\n\n // For any element (usually <a>), returns an array of targets that\n // element might refer to, of the form\n // {for: 'interfacename', title: 'membername'}.\n //\n // For an element like:\n // <p link-for=\"Int1\"><a for=\"Int2\">Int3.member</a></p>\n // we'll return:\n // * {for: \"int2\", title: \"int3.member\"}\n // * {for: \"int3\", title: \"member\"}\n // * {for: \"\", title: \"int3.member\"}\n window.$.fn.linkTargets = function () {\n var elem = this;\n var linkForElem = this[0].closest(\"[data-link-for]\");\n var linkFor = linkForElem ? linkForElem.dataset.linkFor.toLowerCase() : \"\";\n var titles = elem.getDfnTitles();\n var result = [];\n for (const title of titles) {\n result.push({\n for: linkFor,\n title\n });\n const split = title.split(\".\");\n if (split.length === 2) {\n // If there are multiple '.'s, this won't match an\n // Interface/member pair anyway.\n result.push({\n for: split[0],\n title: split[1]\n });\n }\n result.push({\n for: \"\",\n title\n });\n }\n return result;\n };\n\n // Applied to an element, sets an ID for it (and returns it), using a specific prefix\n // if provided, and a specific text if given.\n window.$.fn.makeID = function (pfx = \"\", txt = \"\", noLC = false) {\n const elem = this[0];\n if (elem.id) {\n return elem.id;\n }\n if (!txt) {\n txt = (elem.title ? elem.title : elem.textContent).trim();\n }\n var id = noLC ? txt : txt.toLowerCase();\n id = id.replace(/[\\W]+/gmi, \"-\").replace(/^-+/, \"\").replace(/-+$/, \"\");\n if (!id) {\n id = \"generatedID\";\n } else if (/\\.$/.test(id) || !/^[a-z]/i.test(id)) {\n id = \"x\" + id; // trailing . doesn't play well with jQuery\n }\n if (pfx) {\n id = `${pfx}-${id}`;\n }\n if (elem.ownerDocument.getElementById(id)) {\n let i = 0;\n let nextId = id + \"-\" + i;\n while (elem.ownerDocument.getElementById(nextId)) {\n nextId = id + \"-\" + i++;\n }\n id = nextId;\n }\n elem.id = id;\n return id;\n };\n\n // Returns all the descendant text nodes of an element. Note that those nodes aren't\n // returned as a jQuery array since I'm not sure if that would make too much sense.\n window.$.fn.allTextNodes = function (exclusions) {\n var textNodes = [],\n excl = {};\n for (var i = 0, n = exclusions.length; i < n; i++) excl[exclusions[i]] = true;\n\n function getTextNodes(node) {\n if (node.nodeType === 1 && excl[node.localName.toLowerCase()]) return;\n if (node.nodeType === 3) textNodes.push(node);else {\n for (var i = 0, len = node.childNodes.length; i < len; ++i) getTextNodes(node.childNodes[i]);\n }\n }\n getTextNodes(this[0]);\n return textNodes;\n };\n});\n//# sourceMappingURL=jquery-enhanced.js.map;\n", - "define('core/ui',[\"exports\", \"shortcut\", \"core/pubsubhub\", \"deps/text!ui/ui.css\", \"core/utils\", \"core/jquery-enhanced\"], function (exports, _shortcut, _pubsubhub, _ui, _utils) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.ui = exports.name = undefined;\n\n var _shortcut2 = _interopRequireDefault(_shortcut);\n\n var _ui2 = _interopRequireDefault(_ui);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n const name = exports.name = \"core/ui\";\n\n // Opportunistically inserts the style, with the chance to reduce some FOUC\n // Module core/ui\n // Handles the ReSpec UI\n /*jshint laxcomma:true*/\n // XXX TODO\n // - look at other UI things to add\n // - list issues\n // - lint: validator, link checker, check WebIDL, ID references\n // - save to GitHub\n // - make a release candidate that people can test\n // - once we have something decent, merge, ship as 3.2.0\n\n const styleElement = document.createElement(\"style\");\n styleElement.id = \"respec-ui-styles\";\n styleElement.textContent = _ui2.default;\n styleElement.classList.add(\"removeOnSave\");\n\n document.head.appendChild(styleElement);\n\n function ariaDecorate(elem, ariaMap) {\n if (!elem) {\n return;\n }\n Array.from(ariaMap.entries()).reduce((elem, [name, value]) => {\n elem.setAttribute(\"aria-\" + name, value);\n return elem;\n }, elem);\n }\n\n const $respecUI = $(\"<div id='respec-ui' class='removeOnSave' hidden></div>\");\n const $menu = $(\"<ul id=respec-menu role=menu aria-labelledby='respec-pill' hidden></ul>\");\n var $modal;\n var $overlay;\n const errors = [];\n const warnings = [];\n const buttons = {};\n\n (0, _pubsubhub.sub)(\"start-all\", () => {\n document.body.insertAdjacentElement(\"afterbegin\", $respecUI[0]);\n }, { once: true });\n (0, _pubsubhub.sub)(\"end-all\", () => {\n document.body.insertAdjacentElement(\"afterbegin\", $respecUI[0]);\n }, { once: true });\n\n const $respecPill = $(\"<button id='respec-pill' disabled>ReSpec</button>\");\n $respecPill.click(function (e) {\n e.stopPropagation();\n if ($menu[0].hidden) {\n $menu[0].classList.remove(\"respec-hidden\");\n $menu[0].classList.add(\"respec-visible\");\n } else {\n $menu[0].classList.add(\"respec-hidden\");\n $menu[0].classList.remove(\"respec-visible\");\n }\n this.setAttribute(\"aria-expanded\", String($menu[0].hidden));\n $menu[0].hidden = !$menu[0].hidden;\n }).appendTo($respecUI);\n document.documentElement.addEventListener(\"click\", function () {\n if (!$menu[0].hidden) {\n $menu[0].classList.remove(\"respec-visible\");\n $menu[0].classList.add(\"respec-hidden\");\n $menu[0].hidden = true;\n }\n });\n $menu.appendTo($respecUI);\n\n const ariaMap = new Map([[\"controls\", \"respec-menu\"], [\"expanded\", \"false\"], [\"haspopup\", \"true\"], [\"label\", \"ReSpec Menu\"]]);\n ariaDecorate($respecPill[0], ariaMap);\n\n function errWarn(msg, arr, butName, title) {\n arr.push(msg);\n if (buttons.hasOwnProperty(butName)) {\n buttons[butName].text(arr.length);\n return;\n }\n buttons[butName] = $(\"<button id='respec-pill-\" + butName + \"' class='respec-info-button'>\" + arr.length + \"</button>\").appendTo($respecUI).click(function () {\n this.setAttribute(\"aria-expanded\", \"true\");\n var $ul = $(\"<ol class='respec-\" + butName + \"-list'></ol>\");\n for (var i = 0, n = arr.length; i < n; i++) {\n var err = arr[i];\n if (err instanceof Error) {\n $(\"<li><span></span> <a>\\u229e</a><pre></pre></li>\").appendTo($ul).find(\"span\").text(\"[\" + err.name + \"] \" + err.message).end().find(\"a\").css({\n fontSize: \"1.1em\",\n color: \"#999\",\n cursor: \"pointer\"\n }).click(function () {\n var $a = $(this),\n state = $a.text(),\n $pre = $a.parent().find(\"pre\");\n if (state === \"\\u229e\") {\n $a.text(\"\\u229f\");\n $pre.show();\n } else {\n $a.text(\"\\u229e\");\n $pre.hide();\n }\n }).end().find(\"pre\").text(err.stack).css({\n marginLeft: \"0\",\n maxWidth: \"100%\",\n overflowY: \"hidden\",\n overflowX: \"scroll\"\n }).hide().end();\n } else {\n const tmp = document.createElement(\"tmp\");\n tmp.innerHTML = (0, _utils.markdownToHtml)(err);\n const li = document.createElement(\"li\");\n // if it's only a single element, just copy the contents into li\n if (tmp.firstElementChild === tmp.lastElementChild) {\n while (tmp.firstElementChild && tmp.firstElementChild.hasChildNodes()) {\n li.appendChild(tmp.firstElementChild.firstChild);\n }\n // Otherwise, take everything.\n } else {\n li.innerHTML = tmp.innerHTML;\n }\n $ul[0].appendChild(li);\n }\n }\n ui.freshModal(title, $ul, this);\n });\n const ariaMap = new Map([[\"expanded\", \"false\"], [\"haspopup\", \"true\"], [\"controls\", \"respec-pill-\" + butName + \"-modal\"], [\"label\", \"Document \" + title.toLowerCase()]]);\n ariaDecorate(buttons[butName][0], ariaMap);\n }\n const ui = exports.ui = {\n show: function () {\n try {\n $respecUI[0].hidden = false;\n } catch (err) {\n console.error(err);\n }\n },\n hide: function () {\n $respecUI[0].hidden = true;\n },\n enable: function () {\n $respecPill[0].removeAttribute(\"disabled\");\n },\n addCommand: function (label, module, keyShort, icon) {\n icon = icon || \"\";\n var handler = function () {\n require([module], function (mod) {\n mod.show();\n });\n };\n var id = \"respec-button-\" + label.toLowerCase().replace(/\\s+/, \"-\");\n var menuItem = $('<li role=menuitem><button id=\"' + id + '\" class=\"respec-option\" title=\"' + keyShort + '\"><span class=\"respec-cmd-icon\">' + icon + \"</span> \" + label + \"… </button></li>\").click(handler).appendTo($menu);\n if (keyShort) _shortcut2.default.add(keyShort, handler);\n return menuItem[0].querySelector(\"button\");\n },\n error: function (msg) {\n errWarn(msg, errors, \"error\", \"Errors\");\n },\n warning: function (msg) {\n errWarn(msg, warnings, \"warning\", \"Warnings\");\n },\n closeModal: function (owner) {\n if ($overlay) {\n $overlay[0].classList.remove(\"respec-show-overlay\");\n $overlay[0].classList.add(\"respec-hide-overlay\");\n $overlay[0].addEventListener(\"transitionend\", () => {\n $overlay.remove();\n $overlay = null;\n });\n }\n if (owner) {\n owner.setAttribute(\"aria-expanded\", \"false\");\n }\n if (!$modal) return;\n $modal.remove();\n $modal = null;\n },\n freshModal: function (title, content, currentOwner) {\n if ($modal) $modal.remove();\n if ($overlay) $overlay.remove();\n $overlay = $(\"<div id='respec-overlay' class='removeOnSave'></div>\");\n const id = currentOwner.id + \"-modal\";\n const headingId = id + \"-heading\";\n $modal = $(\"<div id='\" + id + \"' class='respec-modal removeOnSave' role='dialog'><h3></h3><div class='inside'></div></div>\");\n $modal.find(\"h3\").text(title);\n $modal.find(\"h3\")[0].id = headingId;\n const ariaMap = new Map([[\"labelledby\", headingId]]);\n ariaDecorate($modal[0], ariaMap);\n $modal.find(\".inside\").append(content);\n $(document.body).append($overlay).append($modal);\n $overlay.click(() => {\n this.closeModal(currentOwner);\n });\n $overlay[0].classList.toggle(\"respec-show-overlay\");\n $modal[0].hidden = false;\n }\n };\n _shortcut2.default.add(\"Esc\", function () {\n ui.closeModal();\n });\n _shortcut2.default.add(\"Ctrl+Alt+Shift+E\", function () {\n if (buttons.error) buttons.error.click();\n });\n _shortcut2.default.add(\"Ctrl+Alt+Shift+W\", function () {\n if (buttons.warning) buttons.warning.click();\n });\n window.respecUI = ui;\n (0, _pubsubhub.sub)(\"error\", function (details) {\n ui.error(details);\n });\n (0, _pubsubhub.sub)(\"warn\", function (details) {\n ui.warning(details);\n });\n});\n//# sourceMappingURL=ui.js.map;\n", - "define('core/l10n',[\"exports\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.run = run;\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n /**\n * Module core/l10n\n *\n * Looks at the lang attribute on the root element and uses it\n * to manage the config.l10n object so that other parts of the system can\n * localize their text.\n */\n const name = exports.name = \"core/l10n\";\n\n const html = document.documentElement;\n if (html && !html.hasAttribute(\"lang\")) {\n html.lang = \"en\";\n if (!html.hasAttribute(\"dir\")) {\n html.dir = \"ltr\";\n }\n }\n\n // We use en-US as the base\n const base = {\n about_respec: \"About\",\n abstract: \"Abstract\",\n author: \"Author:\",\n authors: \"Authors:\",\n bug_tracker: \"Bug tracker:\",\n close_parens: \")\",\n commit_history: \"Commit history\",\n definition_list: \"Definitions\",\n editor: \"Editor:\",\n editors_note: \"Editor's note\",\n editors: \"Editors:\",\n example: \"Example\",\n feature_at_risk: \"Feature at Risk\",\n fig: \"Figure \",\n file_a_bug: \"File a bug\",\n former_editor: \"Former editor:\",\n former_editors: \"Former editors:\",\n info_references: \"Informative references\",\n issue_summary: \"Issue Summary\",\n issue: \"Issue\",\n latest_editors_draft: \"Latest editor's draft:\",\n latest_published_version: \"Latest published version:\",\n list_of_definitions: \"List of Definitions\",\n norm_references: \"Normative references\",\n note: \"Note\",\n open_bugs: \"open bugs\",\n open_parens: \"(\",\n participate: \"Participate\",\n pull_requests: \"Pull requests\",\n references: \"References\",\n save_as: \"Save as\",\n save_snapshot: \"Export\",\n search_specref: \"Search Specref\",\n sotd: \"Status of This Document\",\n table_of_fig: \"Table of Figures\",\n this_version: \"This version:\",\n toc: \"Table of Contents\",\n warning: \"Warning\"\n };\n\n const ko = {\n abstract: \"요약\",\n author: \"저자:\",\n authors: \"저자:\",\n fig: \"그림 \",\n latest_published_version: \"최신 버전:\",\n sotd: \"현재 문서의 상태\",\n this_version: \"현재 버전:\"\n };\n\n const zh = {\n abstract: \"摘要\",\n bug_tracker: \"错误跟踪:\",\n editor: \"编辑:\",\n editors: \"编辑们:\",\n fig: \"圖\",\n file_a_bug: \"反馈错误\",\n latest_editors_draft: \"最新编辑草稿:\",\n latest_published_version: \"最新发布草稿:\",\n note: \"注\",\n open_bugs: \"修正中的错误\",\n sotd: \"关于本文档\",\n this_version: \"本版本:\",\n toc: \"内容大纲\"\n };\n\n const ja = {\n abstract: \"要約\",\n author: \"著者:\",\n authors: \"著者:\",\n bug_tracker: \"バグの追跡履歴:\",\n editor: \"編者:\",\n editors: \"編者:\",\n fig: \"図\",\n latest_editors_draft: \"最新の編集用草案:\",\n latest_published_version: \"最新バージョン:\",\n note: \"注\",\n open_bugs: \"改修されていないバグ\",\n sotd: \"この文書の位置付け\",\n this_version: \"このバージョン:\",\n toc: \"目次\"\n };\n\n const nl = {\n about_respec: \"Over\",\n abstract: \"Samenvatting\",\n author: \"Auteur:\",\n authors: \"Auteurs:\",\n bug_tracker: \"Meldingensysteem:\",\n commit_history: \"Revisiehistorie\",\n definition_list: \"Lijst van Definities\",\n editor: \"Redacteur:\",\n editors_note: \"Redactionele noot\",\n editors: \"Redacteurs:\",\n example: \"Voorbeeld\",\n fig: \"Figuur \",\n file_a_bug: \"Dien een melding in\",\n info_references: \"Informatieve referenties\",\n issue_summary: \"Lijst met issues\",\n latest_editors_draft: \"Laatste werkversie:\",\n latest_published_version: \"Laatst gepubliceerde versie:\",\n list_of_definitions: \"Lijst van Definities\",\n norm_references: \"Normatieve referenties\",\n note: \"Noot\",\n open_bugs: \"open meldingen\",\n participate: \"Doe mee\",\n references: \"Referenties\",\n save_as: \"Bewaar als\",\n save_snapshot: \"Bewaar Snapshot\",\n search_specref: \"Doorzoek Specref\",\n sotd: \"Status van dit document\",\n table_of_fig: \"Lijst met figuren\",\n this_version: \"Deze versie:\",\n toc: \"Inhoudsopgave\",\n warning: \"Waarschuwing\"\n };\n\n const es = {\n abstract: \"Resumen\",\n author: \"Autor:\",\n authors: \"Autores:\",\n bug_tracker: \"Repositorio de bugs:\",\n close_parens: \")\",\n commit_history: \"Historia de cambios\",\n editor: \"Editor:\",\n editors_note: \"Nota de editor\",\n editors: \"Editores:\",\n example: \"Ejemplo\",\n fig: \"Figura \",\n file_a_bug: \"Nota un bug\",\n info_references: \"Referencias informativas\",\n issue_summary: \"Resumen de la cuestión\",\n issue: \"Cuestión\",\n latest_editors_draft: \"Borrador de editor mas reciente:\",\n latest_published_version: \"Versión publicada mas reciente:\",\n norm_references: \"Referencias normativas\",\n note: \"Nota\",\n open_bugs: \"Bugs abiertos\",\n open_parens: \"(\",\n participate: \"Participad\",\n references: \"Referencias\",\n sotd: \"Estado de este Document\",\n table_of_fig: \"Tabla de Figuras\",\n this_version: \"Ésta versión:\",\n toc: \"Tabla de Contenidos\",\n warning: \"Aviso\"\n };\n\n const l10n = exports.l10n = {\n en: _extends({}, base),\n ko: _extends({}, base, ko),\n zh: _extends({}, base, zh),\n ja: _extends({}, base, ja),\n nl: _extends({}, base, nl),\n es: _extends({}, base, es)\n };\n\n l10n[\"zh-hans\"] = l10n.zh;\n l10n[\"zh-cn\"] = l10n.zh;\n\n const lang = exports.lang = html && html.lang in l10n ? html.lang : \"en\";\n\n function run(config) {\n config.l10n = l10n[lang] || l10n.en;\n }\n});\n//# sourceMappingURL=l10n.js.map;\n", - "define('core/linter',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n const name = exports.name = \"core/linter\";\n const privates = new WeakMap();\n\n class Linter {\n constructor() {\n privates.set(this, {\n rules: new Set()\n });\n }\n get rules() {\n return privates.get(this).rules;\n }\n register(...newRules) {\n newRules.reduce((rules, newRule) => rules.add(newRule), this.rules);\n }\n async lint(conf, doc = window.document) {\n const promisesToLint = [...privates.get(this).rules].map(rule => toLinterWarning(rule.lint(conf, doc)));\n await promisesToLint;\n }\n }\n\n const linter = new Linter();\n exports.default = linter;\n\n\n const baseResult = {\n name: \"unknown\",\n description: \"\",\n occurrences: 0,\n howToFix: \"\",\n offendingElements: [], // DOM Nodes\n help: \"\" // where to get help\n };\n\n async function toLinterWarning(promiseToLint) {\n const results = await promiseToLint;\n results.map(async resultPromise => {\n const result = await resultPromise;\n const output = _extends({}, baseResult, result);\n const {\n description,\n help,\n howToFix,\n name,\n occurrences,\n offendingElements\n } = output;\n const msg = `${description} ${howToFix} ${help} (\"${name}\" x ${occurrences})`;\n offendingElements.forEach(elem => {\n elem.classList.add(\"respec-offending-element\");\n });\n console.warn(`Linter (${name}):`, description, ...offendingElements);\n return msg;\n }).forEach(async msgPromise => {\n (0, _pubsubhub.pub)(\"warn\", (await msgPromise));\n });\n }\n\n async function run(conf, doc, cb) {\n cb(); // return early, continue processing other things\n if (conf.lint === false) {\n return; // nothing to do\n }\n await document.respecReady;\n try {\n await linter.lint(conf, doc);\n } catch (err) {\n console.error(\"Error ocurred while running the linter\", err);\n }\n }\n});\n//# sourceMappingURL=linter.js.map;\n", - "define('core/LinterRule',[\"exports\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n const privs = new WeakMap();\n /**\n * Checks if the linter rule is enabled.\n *\n * @param {Object} conf ReSpec config object.\n */\n function canLint(conf, name) {\n return !(conf.hasOwnProperty(\"lint\") === false || conf.lint === false || !conf.lint[name]);\n }\n\n class LinterRule {\n /**\n *\n * @param {String} the name of the rule\n * @param {Function} lintingFunction has a conf, and doc argument\n */\n constructor(name, lintingFunction) {\n privs.set(this, { name, lintingFunction });\n }\n get name() {\n return privs.get(this).name;\n }\n /**\n * Runs linter rule.\n *\n * @param {Object} config The ReSpec config.\n * @param {Document} doc The document to be checked.\n */\n lint(conf = { lint: { [this.name]: false } }, doc = document) {\n return canLint(conf, this.name) ? [].concat(privs.get(this).lintingFunction(conf, doc)) : [];\n }\n }\n exports.default = LinterRule;\n});\n//# sourceMappingURL=LinterRule.js.map;\n", - "define('core/linter-rules/no-headingless-sections',[\"exports\", \"core/LinterRule\", \"../l10n\"], function (exports, _LinterRule, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.rule = undefined;\n\n var _LinterRule2 = _interopRequireDefault(_LinterRule);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n const name = \"no-headingless-sections\";\n const meta = {\n en: {\n description: \"All sections must start with a `h2-6` element.\",\n howToFix: \"Add a `h2-6` to the offending section or use a `<div>`.\",\n help: \"See developer console.\"\n },\n nl: {\n description: \"Alle secties moeten beginnen met een `h2-6` element.\",\n howToFix: \"Voeg een `h2-6` toe aan de conflicterende sectie of gebruik een `<div>`.\",\n help: \"Zie de developer console.\"\n }\n };\n\n // Fall back to english, if language is missing\n const lang = _l10n.lang in meta ? _l10n.lang : \"en\";\n const hasNoHeading = ({ firstElementChild: elem }) => {\n return elem === null || /^h[1-6]$/.test(elem.localName) === false;\n };\n\n function linterFunction(conf, doc) {\n const offendingElements = Array.from(doc.querySelectorAll(\"section\")).filter(hasNoHeading);\n if (!offendingElements.length) {\n return [];\n }\n return _extends({\n name,\n offendingElements,\n occurrences: offendingElements.length\n }, meta[lang]);\n }\n const rule = exports.rule = new _LinterRule2.default(name, linterFunction);\n});\n//# sourceMappingURL=no-headingless-sections.js.map;\n", - "define('core/linter-rules/no-http-props',[\"exports\", \"core/l10n\", \"core/LinterRule\"], function (exports, _l10n, _LinterRule) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.rule = undefined;\n\n var _LinterRule2 = _interopRequireDefault(_LinterRule);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n const name = \"no-http-props\";\n\n const meta = {\n en: {\n description: \"Insecure URLs are not allowed in `respecConfig`.\",\n howToFix: \"Please change the following properties to 'https://': \"\n }\n };\n\n // Fall back to english, if language is missing\n const lang = _l10n.lang in meta ? _l10n.lang : \"en\";\n\n /**\n * Runs linter rule.\n *\n * @param {Object} config The ReSpec config.\n * @param {Document} doc The document to be checked.\n */\n function lintingFunction(conf, doc) {\n // We can only really perform this check over http/https\n if (!doc.location.href.startsWith(\"http\")) {\n return [];\n }\n const offendingMembers = Object.getOwnPropertyNames(conf)\n // this check is cheap, \"prevED\" is w3c exception.\n .filter(key => key.endsWith(\"URI\") || key === \"prevED\")\n // this check is expensive, so separate step\n .filter(key => new URL(conf[key], doc.location.href).href.startsWith(\"http://\")).reduce((collector, key) => collector.concat(key), []);\n if (!offendingMembers.length) {\n return [];\n }\n const result = _extends({\n name,\n occurrences: offendingMembers.length\n }, meta[lang]);\n result.howToFix += offendingMembers.map(item => \"`\" + item + \"`\").join(\", \") + \".\";\n return result;\n }\n\n const rule = exports.rule = new _LinterRule2.default(name, lintingFunction);\n});\n//# sourceMappingURL=no-http-props.js.map;\n", - "define('w3c/l10n',[\"exports\", \"core/l10n\"], function (exports, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n const name = exports.name = \"w3c/l10n\"; // Module w3c/l10n\n // Looks at the lang attribute on the root element and uses it to manage the config.l10n object so\n // that other parts of the system can localise their text\n\n const additions = {\n en: {\n status_at_publication: \"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the <a href='https://www.w3.org/TR/'>W3C technical reports index</a> at https://www.w3.org/TR/.\"\n },\n ko: {\n status_at_publication: \"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the <a href='https://www.w3.org/TR/'>W3C technical reports index</a> at https://www.w3.org/TR/.\"\n },\n zh: {\n status_at_publication: \"本章节描述了本文档的发布状态。其它更新版本可能会覆盖本文档。W3C的文档列 表和最新版本可通过<a href='https://www.w3.org/TR/'>W3C技术报告</a>索引访问。\"\n },\n ja: {\n status_at_publication: \"この節には、公開時点でのこの文書の位置づけが記されている。他の文書によって置き換えられる可能性がある。現時点でのW3Cの発行文書とこのテクニカルレポートの最新版は、下記から参照できる。 <a href='https://www.w3.org/TR/'>W3C technical reports index</a> (https://www.w3.org/TR/)\"\n },\n nl: {\n status_at_publication: \"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the <a href='https://www.w3.org/TR/'>W3C technical reports index</a> at https://www.w3.org/TR/.\"\n }\n };\n\n Object.keys(additions).reduce((l10n, key) => {\n Object.assign(l10n[key], additions[key]);\n return l10n;\n }, _l10n.l10n);\n});\n//# sourceMappingURL=l10n.js.map;\n", - "define('w3c/linter-rules/privsec-section',[\"exports\", \"core/LinterRule\", \"../l10n\"], function (exports, _LinterRule, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.rule = undefined;\n\n var _LinterRule2 = _interopRequireDefault(_LinterRule);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n const name = \"privsec-section\";\n const meta = {\n en: {\n description: \"Document must a 'Privacy and/or Security' Considerations section.\",\n howToFix: \"Add a privacy and/or security considerations section.\",\n help: \"See the [Self-Review Questionnaire](https://w3ctag.github.io/security-questionnaire/).\"\n }\n };\n\n // Fall back to english, if language is missing\n const lang = _l10n.lang in meta ? _l10n.lang : \"en\";\n\n function hasPriSecConsiderations(doc) {\n return Array.from(doc.querySelectorAll(\"h2, h3, h4, h5, h6\")).some(({ textContent: text }) => {\n const saysPrivOrSec = /(privacy|security)/im.test(text);\n const saysConsiderations = /(considerations)/im.test(text);\n return saysPrivOrSec && saysConsiderations || saysPrivOrSec;\n });\n }\n\n function lintingFunction(conf, doc) {\n const results = [];\n if (conf.isRecTrack && !hasPriSecConsiderations(doc)) {\n results.push(_extends({ name, occurrences: 1 }, meta[lang]));\n }\n return results;\n }\n\n const rule = exports.rule = new _LinterRule2.default(name, lintingFunction);\n});\n//# sourceMappingURL=privsec-section.js.map;\n", - "define('core/linter-rules/check-punctuation',[\"exports\", \"core/l10n\", \"core/LinterRule\"], function (exports, _l10n, _LinterRule) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.rule = undefined;\n\n var _LinterRule2 = _interopRequireDefault(_LinterRule);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n const name = \"check-punctuation\";\n const punctuationMarks = [\".\", \":\", \"!\", \"?\"];\n const humanMarks = punctuationMarks.map(mark => `\"${mark}\"`).join(\", \");\n const meta = {\n en: {\n description: \"`p` elements should end with a punctuation mark.\",\n howToFix: `Please make sure \\`p\\` elements end with one of: ${humanMarks}.`\n }\n };\n // Fall back to english, if language is missing\n const lang = _l10n.lang in meta ? _l10n.lang : \"en\";\n\n /**\n * Runs linter rule.\n *\n * @param {Object} config The ReSpec config.\n * @param {Document} doc The document to be checked.\n */\n function lintingFunction(conf, doc) {\n // Check string ends with one of ., !, ?, :, ], or is empty.\n const punctuatingRegExp = new RegExp(`[${punctuationMarks.join(\"\")}\\\\]]$|^ *$`, \"m\");\n const offendingElements = [...doc.querySelectorAll(\"p:not(#back-to-top)\")].filter(elem => !punctuatingRegExp.test(elem.textContent.trim()));\n if (!offendingElements.length) {\n return [];\n }\n const result = _extends({\n name,\n offendingElements,\n occurrences: offendingElements.length\n }, meta[lang]);\n return result;\n }\n const rule = exports.rule = new _LinterRule2.default(name, lintingFunction);\n});\n//# sourceMappingURL=check-punctuation.js.map;\n", - "define('core/linter-rules/local-refs-exist',[\"exports\", \"core/l10n\", \"core/LinterRule\"], function (exports, _l10n, _LinterRule) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.rule = undefined;\n\n var _LinterRule2 = _interopRequireDefault(_LinterRule);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n const name = \"local-refs-exist\";\n\n const meta = {\n en: {\n description: \"Broken local reference found in document.\",\n howToFix: \"Please fix the links mentioned.\",\n help: \"See developer console.\"\n }\n };\n\n // Fall back to english, if language is missing\n const lang = _l10n.lang in meta ? _l10n.lang : \"en\";\n\n /**\n * Runs linter rule.\n * @param {Object} config The ReSpec config.\n * @param {Document} doc The document to be checked.\n */\n function linterFunction(conf, doc) {\n const offendingElements = [...doc.querySelectorAll(\"a[href^='#']\")].filter(isBrokenHyperlink);\n if (!offendingElements.length) {\n return [];\n }\n return _extends({\n name,\n offendingElements,\n occurrences: offendingElements.length\n }, meta[lang]);\n }\n\n const rule = exports.rule = new _LinterRule2.default(name, linterFunction);\n\n function isBrokenHyperlink(elem) {\n const { href, ownerDocument: doc } = elem;\n const { hash } = new URL(href);\n return !doc.getElementById(hash.substring(1));\n }\n});\n//# sourceMappingURL=local-refs-exist.js.map;\n", - "define('oai/defaults',[\"exports\", \"core/linter\", \"core/linter-rules/no-headingless-sections\", \"core/linter-rules/no-http-props\", \"w3c/linter-rules/privsec-section\", \"core/linter-rules/check-punctuation\", \"core/linter-rules/local-refs-exist\"], function (exports, _linter, _noHeadinglessSections, _noHttpProps, _privsecSection, _checkPunctuation, _localRefsExist) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _linter2 = _interopRequireDefault(_linter);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n /**\n * Sets the defaults for OAI specs\n */\n const name = exports.name = \"oai/defaults\";\n\n\n _linter2.default.register(_noHttpProps.rule, _privsecSection.rule, _noHeadinglessSections.rule, _checkPunctuation.rule, _localRefsExist.rule);\n\n const cgbg = new Set([\"BG-DRAFT\", \"BG-FINAL\", \"CG-DRAFT\", \"CG-FINAL\"]);\n const licenses = new Map([[\"cc0\", {\n name: \"Creative Commons 0 Public Domain Dedication\",\n short: \"CC0\",\n url: \"https://creativecommons.org/publicdomain/zero/1.0/\"\n }], [\"w3c-software\", {\n name: \"W3C Software Notice and License\",\n short: \"W3C Software\",\n url: \"https://www.w3.org/Consortium/Legal/2002/copyright-software-20021231\"\n }], [\"w3c-software-doc\", {\n name: \"W3C Software and Document Notice and License\",\n short: \"W3C Software and Document\",\n url: \"https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document\"\n }], [\"apache2\", {\n name: \"Apache 2.0 License\",\n short: \"Apache 2.0\",\n url: \"https://www.apache.org/licenses/LICENSE-2.0.html\"\n }], [\"cc-by\", {\n name: \"Creative Commons Attribution 4.0 International Public License\",\n short: \"CC-BY\",\n url: \"https://creativecommons.org/licenses/by/4.0/legalcode\"\n }]]);\n\n const oaiDefaults = {\n lint: {\n \"no-headingless-sections\": false,\n \"privsec-section\": true,\n \"no-http-props\": false,\n \"check-punctuation\": false,\n \"local-refs-exist\": false\n },\n pluralize: true,\n doJsonLd: true,\n license: \"apache2\",\n specStatus: \"base\",\n prependW3C: false,\n //overrideCopyright: true,\n logos: [{\n src: \"https://raw.githubusercontent.com/OAI/OpenAPI-Style-Guide/master/graphics/bitmap/OpenAPI_Logo_Pantone.png\",\n alt: \"OpenAPI Initiative\",\n height: 48,\n //width: 211,\n url: \"https://openapis.org/\"\n }]\n };\n\n function computeProps(conf) {\n return {\n isCCBY: conf.license === \"cc-by\",\n licenseInfo: licenses.get(conf.license),\n isCGBG: cgbg.has(conf.specStatus),\n isCGFinal: conf.isCGBG && /G-FINAL$/.test(conf.specStatus),\n isBasic: conf.specStatus === \"base\",\n isRegular: !conf.isCGBG && conf.specStatus === \"base\"\n };\n }\n\n function run(conf) {\n // assign the defaults\n Object.assign(conf, _extends({}, oaiDefaults, conf));\n //computed properties\n Object.assign(conf, computeProps(conf));\n }\n});\n//# sourceMappingURL=defaults.js.map\n;\n", - "\ndefine('deps/text!core/css/respec2.css',[],function () { return '/*****************************************************************\\n * ReSpec 3 CSS\\n * Robin Berjon - http://berjon.com/\\n *****************************************************************/\\n\\n/* Override code highlighter background */\\n.hljs {\\n background: transparent !important;\\n}\\n\\n/* --- INLINES --- */\\nh1 abbr,\\nh2 abbr,\\nh3 abbr,\\nh4 abbr,\\nh5 abbr,\\nh6 abbr,\\na abbr {\\n border: none;\\n}\\n\\ndfn {\\n font-weight: bold;\\n}\\n\\na.internalDFN {\\n color: inherit;\\n border-bottom: 1px solid #99c;\\n text-decoration: none;\\n}\\n\\na.externalDFN {\\n color: inherit;\\n border-bottom: 1px dotted #ccc;\\n text-decoration: none;\\n}\\n\\na.bibref {\\n text-decoration: none;\\n}\\n\\ncite .bibref {\\n font-style: normal;\\n}\\n\\ncode {\\n color: #c83500;\\n}\\n\\nth code {\\n color: inherit;\\n}\\n\\n/* --- TOC --- */\\n\\n.toc a,\\n.tof a {\\n text-decoration: none;\\n}\\n\\na .secno,\\na .figno {\\n color: #000;\\n}\\n\\nul.tof,\\nol.tof {\\n list-style: none outside none;\\n}\\n\\n.caption {\\n margin-top: 0.5em;\\n font-style: italic;\\n}\\n\\n/* --- TABLE --- */\\n\\ntable.simple {\\n border-spacing: 0;\\n border-collapse: collapse;\\n border-bottom: 3px solid #005a9c;\\n}\\n\\n.simple th {\\n background: #005a9c;\\n color: #fff;\\n padding: 3px 5px;\\n text-align: left;\\n}\\n\\n.simple th[scope=\"row\"] {\\n background: inherit;\\n color: inherit;\\n border-top: 1px solid #ddd;\\n}\\n\\n.simple td {\\n padding: 3px 10px;\\n border-top: 1px solid #ddd;\\n}\\n\\n.simple tr:nth-child(even) {\\n background: #f0f6ff;\\n}\\n\\n/* --- DL --- */\\n\\n.section dd > p:first-child {\\n margin-top: 0;\\n}\\n\\n.section dd > p:last-child {\\n margin-bottom: 0;\\n}\\n\\n.section dd {\\n margin-bottom: 1em;\\n}\\n\\n.section dl.attrs dd,\\n.section dl.eldef dd {\\n margin-bottom: 0;\\n}\\n\\n#issue-summary > ul,\\n.respec-dfn-list {\\n column-count: 2;\\n}\\n\\n#issue-summary li,\\n.respec-dfn-list li {\\n list-style: none;\\n}\\n\\ndetails.respec-tests-details {\\n margin-left: 1em;\\n display: inline-block;\\n vertical-align: top;\\n}\\n\\ndetails.respec-tests-details > * {\\n padding-right: 2em;\\n}\\n\\ndetails.respec-tests-details[open] {\\n z-index: 999999;\\n position: absolute;\\n border: thin solid #cad3e2;\\n border-radius: .3em;\\n background-color: white;\\n padding-bottom: .5em;\\n}\\n\\ndetails.respec-tests-details[open] > summary {\\n border-bottom: thin solid #cad3e2;\\n padding-left: 1em;\\n margin-bottom: 1em;\\n line-height: 2em;\\n}\\n\\ndetails.respec-tests-details > ul {\\n width: 100%;\\n margin-top: -0.3em;\\n}\\n\\ndetails.respec-tests-details > li {\\n padding-left: 1em;\\n}\\n\\n@media print {\\n .removeOnSave {\\n display: none;\\n }\\n}\\n';});\n\n", - "define('core/style',[\"exports\", \"deps/text!core/css/respec2.css\"], function (exports, _respec) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _respec2 = _interopRequireDefault(_respec);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n const name = exports.name = \"core/style\";\n\n // Opportunistically inserts the style, with the chance to reduce some FOUC\n // Module core/style\n // Inserts the CSS that ReSpec uses into the document.\n //\n // IMPORTANT NOTE\n // To add you own styles, create a plugin that declares the css as a dependency\n // and create a build of your new ReSpec profile.\n //\n // CONFIGURATION\n // - noReSpecCSS: if you're using a profile that loads this module but you don't want\n // the style, set this to true\n const styleElement = document.createElement(\"style\");\n styleElement.id = \"respec-mainstyle\";\n styleElement.textContent = _respec2.default;\n document.head.appendChild(styleElement);\n\n function run(conf, doc, cb) {\n if (conf.noReSpecCSS) {\n styleElement.remove();\n }\n cb();\n }\n});\n//# sourceMappingURL=style.js.map;\n", - "define('w3c/style',[\"exports\", \"core/utils\", \"core/pubsubhub\"], function (exports, _utils, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n /*jshint strict: true, browser:true, jquery: true*/\n /*globals define*/\n // Module w3c/style\n // Inserts a link to the appropriate W3C style for the specification's maturity level.\n // CONFIGURATION\n // - specStatus: the short code for the specification's maturity level or type (required)\n\n const name = exports.name = \"w3c/style\";\n function attachFixupScript(doc, version) {\n const script = doc.createElement(\"script\");\n script.addEventListener(\"load\", function () {\n if (window.location.hash) {\n window.location = window.location;\n }\n }, { once: true });\n script.src = `https://www.w3.org/scripts/TR/${version}/fixup.js`;\n doc.body.appendChild(script);\n }\n\n // Make a best effort to attach meta viewport at the top of the head.\n // Other plugins might subsequently push it down, but at least we start\n // at the right place. When ReSpec exports the HTML, it again moves the\n // meta viewport to the top of the head - so to make sure it's the first\n // thing the browser sees. See js/ui/save-html.js.\n function createMetaViewport() {\n const meta = document.createElement(\"meta\");\n meta.name = \"viewport\";\n const contentProps = {\n width: \"device-width\",\n \"initial-scale\": \"1\",\n \"shrink-to-fit\": \"no\"\n };\n meta.content = (0, _utils.toKeyValuePairs)(contentProps).replace(/\\\"/g, \"\");\n return meta;\n }\n\n function createBaseStyle() {\n const link = document.createElement(\"link\");\n link.rel = \"stylesheet\";\n link.href = \"https://www.w3.org/StyleSheets/TR/2016/base.css\";\n link.classList.add(\"removeOnSave\");\n return link;\n }\n\n function selectStyleVersion(styleVersion) {\n let version = \"\";\n switch (styleVersion) {\n case null:\n case true:\n version = \"2016\";\n break;\n default:\n if (styleVersion && !isNaN(styleVersion)) {\n version = styleVersion.toString().trim();\n }\n }\n return version;\n }\n\n function createResourceHints() {\n const resourceHints = [{\n hint: \"preconnect\", // for W3C styles and scripts.\n href: \"https://www.w3.org\"\n }, {\n hint: \"preload\", // all specs need it, and we attach it on end-all.\n href: \"https://www.w3.org/scripts/TR/2016/fixup.js\",\n as: \"script\"\n }, {\n hint: \"preload\", // all specs include on base.css.\n href: \"https://www.w3.org/StyleSheets/TR/2016/base.css\",\n as: \"style\"\n }, {\n hint: \"preload\", // all specs show the logo.\n href: \"https://www.w3.org/StyleSheets/TR/2016/logos/W3C\",\n as: \"image\"\n }].map(_utils.createResourceHint).reduce(function (frag, link) {\n frag.appendChild(link);\n return frag;\n }, document.createDocumentFragment());\n return resourceHints;\n }\n // Collect elements for insertion (document fragment)\n const elements = createResourceHints();\n\n // Opportunistically apply base style\n elements.appendChild(createBaseStyle());\n if (!document.head.querySelector(\"meta[name=viewport]\")) {\n // Make meta viewport the first element in the head.\n elements.insertBefore(createMetaViewport(), elements.firstChild);\n }\n\n document.head.insertBefore(elements, document.head.firstChild);\n\n function run(conf, doc, cb) {\n if (!conf.specStatus) {\n const warn = \"`respecConfig.specStatus` missing. Defaulting to 'base'.\";\n conf.specStatus = \"base\";\n (0, _pubsubhub.pub)(\"warn\", warn);\n }\n\n let styleFile = \"W3C-\";\n\n // Figure out which style file to use.\n switch (conf.specStatus.toUpperCase()) {\n case \"CG-DRAFT\":\n case \"CG-FINAL\":\n case \"BG-DRAFT\":\n case \"BG-FINAL\":\n styleFile = conf.specStatus.toLowerCase();\n break;\n case \"FPWD\":\n case \"LC\":\n case \"WD-NOTE\":\n case \"LC-NOTE\":\n styleFile += \"WD\";\n break;\n case \"WG-NOTE\":\n case \"FPWD-NOTE\":\n styleFile += \"WG-NOTE.css\";\n break;\n case \"UNOFFICIAL\":\n styleFile += \"UD\";\n break;\n case \"FINDING\":\n case \"FINDING-DRAFT\":\n case \"BASE\":\n styleFile = \"base.css\";\n break;\n default:\n styleFile += conf.specStatus;\n }\n\n // Select between released styles and experimental style.\n const version = selectStyleVersion(conf.useExperimentalStyles || \"2016\");\n // Attach W3C fixup script after we are done.\n if (version && !conf.noToc) {\n (0, _pubsubhub.sub)(\"end-all\", function () {\n attachFixupScript(doc, version);\n }, { once: true });\n }\n const finalVersionPath = version ? version + \"/\" : \"\";\n const finalStyleURL = `https://www.w3.org/StyleSheets/TR/${finalVersionPath}${styleFile}`;\n\n (0, _utils.linkCSS)(doc, finalStyleURL);\n cb();\n }\n});\n//# sourceMappingURL=style.js.map;\n", - "define('core/github',[\"exports\", \"core/l10n\", \"core/pubsubhub\"], function (exports, _l10n, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.fetchAll = fetchAll;\n exports.fetchIndex = fetchIndex;\n exports.run = run;\n\n var _l10n2 = _interopRequireDefault(_l10n);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n const name = exports.name = \"core/github\";\n\n function findNext(header) {\n // Finds the next URL of paginated resources which\n // is available in the Link header. Link headers look like this:\n // Link: <url1>; rel=\"next\", <url2>; rel=\"foo\"; bar=\"baz\"\n // More info here: https://developer.github.com/v3/#link-header\n var m = (header || \"\").match(/<([^>]+)>\\s*;\\s*rel=\"next\"/);\n return m && m[1] || null;\n }\n\n async function fetchAll(url, headers = {}, output = []) {\n const urlObj = new URL(url);\n if (urlObj.searchParams && !urlObj.searchParams.has(\"per_page\")) {\n urlObj.searchParams.append(\"per_page\", \"100\");\n }\n const request = new Request(urlObj, {\n headers\n });\n request.headers.set(\"Accept\", \"application/vnd.github.v3+json\");\n const response = await window.fetch(request);\n const json = await response.json();\n if (Array.isArray(json)) {\n output.push(...json);\n }\n const next = findNext(response.headers.get(\"Link\"));\n return next ? fetchAll(next, headers, output) : output;\n }\n\n function fetchIndex(url, headers) {\n // converts URLs of the form:\n // https://api.github.com/repos/user/repo/comments{/number}\n // into:\n // https://api.github.com/repos/user/repo/comments\n // which is what you need if you want to get the index.\n return fetchAll(url.replace(/\\{[^}]+\\}/, \"\"), headers);\n }\n\n async function run(conf) {\n if (!conf.hasOwnProperty(\"github\") || !conf.github) {\n // nothing to do, bail out.\n return;\n }\n if (typeof conf.github === \"object\" && !conf.github.hasOwnProperty(\"repoURL\")) {\n const msg = \"Config option `[github](https://github.com/w3c/respec/wiki/github)` \" + \"is missing property `repoURL`.\";\n (0, _pubsubhub.pub)(\"error\", msg);\n return;\n }\n let ghURL;\n try {\n ghURL = new URL(conf.github.repoURL || conf.github, \"https://github.com\");\n } catch (err) {\n (0, _pubsubhub.pub)(\"error\", `\\`respecConf.github\\` is not a valid URL? (${ghURL})`);\n return;\n }\n if (ghURL.origin !== \"https://github.com\") {\n const msg = `\\`respecConf.github\\` must be HTTPS and pointing to GitHub. (${ghURL})`;\n (0, _pubsubhub.pub)(\"error\", msg);\n return;\n }\n const [org, repo] = ghURL.pathname.split(\"/\").filter(item => item);\n if (!org || !repo) {\n const msg = \"`respecConf.github` URL needs a path with, for example, w3c/my-spec\";\n (0, _pubsubhub.pub)(\"error\", msg);\n return;\n }\n const branch = conf.github.branch || \"gh-pages\";\n const newProps = {\n edDraftURI: `https://${org.toLowerCase()}.github.io/${repo}/`,\n githubToken: undefined,\n githubUser: undefined,\n githubAPI: `https://api.github.com/repos/${org}/${repo}`,\n issueBase: new URL(\"./issues/\", ghURL).href,\n otherLinks: [],\n pullBase: new URL(\"./pulls/\", ghURL).href,\n shortName: repo\n };\n const otherLink = {\n key: conf.l10n.participate,\n data: [{\n value: `GitHub ${org}/${repo}`,\n href: ghURL\n }, {\n value: conf.l10n.file_a_bug,\n href: newProps.issueBase\n }, {\n value: conf.l10n.commit_history,\n href: new URL(`./commits/${branch}`, ghURL.href).href\n }, {\n value: conf.l10n.pull_requests,\n href: newProps.pullBase\n }]\n };\n // Assign new properties, but retain existing ones\n const normalizedGHObj = {\n branch,\n repoURL: ghURL.href\n };\n const normalizedConfig = _extends({}, newProps, conf, { github: normalizedGHObj });\n Object.assign(conf, normalizedConfig);\n conf.otherLinks.unshift(otherLink);\n }\n});\n//# sourceMappingURL=github.js.map;\n", - "define('core/data-include',[\"exports\", \"core/pubsubhub\", \"core/utils\"], function (exports, _pubsubhub, _utils) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n /*globals console*/\n // Module core/data-include\n // Support for the data-include attribute. Causes external content to be included inside an\n // element that has data-include='some URI'. There is also a data-oninclude attribute that\n // features a white space separated list of global methods that will be called with the\n // module object, the content, and the included URI.\n //\n // IMPORTANT:\n // This module only really works when you are in an HTTP context, and will most likely\n // fail if you are editing your documents on your local drive. That is due to security\n // restrictions in the browser.\n const name = exports.name = \"core/data-include\";\n\n function processResponse(rawData, id, url) {\n const el = document.querySelector(`[data-include-id=${id}]`);\n const doc = el.ownerDocument;\n const data = (0, _utils.runTransforms)(rawData, el.dataset.oninclude, url);\n const replace = typeof el.dataset.includeReplace === \"string\";\n let replacementNode;\n switch (el.dataset.includeFormat) {\n case \"text\":\n if (replace) {\n replacementNode = doc.createTextNode(data);\n el.parentNode.replaceChild(replacementNode, el);\n } else {\n el.textContent = data;\n }\n break;\n default:\n // html, which is just using \"innerHTML\"\n el.innerHTML = data;\n if (replace) {\n replacementNode = doc.createDocumentFragment();\n while (el.hasChildNodes()) {\n replacementNode.append(el.removeChild(el.firstChild));\n }\n el.parentNode.replaceChild(replacementNode, el);\n }\n }\n // If still in the dom tree, clean up\n if (doc.contains(el)) {\n cleanUp(el);\n }\n }\n /**\n * Removes attributes after they are used for inclusion, if present.\n *\n * @param {Element} el The element to clean up.\n */\n function cleanUp(el) {\n [\"data-include\", \"data-include-format\", \"data-include-replace\", \"data-include-id\", \"oninclude\"].forEach(attr => el.removeAttribute(attr));\n }\n\n function run(conf, doc, cb) {\n const promisesToInclude = Array.from(doc.querySelectorAll(\"[data-include]\")).map(async el => {\n const url = el.dataset.include;\n if (!url) {\n return; // just skip it\n }\n const id = \"include-\" + String(Math.random()).substr(2);\n el.dataset.includeId = id;\n try {\n const response = await fetch(url);\n const text = await response.text();\n processResponse(text, id, url);\n } catch (err) {\n const msg = `\\`data-include\\` failed: \\`${url}\\` (${err.message}). See console for details.`;\n console.error(\"data-include failed for element: \", el, err);\n (0, _pubsubhub.pub)(\"error\", msg);\n }\n });\n Promise.all(promisesToInclude).then(cb);\n }\n});\n//# sourceMappingURL=data-include.js.map;\n", - "define('core/markdown',[\"exports\", \"core/utils\"], function (exports, _utils) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"core/markdown\"; /**\n * Module core/markdown\n * Handles the optional markdown processing.\n *\n * Markdown support is optional. It is enabled by setting the `format`\n * property of the configuration object to \"markdown.\"\n *\n * We use marked for parsing Markdown:\n * https://github.com/chjj/marked\n *\n * Note that the content of SECTION elements, and elements with a\n * class name of \"note\", \"issue\" or \"req\" are also parsed.\n *\n * The HTML created by the Markdown parser is turned into a nested\n * structure of SECTION elements, following the structure given by\n * the headings. For example, the following markup:\n *\n * Title\n * -----\n *\n * ### Subtitle ###\n *\n * Here's some text.\n *\n * ### Another subtitle ###\n *\n * More text.\n *\n * will be transformed into:\n *\n * <section>\n * <h2>Title</h2>\n * <section>\n * <h3>Subtitle</h3>\n * <p>Here's some text.</p>\n * </section>\n * <section>\n * <h3>Another subtitle</h3>\n * <p>More text.</p>\n * </section>\n * </section>\n *\n * The whitespace of pre elements are left alone.\n **/\n\n function processElements(selector) {\n return element => {\n const elements = Array.from(element.querySelectorAll(selector));\n elements.reverse().forEach(element => {\n element.innerHTML = (0, _utils.markdownToHtml)(element.innerHTML);\n });\n return elements;\n };\n }\n\n class Builder {\n constructor(doc) {\n this.doc = doc;\n this.root = doc.createDocumentFragment();\n this.stack = [this.root];\n this.current = this.root;\n }\n findPosition(header) {\n return parseInt(header.tagName.charAt(1), 10);\n }\n findParent(position) {\n let parent;\n while (position > 0) {\n position--;\n parent = this.stack[position];\n if (parent) return parent;\n }\n }\n findHeader({ firstChild: node }) {\n while (node) {\n if (/H[1-6]/.test(node.tagName)) {\n return node;\n }\n node = node.nextSibling;\n }\n return null;\n }\n\n addHeader(header) {\n const section = this.doc.createElement(\"section\");\n const position = this.findPosition(header);\n\n section.appendChild(header);\n this.findParent(position).appendChild(section);\n this.stack[position] = section;\n this.stack.length = position + 1;\n this.current = section;\n }\n\n addSection(node, process) {\n const header = this.findHeader(node);\n const position = header ? this.findPosition(header) : 1;\n const parent = this.findParent(position);\n\n if (header) {\n node.removeChild(header);\n }\n\n node.appendChild(process(node));\n\n if (header) {\n node.insertBefore(header, node.firstChild);\n }\n\n parent.appendChild(node);\n this.current = parent;\n }\n\n addElement(node) {\n this.current.appendChild(node);\n }\n }\n\n function structure(fragment, doc) {\n function process(root) {\n const stack = new Builder(doc);\n while (root.firstChild) {\n const node = root.firstChild;\n if (node.nodeType !== Node.ELEMENT_NODE) {\n root.removeChild(node);\n continue;\n }\n switch (node.localName) {\n case \"h1\":\n case \"h2\":\n case \"h3\":\n case \"h4\":\n case \"h5\":\n case \"h6\":\n stack.addHeader(node);\n break;\n case \"section\":\n stack.addSection(node, process);\n break;\n default:\n stack.addElement(node);\n }\n }\n return stack.root;\n }\n return process(fragment);\n }\n\n function substituteWithTextNodes(elements) {\n Array.from(elements).forEach(element => {\n const textNode = element.ownerDocument.createTextNode(element.textContent);\n element.parentElement.replaceChild(textNode, element);\n });\n }\n\n const processMDSections = processElements(\"[data-format='markdown']:not(body)\");\n const processBlockLevelElements = processElements(\"[data-format=markdown]:not(body), section, div, address, article, aside, figure, header, main, body\");\n\n function run(conf, doc, cb) {\n const hasMDSections = !!doc.querySelector(\"[data-format=markdown]:not(body)\");\n const isMDFormat = conf.format === \"markdown\";\n if (!isMDFormat && !hasMDSections) {\n return cb(); // Nothing to be done\n }\n // Only has markdown-format sections\n if (!isMDFormat) {\n processMDSections(doc.body).map(elem => {\n const structuredInternals = structure(elem, elem.ownerDocument);\n return {\n structuredInternals,\n elem\n };\n }).forEach(({ elem, structuredInternals }) => {\n elem.setAttribute(\"aria-busy\", \"true\");\n if (structuredInternals.firstElementChild.localName === \"section\" && elem.localName === \"section\") {\n const section = structuredInternals.firstElementChild;\n section.remove();\n while (section.hasChildNodes()) {\n elem.appendChild(section.firstChild);\n }\n } else {\n elem.innerHTML = \"\";\n }\n elem.appendChild(structuredInternals);\n elem.setAttribute(\"aria-busy\", \"false\");\n });\n return cb();\n }\n // We transplant the UI to do the markdown processing\n const rsUI = doc.getElementById(\"respec-ui\");\n rsUI.remove();\n // The new body will replace the old body\n const newHTML = doc.createElement(\"html\");\n const newBody = doc.createElement(\"body\");\n newBody.innerHTML = doc.body.innerHTML;\n // Marked expects markdown be flush against the left margin\n // so we need to normalize the inner text of some block\n // elements.\n newHTML.appendChild(newBody);\n processBlockLevelElements(newHTML);\n // Process root level text nodes\n const cleanHTML = newBody.innerHTML\n // Markdown parsing sometimes inserts empty p tags\n .replace(/<p>\\s*<\\/p>/gm, \"\");\n newBody.innerHTML = cleanHTML;\n // Remove links where class .nolinks\n substituteWithTextNodes(newBody.querySelectorAll(\".nolinks a[href]\"));\n // Restructure the document properly\n var fragment = structure(newBody, doc);\n // Frankenstein the whole thing back together\n newBody.appendChild(fragment);\n newBody.insertAdjacentElement(\"afterbegin\", rsUI);\n doc.body.parentNode.replaceChild(newBody, doc.body);\n cb();\n }\n});\n//# sourceMappingURL=markdown.js.map;\n", - "/**!\n\n @license\n handlebars v4.0.11\n\nCopyright (C) 2011-2017 by Yehuda Katz\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n\n*/\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine('handlebars.runtime',[], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"Handlebars\"] = factory();\n\telse\n\t\troot[\"Handlebars\"] = factory();\n})(this, function() {\nreturn /******/ (function(modules) { // webpackBootstrap\n/******/ \t// The module cache\n/******/ \tvar installedModules = {};\n\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(installedModules[moduleId])\n/******/ \t\t\treturn installedModules[moduleId].exports;\n\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = installedModules[moduleId] = {\n/******/ \t\t\texports: {},\n/******/ \t\t\tid: moduleId,\n/******/ \t\t\tloaded: false\n/******/ \t\t};\n\n/******/ \t\t// Execute the module function\n/******/ \t\tmodules[moduleId].call(module.exports, module, module.exports, __webpack_require__);\n\n/******/ \t\t// Flag the module as loaded\n/******/ \t\tmodule.loaded = true;\n\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n\n\n/******/ \t// expose the modules object (__webpack_modules__)\n/******/ \t__webpack_require__.m = modules;\n\n/******/ \t// expose the module cache\n/******/ \t__webpack_require__.c = installedModules;\n\n/******/ \t// __webpack_public_path__\n/******/ \t__webpack_require__.p = \"\";\n\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(0);\n/******/ })\n/************************************************************************/\n/******/ ([\n/* 0 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\tvar _interopRequireWildcard = __webpack_require__(1)['default'];\n\n\tvar _interopRequireDefault = __webpack_require__(2)['default'];\n\n\texports.__esModule = true;\n\n\tvar _handlebarsBase = __webpack_require__(3);\n\n\tvar base = _interopRequireWildcard(_handlebarsBase);\n\n\t// Each of these augment the Handlebars object. No need to setup here.\n\t// (This is done to easily share code between commonjs and browse envs)\n\n\tvar _handlebarsSafeString = __webpack_require__(20);\n\n\tvar _handlebarsSafeString2 = _interopRequireDefault(_handlebarsSafeString);\n\n\tvar _handlebarsException = __webpack_require__(5);\n\n\tvar _handlebarsException2 = _interopRequireDefault(_handlebarsException);\n\n\tvar _handlebarsUtils = __webpack_require__(4);\n\n\tvar Utils = _interopRequireWildcard(_handlebarsUtils);\n\n\tvar _handlebarsRuntime = __webpack_require__(21);\n\n\tvar runtime = _interopRequireWildcard(_handlebarsRuntime);\n\n\tvar _handlebarsNoConflict = __webpack_require__(33);\n\n\tvar _handlebarsNoConflict2 = _interopRequireDefault(_handlebarsNoConflict);\n\n\t// For compatibility and usage outside of module systems, make the Handlebars object a namespace\n\tfunction create() {\n\t var hb = new base.HandlebarsEnvironment();\n\n\t Utils.extend(hb, base);\n\t hb.SafeString = _handlebarsSafeString2['default'];\n\t hb.Exception = _handlebarsException2['default'];\n\t hb.Utils = Utils;\n\t hb.escapeExpression = Utils.escapeExpression;\n\n\t hb.VM = runtime;\n\t hb.template = function (spec) {\n\t return runtime.template(spec, hb);\n\t };\n\n\t return hb;\n\t}\n\n\tvar inst = create();\n\tinst.create = create;\n\n\t_handlebarsNoConflict2['default'](inst);\n\n\tinst['default'] = inst;\n\n\texports['default'] = inst;\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 1 */\n/***/ (function(module, exports) {\n\n\t\"use strict\";\n\n\texports[\"default\"] = function (obj) {\n\t if (obj && obj.__esModule) {\n\t return obj;\n\t } else {\n\t var newObj = {};\n\n\t if (obj != null) {\n\t for (var key in obj) {\n\t if (Object.prototype.hasOwnProperty.call(obj, key)) newObj[key] = obj[key];\n\t }\n\t }\n\n\t newObj[\"default\"] = obj;\n\t return newObj;\n\t }\n\t};\n\n\texports.__esModule = true;\n\n/***/ }),\n/* 2 */\n/***/ (function(module, exports) {\n\n\t\"use strict\";\n\n\texports[\"default\"] = function (obj) {\n\t return obj && obj.__esModule ? obj : {\n\t \"default\": obj\n\t };\n\t};\n\n\texports.__esModule = true;\n\n/***/ }),\n/* 3 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\tvar _interopRequireDefault = __webpack_require__(2)['default'];\n\n\texports.__esModule = true;\n\texports.HandlebarsEnvironment = HandlebarsEnvironment;\n\n\tvar _utils = __webpack_require__(4);\n\n\tvar _exception = __webpack_require__(5);\n\n\tvar _exception2 = _interopRequireDefault(_exception);\n\n\tvar _helpers = __webpack_require__(9);\n\n\tvar _decorators = __webpack_require__(17);\n\n\tvar _logger = __webpack_require__(19);\n\n\tvar _logger2 = _interopRequireDefault(_logger);\n\n\tvar VERSION = '4.0.11';\n\texports.VERSION = VERSION;\n\tvar COMPILER_REVISION = 7;\n\n\texports.COMPILER_REVISION = COMPILER_REVISION;\n\tvar REVISION_CHANGES = {\n\t 1: '<= 1.0.rc.2', // 1.0.rc.2 is actually rev2 but doesn't report it\n\t 2: '== 1.0.0-rc.3',\n\t 3: '== 1.0.0-rc.4',\n\t 4: '== 1.x.x',\n\t 5: '== 2.0.0-alpha.x',\n\t 6: '>= 2.0.0-beta.1',\n\t 7: '>= 4.0.0'\n\t};\n\n\texports.REVISION_CHANGES = REVISION_CHANGES;\n\tvar objectType = '[object Object]';\n\n\tfunction HandlebarsEnvironment(helpers, partials, decorators) {\n\t this.helpers = helpers || {};\n\t this.partials = partials || {};\n\t this.decorators = decorators || {};\n\n\t _helpers.registerDefaultHelpers(this);\n\t _decorators.registerDefaultDecorators(this);\n\t}\n\n\tHandlebarsEnvironment.prototype = {\n\t constructor: HandlebarsEnvironment,\n\n\t logger: _logger2['default'],\n\t log: _logger2['default'].log,\n\n\t registerHelper: function registerHelper(name, fn) {\n\t if (_utils.toString.call(name) === objectType) {\n\t if (fn) {\n\t throw new _exception2['default']('Arg not supported with multiple helpers');\n\t }\n\t _utils.extend(this.helpers, name);\n\t } else {\n\t this.helpers[name] = fn;\n\t }\n\t },\n\t unregisterHelper: function unregisterHelper(name) {\n\t delete this.helpers[name];\n\t },\n\n\t registerPartial: function registerPartial(name, partial) {\n\t if (_utils.toString.call(name) === objectType) {\n\t _utils.extend(this.partials, name);\n\t } else {\n\t if (typeof partial === 'undefined') {\n\t throw new _exception2['default']('Attempting to register a partial called \"' + name + '\" as undefined');\n\t }\n\t this.partials[name] = partial;\n\t }\n\t },\n\t unregisterPartial: function unregisterPartial(name) {\n\t delete this.partials[name];\n\t },\n\n\t registerDecorator: function registerDecorator(name, fn) {\n\t if (_utils.toString.call(name) === objectType) {\n\t if (fn) {\n\t throw new _exception2['default']('Arg not supported with multiple decorators');\n\t }\n\t _utils.extend(this.decorators, name);\n\t } else {\n\t this.decorators[name] = fn;\n\t }\n\t },\n\t unregisterDecorator: function unregisterDecorator(name) {\n\t delete this.decorators[name];\n\t }\n\t};\n\n\tvar log = _logger2['default'].log;\n\n\texports.log = log;\n\texports.createFrame = _utils.createFrame;\n\texports.logger = _logger2['default'];\n\n/***/ }),\n/* 4 */\n/***/ (function(module, exports) {\n\n\t'use strict';\n\n\texports.__esModule = true;\n\texports.extend = extend;\n\texports.indexOf = indexOf;\n\texports.escapeExpression = escapeExpression;\n\texports.isEmpty = isEmpty;\n\texports.createFrame = createFrame;\n\texports.blockParams = blockParams;\n\texports.appendContextPath = appendContextPath;\n\tvar escape = {\n\t '&': '&',\n\t '<': '<',\n\t '>': '>',\n\t '\"': '"',\n\t \"'\": ''',\n\t '`': '`',\n\t '=': '='\n\t};\n\n\tvar badChars = /[&<>\"'`=]/g,\n\t possible = /[&<>\"'`=]/;\n\n\tfunction escapeChar(chr) {\n\t return escape[chr];\n\t}\n\n\tfunction extend(obj /* , ...source */) {\n\t for (var i = 1; i < arguments.length; i++) {\n\t for (var key in arguments[i]) {\n\t if (Object.prototype.hasOwnProperty.call(arguments[i], key)) {\n\t obj[key] = arguments[i][key];\n\t }\n\t }\n\t }\n\n\t return obj;\n\t}\n\n\tvar toString = Object.prototype.toString;\n\n\texports.toString = toString;\n\t// Sourced from lodash\n\t// https://github.com/bestiejs/lodash/blob/master/LICENSE.txt\n\t/* eslint-disable func-style */\n\tvar isFunction = function isFunction(value) {\n\t return typeof value === 'function';\n\t};\n\t// fallback for older versions of Chrome and Safari\n\t/* istanbul ignore next */\n\tif (isFunction(/x/)) {\n\t exports.isFunction = isFunction = function (value) {\n\t return typeof value === 'function' && toString.call(value) === '[object Function]';\n\t };\n\t}\n\texports.isFunction = isFunction;\n\n\t/* eslint-enable func-style */\n\n\t/* istanbul ignore next */\n\tvar isArray = Array.isArray || function (value) {\n\t return value && typeof value === 'object' ? toString.call(value) === '[object Array]' : false;\n\t};\n\n\texports.isArray = isArray;\n\t// Older IE versions do not directly support indexOf so we must implement our own, sadly.\n\n\tfunction indexOf(array, value) {\n\t for (var i = 0, len = array.length; i < len; i++) {\n\t if (array[i] === value) {\n\t return i;\n\t }\n\t }\n\t return -1;\n\t}\n\n\tfunction escapeExpression(string) {\n\t if (typeof string !== 'string') {\n\t // don't escape SafeStrings, since they're already safe\n\t if (string && string.toHTML) {\n\t return string.toHTML();\n\t } else if (string == null) {\n\t return '';\n\t } else if (!string) {\n\t return string + '';\n\t }\n\n\t // Force a string conversion as this will be done by the append regardless and\n\t // the regex test will do this transparently behind the scenes, causing issues if\n\t // an object's to string has escaped characters in it.\n\t string = '' + string;\n\t }\n\n\t if (!possible.test(string)) {\n\t return string;\n\t }\n\t return string.replace(badChars, escapeChar);\n\t}\n\n\tfunction isEmpty(value) {\n\t if (!value && value !== 0) {\n\t return true;\n\t } else if (isArray(value) && value.length === 0) {\n\t return true;\n\t } else {\n\t return false;\n\t }\n\t}\n\n\tfunction createFrame(object) {\n\t var frame = extend({}, object);\n\t frame._parent = object;\n\t return frame;\n\t}\n\n\tfunction blockParams(params, ids) {\n\t params.path = ids;\n\t return params;\n\t}\n\n\tfunction appendContextPath(contextPath, id) {\n\t return (contextPath ? contextPath + '.' : '') + id;\n\t}\n\n/***/ }),\n/* 5 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\tvar _Object$defineProperty = __webpack_require__(6)['default'];\n\n\texports.__esModule = true;\n\n\tvar errorProps = ['description', 'fileName', 'lineNumber', 'message', 'name', 'number', 'stack'];\n\n\tfunction Exception(message, node) {\n\t var loc = node && node.loc,\n\t line = undefined,\n\t column = undefined;\n\t if (loc) {\n\t line = loc.start.line;\n\t column = loc.start.column;\n\n\t message += ' - ' + line + ':' + column;\n\t }\n\n\t var tmp = Error.prototype.constructor.call(this, message);\n\n\t // Unfortunately errors are not enumerable in Chrome (at least), so `for prop in tmp` doesn't work.\n\t for (var idx = 0; idx < errorProps.length; idx++) {\n\t this[errorProps[idx]] = tmp[errorProps[idx]];\n\t }\n\n\t /* istanbul ignore else */\n\t if (Error.captureStackTrace) {\n\t Error.captureStackTrace(this, Exception);\n\t }\n\n\t try {\n\t if (loc) {\n\t this.lineNumber = line;\n\n\t // Work around issue under safari where we can't directly set the column value\n\t /* istanbul ignore next */\n\t if (_Object$defineProperty) {\n\t Object.defineProperty(this, 'column', {\n\t value: column,\n\t enumerable: true\n\t });\n\t } else {\n\t this.column = column;\n\t }\n\t }\n\t } catch (nop) {\n\t /* Ignore if the browser is very particular */\n\t }\n\t}\n\n\tException.prototype = new Error();\n\n\texports['default'] = Exception;\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 6 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\tmodule.exports = { \"default\": __webpack_require__(7), __esModule: true };\n\n/***/ }),\n/* 7 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\tvar $ = __webpack_require__(8);\n\tmodule.exports = function defineProperty(it, key, desc){\n\t return $.setDesc(it, key, desc);\n\t};\n\n/***/ }),\n/* 8 */\n/***/ (function(module, exports) {\n\n\tvar $Object = Object;\n\tmodule.exports = {\n\t create: $Object.create,\n\t getProto: $Object.getPrototypeOf,\n\t isEnum: {}.propertyIsEnumerable,\n\t getDesc: $Object.getOwnPropertyDescriptor,\n\t setDesc: $Object.defineProperty,\n\t setDescs: $Object.defineProperties,\n\t getKeys: $Object.keys,\n\t getNames: $Object.getOwnPropertyNames,\n\t getSymbols: $Object.getOwnPropertySymbols,\n\t each: [].forEach\n\t};\n\n/***/ }),\n/* 9 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\tvar _interopRequireDefault = __webpack_require__(2)['default'];\n\n\texports.__esModule = true;\n\texports.registerDefaultHelpers = registerDefaultHelpers;\n\n\tvar _helpersBlockHelperMissing = __webpack_require__(10);\n\n\tvar _helpersBlockHelperMissing2 = _interopRequireDefault(_helpersBlockHelperMissing);\n\n\tvar _helpersEach = __webpack_require__(11);\n\n\tvar _helpersEach2 = _interopRequireDefault(_helpersEach);\n\n\tvar _helpersHelperMissing = __webpack_require__(12);\n\n\tvar _helpersHelperMissing2 = _interopRequireDefault(_helpersHelperMissing);\n\n\tvar _helpersIf = __webpack_require__(13);\n\n\tvar _helpersIf2 = _interopRequireDefault(_helpersIf);\n\n\tvar _helpersLog = __webpack_require__(14);\n\n\tvar _helpersLog2 = _interopRequireDefault(_helpersLog);\n\n\tvar _helpersLookup = __webpack_require__(15);\n\n\tvar _helpersLookup2 = _interopRequireDefault(_helpersLookup);\n\n\tvar _helpersWith = __webpack_require__(16);\n\n\tvar _helpersWith2 = _interopRequireDefault(_helpersWith);\n\n\tfunction registerDefaultHelpers(instance) {\n\t _helpersBlockHelperMissing2['default'](instance);\n\t _helpersEach2['default'](instance);\n\t _helpersHelperMissing2['default'](instance);\n\t _helpersIf2['default'](instance);\n\t _helpersLog2['default'](instance);\n\t _helpersLookup2['default'](instance);\n\t _helpersWith2['default'](instance);\n\t}\n\n/***/ }),\n/* 10 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\texports.__esModule = true;\n\n\tvar _utils = __webpack_require__(4);\n\n\texports['default'] = function (instance) {\n\t instance.registerHelper('blockHelperMissing', function (context, options) {\n\t var inverse = options.inverse,\n\t fn = options.fn;\n\n\t if (context === true) {\n\t return fn(this);\n\t } else if (context === false || context == null) {\n\t return inverse(this);\n\t } else if (_utils.isArray(context)) {\n\t if (context.length > 0) {\n\t if (options.ids) {\n\t options.ids = [options.name];\n\t }\n\n\t return instance.helpers.each(context, options);\n\t } else {\n\t return inverse(this);\n\t }\n\t } else {\n\t if (options.data && options.ids) {\n\t var data = _utils.createFrame(options.data);\n\t data.contextPath = _utils.appendContextPath(options.data.contextPath, options.name);\n\t options = { data: data };\n\t }\n\n\t return fn(context, options);\n\t }\n\t });\n\t};\n\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 11 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\tvar _interopRequireDefault = __webpack_require__(2)['default'];\n\n\texports.__esModule = true;\n\n\tvar _utils = __webpack_require__(4);\n\n\tvar _exception = __webpack_require__(5);\n\n\tvar _exception2 = _interopRequireDefault(_exception);\n\n\texports['default'] = function (instance) {\n\t instance.registerHelper('each', function (context, options) {\n\t if (!options) {\n\t throw new _exception2['default']('Must pass iterator to #each');\n\t }\n\n\t var fn = options.fn,\n\t inverse = options.inverse,\n\t i = 0,\n\t ret = '',\n\t data = undefined,\n\t contextPath = undefined;\n\n\t if (options.data && options.ids) {\n\t contextPath = _utils.appendContextPath(options.data.contextPath, options.ids[0]) + '.';\n\t }\n\n\t if (_utils.isFunction(context)) {\n\t context = context.call(this);\n\t }\n\n\t if (options.data) {\n\t data = _utils.createFrame(options.data);\n\t }\n\n\t function execIteration(field, index, last) {\n\t if (data) {\n\t data.key = field;\n\t data.index = index;\n\t data.first = index === 0;\n\t data.last = !!last;\n\n\t if (contextPath) {\n\t data.contextPath = contextPath + field;\n\t }\n\t }\n\n\t ret = ret + fn(context[field], {\n\t data: data,\n\t blockParams: _utils.blockParams([context[field], field], [contextPath + field, null])\n\t });\n\t }\n\n\t if (context && typeof context === 'object') {\n\t if (_utils.isArray(context)) {\n\t for (var j = context.length; i < j; i++) {\n\t if (i in context) {\n\t execIteration(i, i, i === context.length - 1);\n\t }\n\t }\n\t } else {\n\t var priorKey = undefined;\n\n\t for (var key in context) {\n\t if (context.hasOwnProperty(key)) {\n\t // We're running the iterations one step out of sync so we can detect\n\t // the last iteration without have to scan the object twice and create\n\t // an itermediate keys array.\n\t if (priorKey !== undefined) {\n\t execIteration(priorKey, i - 1);\n\t }\n\t priorKey = key;\n\t i++;\n\t }\n\t }\n\t if (priorKey !== undefined) {\n\t execIteration(priorKey, i - 1, true);\n\t }\n\t }\n\t }\n\n\t if (i === 0) {\n\t ret = inverse(this);\n\t }\n\n\t return ret;\n\t });\n\t};\n\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 12 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\tvar _interopRequireDefault = __webpack_require__(2)['default'];\n\n\texports.__esModule = true;\n\n\tvar _exception = __webpack_require__(5);\n\n\tvar _exception2 = _interopRequireDefault(_exception);\n\n\texports['default'] = function (instance) {\n\t instance.registerHelper('helperMissing', function () /* [args, ]options */{\n\t if (arguments.length === 1) {\n\t // A missing field in a {{foo}} construct.\n\t return undefined;\n\t } else {\n\t // Someone is actually trying to call something, blow up.\n\t throw new _exception2['default']('Missing helper: \"' + arguments[arguments.length - 1].name + '\"');\n\t }\n\t });\n\t};\n\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 13 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\texports.__esModule = true;\n\n\tvar _utils = __webpack_require__(4);\n\n\texports['default'] = function (instance) {\n\t instance.registerHelper('if', function (conditional, options) {\n\t if (_utils.isFunction(conditional)) {\n\t conditional = conditional.call(this);\n\t }\n\n\t // Default behavior is to render the positive path if the value is truthy and not empty.\n\t // The `includeZero` option may be set to treat the condtional as purely not empty based on the\n\t // behavior of isEmpty. Effectively this determines if 0 is handled by the positive path or negative.\n\t if (!options.hash.includeZero && !conditional || _utils.isEmpty(conditional)) {\n\t return options.inverse(this);\n\t } else {\n\t return options.fn(this);\n\t }\n\t });\n\n\t instance.registerHelper('unless', function (conditional, options) {\n\t return instance.helpers['if'].call(this, conditional, { fn: options.inverse, inverse: options.fn, hash: options.hash });\n\t });\n\t};\n\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 14 */\n/***/ (function(module, exports) {\n\n\t'use strict';\n\n\texports.__esModule = true;\n\n\texports['default'] = function (instance) {\n\t instance.registerHelper('log', function () /* message, options */{\n\t var args = [undefined],\n\t options = arguments[arguments.length - 1];\n\t for (var i = 0; i < arguments.length - 1; i++) {\n\t args.push(arguments[i]);\n\t }\n\n\t var level = 1;\n\t if (options.hash.level != null) {\n\t level = options.hash.level;\n\t } else if (options.data && options.data.level != null) {\n\t level = options.data.level;\n\t }\n\t args[0] = level;\n\n\t instance.log.apply(instance, args);\n\t });\n\t};\n\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 15 */\n/***/ (function(module, exports) {\n\n\t'use strict';\n\n\texports.__esModule = true;\n\n\texports['default'] = function (instance) {\n\t instance.registerHelper('lookup', function (obj, field) {\n\t return obj && obj[field];\n\t });\n\t};\n\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 16 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\texports.__esModule = true;\n\n\tvar _utils = __webpack_require__(4);\n\n\texports['default'] = function (instance) {\n\t instance.registerHelper('with', function (context, options) {\n\t if (_utils.isFunction(context)) {\n\t context = context.call(this);\n\t }\n\n\t var fn = options.fn;\n\n\t if (!_utils.isEmpty(context)) {\n\t var data = options.data;\n\t if (options.data && options.ids) {\n\t data = _utils.createFrame(options.data);\n\t data.contextPath = _utils.appendContextPath(options.data.contextPath, options.ids[0]);\n\t }\n\n\t return fn(context, {\n\t data: data,\n\t blockParams: _utils.blockParams([context], [data && data.contextPath])\n\t });\n\t } else {\n\t return options.inverse(this);\n\t }\n\t });\n\t};\n\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 17 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\tvar _interopRequireDefault = __webpack_require__(2)['default'];\n\n\texports.__esModule = true;\n\texports.registerDefaultDecorators = registerDefaultDecorators;\n\n\tvar _decoratorsInline = __webpack_require__(18);\n\n\tvar _decoratorsInline2 = _interopRequireDefault(_decoratorsInline);\n\n\tfunction registerDefaultDecorators(instance) {\n\t _decoratorsInline2['default'](instance);\n\t}\n\n/***/ }),\n/* 18 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\texports.__esModule = true;\n\n\tvar _utils = __webpack_require__(4);\n\n\texports['default'] = function (instance) {\n\t instance.registerDecorator('inline', function (fn, props, container, options) {\n\t var ret = fn;\n\t if (!props.partials) {\n\t props.partials = {};\n\t ret = function (context, options) {\n\t // Create a new partials stack frame prior to exec.\n\t var original = container.partials;\n\t container.partials = _utils.extend({}, original, props.partials);\n\t var ret = fn(context, options);\n\t container.partials = original;\n\t return ret;\n\t };\n\t }\n\n\t props.partials[options.args[0]] = options.fn;\n\n\t return ret;\n\t });\n\t};\n\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 19 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\texports.__esModule = true;\n\n\tvar _utils = __webpack_require__(4);\n\n\tvar logger = {\n\t methodMap: ['debug', 'info', 'warn', 'error'],\n\t level: 'info',\n\n\t // Maps a given level value to the `methodMap` indexes above.\n\t lookupLevel: function lookupLevel(level) {\n\t if (typeof level === 'string') {\n\t var levelMap = _utils.indexOf(logger.methodMap, level.toLowerCase());\n\t if (levelMap >= 0) {\n\t level = levelMap;\n\t } else {\n\t level = parseInt(level, 10);\n\t }\n\t }\n\n\t return level;\n\t },\n\n\t // Can be overridden in the host environment\n\t log: function log(level) {\n\t level = logger.lookupLevel(level);\n\n\t if (typeof console !== 'undefined' && logger.lookupLevel(logger.level) <= level) {\n\t var method = logger.methodMap[level];\n\t if (!console[method]) {\n\t // eslint-disable-line no-console\n\t method = 'log';\n\t }\n\n\t for (var _len = arguments.length, message = Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {\n\t message[_key - 1] = arguments[_key];\n\t }\n\n\t console[method].apply(console, message); // eslint-disable-line no-console\n\t }\n\t }\n\t};\n\n\texports['default'] = logger;\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 20 */\n/***/ (function(module, exports) {\n\n\t// Build out our basic SafeString type\n\t'use strict';\n\n\texports.__esModule = true;\n\tfunction SafeString(string) {\n\t this.string = string;\n\t}\n\n\tSafeString.prototype.toString = SafeString.prototype.toHTML = function () {\n\t return '' + this.string;\n\t};\n\n\texports['default'] = SafeString;\n\tmodule.exports = exports['default'];\n\n/***/ }),\n/* 21 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t'use strict';\n\n\tvar _Object$seal = __webpack_require__(22)['default'];\n\n\tvar _interopRequireWildcard = __webpack_require__(1)['default'];\n\n\tvar _interopRequireDefault = __webpack_require__(2)['default'];\n\n\texports.__esModule = true;\n\texports.checkRevision = checkRevision;\n\texports.template = template;\n\texports.wrapProgram = wrapProgram;\n\texports.resolvePartial = resolvePartial;\n\texports.invokePartial = invokePartial;\n\texports.noop = noop;\n\n\tvar _utils = __webpack_require__(4);\n\n\tvar Utils = _interopRequireWildcard(_utils);\n\n\tvar _exception = __webpack_require__(5);\n\n\tvar _exception2 = _interopRequireDefault(_exception);\n\n\tvar _base = __webpack_require__(3);\n\n\tfunction checkRevision(compilerInfo) {\n\t var compilerRevision = compilerInfo && compilerInfo[0] || 1,\n\t currentRevision = _base.COMPILER_REVISION;\n\n\t if (compilerRevision !== currentRevision) {\n\t if (compilerRevision < currentRevision) {\n\t var runtimeVersions = _base.REVISION_CHANGES[currentRevision],\n\t compilerVersions = _base.REVISION_CHANGES[compilerRevision];\n\t throw new _exception2['default']('Template was precompiled with an older version of Handlebars than the current runtime. ' + 'Please update your precompiler to a newer version (' + runtimeVersions + ') or downgrade your runtime to an older version (' + compilerVersions + ').');\n\t } else {\n\t // Use the embedded version info since the runtime doesn't know about this revision yet\n\t throw new _exception2['default']('Template was precompiled with a newer version of Handlebars than the current runtime. ' + 'Please update your runtime to a newer version (' + compilerInfo[1] + ').');\n\t }\n\t }\n\t}\n\n\tfunction template(templateSpec, env) {\n\t /* istanbul ignore next */\n\t if (!env) {\n\t throw new _exception2['default']('No environment passed to template');\n\t }\n\t if (!templateSpec || !templateSpec.main) {\n\t throw new _exception2['default']('Unknown template object: ' + typeof templateSpec);\n\t }\n\n\t templateSpec.main.decorator = templateSpec.main_d;\n\n\t // Note: Using env.VM references rather than local var references throughout this section to allow\n\t // for external users to override these as psuedo-supported APIs.\n\t env.VM.checkRevision(templateSpec.compiler);\n\n\t function invokePartialWrapper(partial, context, options) {\n\t if (options.hash) {\n\t context = Utils.extend({}, context, options.hash);\n\t if (options.ids) {\n\t options.ids[0] = true;\n\t }\n\t }\n\n\t partial = env.VM.resolvePartial.call(this, partial, context, options);\n\t var result = env.VM.invokePartial.call(this, partial, context, options);\n\n\t if (result == null && env.compile) {\n\t options.partials[options.name] = env.compile(partial, templateSpec.compilerOptions, env);\n\t result = options.partials[options.name](context, options);\n\t }\n\t if (result != null) {\n\t if (options.indent) {\n\t var lines = result.split('\\n');\n\t for (var i = 0, l = lines.length; i < l; i++) {\n\t if (!lines[i] && i + 1 === l) {\n\t break;\n\t }\n\n\t lines[i] = options.indent + lines[i];\n\t }\n\t result = lines.join('\\n');\n\t }\n\t return result;\n\t } else {\n\t throw new _exception2['default']('The partial ' + options.name + ' could not be compiled when running in runtime-only mode');\n\t }\n\t }\n\n\t // Just add water\n\t var container = {\n\t strict: function strict(obj, name) {\n\t if (!(name in obj)) {\n\t throw new _exception2['default']('\"' + name + '\" not defined in ' + obj);\n\t }\n\t return obj[name];\n\t },\n\t lookup: function lookup(depths, name) {\n\t var len = depths.length;\n\t for (var i = 0; i < len; i++) {\n\t if (depths[i] && depths[i][name] != null) {\n\t return depths[i][name];\n\t }\n\t }\n\t },\n\t lambda: function lambda(current, context) {\n\t return typeof current === 'function' ? current.call(context) : current;\n\t },\n\n\t escapeExpression: Utils.escapeExpression,\n\t invokePartial: invokePartialWrapper,\n\n\t fn: function fn(i) {\n\t var ret = templateSpec[i];\n\t ret.decorator = templateSpec[i + '_d'];\n\t return ret;\n\t },\n\n\t programs: [],\n\t program: function program(i, data, declaredBlockParams, blockParams, depths) {\n\t var programWrapper = this.programs[i],\n\t fn = this.fn(i);\n\t if (data || depths || blockParams || declaredBlockParams) {\n\t programWrapper = wrapProgram(this, i, fn, data, declaredBlockParams, blockParams, depths);\n\t } else if (!programWrapper) {\n\t programWrapper = this.programs[i] = wrapProgram(this, i, fn);\n\t }\n\t return programWrapper;\n\t },\n\n\t data: function data(value, depth) {\n\t while (value && depth--) {\n\t value = value._parent;\n\t }\n\t return value;\n\t },\n\t merge: function merge(param, common) {\n\t var obj = param || common;\n\n\t if (param && common && param !== common) {\n\t obj = Utils.extend({}, common, param);\n\t }\n\n\t return obj;\n\t },\n\t // An empty object to use as replacement for null-contexts\n\t nullContext: _Object$seal({}),\n\n\t noop: env.VM.noop,\n\t compilerInfo: templateSpec.compiler\n\t };\n\n\t function ret(context) {\n\t var options = arguments.length <= 1 || arguments[1] === undefined ? {} : arguments[1];\n\n\t var data = options.data;\n\n\t ret._setup(options);\n\t if (!options.partial && templateSpec.useData) {\n\t data = initData(context, data);\n\t }\n\t var depths = undefined,\n\t blockParams = templateSpec.useBlockParams ? [] : undefined;\n\t if (templateSpec.useDepths) {\n\t if (options.depths) {\n\t depths = context != options.depths[0] ? [context].concat(options.depths) : options.depths;\n\t } else {\n\t depths = [context];\n\t }\n\t }\n\n\t function main(context /*, options*/) {\n\t return '' + templateSpec.main(container, context, container.helpers, container.partials, data, blockParams, depths);\n\t }\n\t main = executeDecorators(templateSpec.main, main, container, options.depths || [], data, blockParams);\n\t return main(context, options);\n\t }\n\t ret.isTop = true;\n\n\t ret._setup = function (options) {\n\t if (!options.partial) {\n\t container.helpers = container.merge(options.helpers, env.helpers);\n\n\t if (templateSpec.usePartial) {\n\t container.partials = container.merge(options.partials, env.partials);\n\t }\n\t if (templateSpec.usePartial || templateSpec.useDecorators) {\n\t container.decorators = container.merge(options.decorators, env.decorators);\n\t }\n\t } else {\n\t container.helpers = options.helpers;\n\t container.partials = options.partials;\n\t container.decorators = options.decorators;\n\t }\n\t };\n\n\t ret._child = function (i, data, blockParams, depths) {\n\t if (templateSpec.useBlockParams && !blockParams) {\n\t throw new _exception2['default']('must pass block params');\n\t }\n\t if (templateSpec.useDepths && !depths) {\n\t throw new _exception2['default']('must pass parent depths');\n\t }\n\n\t return wrapProgram(container, i, templateSpec[i], data, 0, blockParams, depths);\n\t };\n\t return ret;\n\t}\n\n\tfunction wrapProgram(container, i, fn, data, declaredBlockParams, blockParams, depths) {\n\t function prog(context) {\n\t var options = arguments.length <= 1 || arguments[1] === undefined ? {} : arguments[1];\n\n\t var currentDepths = depths;\n\t if (depths && context != depths[0] && !(context === container.nullContext && depths[0] === null)) {\n\t currentDepths = [context].concat(depths);\n\t }\n\n\t return fn(container, context, container.helpers, container.partials, options.data || data, blockParams && [options.blockParams].concat(blockParams), currentDepths);\n\t }\n\n\t prog = executeDecorators(fn, prog, container, depths, data, blockParams);\n\n\t prog.program = i;\n\t prog.depth = depths ? depths.length : 0;\n\t prog.blockParams = declaredBlockParams || 0;\n\t return prog;\n\t}\n\n\tfunction resolvePartial(partial, context, options) {\n\t if (!partial) {\n\t if (options.name === '@partial-block') {\n\t partial = options.data['partial-block'];\n\t } else {\n\t partial = options.partials[options.name];\n\t }\n\t } else if (!partial.call && !options.name) {\n\t // This is a dynamic partial that returned a string\n\t options.name = partial;\n\t partial = options.partials[partial];\n\t }\n\t return partial;\n\t}\n\n\tfunction invokePartial(partial, context, options) {\n\t // Use the current closure context to save the partial-block if this partial\n\t var currentPartialBlock = options.data && options.data['partial-block'];\n\t options.partial = true;\n\t if (options.ids) {\n\t options.data.contextPath = options.ids[0] || options.data.contextPath;\n\t }\n\n\t var partialBlock = undefined;\n\t if (options.fn && options.fn !== noop) {\n\t (function () {\n\t options.data = _base.createFrame(options.data);\n\t // Wrapper function to get access to currentPartialBlock from the closure\n\t var fn = options.fn;\n\t partialBlock = options.data['partial-block'] = function partialBlockWrapper(context) {\n\t var options = arguments.length <= 1 || arguments[1] === undefined ? {} : arguments[1];\n\n\t // Restore the partial-block from the closure for the execution of the block\n\t // i.e. the part inside the block of the partial call.\n\t options.data = _base.createFrame(options.data);\n\t options.data['partial-block'] = currentPartialBlock;\n\t return fn(context, options);\n\t };\n\t if (fn.partials) {\n\t options.partials = Utils.extend({}, options.partials, fn.partials);\n\t }\n\t })();\n\t }\n\n\t if (partial === undefined && partialBlock) {\n\t partial = partialBlock;\n\t }\n\n\t if (partial === undefined) {\n\t throw new _exception2['default']('The partial ' + options.name + ' could not be found');\n\t } else if (partial instanceof Function) {\n\t return partial(context, options);\n\t }\n\t}\n\n\tfunction noop() {\n\t return '';\n\t}\n\n\tfunction initData(context, data) {\n\t if (!data || !('root' in data)) {\n\t data = data ? _base.createFrame(data) : {};\n\t data.root = context;\n\t }\n\t return data;\n\t}\n\n\tfunction executeDecorators(fn, prog, container, depths, data, blockParams) {\n\t if (fn.decorator) {\n\t var props = {};\n\t prog = fn.decorator(prog, props, container, depths && depths[0], data, blockParams, depths);\n\t Utils.extend(prog, props);\n\t }\n\t return prog;\n\t}\n\n/***/ }),\n/* 22 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\tmodule.exports = { \"default\": __webpack_require__(23), __esModule: true };\n\n/***/ }),\n/* 23 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t__webpack_require__(24);\n\tmodule.exports = __webpack_require__(29).Object.seal;\n\n/***/ }),\n/* 24 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t// 19.1.2.17 Object.seal(O)\n\tvar isObject = __webpack_require__(25);\n\n\t__webpack_require__(26)('seal', function($seal){\n\t return function seal(it){\n\t return $seal && isObject(it) ? $seal(it) : it;\n\t };\n\t});\n\n/***/ }),\n/* 25 */\n/***/ (function(module, exports) {\n\n\tmodule.exports = function(it){\n\t return typeof it === 'object' ? it !== null : typeof it === 'function';\n\t};\n\n/***/ }),\n/* 26 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t// most Object methods by ES6 should accept primitives\n\tvar $export = __webpack_require__(27)\n\t , core = __webpack_require__(29)\n\t , fails = __webpack_require__(32);\n\tmodule.exports = function(KEY, exec){\n\t var fn = (core.Object || {})[KEY] || Object[KEY]\n\t , exp = {};\n\t exp[KEY] = exec(fn);\n\t $export($export.S + $export.F * fails(function(){ fn(1); }), 'Object', exp);\n\t};\n\n/***/ }),\n/* 27 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\tvar global = __webpack_require__(28)\n\t , core = __webpack_require__(29)\n\t , ctx = __webpack_require__(30)\n\t , PROTOTYPE = 'prototype';\n\n\tvar $export = function(type, name, source){\n\t var IS_FORCED = type & $export.F\n\t , IS_GLOBAL = type & $export.G\n\t , IS_STATIC = type & $export.S\n\t , IS_PROTO = type & $export.P\n\t , IS_BIND = type & $export.B\n\t , IS_WRAP = type & $export.W\n\t , exports = IS_GLOBAL ? core : core[name] || (core[name] = {})\n\t , target = IS_GLOBAL ? global : IS_STATIC ? global[name] : (global[name] || {})[PROTOTYPE]\n\t , key, own, out;\n\t if(IS_GLOBAL)source = name;\n\t for(key in source){\n\t // contains in native\n\t own = !IS_FORCED && target && key in target;\n\t if(own && key in exports)continue;\n\t // export native or passed\n\t out = own ? target[key] : source[key];\n\t // prevent global pollution for namespaces\n\t exports[key] = IS_GLOBAL && typeof target[key] != 'function' ? source[key]\n\t // bind timers to global for call from export context\n\t : IS_BIND && own ? ctx(out, global)\n\t // wrap global constructors for prevent change them in library\n\t : IS_WRAP && target[key] == out ? (function(C){\n\t var F = function(param){\n\t return this instanceof C ? new C(param) : C(param);\n\t };\n\t F[PROTOTYPE] = C[PROTOTYPE];\n\t return F;\n\t // make static versions for prototype methods\n\t })(out) : IS_PROTO && typeof out == 'function' ? ctx(Function.call, out) : out;\n\t if(IS_PROTO)(exports[PROTOTYPE] || (exports[PROTOTYPE] = {}))[key] = out;\n\t }\n\t};\n\t// type bitmap\n\t$export.F = 1; // forced\n\t$export.G = 2; // global\n\t$export.S = 4; // static\n\t$export.P = 8; // proto\n\t$export.B = 16; // bind\n\t$export.W = 32; // wrap\n\tmodule.exports = $export;\n\n/***/ }),\n/* 28 */\n/***/ (function(module, exports) {\n\n\t// https://github.com/zloirock/core-js/issues/86#issuecomment-115759028\n\tvar global = module.exports = typeof window != 'undefined' && window.Math == Math\n\t ? window : typeof self != 'undefined' && self.Math == Math ? self : Function('return this')();\n\tif(typeof __g == 'number')__g = global; // eslint-disable-line no-undef\n\n/***/ }),\n/* 29 */\n/***/ (function(module, exports) {\n\n\tvar core = module.exports = {version: '1.2.6'};\n\tif(typeof __e == 'number')__e = core; // eslint-disable-line no-undef\n\n/***/ }),\n/* 30 */\n/***/ (function(module, exports, __webpack_require__) {\n\n\t// optional / simple context binding\n\tvar aFunction = __webpack_require__(31);\n\tmodule.exports = function(fn, that, length){\n\t aFunction(fn);\n\t if(that === undefined)return fn;\n\t switch(length){\n\t case 1: return function(a){\n\t return fn.call(that, a);\n\t };\n\t case 2: return function(a, b){\n\t return fn.call(that, a, b);\n\t };\n\t case 3: return function(a, b, c){\n\t return fn.call(that, a, b, c);\n\t };\n\t }\n\t return function(/* ...args */){\n\t return fn.apply(that, arguments);\n\t };\n\t};\n\n/***/ }),\n/* 31 */\n/***/ (function(module, exports) {\n\n\tmodule.exports = function(it){\n\t if(typeof it != 'function')throw TypeError(it + ' is not a function!');\n\t return it;\n\t};\n\n/***/ }),\n/* 32 */\n/***/ (function(module, exports) {\n\n\tmodule.exports = function(exec){\n\t try {\n\t return !!exec();\n\t } catch(e){\n\t return true;\n\t }\n\t};\n\n/***/ }),\n/* 33 */\n/***/ (function(module, exports) {\n\n\t/* WEBPACK VAR INJECTION */(function(global) {/* global window */\n\t'use strict';\n\n\texports.__esModule = true;\n\n\texports['default'] = function (Handlebars) {\n\t /* istanbul ignore next */\n\t var root = typeof global !== 'undefined' ? global : window,\n\t $Handlebars = root.Handlebars;\n\t /* istanbul ignore next */\n\t Handlebars.noConflict = function () {\n\t if (root.Handlebars === Handlebars) {\n\t root.Handlebars = $Handlebars;\n\t }\n\t return Handlebars;\n\t };\n\t};\n\n\tmodule.exports = exports['default'];\n\t/* WEBPACK VAR INJECTION */}.call(exports, (function() { return this; }())))\n\n/***/ })\n/******/ ])\n});\n;\n", - "define('templates',['handlebars.runtime'], function(Handlebars) {\n Handlebars = Handlebars[\"default\"]; var template = Handlebars.template, templates = Handlebars.templates = Handlebars.templates || {};\ntemplates['permalinks.css'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n return \" section > *:hover > span.permalink { visibility: visible; }\\n\";\n},\"3\":function(container,depth0,helpers,partials,data) {\n return \" float: right;\\n\";\n},\"5\":function(container,depth0,helpers,partials,data) {\n return \" visibility: hidden;\\n\";\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, alias1=depth0 != null ? depth0 : (container.nullContext || {});\n\n return \"/* --- PERMALINKS --- */\\n\"\n + ((stack1 = helpers[\"if\"].call(alias1,(depth0 != null ? depth0.permalinkHide : depth0),{\"name\":\"if\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"\\n.permalink {\\n width: 1px;\\n height: 1px;\\n overflow: visible;\\n font-size: 10pt;\\n font-style: normal;\\n vertical-align: middle;\\n margin-left: 4px;\\n\"\n + ((stack1 = helpers[\"if\"].call(alias1,(depth0 != null ? depth0.permalinkEdge : depth0),{\"name\":\"if\",\"hash\":{},\"fn\":container.program(3, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + ((stack1 = helpers[\"if\"].call(alias1,(depth0 != null ? depth0.permalinkHide : depth0),{\"name\":\"if\",\"hash\":{},\"fn\":container.program(5, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"}\\n\\n.permalink a, .permalink a:link, .permalink a:visited, .permalink a:hover, .permalink a:focus, .permalink a:active {\\n background:transparent !important;\\n text-decoration:none;\\n font-weight: bold;\\n color:#666 !important;\\n}\\n\\n.permalink abbr {\\n border:0;\\n}\\n\";\n},\"useData\":true});\ntemplates['attribute.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return container.escapeExpression((helpers.escapeAttributeName || (depth0 && depth0.escapeAttributeName) || helpers.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1),{\"name\":\"escapeAttributeName\",\"hash\":{},\"data\":data}));\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=container.lambda, alias2=container.escapeExpression, alias3=depth0 != null ? depth0 : (container.nullContext || {}), alias4=helpers.helperMissing;\n\n return \"<span class='idlAttribute' id=\\\"\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"\\\" data-idl data-title='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0))\n + \"'>\"\n + alias2((helpers.extAttr || (depth0 && depth0.extAttr) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias2((helpers.idn || (depth0 && depth0.idn) || alias4).call(alias3,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + alias2(((helper = (helper = helpers.qualifiers || (depth0 != null ? depth0.qualifiers : depth0)) != null ? helper : alias4),(typeof helper === \"function\" ? helper.call(alias3,{\"name\":\"qualifiers\",\"hash\":{},\"data\":data}) : helper)))\n + \"attribute <span class='idlAttrType'>\"\n + alias2((helpers.idlType || (depth0 && depth0.idlType) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"idlType\",\"hash\":{},\"data\":data}))\n + \"</span> \"\n + alias2((helpers.pads || (depth0 && depth0.pads) || alias4).call(alias3,(depth0 != null ? depth0.pad : depth0),{\"name\":\"pads\",\"hash\":{},\"data\":data}))\n + \"<span class='idlAttrName'>\"\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span>;</span>\\n\";\n},\"useData\":true});\ntemplates['callback.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return container.escapeExpression(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0));\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=container.lambda, alias2=container.escapeExpression, alias3=depth0 != null ? depth0 : (container.nullContext || {}), alias4=helpers.helperMissing;\n\n return \"<span class='idlCallback' id='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"' data-idl data-title='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0))\n + \"'>\"\n + alias2((helpers.extAttr || (depth0 && depth0.extAttr) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias2((helpers.idn || (depth0 && depth0.idn) || alias4).call(alias3,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"callback <span class='idlCallbackID'>\"\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span> = <span class='idlCallbackType'>\"\n + alias2((helpers.idlType || (depth0 && depth0.idlType) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"idlType\",\"hash\":{},\"data\":data}))\n + \"</span> (\"\n + ((stack1 = ((helper = (helper = helpers.children || (depth0 != null ? depth0.children : depth0)) != null ? helper : alias4),(typeof helper === \"function\" ? helper.call(alias3,{\"name\":\"children\",\"hash\":{},\"data\":data}) : helper))) != null ? stack1 : \"\")\n + \");</span>\";\n},\"useData\":true});\ntemplates['const.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return container.escapeExpression(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0));\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=container.lambda, alias2=container.escapeExpression, alias3=depth0 != null ? depth0 : (container.nullContext || {}), alias4=helpers.helperMissing;\n\n return \"<span class='idlConst' id=\\\"\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"\\\" data-idl data-title='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0))\n + \"'>\"\n + alias2((helpers.extAttr || (depth0 && depth0.extAttr) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias2((helpers.idn || (depth0 && depth0.idn) || alias4).call(alias3,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"const <span class='idlConstType'>\"\n + alias2((helpers.idlType || (depth0 && depth0.idlType) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"idlType\",\"hash\":{},\"data\":data}))\n + \"</span>\"\n + alias2(((helper = (helper = helpers.nullable || (depth0 != null ? depth0.nullable : depth0)) != null ? helper : alias4),(typeof helper === \"function\" ? helper.call(alias3,{\"name\":\"nullable\",\"hash\":{},\"data\":data}) : helper)))\n + \" \"\n + alias2((helpers.pads || (depth0 && depth0.pads) || alias4).call(alias3,(depth0 != null ? depth0.pad : depth0),{\"name\":\"pads\",\"hash\":{},\"data\":data}))\n + \"<span class='idlConstName'>\"\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span> = <span class='idlConstValue'>\"\n + alias2((helpers.stringifyIdlConst || (depth0 && depth0.stringifyIdlConst) || alias4).call(alias3,((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.value : stack1),{\"name\":\"stringifyIdlConst\",\"hash\":{},\"data\":data}))\n + \"</span>;</span>\\n\";\n},\"useData\":true});\ntemplates['dict-member.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return container.escapeExpression(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0));\n},\"3\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return \" = <span class='idlMemberValue'>\"\n + container.escapeExpression((helpers.stringifyIdlConst || (depth0 && depth0.stringifyIdlConst) || helpers.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1[\"default\"] : stack1),{\"name\":\"stringifyIdlConst\",\"hash\":{},\"data\":data}))\n + \"</span>\";\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=container.lambda, alias2=container.escapeExpression, alias3=depth0 != null ? depth0 : (container.nullContext || {}), alias4=helpers.helperMissing;\n\n return \"<span class='idlMember' id=\\\"\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"\\\" data-idl data-title='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0))\n + \"'>\"\n + alias2((helpers.extAttr || (depth0 && depth0.extAttr) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias2((helpers.idn || (depth0 && depth0.idn) || alias4).call(alias3,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + alias2(((helper = (helper = helpers.qualifiers || (depth0 != null ? depth0.qualifiers : depth0)) != null ? helper : alias4),(typeof helper === \"function\" ? helper.call(alias3,{\"name\":\"qualifiers\",\"hash\":{},\"data\":data}) : helper)))\n + \"<span class='idlMemberType'>\"\n + alias2((helpers.idlType || (depth0 && depth0.idlType) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"idlType\",\"hash\":{},\"data\":data}))\n + \"</span> \"\n + alias2((helpers.pads || (depth0 && depth0.pads) || alias4).call(alias3,(depth0 != null ? depth0.typePad : depth0),{\"name\":\"pads\",\"hash\":{},\"data\":data}))\n + \"<span class='idlMemberName'>\"\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span>\"\n + ((stack1 = helpers[\"if\"].call(alias3,((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1[\"default\"] : stack1),{\"name\":\"if\",\"hash\":{},\"fn\":container.program(3, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \";</span>\\n\";\n},\"useData\":true});\ntemplates['dictionary.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return container.escapeExpression(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0));\n},\"3\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return \" : <span class='idlSuperclass'><a>\"\n + container.escapeExpression(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.inheritance : stack1), depth0))\n + \"</a></span>\";\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=container.lambda, alias2=container.escapeExpression, alias3=depth0 != null ? depth0 : (container.nullContext || {}), alias4=helpers.helperMissing, alias5=\"function\";\n\n return \"<span class='idlDictionary' id='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"' data-idl data-title='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0))\n + \"'>\"\n + alias2((helpers.extAttr || (depth0 && depth0.extAttr) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias2((helpers.idn || (depth0 && depth0.idn) || alias4).call(alias3,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + alias2(((helper = (helper = helpers.partial || (depth0 != null ? depth0.partial : depth0)) != null ? helper : alias4),(typeof helper === alias5 ? helper.call(alias3,{\"name\":\"partial\",\"hash\":{},\"data\":data}) : helper)))\n + \"dictionary <span class='idlDictionaryID'>\"\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span>\"\n + ((stack1 = helpers[\"if\"].call(alias3,((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.inheritance : stack1),{\"name\":\"if\",\"hash\":{},\"fn\":container.program(3, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \" {\\n\"\n + ((stack1 = ((helper = (helper = helpers.children || (depth0 != null ? depth0.children : depth0)) != null ? helper : alias4),(typeof helper === alias5 ? helper.call(alias3,{\"name\":\"children\",\"hash\":{},\"data\":data}) : helper))) != null ? stack1 : \"\")\n + \"};</span>\";\n},\"useData\":true});\ntemplates['enum-item.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n return \",\";\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), alias2=helpers.helperMissing, alias3=container.escapeExpression, alias4=\"function\";\n\n return alias3((helpers.idn || (depth0 && depth0.idn) || alias2).call(alias1,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"<a href=\\\"#dom-\"\n + alias3(((helper = (helper = helpers.parentID || (depth0 != null ? depth0.parentID : depth0)) != null ? helper : alias2),(typeof helper === alias4 ? helper.call(alias1,{\"name\":\"parentID\",\"hash\":{},\"data\":data}) : helper)))\n + \"-\"\n + alias3(((helper = (helper = helpers.lname || (depth0 != null ? depth0.lname : depth0)) != null ? helper : alias2),(typeof helper === alias4 ? helper.call(alias1,{\"name\":\"lname\",\"hash\":{},\"data\":data}) : helper)))\n + \"\\\" class=\\\"idlEnumItem\\\">\\\"\"\n + alias3(((helper = (helper = helpers.name || (depth0 != null ? depth0.name : depth0)) != null ? helper : alias2),(typeof helper === alias4 ? helper.call(alias1,{\"name\":\"name\",\"hash\":{},\"data\":data}) : helper)))\n + \"\\\"</a>\"\n + ((stack1 = helpers[\"if\"].call(alias1,(depth0 != null ? depth0.needsComma : depth0),{\"name\":\"if\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"\\n\";\n},\"useData\":true});\ntemplates['enum.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return container.escapeExpression(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0));\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=container.lambda, alias2=container.escapeExpression, alias3=depth0 != null ? depth0 : (container.nullContext || {}), alias4=helpers.helperMissing;\n\n return \"<span class='idlEnum' id='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"' data-idl data-title='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0))\n + \"'>\"\n + alias2((helpers.extAttr || (depth0 && depth0.extAttr) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias2((helpers.idn || (depth0 && depth0.idn) || alias4).call(alias3,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"enum <span class='idlEnumID'>\"\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span> {\\n\"\n + ((stack1 = ((helper = (helper = helpers.children || (depth0 != null ? depth0.children : depth0)) != null ? helper : alias4),(typeof helper === \"function\" ? helper.call(alias3,{\"name\":\"children\",\"hash\":{},\"data\":data}) : helper))) != null ? stack1 : \"\")\n + alias2((helpers.idn || (depth0 && depth0.idn) || alias4).call(alias3,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"};</span>\";\n},\"useData\":true});\ntemplates['extended-attribute.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), alias2=helpers.helperMissing, alias3=\"function\", alias4=container.escapeExpression;\n\n return \"<span class='\"\n + alias4(((helper = (helper = helpers.extAttrClassName || (depth0 != null ? depth0.extAttrClassName : depth0)) != null ? helper : alias2),(typeof helper === alias3 ? helper.call(alias1,{\"name\":\"extAttrClassName\",\"hash\":{},\"data\":data}) : helper)))\n + \"'><span class=\\\"extAttrName\\\">\"\n + alias4(((helper = (helper = helpers.name || (depth0 != null ? depth0.name : depth0)) != null ? helper : alias2),(typeof helper === alias3 ? helper.call(alias1,{\"name\":\"name\",\"hash\":{},\"data\":data}) : helper)))\n + \"</span>\"\n + ((stack1 = helpers[\"if\"].call(alias1,(depth0 != null ? depth0.rhs : depth0),{\"name\":\"if\",\"hash\":{},\"fn\":container.program(2, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + ((stack1 = (helpers.jsIf || (depth0 && depth0.jsIf) || alias2).call(alias1,(depth0 != null ? depth0.arguments : depth0),{\"name\":\"jsIf\",\"hash\":{},\"fn\":container.program(5, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span>\";\n},\"2\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return \"=<span class=\\\"extAttrRhs\\\">\"\n + ((stack1 = (helpers.extAttrRhs || (depth0 && depth0.extAttrRhs) || helpers.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),(depth0 != null ? depth0.rhs : depth0),{\"name\":\"extAttrRhs\",\"hash\":{},\"fn\":container.program(3, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span>\";\n},\"3\":function(container,depth0,helpers,partials,data) {\n return container.escapeExpression(container.lambda(depth0, depth0));\n},\"5\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return \"(\"\n + ((stack1 = (helpers.joinNonWhitespace || (depth0 && depth0.joinNonWhitespace) || helpers.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),(depth0 != null ? depth0.arguments : depth0),\", \",{\"name\":\"joinNonWhitespace\",\"hash\":{},\"fn\":container.program(6, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \")\";\n},\"6\":function(container,depth0,helpers,partials,data) {\n return container.escapeExpression((helpers.param || (depth0 && depth0.param) || helpers.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),depth0,{\"name\":\"param\",\"hash\":{},\"data\":data}));\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), alias2=helpers.helperMissing, alias3=container.escapeExpression;\n\n return alias3((helpers.idn || (depth0 && depth0.idn) || alias2).call(alias1,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"[\"\n + ((stack1 = (helpers.join || (depth0 && depth0.join) || alias2).call(alias1,(depth0 != null ? depth0.extAttrs : depth0),(depth0 != null ? depth0.sep : depth0),{\"name\":\"join\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"]\"\n + alias3(((helper = (helper = helpers.end || (depth0 != null ? depth0.end : depth0)) != null ? helper : alias2),(typeof helper === \"function\" ? helper.call(alias1,{\"name\":\"end\",\"hash\":{},\"data\":data}) : helper)));\n},\"useData\":true});\ntemplates['field.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return container.escapeExpression(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0));\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, alias1=container.lambda, alias2=container.escapeExpression, alias3=depth0 != null ? depth0 : (container.nullContext || {}), alias4=helpers.helperMissing;\n\n return \"<span class='idlField' id=\\\"\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"\\\" data-idl data-title='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0))\n + \"'>\"\n + alias2((helpers.extAttr || (depth0 && depth0.extAttr) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias2((helpers.idn || (depth0 && depth0.idn) || alias4).call(alias3,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"<span class='idlFieldType'>\"\n + alias2((helpers.idlType || (depth0 && depth0.idlType) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"idlType\",\"hash\":{},\"data\":data}))\n + \"</span> \"\n + alias2((helpers.pads || (depth0 && depth0.pads) || alias4).call(alias3,(depth0 != null ? depth0.pad : depth0),{\"name\":\"pads\",\"hash\":{},\"data\":data}))\n + \"<span class='idlFieldName'>\"\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span>;</span>\\n\";\n},\"useData\":true});\ntemplates['implements.html'] = template({\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, alias1=depth0 != null ? depth0 : (container.nullContext || {}), alias2=helpers.helperMissing, alias3=container.escapeExpression, alias4=container.lambda;\n\n return \"<span class='idlImplements'>\"\n + alias3((helpers.extAttr || (depth0 && depth0.extAttr) || alias2).call(alias1,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias3((helpers.idn || (depth0 && depth0.idn) || alias2).call(alias1,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"<a>\"\n + alias3(alias4(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.target : stack1), depth0))\n + \"</a> implements <a>\"\n + alias3(alias4(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1[\"implements\"] : stack1), depth0))\n + \"</a>;</span>\";\n},\"useData\":true});\ntemplates['includes.html'] = template({\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, alias1=depth0 != null ? depth0 : (container.nullContext || {}), alias2=helpers.helperMissing, alias3=container.escapeExpression, alias4=container.lambda;\n\n return \"<span class='idlIncludes'>\"\n + alias3((helpers.extAttr || (depth0 && depth0.extAttr) || alias2).call(alias1,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias3((helpers.idn || (depth0 && depth0.idn) || alias2).call(alias1,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"<a>\"\n + alias3(alias4(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.target : stack1), depth0))\n + \"</a> includes <a>\"\n + alias3(alias4(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.includes : stack1), depth0))\n + \"</a>;</span>\";\n},\"useData\":true});\ntemplates['interface.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return container.escapeExpression(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0));\n},\"3\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return \" : <span class='idlSuperclass'><a>\"\n + container.escapeExpression(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.inheritance : stack1), depth0))\n + \"</a></span>\";\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=container.lambda, alias2=container.escapeExpression, alias3=depth0 != null ? depth0 : (container.nullContext || {}), alias4=helpers.helperMissing, alias5=\"function\";\n\n return \"<span class='idlInterface' id='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"' data-idl data-title='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0))\n + \"'>\"\n + alias2((helpers.extAttr || (depth0 && depth0.extAttr) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias2((helpers.idn || (depth0 && depth0.idn) || alias4).call(alias3,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + alias2(((helper = (helper = helpers.partial || (depth0 != null ? depth0.partial : depth0)) != null ? helper : alias4),(typeof helper === alias5 ? helper.call(alias3,{\"name\":\"partial\",\"hash\":{},\"data\":data}) : helper)))\n + alias2(((helper = (helper = helpers.callback || (depth0 != null ? depth0.callback : depth0)) != null ? helper : alias4),(typeof helper === alias5 ? helper.call(alias3,{\"name\":\"callback\",\"hash\":{},\"data\":data}) : helper)))\n + \"interface \"\n + alias2(((helper = (helper = helpers.mixin || (depth0 != null ? depth0.mixin : depth0)) != null ? helper : alias4),(typeof helper === alias5 ? helper.call(alias3,{\"name\":\"mixin\",\"hash\":{},\"data\":data}) : helper)))\n + \"<span class='idlInterfaceID'>\"\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span>\"\n + ((stack1 = helpers[\"if\"].call(alias3,((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.inheritance : stack1),{\"name\":\"if\",\"hash\":{},\"fn\":container.program(3, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \" {\\n\"\n + ((stack1 = ((helper = (helper = helpers.children || (depth0 != null ? depth0.children : depth0)) != null ? helper : alias4),(typeof helper === alias5 ? helper.call(alias3,{\"name\":\"children\",\"hash\":{},\"data\":data}) : helper))) != null ? stack1 : \"\")\n + alias2((helpers.idn || (depth0 && depth0.idn) || alias4).call(alias3,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"};</span>\";\n},\"useData\":true});\ntemplates['iterable.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n return \"iterable\";\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=container.escapeExpression, alias2=depth0 != null ? depth0 : (container.nullContext || {}), alias3=helpers.helperMissing;\n\n return \"<span class='idlIterable' id=\\\"\"\n + alias1(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"\\\" data-idl data-title='iterable'>\"\n + alias1((helpers.extAttr || (depth0 && depth0.extAttr) || alias3).call(alias2,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias1((helpers.idn || (depth0 && depth0.idn) || alias3).call(alias2,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + alias1(((helper = (helper = helpers.qualifiers || (depth0 != null ? depth0.qualifiers : depth0)) != null ? helper : alias3),(typeof helper === \"function\" ? helper.call(alias2,{\"name\":\"qualifiers\",\"hash\":{},\"data\":data}) : helper)))\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias3).call(alias2,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"<\"\n + alias1((helpers.idlType || (depth0 && depth0.idlType) || alias3).call(alias2,(depth0 != null ? depth0.obj : depth0),{\"name\":\"idlType\",\"hash\":{},\"data\":data}))\n + \">;</span>\\n\";\n},\"useData\":true});\ntemplates['line-comment.html'] = template({\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), alias2=helpers.helperMissing, alias3=container.escapeExpression;\n\n return \"<span class='idlSectionComment'>\"\n + alias3((helpers.idn || (depth0 && depth0.idn) || alias2).call(alias1,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"//\"\n + alias3(((helper = (helper = helpers.comment || (depth0 != null ? depth0.comment : depth0)) != null ? helper : alias2),(typeof helper === \"function\" ? helper.call(alias1,{\"name\":\"comment\",\"hash\":{},\"data\":data}) : helper)))\n + \"</span>\\n\";\n},\"useData\":true});\ntemplates['maplike.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n return \"maplike\";\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=container.escapeExpression, alias2=depth0 != null ? depth0 : (container.nullContext || {}), alias3=helpers.helperMissing;\n\n return \"<span class='idlMaplike' id=\\\"\"\n + alias1(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"\\\" data-idl data-title='maplike'>\"\n + alias1((helpers.extAttr || (depth0 && depth0.extAttr) || alias3).call(alias2,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttr\",\"hash\":{},\"data\":data}))\n + alias1((helpers.idn || (depth0 && depth0.idn) || alias3).call(alias2,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + alias1(((helper = (helper = helpers.qualifiers || (depth0 != null ? depth0.qualifiers : depth0)) != null ? helper : alias3),(typeof helper === \"function\" ? helper.call(alias2,{\"name\":\"qualifiers\",\"hash\":{},\"data\":data}) : helper)))\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias3).call(alias2,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"<\"\n + alias1((helpers.idlType || (depth0 && depth0.idlType) || alias3).call(alias2,(depth0 != null ? depth0.obj : depth0),{\"name\":\"idlType\",\"hash\":{},\"data\":data}))\n + \">;</span>\\n\";\n},\"useData\":true});\ntemplates['method.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return container.escapeExpression(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0));\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=container.lambda, alias2=container.escapeExpression, alias3=depth0 != null ? depth0 : (container.nullContext || {}), alias4=helpers.helperMissing, alias5=\"function\";\n\n return \"<span class='idlMethod' id=\\\"\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"\\\" data-idl data-title='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0))\n + \"'>\"\n + alias2((helpers.idn || (depth0 && depth0.idn) || alias4).call(alias3,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + alias2((helpers.extAttrInline || (depth0 && depth0.extAttrInline) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),(depth0 != null ? depth0.indent : depth0),{\"name\":\"extAttrInline\",\"hash\":{},\"data\":data}))\n + alias2(((helper = (helper = helpers.special || (depth0 != null ? depth0.special : depth0)) != null ? helper : alias4),(typeof helper === alias5 ? helper.call(alias3,{\"name\":\"special\",\"hash\":{},\"data\":data}) : helper)))\n + \"<span class='idlMethType'>\"\n + alias2((helpers.idlType || (depth0 && depth0.idlType) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"idlType\",\"hash\":{},\"data\":data}))\n + \"</span> \"\n + alias2((helpers.pads || (depth0 && depth0.pads) || alias4).call(alias3,(depth0 != null ? depth0.pad : depth0),{\"name\":\"pads\",\"hash\":{},\"data\":data}))\n + \"<span class='idlMethName'>\"\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span>(\"\n + ((stack1 = ((helper = (helper = helpers.children || (depth0 != null ? depth0.children : depth0)) != null ? helper : alias4),(typeof helper === alias5 ? helper.call(alias3,{\"name\":\"children\",\"hash\":{},\"data\":data}) : helper))) != null ? stack1 : \"\")\n + \");</span>\\n\";\n},\"useData\":true});\ntemplates['multiline-comment.html'] = template({\"1\":function(container,depth0,helpers,partials,data,blockParams,depths) {\n var alias1=container.escapeExpression;\n\n return alias1((helpers.idn || (depth0 && depth0.idn) || helpers.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),(depths[1] != null ? depths[1].indent : depths[1]),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + alias1(container.lambda(depth0, depth0))\n + \"\\n\";\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data,blockParams,depths) {\n var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), alias2=helpers.helperMissing, alias3=container.escapeExpression, alias4=\"function\";\n\n return \"<span class='idlSectionComment'>\"\n + alias3((helpers.idn || (depth0 && depth0.idn) || alias2).call(alias1,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + \"/*\"\n + alias3(((helper = (helper = helpers.firstLine || (depth0 != null ? depth0.firstLine : depth0)) != null ? helper : alias2),(typeof helper === alias4 ? helper.call(alias1,{\"name\":\"firstLine\",\"hash\":{},\"data\":data}) : helper)))\n + \"\\n\"\n + ((stack1 = helpers.each.call(alias1,(depth0 != null ? depth0.innerLine : depth0),{\"name\":\"each\",\"hash\":{},\"fn\":container.program(1, data, 0, blockParams, depths),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + alias3((helpers.idn || (depth0 && depth0.idn) || alias2).call(alias1,(depth0 != null ? depth0.indent : depth0),{\"name\":\"idn\",\"hash\":{},\"data\":data}))\n + alias3(((helper = (helper = helpers.lastLine || (depth0 != null ? depth0.lastLine : depth0)) != null ? helper : alias2),(typeof helper === alias4 ? helper.call(alias1,{\"name\":\"lastLine\",\"hash\":{},\"data\":data}) : helper)))\n + \"*/</span>\\n\";\n},\"useData\":true,\"useDepths\":true});\ntemplates['param.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return \" = <span class='idlDefaultValue'>\"\n + container.escapeExpression((helpers.stringifyIdlConst || (depth0 && depth0.stringifyIdlConst) || helpers.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1[\"default\"] : stack1),{\"name\":\"stringifyIdlConst\",\"hash\":{},\"data\":data}))\n + \"</span>\";\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), alias2=helpers.helperMissing, alias3=container.escapeExpression, alias4=\"function\";\n\n return \"<span class='idlParam'>\"\n + alias3((helpers.extAttrInline || (depth0 && depth0.extAttrInline) || alias2).call(alias1,(depth0 != null ? depth0.obj : depth0),{\"name\":\"extAttrInline\",\"hash\":{},\"data\":data}))\n + alias3(((helper = (helper = helpers.optional || (depth0 != null ? depth0.optional : depth0)) != null ? helper : alias2),(typeof helper === alias4 ? helper.call(alias1,{\"name\":\"optional\",\"hash\":{},\"data\":data}) : helper)))\n + \"<span class='idlParamType'>\"\n + alias3((helpers.idlType || (depth0 && depth0.idlType) || alias2).call(alias1,(depth0 != null ? depth0.obj : depth0),{\"name\":\"idlType\",\"hash\":{},\"data\":data}))\n + alias3(((helper = (helper = helpers.variadic || (depth0 != null ? depth0.variadic : depth0)) != null ? helper : alias2),(typeof helper === alias4 ? helper.call(alias1,{\"name\":\"variadic\",\"hash\":{},\"data\":data}) : helper)))\n + \"</span> <span class='idlParamName'>\"\n + alias3(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0))\n + \"</span>\"\n + ((stack1 = helpers[\"if\"].call(alias1,((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1[\"default\"] : stack1),{\"name\":\"if\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span>\";\n},\"useData\":true});\ntemplates['typedef.html'] = template({\"1\":function(container,depth0,helpers,partials,data) {\n var stack1;\n\n return container.escapeExpression(container.lambda(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0));\n},\"compiler\":[7,\">= 4.0.0\"],\"main\":function(container,depth0,helpers,partials,data) {\n var stack1, alias1=container.lambda, alias2=container.escapeExpression, alias3=depth0 != null ? depth0 : (container.nullContext || {}), alias4=helpers.helperMissing;\n\n return \"<span class='idlTypedef' id='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.idlId : stack1), depth0))\n + \"' data-idl data-title='\"\n + alias2(alias1(((stack1 = (depth0 != null ? depth0.obj : depth0)) != null ? stack1.name : stack1), depth0))\n + \"'>typedef <span class='idlTypedefType'>\"\n + alias2((helpers.idlType || (depth0 && depth0.idlType) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"idlType\",\"hash\":{},\"data\":data}))\n + \"</span> <span class='idlTypedefID'>\"\n + ((stack1 = (helpers.tryLink || (depth0 && depth0.tryLink) || alias4).call(alias3,(depth0 != null ? depth0.obj : depth0),{\"name\":\"tryLink\",\"hash\":{},\"fn\":container.program(1, data, 0),\"inverse\":container.noop,\"data\":data})) != null ? stack1 : \"\")\n + \"</span>;</span>\";\n},\"useData\":true});\nreturn templates;\n});\n", - "define('w3c/templates/cgbg-sotd',[\"exports\", \"deps/hyperhtml\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n\n exports.default = conf => {\n const html = hyperHTML;\n return html`<h2>${conf.l10n.sotd}</h2>\n${conf.isPreview ? html`\n <details class=\"annoying-warning\" open=\"\">\n <summary>This is a preview</summary>\n <p>\n Do not attempt to implement this version of the specification. Do not reference this\n version as authoritative in any way.\n ${conf.edDraftURI ? html`\n Instead, see <a href=\"${conf.edDraftURI}\">${conf.edDraftURI}</a> for the Editor's draft.\n ` : \"\"}\n </p>\n </details>\n` : \"\"}\n<p>\n This specification was published by the <a href='${conf.wgURI}'>${conf.wg}</a>.\n It is not a W3C Standard nor is it on the W3C Standards Track.\n ${conf.isCGFinal ? html`\n Please note that under the\n <a href=\"https://www.w3.org/community/about/agreements/final/\">W3C Community Final Specification Agreement (FSA)</a>\n other conditions apply.\n ` : html`\n Please note that under the\n <a href=\"https://www.w3.org/community/about/agreements/cla/\">W3C Community Contributor License Agreement (CLA)</a>\n there is a limited opt-out and other conditions apply.\n `}\n Learn more about\n <a href=\"https://www.w3.org/community/\">W3C Community and Business Groups</a>.\n</p>\n${!conf.sotdAfterWGinfo ? [conf.additionalContent] : \"\"}\n ${conf.wgPublicList ? html`\n <p>If you wish to make comments regarding this document, please send them to\n <a href='${`mailto:${conf.wgPublicList}@w3.org${conf.subjectPrefix ? `?subject=${conf.subjectPrefixEnc}` : \"\"}`}'>${conf.wgPublicList}@w3.org</a>\n (<a href='${`mailto:${conf.wgPublicList}-request@w3.org?subject=subscribe`}'>subscribe</a>,\n <a\n href='${`https://lists.w3.org/Archives/Public/${conf.wgPublicList}/`}'>archives</a>)${conf.subjectPrefix ? html`\n with <code>${conf.subjectPrefix}</code> at the start of your\n email's subject` : \"\"}.</p>\n ` : \"\"}\n${conf.sotdAfterWGinfo ? [conf.additionalContent] : \"\"}\n${[conf.additionalSections]}`;\n };\n});\n//# sourceMappingURL=cgbg-sotd.js.map;\n", - "define('w3c/templates/sotd',[\"exports\", \"deps/hyperhtml\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n\n exports.default = conf => {\n const html = hyperHTML;\n return html`<h2>${conf.l10n.sotd}</h2>\n${conf.isPreview ? html`\n <details class=\"annoying-warning\" open=\"\">\n <summary>This is a preview</summary>\n <p>\n Do not attempt to implement this version of the specification. Do not reference this\n version as authoritative in any way.\n ${conf.edDraftURI ? html`\n Instead, see <a href=\"${conf.edDraftURI}\">${conf.edDraftURI}</a> for the Editor's draft.\n ` : \"\"}\n </p>\n </details>\n` : \"\"}\n${conf.isUnofficial ? html`\n <p>\n This document is draft of a potential specification. It has no official standing of\n any kind and does not represent the support or consensus of any standards organisation.\n </p>\n ${[conf.additionalContent]}\n` : html`\n ${conf.isTagFinding ? [conf.additionalContent] : html`\n ${conf.isNoTrack ? html`\n <p>\n This document is merely a W3C-internal ${conf.isMO ? \"member-confidential\" : \"\"} document. It\n has no official standing of any kind and does not represent consensus of the W3C\n Membership.\n </p>\n ${[conf.additionalContent]}\n ` : html`\n <p>\n <em>${[conf.l10n.status_at_publication]}</em>\n </p>\n ${conf.isSubmission ? html`\n ${[conf.additionalContent]}\n ${conf.isMemberSubmission ? html`\n <p>\n By publishing this document, W3C acknowledges that the <a href=\"${conf.thisVersion}\">Submitting Members</a>\n have made a formal Submission request to W3C for discussion. Publication of this document\n by W3C indicates no endorsement of its content by W3C, nor that W3C has, is, or will be\n allocating any resources to the issues addressed by it. This document is not the product\n of a chartered W3C group, but is published as potential input to\n the <a href=\"https://www.w3.org/Consortium/Process\">W3C Process</a>.\n A <a href=\"${`https://www.w3.org/Submission/${conf.publishDate.getUTCFullYear()}/${conf.submissionCommentNumber}/Comment/`}\">W3C Team Comment</a> has been\n published in conjunction with this Member Submission. Publication of acknowledged Member Submissions\n at the W3C site is one of the benefits of <a href=\"https://www.w3.org/Consortium/Prospectus/Joining\">\n W3C Membership</a>. Please consult the requirements associated with Member Submissions of\n <a href=\"https://www.w3.org/Consortium/Patent-Policy/#sec-submissions\">section 3.3 of the\n W3C Patent Policy</a>. Please consult the complete <a href=\"https://www.w3.org/Submission\">list\n of acknowledged W3C Member Submissions</a>.\n </p>\n ` : html`\n ${conf.isTeamSubmission ? html`\n <p>If you wish to make comments regarding this document, please send them to\n <a href='${`mailto:${conf.wgPublicList}@w3.org${conf.subjectPrefix ? `?subject=${conf.subjectPrefixEnc}` : [\"\"]}`}'>${conf.wgPublicList}@w3.org</a>\n (<a href='${`mailto:${conf.wgPublicList}-request@w3.org?subject=subscribe`}'>subscribe</a>,\n <a\n href='${`https://lists.w3.org/Archives/Public/${conf.wgPublicList}/`}'>archives</a>)${conf.subjectPrefix ? html`\n with <code>${conf.subjectPrefix}</code> at the start of your email's subject` : \"\"}.</p>\n <p>Please consult the complete <a href=\"https://www.w3.org/TeamSubmission/\">list of Team Submissions</a>.</p>\n ` : \"\"}\n `}\n ` : html`\n ${!conf.sotdAfterWGinfo ? [conf.additionalContent] : \"\"}\n ${!conf.overrideStatus ? html`\n <p>\n This document was published by ${[conf.wgHTML]} as ${conf.anOrA} ${conf.longStatus}.\n ${conf.notYetRec ? \"This document is intended to become a W3C Recommendation.\" : \"\"}\n ${conf.wgPublicList ? html`\n Comments regarding this document are welcome. Please send them to\n <a href='${`mailto:${conf.wgPublicList}@w3.org${conf.subjectPrefix ? `?subject=${conf.subjectPrefixEnc}` : [\"\"]}`}'>${conf.wgPublicList}@w3.org</a>\n (<a href='${`mailto:${conf.wgPublicList}-request@w3.org?subject=subscribe`}'>subscribe</a>,\n <a\n href='${`https://lists.w3.org/Archives/Public/${conf.wgPublicList}/`}'>archives</a>)${conf.subjectPrefix ? html`\n with <code>${conf.subjectPrefix}</code> at the start of your email's subject` : \"\"}.\n ` : \"\"}\n ${conf.isCR ? `\n W3C publishes a Candidate Recommendation to indicate that the document is believed to be\n stable and to encourage implementation by the developer community. This Candidate\n Recommendation is expected to advance to Proposed Recommendation no earlier than\n ${conf.humanCREnd}.\n ` : \"\"}\n ${conf.isPER ? html`\n W3C Advisory Committee Members are invited to\n send formal review comments on this Proposed\n Edited Recommendation to the W3C Team until\n ${conf.humanPEREnd}.\n Members of the Advisory Committee will find the\n appropriate review form for this document by\n consulting their list of current\n <a href='https://www.w3.org/2002/09/wbs/myQuestionnaires'>WBS questionnaires</a>.\n ` : \"\"}\n ${conf.isPR ? html`\n The W3C Membership and other interested parties are invited to review the document and\n send comments to\n <a rel='discussion' href='${`mailto:${conf.wgPublicList}@w3.org`}'>${conf.wgPublicList}@w3.org</a>\n (<a href='${`mailto:${conf.wgPublicList}-request@w3.org?subject=subscribe`}'>subscribe</a>,\n <a href='${`https://lists.w3.org/Archives/Public/${conf.wgPublicList}/`}'>archives</a>)\n through ${conf.humanPREnd}. Advisory Committee Representatives should consult their\n <a href='https://www.w3.org/2002/09/wbs/myQuestionnaires'>WBS questionnaires</a>.\n Note that substantive technical comments were expected during the Candidate Recommendation\n review period that ended ${conf.humanCREnd}.\n ` : \"\"}\n </p>\n ` : \"\"}\n ${conf.implementationReportURI ? html`\n <p>\n Please see the Working Group's <a href='${conf.implementationReportURI}'>implementation\n report</a>.\n </p>\n ` : \"\"}\n ${conf.sotdAfterWGinfo ? [conf.additionalContent] : \"\"}\n ${conf.notRec ? html`\n <p>\n Publication as ${conf.anOrA} ${conf.textStatus} does not imply endorsement by the W3C\n Membership. This is a draft document and may be updated, replaced or obsoleted by other\n documents at any time. It is inappropriate to cite this document as other than work in\n progress.\n </p>\n ` : \"\"}\n ${conf.isRec ? html`\n <p>\n This document has been reviewed by W3C Members, by software developers, and by other W3C\n groups and interested parties, and is endorsed by the Director as a W3C Recommendation.\n It is a stable document and may be used as reference material or cited from another\n document. W3C's role in making the Recommendation is to draw attention to the\n specification and to promote its widespread deployment. This enhances the functionality\n and interoperability of the Web.\n </p>\n ` : \"\"}\n <p data-deliverer=\"${conf.isNote ? conf.wgId : null}\">\n ${!conf.isIGNote ? html`\n This document was produced by\n ${conf.multipleWGs ? \"groups\" : \"a group\"}\n operating under the\n <a href='https://www.w3.org/Consortium/Patent-Policy/'>W3C Patent Policy</a>.\n ` : \"\"}\n ${conf.recNotExpected ? \"The group does not expect this document to become a W3C Recommendation.\" : \"\"}\n ${!conf.isIGNote ? html`\n ${conf.multipleWGs ? html`W3C maintains ${[conf.wgPatentHTML]}` : html`\n W3C maintains a <a href='${[conf.wgPatentURI]}' rel='disclosure'>public list of any patent\n disclosures</a>\n `}\n made in connection with the deliverables of\n ${conf.multipleWGs ? \"each group; these pages also include\" : \"the group; that page also includes\"}\n instructions for disclosing a patent. An individual who has actual knowledge of a patent\n which the individual believes contains\n <a href='https://www.w3.org/Consortium/Patent-Policy/#def-essential'>Essential\n Claim(s)</a> must disclose the information in accordance with\n <a href='https://www.w3.org/Consortium/Patent-Policy/#sec-Disclosure'>section\n 6 of the W3C Patent Policy</a>.\n ` : \"\"}\n ${conf.isIGNote ? html`\n The disclosure obligations of the Participants of this group are described in the\n <a href='${conf.charterDisclosureURI}'>charter</a>.\n ` : \"\"}\n </p>\n <p>This document is governed by the <a id=\"w3c_process_revision\"\n href=\"https://www.w3.org/2018/Process-20180201/\">1 February 2018 W3C Process Document</a>.\n </p>\n ${conf.addPatentNote ? html`<p>${[conf.addPatentNote]}</p>` : \"\"}\n `}\n `}\n `}\n`}\n${[conf.additionalSections]}`;\n };\n});\n//# sourceMappingURL=sotd.js.map;\n", - "define('w3c/templates/show-logo',[\"exports\", \"core/pubsubhub\", \"deps/hyperhtml\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n\n exports.default = obj => {\n const a = document.createElement(\"a\");\n if (!obj.alt) {\n const msg = \"Found spec logo without an `alt` attribute. See dev console.\";\n a.classList.add(\"respec-offending-element\");\n (0, _pubsubhub.pub)(\"warn\", msg);\n console.warn(\"warn\", msg, a);\n }\n a.href = obj.url || \"\";\n a.classList.add(\"logo\");\n hyperHTML.bind(a)`\n <img\n id=\"${obj.id}\"\n alt=\"${obj.alt}\"\n width=\"${obj.width}\"\n height=\"${obj.height}\">\n `;\n // avoid triggering 404 requests from dynamically generated\n // hyperHTML attribute values\n a.querySelector(\"img\").src = obj.src;\n return a;\n };\n});\n//# sourceMappingURL=show-logo.js.map;\n", - "define('w3c/templates/show-people',[\"exports\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n\n exports.default = (conf, name, items = []) => {\n const html = hyperHTML;\n const results = [];\n for (let i = 0; i < items.length; i++) {\n results.push(getItem(items[i], i));\n }\n return results;\n\n function getItem(p, i) {\n const personName = [p.name]; // treated as opt-in HTML by hyperHTML\n const editorid = p.w3cid ? parseInt(p.w3cid, 10) : null;\n const dd = html`<dd class='p-author h-card vcard'\n data-editor-id='${editorid}'></dd>`;\n const span = document.createDocumentFragment();\n const contents = [];\n if (p.mailto) {\n contents.push(html`<a class='ed_mailto u-email email p-name'\n href='${`mailto:${p.mailto}`}'>${personName}</a>`);\n } else if (p.url) {\n contents.push(html`<a class='u-url url p-name fn'\n href='${p.url}'>${personName}</a>`);\n } else {\n contents.push(html`<span class='p-name fn'>${personName}</span>`);\n }\n if (p.company) {\n if (p.companyURL) {\n contents.push(html` (<a class='p-org org h-org h-card' href='${p.companyURL}'>${p.company}</a>)`);\n } else {\n contents.push(html` (${p.company})`);\n }\n }\n if (p.note) contents.push(document.createTextNode(` (${p.note})`));\n if (p.extras) {\n const results = p.extras\n // Remove empty names\n .filter(extra => extra.name && extra.name.trim())\n // Convert to HTML\n .map(getExtra);\n for (const result of results) {\n contents.push(document.createTextNode(\", \"), result);\n }\n }\n hyperHTML.bind(span)`${contents}`;\n dd.appendChild(span);\n return dd;\n }\n\n function getExtra(extra) {\n const span = html`<span class='${extra.class || null}'></span>`;\n let textContainer = span;\n if (extra.href) {\n textContainer = html`<a href='${extra.href}'></a>`;\n span.appendChild(textContainer);\n }\n textContainer.textContent = extra.name;\n return span;\n }\n };\n});\n//# sourceMappingURL=show-people.js.map;\n", - "define('w3c/templates/show-link',[\"exports\", \"core/pubsubhub\", \"deps/hyperhtml\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n\n const html = hyperHTML;\n\n exports.default = link => {\n if (!link.key) {\n const msg = \"Found a link without `key` attribute in the configuration. See dev console.\";\n (0, _pubsubhub.pub)(\"warn\", msg);\n console.warn(\"warn\", msg, link);\n return;\n }\n return html`\n <dt class=\"${link.class ? link.class : null}\">${link.key}:</dt>\n ${link.data ? link.data.map(showLinkData) : showLinkData(link)}\n `;\n };\n\n function showLinkData(data) {\n return html`\n <dd class=\"${data.class ? data.class : null}\">\n ${data.href ? html`\n <a href=\"${data.href}\">${data.value || data.href}</a>\n ` : \"\"}\n </dd>\n `;\n }\n});\n//# sourceMappingURL=show-link.js.map;\n", - "define('w3c/templates/cgbg-headers',[\"exports\", \"./show-logo\", \"./show-people\", \"./show-link\", \"deps/hyperhtml\"], function (exports, _showLogo, _showPeople, _showLink) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n\n var _showLogo2 = _interopRequireDefault(_showLogo);\n\n var _showPeople2 = _interopRequireDefault(_showPeople);\n\n var _showLink2 = _interopRequireDefault(_showLink);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n exports.default = conf => {\n const html = hyperHTML;\n return html`<div class='head'>\n ${conf.logos.map(_showLogo2.default)}\n <h1 class='title p-name' id='title'>${conf.title}</h1>\n ${conf.subtitle ? html`\n <h2 id='subtitle'>${conf.subtitle}</h2>\n ` : \"\"}\n <h2>${conf.longStatus} <time class='dt-published' datetime='${conf.dashDate}'>${conf.publishHumanDate}</time></h2>\n <dl>\n ${conf.thisVersion ? html`\n <dt>${conf.l10n.this_version}</dt>\n <dd><a class='u-url' href='${conf.thisVersion}'>${conf.thisVersion}</a></dd>\n ` : \"\"}\n ${conf.latestVersion ? html`\n <dt>${conf.l10n.latest_published_version}</dt>\n <dd><a href='${conf.latestVersion}'>${conf.latestVersion}</a></dd>\n ` : \"\"}\n ${conf.edDraftURI ? html`\n <dt>${conf.l10n.latest_editors_draft}</dt>\n <dd><a href='${conf.edDraftURI}'>${conf.edDraftURI}</a></dd>\n ` : \"\"}\n ${conf.testSuiteURI ? html`\n <dt>Test suite:</dt>\n <dd><a href='${conf.testSuiteURI}'>${conf.testSuiteURI}</a></dd>\n ` : \"\"}\n ${conf.implementationReportURI ? html`\n <dt>Implementation report:</dt>\n <dd><a href='${conf.implementationReportURI}'>${conf.implementationReportURI}</a></dd>\n ` : \"\"}\n ${conf.bugTrackerHTML ? html`\n <dt>${conf.l10n.bug_tracker}</dt>\n <dd>${[conf.bugTrackerHTML]}</dd>\n ` : \"\"}\n ${conf.prevVersion ? html`\n <dt>Previous version:</dt>\n <dd><a href='${conf.prevVersion}'>${conf.prevVersion}</a></dd>\n ` : \"\"}\n ${!conf.isCGFinal ? html`\n ${conf.prevED ? html`\n <dt>Previous editor's draft:</dt>\n <dd><a href='${conf.prevED}'>${conf.prevED}</a></dd>\n ` : \"\"}\n ` : \"\"}\n <dt>${conf.multipleEditors ? conf.l10n.editors : conf.l10n.editor}</dt>\n ${(0, _showPeople2.default)(conf, \"Editor\", conf.editors)}\n ${Array.isArray(conf.formerEditors) && conf.formerEditors.length > 0 ? html`\n <dt>${conf.multipleFormerEditors ? conf.l10n.former_editors : conf.l10n.former_editor}</dt>\n ${(0, _showPeople2.default)(conf, \"Editor\", conf.formerEditors)}\n ` : \"\"}\n ${conf.authors ? html`\n <dt>${conf.multipleAuthors ? conf.l10n.authors : conf.l10n.author}</dt>\n ${(0, _showPeople2.default)(conf, \"Author\", conf.authors)}\n ` : \"\"}\n ${conf.otherLinks ? conf.otherLinks.map(_showLink2.default) : \"\"}\n </dl>\n ${conf.alternateFormats ? html`\n <p>\n ${conf.multipleAlternates ? \"This document is also available in these non-normative formats:\" : \"This document is also available in this non-normative format:\"}\n ${[conf.alternatesHTML]}\n </p>\n ` : \"\"}\n <p class='copyright'>\n <a href='https://www.w3.org/Consortium/Legal/ipr-notice#Copyright'>Copyright</a> ©\n ${conf.copyrightStart ? `${conf.copyrightStart}-` : \"\"}${conf.publishYear}\n the Contributors to the ${conf.title} Specification, published by the\n <a href='${conf.wgURI}'>${conf.wg}</a> under the\n ${conf.isCGFinal ? html`\n <a href=\"https://www.w3.org/community/about/agreements/fsa/\">W3C Community Final Specification Agreement (FSA)</a>. \n A human-readable <a href=\"https://www.w3.org/community/about/agreements/fsa-deed/\">summary</a> is available.\n ` : html`\n <a href=\"https://www.w3.org/community/about/agreements/cla/\">W3C Community Contributor License Agreement (CLA)</a>.\n A human-readable <a href=\"https://www.w3.org/community/about/agreements/cla-deed/\">summary</a> is available.\n `}\n </p>\n <hr title=\"Separator for header\">\n</div>`;\n };\n});\n//# sourceMappingURL=cgbg-headers.js.map;\n", - "define('oai/templates/show-logo',[\"exports\", \"core/pubsubhub\", \"deps/hyperhtml\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n\n exports.default = obj => {\n const a = document.createElement(\"a\");\n if (!obj.alt) {\n const msg = \"Found spec logo without an `alt` attribute. See dev console.\";\n a.classList.add(\"respec-offending-element\");\n (0, _pubsubhub.pub)(\"warn\", msg);\n console.warn(\"warn\", msg, a);\n }\n a.href = obj.url || \"\";\n a.classList.add(\"logo\");\n hyperHTML.bind(a)`\n <img\n id=\"${obj.id}\"\n alt=\"${obj.alt}\"\n width=\"${obj.width}\"\n height=\"${obj.height}\">\n `;\n // avoid triggering 404 requests from dynamically generated\n // hyperHTML attribute values\n a.querySelector(\"img\").src = obj.src;\n return a;\n };\n});\n//# sourceMappingURL=show-logo.js.map;\n", - "define('oai/templates/show-people',[\"exports\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n\n exports.default = (conf, name, items = []) => {\n const html = hyperHTML;\n const results = [];\n for (let i = 0; i < items.length; i++) {\n results.push(getItem(items[i], i));\n }\n return results;\n\n function getItem(p, i) {\n const personName = [p.name]; // treated as opt-in HTML by hyperHTML\n const editorid = p.w3cid ? parseInt(p.w3cid, 10) : null;\n const dd = html`<dd class='p-author h-card vcard'\n data-editor-id='${editorid}'></dd>`;\n const span = document.createDocumentFragment();\n const contents = [];\n if (p.mailto) {\n contents.push(html`<a class='ed_mailto u-email email p-name'\n href='${`mailto:${p.mailto}`}'>${personName}</a>`);\n } else if (p.url) {\n contents.push(html`<a class='u-url url p-name fn'\n href='${p.url}'>${personName}</a>`);\n } else {\n contents.push(html`<span class='p-name fn'>${personName}</span>`);\n }\n if (p.company) {\n if (p.companyURL) {\n contents.push(html` (<a class='p-org org h-org h-card' href='${p.companyURL}'>${p.company}</a>)`);\n } else {\n contents.push(html` (${p.company})`);\n }\n }\n if (p.note) contents.push(document.createTextNode(` (${p.note})`));\n if (p.extras) {\n const results = p.extras\n // Remove empty names\n .filter(extra => extra.name && extra.name.trim())\n // Convert to HTML\n .map(getExtra);\n for (const result of results) {\n contents.push(document.createTextNode(\", \"), result);\n }\n }\n hyperHTML.bind(span)`${contents}`;\n dd.appendChild(span);\n return dd;\n }\n\n function getExtra(extra) {\n const span = html`<span class='${extra.class || null}'></span>`;\n let textContainer = span;\n if (extra.href) {\n textContainer = html`<a href='${extra.href}'></a>`;\n span.appendChild(textContainer);\n }\n textContainer.textContent = extra.name;\n return span;\n }\n };\n});\n//# sourceMappingURL=show-people.js.map;\n", - "define('oai/templates/show-link',[\"exports\", \"core/pubsubhub\", \"deps/hyperhtml\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n\n const html = hyperHTML;\n\n exports.default = link => {\n if (!link.key) {\n const msg = \"Found a link without `key` attribute in the configuration. See dev console.\";\n (0, _pubsubhub.pub)(\"warn\", msg);\n console.warn(\"warn\", msg, link);\n return;\n }\n return html`\n <dt class=\"${link.class ? link.class : null}\">${link.key}:</dt>\n ${link.data ? link.data.map(showLinkData) : showLinkData(link)}\n `;\n };\n\n function showLinkData(data) {\n return html`\n <dd class=\"${data.class ? data.class : null}\">\n ${data.href ? html`\n <a href=\"${data.href}\">${data.value || data.href}</a>\n ` : \"\"}\n </dd>\n `;\n }\n});\n//# sourceMappingURL=show-link.js.map;\n", - "define('oai/templates/headers',[\"exports\", \"./show-logo\", \"./show-people\", \"./show-link\", \"core/pubsubhub\", \"deps/hyperhtml\"], function (exports, _showLogo, _showPeople, _showLink, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n\n var _showLogo2 = _interopRequireDefault(_showLogo);\n\n var _showPeople2 = _interopRequireDefault(_showPeople);\n\n var _showLink2 = _interopRequireDefault(_showLink);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n function getSpecTitleElem(conf) {\n const specTitleElem = document.querySelector(\"h1#title\") || document.createElement(\"h1\");\n if (specTitleElem.parentElement) {\n specTitleElem.remove();\n conf.title = specTitleElem.textContent.trim();\n } else {\n specTitleElem.textContent = conf.title;\n specTitleElem.id = \"title\";\n }\n specTitleElem.classList.add(\"title\", \"p-name\");\n if (document.querySelector(\"title\") === null) {\n document.title = conf.title;\n } else if (document.title !== conf.title) {\n (0, _pubsubhub.pub)(\"warn\", \"The document's title and the `<title>` element differ.\");\n }\n return specTitleElem;\n }\n\n function getSpecSubTitleElem(conf) {\n let specSubTitleElem = document.querySelector(\"h2#subtitle\");\n\n if (specSubTitleElem && specSubTitleElem.parentElement) {\n specSubTitleElem.remove();\n conf.subtitle = specSubTitleElem.textContent.trim();\n } else if (conf.subtitle) {\n specSubTitleElem = document.createElement(\"h2\");\n specSubTitleElem.textContent = conf.subtitle;\n specSubTitleElem.id = \"subtitle\";\n }\n if (specSubTitleElem) {\n specSubTitleElem.classList.add(\"subtitle\");\n }\n return specSubTitleElem;\n }\n\n exports.default = conf => {\n const html = hyperHTML;\n\n return html`<div class='head'>\n ${conf.logos.map(_showLogo2.default)}\n ${getSpecTitleElem(conf)}\n ${getSpecSubTitleElem(conf)}\n <h2>${conf.prependW3C ? \"W3C\" : \"\"}${conf.textStatus} <time class='dt-published' datetime='${conf.dashDate}'>${conf.publishHumanDate}</time></h2>\n <dl>\n ${!conf.isNoTrack ? html`\n <dt>${conf.l10n.this_version}</dt>\n <dd><a class='u-url' href='${conf.thisVersion}'>${conf.thisVersion}</a></dd>\n <dt>${conf.l10n.latest_published_version}</dt>\n <dd>${conf.latestVersion ? html`<a href='${conf.latestVersion}'>${conf.latestVersion}</a>` : \"none\"}</dd>\n ` : \"\"}\n ${conf.edDraftURI ? html`\n <dt>${conf.l10n.latest_editors_draft}</dt>\n <dd><a href='${conf.edDraftURI}'>${conf.edDraftURI}</a></dd>\n ` : \"\"}\n ${conf.testSuiteURI ? html`\n <dt>Test suite:</dt>\n <dd><a href='${conf.testSuiteURI}'>${conf.testSuiteURI}</a></dd>\n ` : \"\"}\n ${conf.implementationReportURI ? html`\n <dt>Implementation report:</dt>\n <dd><a href='${conf.implementationReportURI}'>${conf.implementationReportURI}</a></dd>\n ` : \"\"}\n ${conf.bugTrackerHTML ? html`\n <dt>${conf.l10n.bug_tracker}</dt>\n <dd>${[conf.bugTrackerHTML]}</dd>\n ` : \"\"}\n ${conf.isED ? html`\n ${conf.prevED ? html`\n <dt>Previous editor's draft:</dt>\n <dd><a href='${conf.prevED}'>${conf.prevED}</a></dd>\n ` : \"\"}\n ` : \"\"}\n ${conf.showPreviousVersion ? html`\n <dt>Previous version:</dt>\n <dd><a href='${conf.prevVersion}'>${conf.prevVersion}</a></dd>\n ` : \"\"}\n ${conf.prevRecURI ? html`\n ${conf.isRec ? html`\n <dt>Previous Recommendation:</dt>\n <dd><a href='${conf.prevRecURI}'>${conf.prevRecURI}</a></dd>\n ` : html`\n <dt>Latest Recommendation:</dt>\n <dd><a href='${conf.prevRecURI}'>${conf.prevRecURI}</a></dd>\n `}\n ` : \"\"}\n <dt>${conf.multipleEditors ? conf.l10n.editors : conf.l10n.editor}</dt>\n ${(0, _showPeople2.default)(conf, \"Editor\", conf.editors)}\n ${Array.isArray(conf.formerEditors) && conf.formerEditors.length > 0 ? html`\n <dt>${conf.multipleFormerEditors ? conf.l10n.former_editors : conf.l10n.former_editor}</dt>\n ${(0, _showPeople2.default)(conf, \"Editor\", conf.formerEditors)}\n ` : \"\"}\n ${conf.authors ? html`\n <dt>${conf.multipleAuthors ? conf.l10n.authors : conf.l10n.author}</dt>\n ${(0, _showPeople2.default)(conf, \"Author\", conf.authors)}\n ` : \"\"}\n ${conf.otherLinks ? conf.otherLinks.map(_showLink2.default) : \"\"}\n </dl>\n ${conf.errata ? html`\n <p>\n Please check the <a href=\"${conf.errata}\"><strong>errata</strong></a> for any errors or issues\n reported since publication.\n </p>\n ` : \"\"}\n ${conf.isRec ? html`\n <p>\n See also <a href=\"${`http://www.w3.org/2003/03/Translations/byTechnology?technology=${conf.shortName}`}\">\n <strong>translations</strong></a>.\n </p>\n ` : \"\"}\n ${conf.alternateFormats ? html`\n <p>\n ${conf.multipleAlternates ? \"This document is also available in these non-normative formats:\" : \"This document is also available in this non-normative format:\"}\n ${[conf.alternatesHTML]}\n </p>\n ` : \"\"}\n ${conf.isUnofficial ? html`\n ${conf.additionalCopyrightHolders ? html`\n <p class='copyright'>${[conf.additionalCopyrightHolders]}</p>\n ` : html`\n ${conf.overrideCopyright ? [conf.overrideCopyright] : html`\n <p class='copyright'>\n This document is licensed under a\n <a class='subfoot' href='https://creativecommons.org/licenses/by/3.0/' rel='license'>Creative Commons\n Attribution 3.0 License</a>.\n </p>\n `}\n `}\n ` : html`\n ${conf.overrideCopyright ? [conf.overrideCopyright] : html`\n <p class='copyright'>\n Copyright ©\n ${conf.copyrightStart ? `${conf.copyrightStart}-` : \"\"}${conf.publishYear}\n ${conf.additionalCopyrightHolders ? html` ${[conf.additionalCopyrightHolders]} ` : \"\"}\n ${conf.isCCBY ? html`\n Some Rights Reserved: this document is dual-licensed,\n <a rel=\"license\" href=\"https://creativecommons.org/licenses/by/3.0/\">CC-BY</a> and\n <a rel=\"license\" href=\"https://www.w3.org/Consortium/Legal/copyright-documents\">W3C Document License</a>.\n ` : \"\"}\n </p>\n `}\n `}\n <hr title=\"Separator for header\">\n</div>`;\n };\n});\n//# sourceMappingURL=headers.js.map\n;\n", - "define('oai/headers',[\"exports\", \"core/utils\", \"handlebars.runtime\", \"core/pubsubhub\", \"templates\", \"w3c/templates/cgbg-sotd\", \"w3c/templates/sotd\", \"w3c/templates/cgbg-headers\", \"oai/templates/headers\"], function (exports, _utils, _handlebars, _pubsubhub, _templates, _cgbgSotd, _sotd, _cgbgHeaders, _headers) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _handlebars2 = _interopRequireDefault(_handlebars);\n\n var _templates2 = _interopRequireDefault(_templates);\n\n var _cgbgSotd2 = _interopRequireDefault(_cgbgSotd);\n\n var _sotd2 = _interopRequireDefault(_sotd);\n\n var _cgbgHeaders2 = _interopRequireDefault(_cgbgHeaders);\n\n var _headers2 = _interopRequireDefault(_headers);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n const name = exports.name = \"oai/headers\";\n\n const W3CDate = new Intl.DateTimeFormat([\"en-GB\"], {\n timeZone: \"UTC\",\n year: \"numeric\",\n month: \"long\",\n day: \"2-digit\"\n });\n\n const status2maturity = {\n FPWD: \"WD\",\n LC: \"WD\",\n FPLC: \"WD\",\n \"FPWD-NOTE\": \"NOTE\",\n \"WD-NOTE\": \"WD\",\n \"LC-NOTE\": \"LC\",\n \"IG-NOTE\": \"NOTE\",\n \"WG-NOTE\": \"NOTE\"\n };\n\n const status2rdf = {\n NOTE: \"w3p:NOTE\",\n WD: \"w3p:WD\",\n LC: \"w3p:LastCall\",\n CR: \"w3p:CR\",\n PR: \"w3p:PR\",\n REC: \"w3p:REC\",\n PER: \"w3p:PER\",\n RSCND: \"w3p:RSCND\"\n };\n const status2text = {\n NOTE: \"Working Group Note\",\n \"WG-NOTE\": \"Working Group Note\",\n \"CG-NOTE\": \"Co-ordination Group Note\",\n \"IG-NOTE\": \"Interest Group Note\",\n \"Member-SUBM\": \"Member Submission\",\n \"Team-SUBM\": \"Team Submission\",\n MO: \"Member-Only Document\",\n ED: \"Editor's Draft\",\n FPWD: \"First Public Working Draft\",\n WD: \"Working Draft\",\n \"FPWD-NOTE\": \"Working Group Note\",\n \"WD-NOTE\": \"Working Draft\",\n \"LC-NOTE\": \"Working Draft\",\n FPLC: \"First Public and Last Call Working Draft\",\n LC: \"Last Call Working Draft\",\n CR: \"Candidate Recommendation\",\n PR: \"Proposed Recommendation\",\n PER: \"Proposed Edited Recommendation\",\n REC: \"Recommendation\",\n RSCND: \"Rescinded Recommendation\",\n unofficial: \"Unofficial Draft\",\n base: \"Published\",\n finding: \"TAG Finding\",\n \"draft-finding\": \"Draft TAG Finding\",\n \"CG-DRAFT\": \"Draft Community Group Report\",\n \"CG-FINAL\": \"Final Community Group Report\",\n \"BG-DRAFT\": \"Draft Business Group Report\",\n \"BG-FINAL\": \"Final Business Group Report\"\n };\n const status2long = {\n \"FPWD-NOTE\": \"First Public Working Group Note\",\n \"LC-NOTE\": \"Last Call Working Draft\"\n };\n const recTrackStatus = [\"FPWD\", \"WD\", \"FPLC\", \"LC\", \"CR\", \"PR\", \"PER\", \"REC\"];\n const noTrackStatus = [\"MO\", \"unofficial\", \"base\", \"finding\", \"draft-finding\", \"CG-DRAFT\", \"CG-FINAL\", \"BG-DRAFT\", \"BG-FINAL\"];\n const cgbg = [\"CG-DRAFT\", \"CG-FINAL\", \"BG-DRAFT\", \"BG-FINAL\"];\n const precededByAn = [\"ED\", \"IG-NOTE\"];\n const licenses = {\n cc0: {\n name: \"Creative Commons 0 Public Domain Dedication\",\n short: \"CC0\",\n url: \"https://creativecommons.org/publicdomain/zero/1.0/\"\n },\n \"w3c-software\": {\n name: \"W3C Software Notice and License\",\n short: \"W3C Software\",\n url: \"https://www.w3.org/Consortium/Legal/2002/copyright-software-20021231\"\n },\n \"w3c-software-doc\": {\n name: \"W3C Software and Document Notice and License\",\n short: \"W3C Software and Document\",\n url: \"https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document\"\n },\n \"apache2\": {\n name: \"Apache 2.0 License\",\n short: \"Apache 2.0\",\n url: \"https://www.apache.org/licenses/LICENSE-2.0.html\"\n },\n \"cc-by\": {\n name: \"Creative Commons Attribution 4.0 International Public License\",\n short: \"CC-BY\",\n url: \"https://creativecommons.org/licenses/by/4.0/legalcode\"\n }\n };\n\n const baseLogo = Object.freeze({\n id: \"\",\n alt: \"\",\n href: \"\",\n src: \"\",\n height: \"48\",\n width: \"72\"\n });\n\n function validateDateAndRecover(conf, prop, fallbackDate = new Date()) {\n const date = conf[prop] ? new Date(conf[prop]) : new Date(fallbackDate);\n // if date is valid\n if (Number.isFinite(date.valueOf())) {\n const formattedDate = _utils.ISODate.format(date);\n return new Date(formattedDate);\n }\n const msg = `[\\`${prop}\\`](https://github.com/w3c/respec/wiki/${prop}) ` + `is not a valid date: \"${conf[prop]}\". Expected format 'YYYY-MM-DD'.`;\n (0, _pubsubhub.pub)(\"error\", msg);\n return new Date(_utils.ISODate.format(new Date()));\n }\n\n function run(conf) {\n conf.isUnofficial = conf.specStatus === \"unofficial\";\n if (conf.isUnofficial) {\n conf.logos = [];\n }\n conf.license = \"apache2\";\n conf.isCCBY = conf.license === \"cc-by\";\n conf.isW3CSoftAndDocLicense = conf.license === \"w3c-software-doc\";\n if ([\"cc-by\"].includes(conf.license)) {\n let msg = `You cannot use license \"\\`${conf.license}\\`\" with W3C Specs. `;\n msg += `Please set \\`respecConfig.license: \"w3c-software-doc\"\\` instead.`;\n (0, _pubsubhub.pub)(\"error\", msg);\n }\n conf.licenseInfo = licenses[conf.license];\n conf.isCGBG = cgbg.includes(conf.specStatus);\n conf.isCGFinal = conf.isCGBG && /G-FINAL$/.test(conf.specStatus);\n conf.isBasic = conf.specStatus === \"base\";\n conf.isRegular = !conf.isCGBG && !conf.isBasic;\n if (!conf.specStatus) {\n (0, _pubsubhub.pub)(\"error\", \"Missing required configuration: `specStatus`\");\n }\n if (conf.isRegular && !conf.shortName) {\n (0, _pubsubhub.pub)(\"error\", \"Missing required configuration: `shortName`\");\n }\n if (conf.testSuiteURI) {\n const url = new URL(conf.testSuiteURI, document.location);\n const { host, pathname } = url;\n if (host === \"github.com\" && pathname.startsWith(\"/w3c/web-platform-tests/\")) {\n const msg = \"Web Platform Tests have moved to a new Github Organization at https://github.com/web-platform-tests. \" + \"Please update your [`testSuiteURI`](https://github.com/w3c/respec/wiki/testSuiteURI) to point to the \" + `new tests repository (e.g., https://github.com/web-platform-tests/${conf.shortName} ).`;\n (0, _pubsubhub.pub)(\"warn\", msg);\n }\n }\n conf.title = document.title || \"No Title\";\n if (!conf.subtitle) conf.subtitle = \"\";\n conf.publishDate = validateDateAndRecover(conf, \"publishDate\", document.lastModified);\n conf.publishYear = conf.publishDate.getUTCFullYear();\n conf.publishHumanDate = W3CDate.format(conf.publishDate);\n conf.isNoTrack = noTrackStatus.includes(conf.specStatus);\n conf.isRecTrack = conf.noRecTrack ? false : recTrackStatus.includes(conf.specStatus);\n conf.isMemberSubmission = conf.specStatus === \"Member-SUBM\";\n if (conf.isMemberSubmission) {\n const memSubmissionLogo = {\n alt: \"W3C Member Submission\",\n href: \"https://www.w3.org/Submission/\",\n src: \"https://www.w3.org/Icons/member_subm-v.svg\",\n width: \"211\"\n };\n conf.logos.push(_extends({}, baseLogo, memSubmissionLogo));\n }\n conf.isTeamSubmission = conf.specStatus === \"Team-SUBM\";\n if (conf.isTeamSubmission) {\n const teamSubmissionLogo = {\n alt: \"W3C Team Submission\",\n href: \"https://www.w3.org/TeamSubmission/\",\n src: \"https://www.w3.org/Icons/team_subm-v.svg\",\n width: \"211\"\n };\n conf.logos.push(_extends({}, baseLogo, teamSubmissionLogo));\n }\n conf.isSubmission = conf.isMemberSubmission || conf.isTeamSubmission;\n conf.anOrA = precededByAn.includes(conf.specStatus) ? \"an\" : \"a\";\n conf.isTagFinding = conf.specStatus === \"finding\" || conf.specStatus === \"draft-finding\";\n if (!conf.edDraftURI) {\n conf.edDraftURI = \"\";\n if (conf.specStatus === \"ED\") (0, _pubsubhub.pub)(\"warn\", \"Editor's Drafts should set edDraftURI.\");\n }\n conf.maturity = status2maturity[conf.specStatus] ? status2maturity[conf.specStatus] : conf.specStatus;\n var publishSpace = \"TR\";\n if (conf.specStatus === \"Member-SUBM\") publishSpace = \"Submission\";else if (conf.specStatus === \"Team-SUBM\") publishSpace = \"TeamSubmission\";\n if (conf.isRegular) conf.thisVersion = \"https://www.w3.org/\" + publishSpace + \"/\" + conf.publishDate.getUTCFullYear() + \"/\" + conf.maturity + \"-\" + conf.shortName + \"-\" + (0, _utils.concatDate)(conf.publishDate) + \"/\";\n if (conf.specStatus === \"ED\") conf.thisVersion = conf.edDraftURI;\n if (conf.isRegular) conf.latestVersion = \"https://www.w3.org/\" + publishSpace + \"/\" + conf.shortName + \"/\";\n if (conf.isTagFinding) {\n conf.latestVersion = \"https://www.w3.org/2001/tag/doc/\" + conf.shortName;\n conf.thisVersion = conf.latestVersion + \"-\" + _utils.ISODate.format(conf.publishDate);\n }\n if (conf.previousPublishDate) {\n if (!conf.previousMaturity && !conf.isTagFinding) {\n (0, _pubsubhub.pub)(\"error\", \"`previousPublishDate` is set, but not `previousMaturity`.\");\n }\n\n conf.previousPublishDate = validateDateAndRecover(conf, \"previousPublishDate\");\n\n var pmat = status2maturity[conf.previousMaturity] ? status2maturity[conf.previousMaturity] : conf.previousMaturity;\n if (conf.isTagFinding) {\n conf.prevVersion = conf.latestVersion + \"-\" + _utils.ISODate.format(conf.previousPublishDate);\n } else if (conf.isCGBG) {\n conf.prevVersion = conf.prevVersion || \"\";\n } else if (conf.isBasic) {\n conf.prevVersion = \"\";\n } else {\n conf.prevVersion = \"https://www.w3.org/TR/\" + conf.previousPublishDate.getUTCFullYear() + \"/\" + pmat + \"-\" + conf.shortName + \"-\" + (0, _utils.concatDate)(conf.previousPublishDate) + \"/\";\n }\n } else {\n if (!/NOTE$/.test(conf.specStatus) && conf.specStatus !== \"FPWD\" && conf.specStatus !== \"FPLC\" && conf.specStatus !== \"ED\" && !conf.noRecTrack && !conf.isNoTrack && !conf.isSubmission) (0, _pubsubhub.pub)(\"error\", \"Document on track but no previous version:\" + \" Add `previousMaturity`, and `previousPublishDate` to ReSpec's config.\");\n if (!conf.prevVersion) conf.prevVersion = \"\";\n }\n if (conf.prevRecShortname && !conf.prevRecURI) conf.prevRecURI = \"https://www.w3.org/TR/\" + conf.prevRecShortname;\n if (!conf.editors || conf.editors.length === 0) (0, _pubsubhub.pub)(\"error\", \"At least one editor is required\");\n var peopCheck = function (it) {\n if (!it.name) (0, _pubsubhub.pub)(\"error\", \"All authors and editors must have a name.\");\n };\n if (conf.editors) {\n conf.editors.forEach(peopCheck);\n }\n if (conf.formerEditors) {\n conf.formerEditors.forEach(peopCheck);\n }\n if (conf.authors) {\n conf.authors.forEach(peopCheck);\n }\n conf.multipleEditors = conf.editors && conf.editors.length > 1;\n conf.multipleFormerEditors = Array.isArray(conf.formerEditors) && conf.formerEditors.length > 1;\n conf.multipleAuthors = conf.authors && conf.authors.length > 1;\n $.each(conf.alternateFormats || [], function (i, it) {\n if (!it.uri || !it.label) (0, _pubsubhub.pub)(\"error\", \"All alternate formats must have a uri and a label.\");\n });\n conf.multipleAlternates = conf.alternateFormats && conf.alternateFormats.length > 1;\n conf.alternatesHTML = conf.alternateFormats && (0, _utils.joinAnd)(conf.alternateFormats, function (alt) {\n var optional = alt.hasOwnProperty(\"lang\") && alt.lang ? \" hreflang='\" + alt.lang + \"'\" : \"\";\n optional += alt.hasOwnProperty(\"type\") && alt.type ? \" type='\" + alt.type + \"'\" : \"\";\n return \"<a rel='alternate' href='\" + alt.uri + \"'\" + optional + \">\" + alt.label + \"</a>\";\n });\n if (conf.bugTracker) {\n if (conf.bugTracker[\"new\"] && conf.bugTracker.open) {\n conf.bugTrackerHTML = \"<a href='\" + conf.bugTracker[\"new\"] + \"'>\" + conf.l10n.file_a_bug + \"</a> \" + conf.l10n.open_parens + \"<a href='\" + conf.bugTracker.open + \"'>\" + conf.l10n.open_bugs + \"</a>\" + conf.l10n.close_parens;\n } else if (conf.bugTracker.open) {\n conf.bugTrackerHTML = \"<a href='\" + conf.bugTracker.open + \"'>open bugs</a>\";\n } else if (conf.bugTracker[\"new\"]) {\n conf.bugTrackerHTML = \"<a href='\" + conf.bugTracker[\"new\"] + \"'>file a bug</a>\";\n }\n }\n if (conf.copyrightStart && conf.copyrightStart == conf.publishYear) conf.copyrightStart = \"\";\n for (var k in status2text) {\n if (status2long[k]) continue;\n status2long[k] = status2text[k];\n }\n conf.longStatus = status2long[conf.specStatus];\n conf.textStatus = status2text[conf.specStatus];\n if (status2rdf[conf.specStatus]) {\n conf.rdfStatus = status2rdf[conf.specStatus];\n }\n conf.showThisVersion = !conf.isNoTrack || conf.isTagFinding;\n conf.showPreviousVersion = conf.specStatus !== \"FPWD\" && conf.specStatus !== \"FPLC\" && conf.specStatus !== \"ED\" && !conf.isNoTrack && !conf.isSubmission;\n if (/NOTE$/.test(conf.specStatus) && !conf.prevVersion) conf.showPreviousVersion = false;\n if (conf.isTagFinding) conf.showPreviousVersion = conf.previousPublishDate ? true : false;\n conf.notYetRec = conf.isRecTrack && conf.specStatus !== \"REC\";\n conf.isRec = conf.isRecTrack && conf.specStatus === \"REC\";\n if (conf.isRec && !conf.errata) (0, _pubsubhub.pub)(\"error\", \"Recommendations must have an errata link.\");\n conf.notRec = conf.specStatus !== \"REC\";\n //conf.prependW3C = !conf.isUnofficial;\n conf.prependW3C = false;\n conf.isED = conf.specStatus === \"ED\";\n conf.isCR = conf.specStatus === \"CR\";\n conf.isPR = conf.specStatus === \"PR\";\n conf.isPER = conf.specStatus === \"PER\";\n conf.isMO = conf.specStatus === \"MO\";\n conf.isNote = [\"FPWD-NOTE\", \"WG-NOTE\"].includes(conf.specStatus);\n conf.isIGNote = conf.specStatus === \"IG-NOTE\";\n conf.dashDate = _utils.ISODate.format(conf.publishDate);\n conf.publishISODate = conf.publishDate.toISOString();\n conf.shortISODate = _utils.ISODate.format(conf.publishDate);\n Object.defineProperty(conf, \"wgId\", {\n get() {\n if (!this.hasOwnProperty(\"wgPatentURI\")) {\n return \"\";\n }\n // it's always at \"pp-impl\" + 1\n const urlParts = this.wgPatentURI.split(\"/\");\n const pos = urlParts.findIndex(item => item === \"pp-impl\") + 1;\n return urlParts[pos] || \"\";\n }\n });\n // configuration done - yay!\n\n // insert into document\n const header = (conf.isCGBG ? _cgbgHeaders2.default : _headers2.default)(conf);\n document.body.insertBefore(header, document.body.firstChild);\n document.body.classList.add(\"h-entry\");\n\n // handle SotD\n var sotd = document.getElementById(\"sotd\") || document.createElement(\"section\");\n if ((conf.isCGBG || !conf.isNoTrack || conf.isTagFinding) && !sotd.id) {\n (0, _pubsubhub.pub)(\"error\", \"A custom SotD paragraph is required for your type of document.\");\n }\n sotd.id = sotd.id || \"sotd\";\n sotd.classList.add(\"introductory\");\n // NOTE:\n // When arrays, wg and wgURI have to be the same length (and in the same order).\n // Technically wgURI could be longer but the rest is ignored.\n // However wgPatentURI can be shorter. This covers the case where multiple groups\n // publish together but some aren't used for patent policy purposes (typically this\n // happens when one is foolish enough to do joint work with the TAG). In such cases,\n // the groups whose patent policy applies need to be listed first, and wgPatentURI\n // can be shorter — but it still needs to be an array.\n var wgPotentialArray = [conf.wg, conf.wgURI, conf.wgPatentURI];\n if (wgPotentialArray.some(item => Array.isArray(item)) && !wgPotentialArray.every(item => Array.isArray(item))) {\n (0, _pubsubhub.pub)(\"error\", \"If one of '`wg`', '`wgURI`', or '`wgPatentURI`' is an array, they all have to be.\");\n }\n if (conf.isCGBG && !conf.wg) {\n (0, _pubsubhub.pub)(\"error\", \"[`wg`](https://github.com/w3c/respec/wiki/wg)\" + \" configuration option is required for this kind of document.\");\n }\n if (Array.isArray(conf.wg)) {\n conf.multipleWGs = conf.wg.length > 1;\n conf.wgHTML = (0, _utils.joinAnd)(conf.wg, function (wg, idx) {\n return \"the <a href='\" + conf.wgURI[idx] + \"'>\" + wg + \"</a>\";\n });\n var pats = [];\n for (var i = 0, n = conf.wg.length; i < n; i++) {\n pats.push(\"a <a href='\" + conf.wgPatentURI[i] + \"' rel='disclosure'>\" + \"public list of any patent disclosures (\" + conf.wg[i] + \")</a>\");\n }\n conf.wgPatentHTML = (0, _utils.joinAnd)(pats);\n } else {\n conf.multipleWGs = false;\n conf.wgHTML = \"the <a href='\" + conf.wgURI + \"'>\" + conf.wg + \"</a>\";\n }\n if (conf.specStatus === \"PR\" && !conf.crEnd) {\n (0, _pubsubhub.pub)(\"error\", `\\`specStatus\\` is \"PR\" but no \\`crEnd\\` is specified (needed to indicate end of previous CR).`);\n }\n\n if (conf.specStatus === \"CR\" && !conf.crEnd) {\n (0, _pubsubhub.pub)(\"error\", `\\`specStatus\\` is \"CR\", but no \\`crEnd\\` is specified in Respec config.`);\n }\n conf.crEnd = validateDateAndRecover(conf, \"crEnd\");\n conf.humanCREnd = W3CDate.format(conf.crEnd);\n\n if (conf.specStatus === \"PR\" && !conf.prEnd) {\n (0, _pubsubhub.pub)(\"error\", `\\`specStatus\\` is \"PR\" but no \\`prEnd\\` is specified.`);\n }\n conf.prEnd = validateDateAndRecover(conf, \"prEnd\");\n conf.humanPREnd = W3CDate.format(conf.prEnd);\n\n if (conf.specStatus === \"PER\" && !conf.perEnd) {\n (0, _pubsubhub.pub)(\"error\", \"Status is PER but no perEnd is specified\");\n }\n conf.perEnd = validateDateAndRecover(conf, \"perEnd\");\n conf.humanPEREnd = W3CDate.format(conf.perEnd);\n\n conf.recNotExpected = conf.recNotExpected ? true : !conf.isRecTrack && conf.maturity == \"WD\" && conf.specStatus !== \"FPWD-NOTE\";\n if (conf.isIGNote && !conf.charterDisclosureURI) (0, _pubsubhub.pub)(\"error\", \"IG-NOTEs must link to charter's disclosure section using `charterDisclosureURI`.\");\n // ensure subjectPrefix is encoded before using template\n if (conf.subjectPrefix !== \"\") conf.subjectPrefixEnc = encodeURIComponent(conf.subjectPrefix);\n\n //hyperHTML.bind(sotd)`${populateSoTD(conf, sotd)}`;\n\n if (!conf.implementationReportURI && conf.isCR) {\n (0, _pubsubhub.pub)(\"error\", \"CR documents must have an [`implementationReportURI`](https://github.com/w3c/respec/wiki/implementationReportURI) \" + \"that describes [implementation experience](https://www.w3.org/2018/Process-20180201/#implementation-experience).\");\n }\n if (!conf.implementationReportURI && conf.isPR) {\n (0, _pubsubhub.pub)(\"warn\", \"PR documents should include an \" + \" [`implementationReportURI`](https://github.com/w3c/respec/wiki/implementationReportURI)\" + \" that describes [implementation experience](https://www.w3.org/2018/Process-20180201/#implementation-experience).\");\n }\n\n if (conf.isTagFinding && !conf.additionalContent) {\n (0, _pubsubhub.pub)(\"warn\", \"ReSpec does not support automated SotD generation for TAG findings, \" + \"please add the prerequisite content in the 'sotd' section\");\n }\n // Requested by https://github.com/w3c/respec/issues/504\n // Makes a record of a few auto-generated things.\n (0, _pubsubhub.pub)(\"amend-user-config\", {\n publishISODate: conf.publishISODate,\n generatedSubtitle: `${conf.longStatus} ${conf.publishHumanDate}`\n });\n }\n\n function populateSoTD(conf, sotd) {\n const sotdClone = sotd.cloneNode(true);\n const additionalNodes = document.createDocumentFragment();\n const additionalContent = document.createElement(\"temp\");\n // we collect everything until we hit a section,\n // that becomes the custom content.\n while (sotdClone.hasChildNodes()) {\n if (sotdClone.firstChild.nodeType !== Node.ELEMENT_NODE || sotdClone.firstChild.localName !== \"section\") {\n additionalNodes.appendChild(sotdClone.firstChild);\n continue;\n }\n break;\n }\n additionalContent.appendChild(additionalNodes);\n conf.additionalContent = additionalContent.innerHTML;\n // Whatever sections are left, we throw at the end.\n conf.additionalSections = sotdClone.innerHTML;\n return (conf.isCGBG ? _cgbgSotd2.default : _sotd2.default)(conf);\n }\n});\n//# sourceMappingURL=headers.js.map\n;\n", - "define('w3c/abstract',[\"exports\", \"core/pubsubhub\", \"core/l10n\"], function (exports, _pubsubhub, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n // Module w3c/abstract\n // Handle the abstract section properly.\n const name = exports.name = \"w3c/abstract\";\n\n async function run() {\n const abs = document.getElementById(\"abstract\");\n if (!abs) {\n (0, _pubsubhub.pub)(\"error\", `Document must have one element with \\`id=\"abstract\"`);\n return;\n }\n abs.classList.add(\"introductory\");\n let abstractHeading = document.querySelector(\"#abstract>h2\");\n if (abstractHeading) {\n return;\n }\n abstractHeading = document.createElement(\"h2\");\n abstractHeading.innerText = _l10n.l10n[_l10n.lang].abstract;\n abs.insertAdjacentElement(\"afterbegin\", abstractHeading);\n }\n});\n//# sourceMappingURL=abstract.js.map;\n", - "define('w3c/templates/conformance',[\"exports\", \"deps/hyperhtml\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n\n exports.default = () => {\n const html = hyperHTML;\n return html`<h2>Conformance</h2>\n<p>\n As well as sections marked as non-normative, all authoring guidelines, diagrams, examples,\n and notes in this specification are non-normative. Everything else in this specification is\n normative.\n</p>\n<p id='respecRFC2119'>\n to be interpreted as described in [[!RFC2119]].\n</p>`;\n };\n});\n//# sourceMappingURL=conformance.js.map;\n", - "define('w3c/conformance',[\"exports\", \"w3c/templates/conformance\", \"core/pubsubhub\"], function (exports, _conformance, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _conformance2 = _interopRequireDefault(_conformance);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n // Module w3c/conformance\n // Handle the conformance section properly.\n const name = exports.name = \"w3c/conformance\";\n\n function run(conf, doc, cb) {\n var $confo = $(\"#conformance\");\n if ($confo.length) $confo.prepend((0, _conformance2.default)(conf).childNodes);\n // Added message for legacy compat with Aria specs\n // See https://github.com/w3c/respec/issues/793\n (0, _pubsubhub.pub)(\"end\", \"w3c/conformance\");\n cb();\n }\n});\n//# sourceMappingURL=conformance.js.map;\n", - "define('core/data-transform',[\"exports\", \"core/utils\"], function (exports, _utils) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"core/data-transform\"; // Module core/data-transform\n // Support for the data-transform attribute\n // Any element in the tree that has a data-transform attribute is processed here.\n // The data-transform attribute can contain a white space separated list of functions\n // to call (these must have been defined globally). Each is called with a reference to\n // the core/utils plugin and the innerHTML of the element. The output of each is fed\n // as the input to the next, and the output of the last one replaces the HTML content\n // of the element.\n // IMPORTANT:\n // It is unlikely that you should use this module. The odds are that unless you really\n // know what you are doing, you should be using a dedicated module instead. This feature\n // is not actively supported and support for it may be dropped. It is not accounted for\n // in the test suite, and therefore could easily break.\n function run(conf, doc, cb) {\n Array.from(doc.querySelectorAll(\"[data-transform]\")).forEach(el => {\n el.innerHTML = (0, _utils.runTransforms)(el.innerHTML, el.dataset.transform);\n el.removeAttribute(\"data-transform\");\n });\n cb();\n }\n});\n//# sourceMappingURL=data-transform.js.map;\n", - "define('core/inlines',[\"exports\", \"core/pubsubhub\", \"deps/hyperhtml\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n // Module core/inlines\n // Process all manners of inline information. These are done together despite it being\n // seemingly a better idea to orthogonalise them. The issue is that processing text nodes\n // is harder to orthogonalise, and in some browsers can also be particularly slow.\n // Things that are recognised are <abbr>/<acronym> which when used once are applied\n // throughout the document, [[REFERENCES]]/[[!REFERENCES]], and RFC2119 keywords.\n // CONFIGURATION:\n // These options do not configure the behaviour of this module per se, rather this module\n // manipulates them (oftentimes being the only source to set them) so that other modules\n // may rely on them.\n // - normativeReferences: a map of normative reference identifiers.\n // - informativeReferences: a map of informative reference identifiers.\n // - respecRFC2119: a list of the number of times each RFC2119\n // key word was used. NOTE: While each member is a counter, at this time\n // the counter is not used.\n const name = exports.name = \"core/inlines\";\n\n function run(conf) {\n document.normalize();\n if (!conf.normativeReferences) conf.normativeReferences = new Set();\n if (!conf.informativeReferences) conf.informativeReferences = new Set();\n if (!conf.respecRFC2119) conf.respecRFC2119 = {};\n\n // PRE-PROCESSING\n const abbrMap = new Map();\n for (const abbr of Array.from(document.querySelectorAll(\"abbr[title]\"))) {\n abbrMap.set(abbr.textContent, abbr.title);\n }\n const aKeys = [...abbrMap.keys()];\n aKeys.sort((a, b) => b.length - a.length);\n const abbrRx = aKeys.length ? `(?:\\\\b${aKeys.join(\"\\\\b)|(?:\\\\b\")}\\\\b)` : null;\n\n // PROCESSING\n const txts = window.$.fn.allTextNodes.call([document.body], [\"pre\"]);\n const rx = new RegExp(\"(\\\\bMUST(?:\\\\s+NOT)?\\\\b|\\\\bSHOULD(?:\\\\s+NOT)?\\\\b|\\\\bSHALL(?:\\\\s+NOT)?\\\\b|\" + \"\\\\bMAY\\\\b|\\\\b(?:NOT\\\\s+)?REQUIRED\\\\b|\\\\b(?:NOT\\\\s+)?RECOMMENDED\\\\b|\\\\bOPTIONAL\\\\b|\" + \"(?:\\\\[\\\\[(?:!|\\\\\\\\)?[A-Za-z0-9\\\\.-]+\\\\]\\\\])\" + (abbrRx ? `|${abbrRx}` : \"\") + \")\");\n for (const txt of txts) {\n const subtxt = txt.data.split(rx);\n if (subtxt.length === 1) continue;\n\n const df = document.createDocumentFragment();\n while (subtxt.length) {\n const t = subtxt.shift();\n let matched = null;\n if (subtxt.length) matched = subtxt.shift();\n df.appendChild(document.createTextNode(t));\n if (matched) {\n // RFC 2119\n if (/MUST(?:\\s+NOT)?|SHOULD(?:\\s+NOT)?|SHALL(?:\\s+NOT)?|MAY|(?:NOT\\s+)?REQUIRED|(?:NOT\\s+)?RECOMMENDED|OPTIONAL/.test(matched)) {\n matched = matched.split(/\\s+/).join(\" \");\n df.appendChild(hyperHTML`<em class=\"rfc2119\" title=\"${matched}\">${matched}</em>`);\n // remember which ones were used\n conf.respecRFC2119[matched] = true;\n } else if (/^\\[\\[/.test(matched)) {\n // BIBREF\n let ref = matched;\n ref = ref.replace(/^\\[\\[/, \"\");\n ref = ref.replace(/\\]\\]$/, \"\");\n if (ref.indexOf(\"\\\\\") === 0) {\n df.appendChild(document.createTextNode(`[[${ref.replace(/^\\\\/, \"\")}]]`));\n } else {\n let norm = false;\n if (ref.indexOf(\"!\") === 0) {\n norm = true;\n ref = ref.replace(/^!/, \"\");\n }\n // contrary to before, we always insert the link\n if (norm) conf.normativeReferences.add(ref);else conf.informativeReferences.add(ref);\n df.appendChild(document.createTextNode(\"[\"));\n df.appendChild(hyperHTML`<cite><a class=\"bibref\" href=\"${`#bib-${ref}`}\">${ref}</a></cite>`);\n df.appendChild(document.createTextNode(\"]\"));\n }\n } else if (abbrMap.has(matched)) {\n // ABBR\n if (txt.parentNode.tagName === \"ABBR\") df.appendChild(document.createTextNode(matched));else df.appendChild(hyperHTML`<abbr title=\"${abbrMap.get(matched)}\">${matched}</abbr>`);\n } else {\n // FAIL -- not sure that this can really happen\n (0, _pubsubhub.pub)(\"error\", `Found token '${matched}' but it does not correspond to anything`);\n }\n }\n }\n txt.parentNode.replaceChild(df, txt);\n }\n }\n});\n//# sourceMappingURL=inlines.js.map;\n", - "/* global define */\n\n(function (root, pluralize) {\n /* istanbul ignore else */\n if (typeof require === 'function' && typeof exports === 'object' && typeof module === 'object') {\n // Node.\n module.exports = pluralize();\n } else if (typeof define === 'function' && define.amd) {\n // AMD, registers as an anonymous module.\n define('deps/pluralize',[],function () {\n return pluralize();\n });\n } else {\n // Browser global.\n root.pluralize = pluralize();\n }\n})(this, function () {\n // Rule storage - pluralize and singularize need to be run sequentially,\n // while other rules can be optimized using an object for instant lookups.\n var pluralRules = [];\n var singularRules = [];\n var uncountables = {};\n var irregularPlurals = {};\n var irregularSingles = {};\n\n /**\n * Sanitize a pluralization rule to a usable regular expression.\n *\n * @param {(RegExp|string)} rule\n * @return {RegExp}\n */\n function sanitizeRule (rule) {\n if (typeof rule === 'string') {\n return new RegExp('^' + rule + '$', 'i');\n }\n\n return rule;\n }\n\n /**\n * Pass in a word token to produce a function that can replicate the case on\n * another word.\n *\n * @param {string} word\n * @param {string} token\n * @return {Function}\n */\n function restoreCase (word, token) {\n // Tokens are an exact match.\n if (word === token) return token;\n\n // Upper cased words. E.g. \"HELLO\".\n if (word === word.toUpperCase()) return token.toUpperCase();\n\n // Title cased words. E.g. \"Title\".\n if (word[0] === word[0].toUpperCase()) {\n return token.charAt(0).toUpperCase() + token.substr(1).toLowerCase();\n }\n\n // Lower cased words. E.g. \"test\".\n return token.toLowerCase();\n }\n\n /**\n * Interpolate a regexp string.\n *\n * @param {string} str\n * @param {Array} args\n * @return {string}\n */\n function interpolate (str, args) {\n return str.replace(/\\$(\\d{1,2})/g, function (match, index) {\n return args[index] || '';\n });\n }\n\n /**\n * Replace a word using a rule.\n *\n * @param {string} word\n * @param {Array} rule\n * @return {string}\n */\n function replace (word, rule) {\n return word.replace(rule[0], function (match, index) {\n var result = interpolate(rule[1], arguments);\n\n if (match === '') {\n return restoreCase(word[index - 1], result);\n }\n\n return restoreCase(match, result);\n });\n }\n\n /**\n * Sanitize a word by passing in the word and sanitization rules.\n *\n * @param {string} token\n * @param {string} word\n * @param {Array} rules\n * @return {string}\n */\n function sanitizeWord (token, word, rules) {\n // Empty string or doesn't need fixing.\n if (!token.length || uncountables.hasOwnProperty(token)) {\n return word;\n }\n\n var len = rules.length;\n\n // Iterate over the sanitization rules and use the first one to match.\n while (len--) {\n var rule = rules[len];\n\n if (rule[0].test(word)) return replace(word, rule);\n }\n\n return word;\n }\n\n /**\n * Replace a word with the updated word.\n *\n * @param {Object} replaceMap\n * @param {Object} keepMap\n * @param {Array} rules\n * @return {Function}\n */\n function replaceWord (replaceMap, keepMap, rules) {\n return function (word) {\n // Get the correct token and case restoration functions.\n var token = word.toLowerCase();\n\n // Check against the keep object map.\n if (keepMap.hasOwnProperty(token)) {\n return restoreCase(word, token);\n }\n\n // Check against the replacement map for a direct word replacement.\n if (replaceMap.hasOwnProperty(token)) {\n return restoreCase(word, replaceMap[token]);\n }\n\n // Run all the rules against the word.\n return sanitizeWord(token, word, rules);\n };\n }\n\n /**\n * Check if a word is part of the map.\n */\n function checkWord (replaceMap, keepMap, rules, bool) {\n return function (word) {\n var token = word.toLowerCase();\n\n if (keepMap.hasOwnProperty(token)) return true;\n if (replaceMap.hasOwnProperty(token)) return false;\n\n return sanitizeWord(token, token, rules) === token;\n };\n }\n\n /**\n * Pluralize or singularize a word based on the passed in count.\n *\n * @param {string} word\n * @param {number} count\n * @param {boolean} inclusive\n * @return {string}\n */\n function pluralize (word, count, inclusive) {\n var pluralized = count === 1\n ? pluralize.singular(word) : pluralize.plural(word);\n\n return (inclusive ? count + ' ' : '') + pluralized;\n }\n\n /**\n * Pluralize a word.\n *\n * @type {Function}\n */\n pluralize.plural = replaceWord(\n irregularSingles, irregularPlurals, pluralRules\n );\n\n /**\n * Check if a word is plural.\n *\n * @type {Function}\n */\n pluralize.isPlural = checkWord(\n irregularSingles, irregularPlurals, pluralRules\n );\n\n /**\n * Singularize a word.\n *\n * @type {Function}\n */\n pluralize.singular = replaceWord(\n irregularPlurals, irregularSingles, singularRules\n );\n\n /**\n * Check if a word is singular.\n *\n * @type {Function}\n */\n pluralize.isSingular = checkWord(\n irregularPlurals, irregularSingles, singularRules\n );\n\n /**\n * Add a pluralization rule to the collection.\n *\n * @param {(string|RegExp)} rule\n * @param {string} replacement\n */\n pluralize.addPluralRule = function (rule, replacement) {\n pluralRules.push([sanitizeRule(rule), replacement]);\n };\n\n /**\n * Add a singularization rule to the collection.\n *\n * @param {(string|RegExp)} rule\n * @param {string} replacement\n */\n pluralize.addSingularRule = function (rule, replacement) {\n singularRules.push([sanitizeRule(rule), replacement]);\n };\n\n /**\n * Add an uncountable word rule.\n *\n * @param {(string|RegExp)} word\n */\n pluralize.addUncountableRule = function (word) {\n if (typeof word === 'string') {\n uncountables[word.toLowerCase()] = true;\n return;\n }\n\n // Set singular and plural references for the word.\n pluralize.addPluralRule(word, '$0');\n pluralize.addSingularRule(word, '$0');\n };\n\n /**\n * Add an irregular word definition.\n *\n * @param {string} single\n * @param {string} plural\n */\n pluralize.addIrregularRule = function (single, plural) {\n plural = plural.toLowerCase();\n single = single.toLowerCase();\n\n irregularSingles[single] = plural;\n irregularPlurals[plural] = single;\n };\n\n /**\n * Irregular rules.\n */\n [\n // Pronouns.\n ['I', 'we'],\n ['me', 'us'],\n ['he', 'they'],\n ['she', 'they'],\n ['them', 'them'],\n ['myself', 'ourselves'],\n ['yourself', 'yourselves'],\n ['itself', 'themselves'],\n ['herself', 'themselves'],\n ['himself', 'themselves'],\n ['themself', 'themselves'],\n ['is', 'are'],\n ['was', 'were'],\n ['has', 'have'],\n ['this', 'these'],\n ['that', 'those'],\n // Words ending in with a consonant and `o`.\n ['echo', 'echoes'],\n ['dingo', 'dingoes'],\n ['volcano', 'volcanoes'],\n ['tornado', 'tornadoes'],\n ['torpedo', 'torpedoes'],\n // Ends with `us`.\n ['genus', 'genera'],\n ['viscus', 'viscera'],\n // Ends with `ma`.\n ['stigma', 'stigmata'],\n ['stoma', 'stomata'],\n ['dogma', 'dogmata'],\n ['lemma', 'lemmata'],\n ['schema', 'schemata'],\n ['anathema', 'anathemata'],\n // Other irregular rules.\n ['ox', 'oxen'],\n ['axe', 'axes'],\n ['die', 'dice'],\n ['yes', 'yeses'],\n ['foot', 'feet'],\n ['eave', 'eaves'],\n ['goose', 'geese'],\n ['tooth', 'teeth'],\n ['quiz', 'quizzes'],\n ['human', 'humans'],\n ['proof', 'proofs'],\n ['carve', 'carves'],\n ['valve', 'valves'],\n ['looey', 'looies'],\n ['thief', 'thieves'],\n ['groove', 'grooves'],\n ['pickaxe', 'pickaxes'],\n ['whiskey', 'whiskies']\n ].forEach(function (rule) {\n return pluralize.addIrregularRule(rule[0], rule[1]);\n });\n\n /**\n * Pluralization rules.\n */\n [\n [/s?$/i, 's'],\n [/[^\\u0000-\\u007F]$/i, '$0'],\n [/([^aeiou]ese)$/i, '$1'],\n [/(ax|test)is$/i, '$1es'],\n [/(alias|[^aou]us|tlas|gas|ris)$/i, '$1es'],\n [/(e[mn]u)s?$/i, '$1s'],\n [/([^l]ias|[aeiou]las|[emjzr]as|[iu]am)$/i, '$1'],\n [/(alumn|syllab|octop|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i, '$1i'],\n [/(alumn|alg|vertebr)(?:a|ae)$/i, '$1ae'],\n [/(seraph|cherub)(?:im)?$/i, '$1im'],\n [/(her|at|gr)o$/i, '$1oes'],\n [/(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|automat|quor)(?:a|um)$/i, '$1a'],\n [/(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)(?:a|on)$/i, '$1a'],\n [/sis$/i, 'ses'],\n [/(?:(kni|wi|li)fe|(ar|l|ea|eo|oa|hoo)f)$/i, '$1$2ves'],\n [/([^aeiouy]|qu)y$/i, '$1ies'],\n [/([^ch][ieo][ln])ey$/i, '$1ies'],\n [/(x|ch|ss|sh|zz)$/i, '$1es'],\n [/(matr|cod|mur|sil|vert|ind|append)(?:ix|ex)$/i, '$1ices'],\n [/(m|l)(?:ice|ouse)$/i, '$1ice'],\n [/(pe)(?:rson|ople)$/i, '$1ople'],\n [/(child)(?:ren)?$/i, '$1ren'],\n [/eaux$/i, '$0'],\n [/m[ae]n$/i, 'men'],\n ['thou', 'you']\n ].forEach(function (rule) {\n return pluralize.addPluralRule(rule[0], rule[1]);\n });\n\n /**\n * Singularization rules.\n */\n [\n [/s$/i, ''],\n [/(ss)$/i, '$1'],\n [/(wi|kni|(?:after|half|high|low|mid|non|night|[^\\w]|^)li)ves$/i, '$1fe'],\n [/(ar|(?:wo|[ae])l|[eo][ao])ves$/i, '$1f'],\n [/ies$/i, 'y'],\n [/\\b([pl]|zomb|(?:neck|cross)?t|coll|faer|food|gen|goon|group|lass|talk|goal|cut)ies$/i, '$1ie'],\n [/\\b(mon|smil)ies$/i, '$1ey'],\n [/(m|l)ice$/i, '$1ouse'],\n [/(seraph|cherub)im$/i, '$1'],\n [/(x|ch|ss|sh|zz|tto|go|cho|alias|[^aou]us|tlas|gas|(?:her|at|gr)o|ris)(?:es)?$/i, '$1'],\n [/(analy|ba|diagno|parenthe|progno|synop|the|empha|cri)(?:sis|ses)$/i, '$1sis'],\n [/(movie|twelve|abuse|e[mn]u)s$/i, '$1'],\n [/(test)(?:is|es)$/i, '$1is'],\n [/(alumn|syllab|octop|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i, '$1us'],\n [/(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|quor)a$/i, '$1um'],\n [/(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)a$/i, '$1on'],\n [/(alumn|alg|vertebr)ae$/i, '$1a'],\n [/(cod|mur|sil|vert|ind)ices$/i, '$1ex'],\n [/(matr|append)ices$/i, '$1ix'],\n [/(pe)(rson|ople)$/i, '$1rson'],\n [/(child)ren$/i, '$1'],\n [/(eau)x?$/i, '$1'],\n [/men$/i, 'man']\n ].forEach(function (rule) {\n return pluralize.addSingularRule(rule[0], rule[1]);\n });\n\n /**\n * Uncountable rules.\n */\n [\n // Singular words with no plurals.\n 'adulthood',\n 'advice',\n 'agenda',\n 'aid',\n 'alcohol',\n 'ammo',\n 'anime',\n 'athletics',\n 'audio',\n 'bison',\n 'blood',\n 'bream',\n 'buffalo',\n 'butter',\n 'carp',\n 'cash',\n 'chassis',\n 'chess',\n 'clothing',\n 'cod',\n 'commerce',\n 'cooperation',\n 'corps',\n 'debris',\n 'diabetes',\n 'digestion',\n 'elk',\n 'energy',\n 'equipment',\n 'excretion',\n 'expertise',\n 'flounder',\n 'fun',\n 'gallows',\n 'garbage',\n 'graffiti',\n 'headquarters',\n 'health',\n 'herpes',\n 'highjinks',\n 'homework',\n 'housework',\n 'information',\n 'jeans',\n 'justice',\n 'kudos',\n 'labour',\n 'literature',\n 'machinery',\n 'mackerel',\n 'mail',\n 'media',\n 'mews',\n 'moose',\n 'music',\n 'manga',\n 'news',\n 'pike',\n 'plankton',\n 'pliers',\n 'pollution',\n 'premises',\n 'rain',\n 'research',\n 'rice',\n 'salmon',\n 'scissors',\n 'series',\n 'sewage',\n 'shambles',\n 'shrimp',\n 'species',\n 'staff',\n 'swine',\n 'tennis',\n 'traffic',\n 'transporation',\n 'trout',\n 'tuna',\n 'wealth',\n 'welfare',\n 'whiting',\n 'wildebeest',\n 'wildlife',\n 'you',\n // Regexes.\n /[^aeiou]ese$/i, // \"chinese\", \"japanese\"\n /deer$/i, // \"deer\", \"reindeer\"\n /fish$/i, // \"fish\", \"blowfish\", \"angelfish\"\n /measles$/i,\n /o[iu]s$/i, // \"carnivorous\"\n /pox$/i, // \"chickpox\", \"smallpox\"\n /sheep$/i\n ].forEach(pluralize.addUncountableRule);\n\n return pluralize;\n});\n\n", - "define('core/dfn',[\"exports\", \"deps/pluralize\", \"core/utils\"], function (exports, _pluralize, _utils) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n // Module core/dfn\n // - Finds all <dfn> elements and populates conf.definitionMap to identify them.\n // - Adds data-lt based automatic pluralization, if enabled\n const name = exports.name = \"core/dfn\";\n\n function run(conf) {\n if (!conf.hasOwnProperty(\"definitionMap\")) {\n conf.definitionMap = Object.create(null);\n }\n\n let pluralizeDfn;\n if (conf.pluralize === true) {\n // prevent pluralize booting overhead if not needed\n pluralizeDfn = autoPluralizeDfns();\n }\n\n document.querySelectorAll(\"dfn\").forEach(dfn => {\n const closestDfn = dfn.closest(\"[data-dfn-for]\");\n if (closestDfn && closestDfn !== dfn && !dfn.dataset.dfnFor) {\n dfn.dataset.dfnFor = closestDfn.dataset.dfnFor;\n }\n if (dfn.dataset.dfnFor) {\n dfn.dataset.dfnFor = dfn.dataset.dfnFor.toLowerCase();\n }\n // TODO: dfn's are tragically jquery'ed and stored. Should fix this.\n // Also, we should probably use weakmaps and weaksets here\n // to avoid leaks.\n const $dfn = $(dfn);\n const dfnTitles = $dfn.getDfnTitles({ isDefinition: true });\n\n // add automatic pluralization to `data-lt` attributes\n // see https://github.com/w3c/respec/pull/1682\n if (pluralizeDfn && !dfn.hasAttribute(\"data-lt-no-plural\") && !dfn.hasAttribute(\"data-lt-noDefault\")) {\n const normText = (0, _utils.norm)(dfn.textContent).toLowerCase();\n const plural = pluralizeDfn(normText);\n if (plural) {\n if (dfnTitles[0] === normText) {\n // if normText is first `dfnTitles`, then use plural as `id`\n dfnTitles.unshift(plural);\n } else {\n // otherwise, to prevent breaking exising links,\n // first data-lt is used as `id`\n dfnTitles.push(plural);\n }\n dfn.dataset.lt = dfnTitles.filter(title => title !== normText).join(\"|\");\n }\n }\n\n dfnTitles.map(dfnTitle => {\n if (!conf.definitionMap[dfnTitle]) {\n conf.definitionMap[dfnTitle] = [];\n }\n return conf.definitionMap[dfnTitle];\n }).reduce(($dfn, dfnTitleContainer) => {\n dfnTitleContainer.push($dfn);\n return $dfn;\n }, $dfn);\n });\n }\n\n function autoPluralizeDfns() {\n const links = new Set();\n document.querySelectorAll(\"a:not([href])\").forEach(el => {\n const normText = (0, _utils.norm)(el.textContent).toLowerCase();\n links.add(normText);\n if (el.dataset.lt) {\n links.add(el.dataset.lt);\n }\n });\n\n const dfns = new Set();\n document.querySelectorAll(\"dfn:not([data-lt-noDefault])\").forEach(dfn => {\n const normText = (0, _utils.norm)(dfn.textContent).toLowerCase();\n dfns.add(normText);\n if (dfn.dataset.lt) {\n dfn.dataset.lt.split(\"|\").reduce((dfns, lt) => dfns.add(lt), dfns);\n }\n });\n\n // returns pluralized term if `text` needs pluralization, \"\" otherwise\n return function pluralizeDfn(text) {\n const plural = (0, _pluralize.plural)(text);\n return links.has(plural) && !dfns.has(plural) ? plural : \"\";\n };\n }\n});\n//# sourceMappingURL=dfn.js.map;\n", - "define('w3c/rfc2119',[\"exports\", \"core/utils\"], function (exports, _utils) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"w3c/rfc2119\"; // Module w3c/rfc2119\n // update the 2119 terms section with the terms actually used\n\n function run(conf, doc, cb) {\n const confo = doc.getElementById(\"respecRFC2119\");\n if (!confo) {\n return cb();\n }\n // do we have a list of used RFC2119 items in\n // conf.respecRFC2119\n const terms = Object.getOwnPropertyNames(conf.respecRFC2119);\n\n // there are no terms used - remove the clause\n if (terms.length === 0) {\n confo.remove();\n return cb();\n }\n\n // put in the 2119 clause and reference\n const html = (0, _utils.joinAnd)(terms.sort(), item => `<em class=\"rfc2119\">${item}</em>`);\n const plural = terms.length > 1;\n const str = `The key word${plural ? \"s \" : \" \"} ${html} ${plural ? \"are\" : \"is\"} ${confo.innerHTML}`;\n confo.innerHTML = str;\n cb();\n }\n});\n//# sourceMappingURL=rfc2119.js.map;\n", - "\ndefine('deps/text!core/css/examples.css',[],function () { return '/* --- EXAMPLES --- */\\ndiv.example-title {\\n min-width: 7.5em;\\n color: #b9ab2d;\\n}\\ndiv.example-title span {\\n text-transform: uppercase;\\n}\\naside.example, div.example, div.illegal-example {\\n padding: 0.5em;\\n margin: 1em 0;\\n position: relative;\\n clear: both;\\n}\\ndiv.illegal-example { color: red }\\ndiv.illegal-example p { color: black }\\naside.example, div.example {\\n padding: .5em;\\n border-left-width: .5em;\\n border-left-style: solid;\\n border-color: #e0cb52;\\n background: #fcfaee;\\n}\\n\\naside.example div.example {\\n border-left-width: .1em;\\n border-color: #999;\\n background: #fff;\\n}\\naside.example div.example div.example-title {\\n color: #999;\\n}\\n';});\n\n", - "define('core/examples',[\"exports\", \"core/pubsubhub\", \"deps/text!core/css/examples.css\"], function (exports, _pubsubhub, _examples) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _examples2 = _interopRequireDefault(_examples);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n // Module core/examples\n // Manages examples, including marking them up, numbering, inserting the title,\n // and reindenting.\n // Examples are any pre element with class \"example\" or \"illegal-example\".\n // When an example is found, it is reported using the \"example\" event. This can\n // be used by a containing shell to extract all examples.\n\n const name = exports.name = \"core/examples\";\n\n var makeTitle = function (conf, $el, num, report) {\n var txt = num > 0 ? \" \" + num : \"\";\n var $tit = $(`<div class='example-title'><span>${conf.l10n.example}${txt}</span></div>`);\n report.title = $el.attr(\"title\");\n if (report.title) {\n $tit.append($(\"<span style='text-transform: none'>: \" + report.title + \"</span>\"));\n $el.removeAttr(\"title\");\n }\n $tit.addClass(\"marker\");\n return $tit;\n };\n\n function run(conf, doc, cb) {\n var $exes = $(\"pre.example, pre.illegal-example, aside.example\"),\n num = 0;\n if ($exes.length) {\n $(doc).find(\"head link\").first().before($(\"<style/>\").text(_examples2.default));\n $exes.each(function (i, ex) {\n var $ex = $(ex),\n report = { number: num, illegal: $ex.hasClass(\"illegal-example\") };\n if ($ex.is(\"aside\")) {\n num++;\n var $tit = makeTitle(conf, $ex, num, report);\n $ex.prepend($tit);\n (0, _pubsubhub.pub)(\"example\", report);\n } else {\n var inAside = !!$ex.parents(\"aside\").length;\n if (!inAside) num++;\n // reindent\n var lines = $ex.html().split(\"\\n\");\n while (lines.length && /^\\s*$/.test(lines[0])) lines.shift();\n while (lines.length && /^\\s*$/.test(lines[lines.length - 1])) lines.pop();\n var matches = /^(\\s+)/.exec(lines[0]);\n if (matches) {\n var rep = new RegExp(\"^\" + matches[1]);\n for (var j = 0; j < lines.length; j++) {\n lines[j] = lines[j].replace(rep, \"\");\n }\n }\n report.content = lines.join(\"\\n\");\n $ex.html(lines.join(\"\\n\"));\n $ex.removeClass(\"example illegal-example\");\n // wrap\n var $div = $(\"<div class='example'></div>\"),\n $tit = makeTitle(conf, $ex, inAside ? 0 : num, report);\n $div.append($tit);\n $div.append($ex.clone());\n $ex.replaceWith($div);\n if (!inAside) (0, _pubsubhub.pub)(\"example\", report);\n }\n });\n }\n cb();\n }\n});\n//# sourceMappingURL=examples.js.map;\n", - "\ndefine('deps/text!core/css/issues-notes.css',[],function () { return '/* --- ISSUES/NOTES --- */\\ndiv.issue-title, div.note-title , div.ednote-title, div.warning-title {\\n padding-right: 1em;\\n min-width: 7.5em;\\n color: #b9ab2d;\\n}\\ndiv.issue-title { color: #e05252; }\\ndiv.note-title, div.ednote-title { color: #2b2; }\\ndiv.warning-title { color: #f22; }\\ndiv.issue-title span, div.note-title span, div.ednote-title span, div.warning-title span {\\n text-transform: uppercase;\\n}\\ndiv.note, div.issue, div.ednote, div.warning {\\n margin-top: 1em;\\n margin-bottom: 1em;\\n}\\n.note > p:first-child, .ednote > p:first-child, .issue > p:first-child, .warning > p:first-child { margin-top: 0 }\\n.issue, .note, .ednote, .warning {\\n padding: .5em;\\n border-left-width: .5em;\\n border-left-style: solid;\\n}\\ndiv.issue, div.note , div.ednote, div.warning {\\n padding: 1em 1.2em 0.5em;\\n margin: 1em 0;\\n position: relative;\\n clear: both;\\n}\\nspan.note, span.ednote, span.issue, span.warning { padding: .1em .5em .15em; }\\n\\n.issue {\\n border-color: #e05252;\\n background: #fbe9e9;\\n}\\n.note, .ednote {\\n border-color: #52e052;\\n background: #e9fbe9;\\n}\\n\\n.warning {\\n border-color: #f11;\\n border-width: .2em;\\n border-style: solid;\\n background: #fbe9e9;\\n}\\n\\n.warning-title:before{\\n content: \"⚠\"; /*U+26A0 WARNING SIGN*/\\n font-size: 3em;\\n float: left;\\n height: 100%;\\n padding-right: .3em;\\n vertical-align: top;\\n margin-top: -0.5em;\\n}\\n\\nli.task-list-item {\\n list-style: none;\\n}\\n\\ninput.task-list-item-checkbox {\\n margin: 0 0.35em 0.25em -1.6em;\\n vertical-align: middle;\\n}\\n\\n.issue a.respec-gh-label {\\n padding: 5px;\\n margin: 0 2px 0 2px;\\n font-size: 10px;\\n text-transform: none;\\n text-decoration: none;\\n font-weight: bold;\\n border-radius: 4px;\\n position: relative;\\n bottom: 2px;\\n}\\n\\n.issue a.respec-label-dark {\\n color: #fff;\\n background-color: #000;\\n}\\n\\n.issue a.respec-label-light {\\n color: #000;\\n background-color: #fff;\\n}\\n';});\n\n", - "define('core/issues-notes',[\"exports\", \"core/pubsubhub\", \"deps/text!core/css/issues-notes.css\", \"core/utils\", \"deps/hyperhtml\"], function (exports, _pubsubhub, _issuesNotes, _utils) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _issuesNotes2 = _interopRequireDefault(_issuesNotes);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n const name = exports.name = \"core/issues-notes\";\n\n const MAX_GITHUB_REQUESTS = 60;\n\n function handleIssues(ins, ghIssues, conf) {\n const $ins = $(ins);\n const { issueBase, githubAPI } = conf;\n var hasDataNum = !!document.querySelector(\".issue[data-number]\"),\n issueNum = 0,\n $issueSummary = $(\"<div><h2>\" + conf.l10n.issue_summary + \"</h2><ul></ul></div>\"),\n $issueList = $issueSummary.find(\"ul\");\n if (githubAPI) {\n Array.from($ins).filter(({ dataset: { number: value } }) => value !== undefined && ghIssues.get(Number(value)).state === \"closed\").forEach(issue => {\n const {\n dataset: { number }\n } = issue;\n const msg = `Github issue ${number} was closed on GitHub, so removing from spec`;\n (0, _pubsubhub.pub)(\"warn\", msg);\n issue.remove();\n });\n }\n $ins.filter((i, issue) => issue.parentNode).each(function (i, inno) {\n var $inno = $(inno),\n isIssue = $inno.hasClass(\"issue\"),\n isWarning = $inno.hasClass(\"warning\"),\n isEdNote = $inno.hasClass(\"ednote\"),\n isFeatureAtRisk = $inno.hasClass(\"atrisk\"),\n isInline = $inno[0].localName === \"span\",\n dataNum = $inno.attr(\"data-number\"),\n report = {\n inline: isInline\n };\n report.type = isIssue ? \"issue\" : isWarning ? \"warning\" : isEdNote ? \"ednote\" : \"note\";\n if (isIssue && !isInline && !hasDataNum) {\n issueNum++;\n report.number = issueNum;\n } else if (dataNum) {\n report.number = dataNum;\n }\n // wrap\n if (!isInline) {\n var $div = $(\"<div class='\" + report.type + (isFeatureAtRisk ? \" atrisk\" : \"\") + \"'></div>\"),\n $tit = $(\"<div role='heading' class='\" + report.type + \"-title'><span></span></div>\"),\n text = isIssue ? isFeatureAtRisk ? conf.l10n.feature_at_risk : conf.l10n.issue : isWarning ? conf.l10n.warning : isEdNote ? conf.l10n.editors_note : conf.l10n.note,\n ghIssue;\n if (inno.id) {\n $div[0].id = inno.id;\n inno.removeAttribute(\"id\");\n } else {\n $div.makeID(\"issue-container\", report.number ? `number-${report.number}` : \"\");\n }\n $tit.makeID(\"h\", report.type);\n report.title = $inno.attr(\"title\");\n if (isIssue) {\n if (hasDataNum) {\n if (dataNum) {\n text += \" \" + dataNum;\n // Set issueBase to cause issue to be linked to the external issue tracker\n if (!isFeatureAtRisk && issueBase) {\n $tit.find(\"span\").wrap($(\"<a href='\" + issueBase + dataNum + \"'/>\"));\n } else if (isFeatureAtRisk && conf.atRiskBase) {\n $tit.find(\"span\").wrap($(\"<a href='\" + conf.atRiskBase + dataNum + \"'/>\"));\n }\n ghIssue = ghIssues.get(Number(dataNum));\n if (ghIssue && !report.title) {\n report.title = ghIssue.title;\n }\n }\n } else {\n text += \" \" + issueNum;\n }\n if (report.number !== undefined) {\n // Add entry to #issue-summary.\n var $li = $(\"<li><a></a></li>\");\n var $a = $li.find(\"a\");\n $a.attr(\"href\", \"#\" + $div[0].id).text(conf.l10n.issue + \" \" + report.number);\n if (report.title) {\n $li.append($(\"<span style='text-transform: none'>: \" + report.title + \"</span>\"));\n }\n $issueList.append($li);\n }\n }\n $tit.find(\"span\").text(text);\n if (ghIssue && report.title && githubAPI) {\n const labelsGroup = Array.from(ghIssue.labels).map(label => {\n const issuesURL = new URL(\"issues/\", conf.github.repoURL + \"/\");\n issuesURL.searchParams.set(\"q\", `is:issue is:open label:\"${label.name}\"`);\n return _extends({}, label, {\n href: issuesURL.href\n });\n }).map(createLabel).reduce((frag, labelElem) => {\n frag.appendChild(labelElem);\n return frag;\n }, document.createDocumentFragment());\n $tit.append($(\"<span style='text-transform: none'>: \" + report.title + \"</span>\").append(labelsGroup));\n $inno.removeAttr(\"title\");\n } else if (report.title) {\n $tit.append($(\"<span style='text-transform: none'>: \" + report.title + \"</span>\"));\n $inno.removeAttr(\"title\");\n }\n $tit.addClass(\"marker\");\n $div.append($tit);\n $inno.replaceWith($div);\n var body = $inno.removeClass(report.type).removeAttr(\"data-number\");\n if (ghIssue && !body.text().trim()) {\n body = ghIssue.body_html;\n }\n $div.append(body);\n const level = $tit.parents(\"section\").length + 2;\n $tit.attr(\"aria-level\", level);\n }\n (0, _pubsubhub.pub)(report.type, report);\n });\n if ($(\".issue\").length) {\n if ($(\"#issue-summary\")) $(\"#issue-summary\").append($issueSummary.contents());\n } else if ($(\"#issue-summary\").length) {\n (0, _pubsubhub.pub)(\"warn\", \"Using issue summary (#issue-summary) but no issues found.\");\n $(\"#issue-summary\").remove();\n }\n }\n\n async function fetchAndStoreGithubIssues(conf) {\n const { githubAPI, githubUser, githubToken } = conf;\n const specIssues = document.querySelectorAll(\".issue[data-number]\");\n if (specIssues.length > MAX_GITHUB_REQUESTS) {\n const msg = `Your spec contains ${specIssues.length} Github issues, ` + `but GitHub only allows ${MAX_GITHUB_REQUESTS} requests. Some issues might not show up.`;\n (0, _pubsubhub.pub)(\"warning\", msg);\n }\n const issuePromises = [...specIssues].map(elem => Number.parseInt(elem.dataset.number, 10)).filter(issueNumber => issueNumber).map(async issueNumber => {\n const issueURL = `${githubAPI}/issues/${issueNumber}`;\n const headers = {\n // Get back HTML content instead of markdown\n // See: https://developer.github.com/v3/media/\n Accept: \"application/vnd.github.v3.html+json\"\n };\n if (githubUser && githubToken) {\n const credentials = btoa(`${githubUser}:${githubToken}`);\n const Authorization = `Basic ${credentials}`;\n Object.assign(headers, { Authorization });\n }\n const request = new Request(issueURL, {\n headers\n });\n const response = await (0, _utils.fetchAndCache)(request);\n return processResponse(response, issueNumber);\n });\n const issues = await Promise.all(issuePromises);\n return new Map(issues);\n }\n\n function isLight(rgb) {\n const red = rgb >> 16 & 0xff;\n const green = rgb >> 8 & 0xff;\n const blue = rgb >> 0 & 0xff;\n const illumination = 0.2126 * red + 0.7152 * green + 0.0722 * blue;\n return illumination > 140;\n }\n\n function createLabel(label) {\n const { color, href, name } = label;\n const rgb = parseInt(color, 16);\n const textColorClass = isNaN(rgb) || isLight(rgb) ? \"light\" : \"dark\";\n const cssClasses = `respec-gh-label respec-label-${textColorClass}`;\n const style = `background-color: #${color}`;\n return hyperHTML`<a\n class=\"${cssClasses}\"\n style=\"${style}\"\n href=\"${href}\">${name}</a>`;\n }\n\n async function processResponse(response, issueNumber) {\n // \"message\" is always error message from GitHub\n const issue = { title: \"\", number: issueNumber, state: \"\", message: \"\" };\n try {\n const json = await response.json();\n Object.assign(issue, json);\n } catch (err) {\n issue.message = `Error JSON parsing issue #${issueNumber} from GitHub.`;\n }\n if (!response.ok || issue.message) {\n const msg = `Error fetching issue #${issueNumber} from GitHub. ${issue.message} (HTTP Status ${response.status}).`;\n (0, _pubsubhub.pub)(\"error\", msg);\n }\n return [issueNumber, issue];\n }\n\n async function run(conf) {\n const issuesAndNotes = document.querySelectorAll(\".issue, .note, .warning, .ednote\");\n if (!issuesAndNotes.length) {\n return; // nothing to do.\n }\n const ghIssues = conf.githubAPI ? await fetchAndStoreGithubIssues(conf) : new Map();\n const { head: headElem } = document;\n headElem.insertBefore(hyperHTML`<style>${[_issuesNotes2.default]}</style>`, headElem.querySelector(\"link\"));\n handleIssues(issuesAndNotes, ghIssues, conf);\n }\n});\n//# sourceMappingURL=issues-notes.js.map;\n", - "define('core/requirements',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"core/requirements\"; // Module core/requirements\n // This module does two things:\n //\n // 1. It finds and marks all requirements. These are elements with class \"req\".\n // When a requirement is found, it is reported using the \"req\" event. This\n // can be used by a containing shell to extract them.\n // Requirements are automatically numbered.\n //\n // 2. It allows referencing requirements by their ID simply using an empty <a>\n // element with its href pointing to the requirement it should be referencing\n // and a class of \"reqRef\".\n function run(conf, doc, cb) {\n $(\".req\").each(function (i) {\n i++;\n var $req = $(this);\n var title = \"Req. \" + i;\n $req.prepend(\"<a href='#\" + $req.attr(\"id\") + \"'>\" + title + \"</a>: \");\n });\n\n $(\"a.reqRef\").each(function () {\n var $ref = $(this),\n href = $ref.attr(\"href\"),\n id,\n $req,\n txt;\n if (!href) return;\n id = href.substring(1);\n $req = $(\"#\" + id);\n if ($req.length) {\n txt = $req.find(\"> a\").text();\n } else {\n txt = \"Req. not found '\" + id + \"'\";\n (0, _pubsubhub.pub)(\"error\", \"Requirement not found in element `a.reqRef`: \" + id);\n }\n $ref.text(txt);\n });\n cb();\n }\n});\n//# sourceMappingURL=requirements.js.map;\n", - "\ndefine('deps/text!core/css/bp.css',[],function () { return '/* --- Best Practices --- */\\ndiv.practice {\\n border: solid #bebebe 1px;\\n margin: 2em 1em 1em 2em;\\n}\\n\\nspan.practicelab {\\n margin: 1.5em 0.5em 1em 1em;\\n font-weight: bold;\\n font-style: italic;\\n background: #dfffff;\\n position: relative;\\n padding: 0 0.5em;\\n top: -1.5em;\\n}\\n\\np.practicedesc {\\n margin: 1.5em 0.5em 1em 1em;\\n}\\n\\n@media screen {\\n p.practicedesc {\\n position: relative;\\n top: -2em;\\n padding: 0;\\n margin: 1.5em 0.5em -1em 1em;\\n }\\n}\\n';});\n\n", - "define('core/best-practices',[\"exports\", \"deps/text!core/css/bp.css\", \"core/pubsubhub\", \"deps/hyperhtml\"], function (exports, _bp, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _bp2 = _interopRequireDefault(_bp);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n const name = exports.name = \"core/best-practices\"; // Module core/best-practices\n // Handles the marking up of best practices, and can generate a summary of all of them.\n // The summary is generated if there is a section in the document with ID bp-summary.\n // Best practices are marked up with span.practicelab.\n function run() {\n let num = 0;\n const bps = document.querySelectorAll(\"span.practicelab\");\n const ul = document.createElement(\"ul\");\n for (const bp of Array.from(bps)) {\n num++;\n const id = window.$.fn.makeID.call([bp], \"bp\");\n const li = hyperHTML`<li><a href=\"${`#${id}`}\">Best Practice ${num}</a>: ${bp.textContent}</li>`;\n ul.appendChild(li);\n bp.insertBefore(document.createTextNode(`Best Practice ${num}: `), bp.firstChild);\n }\n const bpSummary = document.getElementById(\"bp-summary\");\n if (bps.length) {\n document.head.insertBefore(hyperHTML`<style>${[_bp2.default]}</style>`, document.head.querySelector(\"link\"));\n if (bpSummary) {\n bpSummary.appendChild(hyperHTML`<h2>Best Practices Summary</h2>`);\n bpSummary.appendChild(ul);\n }\n } else if (bpSummary) {\n (0, _pubsubhub.pub)(\"warn\", \"Using best practices summary (#bp-summary) but no best practices found.\");\n bpSummary.remove();\n }\n }\n});\n//# sourceMappingURL=best-practices.js.map;\n", - "define('core/figures',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"core/figures\"; // Module core/figure\n // Handles figures in the document.\n // Adds width and height to images, if they are missing.\n // Generates a Table of Figures wherever there is a #tof element.\n\n function run(conf, doc, cb) {\n normalizeImages(doc);\n // process all figures\n var figMap = {},\n tof = [],\n num = 0;\n $(\"figure\").each(function () {\n var $fig = $(this),\n $cap = $fig.find(\"figcaption\"),\n tit = $cap.text(),\n id = $fig.makeID(\"fig\", tit);\n if (!$cap.length) (0, _pubsubhub.pub)(\"warn\", \"A `<figure>` should contain a `<figcaption>`.\");\n\n // set proper caption title\n num++;\n $cap.wrapInner($(\"<span class='fig-title'/>\")).prepend(doc.createTextNode(\" \")).prepend($(\"<span class='figno'>\" + num + \"</span>\")).prepend(doc.createTextNode(conf.l10n.fig));\n figMap[id] = $cap.contents();\n var $tofCap = $cap.clone();\n $tofCap.find(\"a\").renameElement(\"span\").removeAttr(\"href\");\n tof.push($(\"<li class='tofline'><a class='tocxref' href='#\" + id + \"'></a></li>\").find(\".tocxref\").append($tofCap.contents()).end());\n });\n\n // Update all anchors with empty content that reference a figure ID\n $(\"a[href]\", doc).each(function () {\n var $a = $(this),\n id = $a.attr(\"href\");\n if (!id) return;\n id = id.substring(1);\n if (figMap[id]) {\n $a.addClass(\"fig-ref\");\n if ($a.html() === \"\") {\n const $shortFigDescriptor = figMap[id].slice(0, 2).clone();\n if (!$a[0].hasAttribute(\"title\")) {\n const longFigDescriptor = figMap[id].slice(2).clone().text();\n $a.attr(\"title\", longFigDescriptor.trim());\n }\n $a.append($shortFigDescriptor);\n }\n }\n });\n\n // Create a Table of Figures if a section with id 'tof' exists.\n var $tof = $(\"#tof\", doc);\n if (tof.length && $tof.length) {\n // if it has a parent section, don't touch it\n // if it has a class of appendix or introductory, don't touch it\n // if all the preceding section siblings are introductory, make it introductory\n // if there is a preceding section sibling which is an appendix, make it appendix\n if (!$tof.hasClass(\"appendix\") && !$tof.hasClass(\"introductory\") && !$tof.parents(\"section\").length) {\n if ($tof.prevAll(\"section.introductory\").length === $tof.prevAll(\"section\").length) {\n $tof.addClass(\"introductory\");\n } else if ($tof.prevAll(\"appendix\").length) {\n $tof.addClass(\"appendix\");\n }\n }\n $tof.append($(\"<h2>\" + conf.l10n.table_of_fig + \"</h2>\"));\n $tof.append($(\"<ul class='tof'/>\"));\n var $ul = $tof.find(\"ul\");\n while (tof.length) $ul.append(tof.shift());\n }\n cb();\n }\n\n function normalizeImages(doc) {\n [...doc.querySelectorAll(\":not(picture)>img:not([width]):not([height]):not([srcset])\")].forEach(img => {\n img.height = img.naturalHeight;\n img.width = img.naturalWidth;\n });\n }\n});\n//# sourceMappingURL=figures.js.map;\n", - "\"use strict\";\r\n\r\n(() => {\r\n // These regular expressions use the sticky flag so they will only match at\r\n // the current location (ie. the offset of lastIndex).\r\n const tokenRe = {\r\n // This expression uses a lookahead assertion to catch false matches\r\n // against integers early.\r\n \"float\": /-?(?=[0-9]*\\.|[0-9]+[eE])(([0-9]+\\.[0-9]*|[0-9]*\\.[0-9]+)([Ee][-+]?[0-9]+)?|[0-9]+[Ee][-+]?[0-9]+)/y,\r\n \"integer\": /-?(0([Xx][0-9A-Fa-f]+|[0-7]*)|[1-9][0-9]*)/y,\r\n \"identifier\": /[A-Z_a-z][0-9A-Z_a-z-]*/y,\r\n \"string\": /\"[^\"]*\"/y,\r\n \"whitespace\": /[\\t\\n\\r ]+/y,\r\n \"comment\": /((\\/(\\/.*|\\*([^*]|\\*[^\\/])*\\*\\/)[\\t\\n\\r ]*)+)/y,\r\n \"other\": /[^\\t\\n\\r 0-9A-Z_a-z]/y\r\n };\r\n\r\n function attemptTokenMatch(str, type, lastIndex, tokens) {\r\n const re = tokenRe[type];\r\n re.lastIndex = lastIndex;\r\n const result = re.exec(str);\r\n if (result) {\r\n tokens.push({ type, value: result[0] });\r\n return re.lastIndex;\r\n }\r\n return -1;\r\n }\r\n\r\n function tokenise(str) {\r\n const tokens = [];\r\n let lastIndex = 0;\r\n while (lastIndex < str.length) {\r\n const nextChar = str.charAt(lastIndex);\r\n let result = -1;\r\n if (/[-0-9.]/.test(nextChar)) {\r\n result = attemptTokenMatch(str, \"float\", lastIndex, tokens);\r\n if (result === -1) {\r\n result = attemptTokenMatch(str, \"integer\", lastIndex, tokens);\r\n }\r\n if (result === -1) {\r\n // '-' and '.' can also match \"other\".\r\n result = attemptTokenMatch(str, \"other\", lastIndex, tokens);\r\n }\r\n } else if (/[A-Z_a-z]/.test(nextChar)) {\r\n result = attemptTokenMatch(str, \"identifier\", lastIndex, tokens);\r\n } else if (nextChar === '\"') {\r\n result = attemptTokenMatch(str, \"string\", lastIndex, tokens);\r\n if (result === -1) {\r\n // '\"' can also match \"other\".\r\n result = attemptTokenMatch(str, \"other\", lastIndex, tokens);\r\n }\r\n } else if (/[\\t\\n\\r ]/.test(nextChar)) {\r\n result = attemptTokenMatch(str, \"whitespace\", lastIndex, tokens);\r\n } else if (nextChar === '/') {\r\n result = attemptTokenMatch(str, \"comment\", lastIndex, tokens);\r\n if (result === -1) {\r\n // '/' can also match \"other\".\r\n result = attemptTokenMatch(str, \"other\", lastIndex, tokens);\r\n }\r\n } else {\r\n result = attemptTokenMatch(str, \"other\", lastIndex, tokens);\r\n }\r\n if (result === -1) {\r\n throw new Error(\"Token stream not progressing\");\r\n }\r\n lastIndex = result;\r\n }\r\n return tokens;\r\n }\r\n\r\n class WebIDLParseError {\r\n constructor(str, line, input, tokens) {\r\n this.message = str;\r\n this.line = line;\r\n this.input = input;\r\n this.tokens = tokens;\r\n }\r\n\r\n toString() {\r\n return `${this.message}, line ${this.line} (tokens: '${this.input}')\\n${JSON.stringify(this.tokens, null, 4)}`;\r\n }\r\n }\r\n\r\n function parse(tokens, opt) {\r\n let line = 1;\r\n tokens = tokens.slice();\r\n const names = new Map();\r\n let current = null;\r\n\r\n const FLOAT = \"float\";\r\n const INT = \"integer\";\r\n const ID = \"identifier\";\r\n const STR = \"string\";\r\n const OTHER = \"other\";\r\n\r\n const EMPTY_OPERATION = Object.freeze({\r\n type: \"operation\",\r\n getter: false,\r\n setter: false,\r\n deleter: false,\r\n static: false,\r\n stringifier: false\r\n });\r\n\r\n const EMPTY_IDLTYPE = Object.freeze({\r\n sequence: false,\r\n generic: null,\r\n nullable: false,\r\n union: false,\r\n idlType: null,\r\n extAttrs: []\r\n });\r\n\r\n function error(str) {\r\n let tok = \"\";\r\n let numTokens = 0;\r\n const maxTokens = 5;\r\n while (numTokens < maxTokens && tokens.length > numTokens) {\r\n tok += tokens[numTokens].value;\r\n numTokens++;\r\n }\r\n\r\n let message;\r\n if (current) {\r\n message = `Got an error during or right after parsing \\`${current.partial ? \"partial \" : \"\"}${current.type} ${current.name}\\`: ${str}`\r\n }\r\n else {\r\n // throwing before any valid definition\r\n message = `Got an error before parsing any named definition: ${str}`;\r\n }\r\n\r\n throw new WebIDLParseError(message, line, tok, tokens.slice(0, maxTokens));\r\n }\r\n\r\n function sanitize_name(name, type) {\r\n if (names.has(name)) {\r\n error(`The name \"${name}\" of type \"${names.get(name)}\" is already seen`);\r\n }\r\n names.set(name, type);\r\n return name;\r\n }\r\n\r\n let last_token = null;\r\n\r\n function consume(type, value) {\r\n if (!tokens.length || tokens[0].type !== type) return;\r\n if (typeof value === \"undefined\" || tokens[0].value === value) {\r\n last_token = tokens.shift();\r\n if (type === ID && last_token.value.startsWith('_'))\r\n last_token.value = last_token.value.substring(1);\r\n return last_token;\r\n }\r\n }\r\n\r\n function count(str, char) {\r\n let total = 0;\r\n for (let i = str.indexOf(char); i !== -1; i = str.indexOf(char, i + 1)) {\r\n ++total;\r\n }\r\n return total;\r\n }\r\n\r\n function ws() {\r\n if (!tokens.length) return;\r\n if (tokens[0].type === \"whitespace\" || tokens[0].type === \"comment\") {\r\n const t = tokens.shift();\r\n line += count(t.value, '\\n');\r\n return t;\r\n }\r\n }\r\n\r\n const all_ws_re = {\r\n \"ws\": /([\\t\\n\\r ]+)/y,\r\n \"line-comment\": /\\/\\/(.*)\\r?\\n?/y,\r\n \"multiline-comment\": /\\/\\*((?:[^*]|\\*[^/])*)\\*\\//y\r\n };\r\n function all_ws(store, pea) { // pea == post extended attribute, tpea = same for types\r\n const t = { type: \"whitespace\", value: \"\" };\r\n while (true) {\r\n const w = ws();\r\n if (!w) break;\r\n t.value += w.value;\r\n }\r\n if (t.value.length > 0) {\r\n if (store) {\r\n let w = t.value;\r\n let lastIndex = 0;\r\n while (lastIndex < w.length) {\r\n let matched = false;\r\n // Servo doesn't support using \"const\" in this construction yet.\r\n // See https://github.com/servo/servo/issues/20231.\r\n // |type| can be made const once Servo supports it.\r\n for (let type in all_ws_re) {\r\n const re = all_ws_re[type];\r\n re.lastIndex = lastIndex;\r\n const result = re.exec(w);\r\n if (result) {\r\n store.push({ type: type + (pea ? (\"-\" + pea) : \"\"), value: result[1] });\r\n matched = true;\r\n lastIndex = re.lastIndex;\r\n break;\r\n }\r\n }\r\n if (!matched)\r\n throw new Error(\"Surprising white space construct.\"); // this shouldn't happen\r\n }\r\n }\r\n return t;\r\n }\r\n }\r\n\r\n function integer_type() {\r\n let ret = \"\";\r\n all_ws();\r\n if (consume(ID, \"unsigned\")) ret = \"unsigned \";\r\n all_ws();\r\n if (consume(ID, \"short\")) return ret + \"short\";\r\n if (consume(ID, \"long\")) {\r\n ret += \"long\";\r\n all_ws();\r\n if (consume(ID, \"long\")) return ret + \" long\";\r\n return ret;\r\n }\r\n if (ret) error(\"Failed to parse integer type\");\r\n }\r\n\r\n function float_type() {\r\n let ret = \"\";\r\n all_ws();\r\n if (consume(ID, \"unrestricted\")) ret = \"unrestricted \";\r\n all_ws();\r\n if (consume(ID, \"float\")) return ret + \"float\";\r\n if (consume(ID, \"double\")) return ret + \"double\";\r\n if (ret) error(\"Failed to parse float type\");\r\n }\r\n\r\n function primitive_type() {\r\n const num_type = integer_type() || float_type();\r\n if (num_type) return num_type;\r\n all_ws();\r\n if (consume(ID, \"boolean\")) return \"boolean\";\r\n if (consume(ID, \"byte\")) return \"byte\";\r\n if (consume(ID, \"octet\")) return \"octet\";\r\n }\r\n\r\n function const_value() {\r\n if (consume(ID, \"true\")) return { type: \"boolean\", value: true };\r\n if (consume(ID, \"false\")) return { type: \"boolean\", value: false };\r\n if (consume(ID, \"null\")) return { type: \"null\" };\r\n if (consume(ID, \"Infinity\")) return { type: \"Infinity\", negative: false };\r\n if (consume(ID, \"NaN\")) return { type: \"NaN\" };\r\n const ret = consume(FLOAT) || consume(INT);\r\n if (ret) return { type: \"number\", value: ret.value };\r\n const tok = consume(OTHER, \"-\");\r\n if (tok) {\r\n if (consume(ID, \"Infinity\")) return { type: \"Infinity\", negative: true };\r\n else tokens.unshift(tok);\r\n }\r\n }\r\n\r\n function type_suffix(obj) {\r\n while (true) {\r\n all_ws();\r\n if (consume(OTHER, \"?\")) {\r\n if (obj.nullable) error(\"Can't nullable more than once\");\r\n obj.nullable = true;\r\n } else return;\r\n }\r\n }\r\n\r\n function single_type(typeName) {\r\n const prim = primitive_type();\r\n const ret = Object.assign({ type: typeName || null }, EMPTY_IDLTYPE);\r\n let name;\r\n let value;\r\n if (prim) {\r\n ret.idlType = prim;\r\n } else if (name = consume(ID)) {\r\n value = name.value;\r\n all_ws();\r\n // Generic types\r\n if (consume(OTHER, \"<\")) {\r\n // backwards compat\r\n if (value === \"sequence\") {\r\n ret.sequence = true;\r\n }\r\n ret.generic = value;\r\n const types = [];\r\n do {\r\n all_ws();\r\n types.push(type_with_extended_attributes(typeName) || error(\"Error parsing generic type \" + value));\r\n all_ws();\r\n }\r\n while (consume(OTHER, \",\"));\r\n if (value === \"sequence\") {\r\n if (types.length !== 1) error(\"A sequence must have exactly one subtype\");\r\n } else if (value === \"record\") {\r\n if (types.length !== 2) error(\"A record must have exactly two subtypes\");\r\n if (!/^(DOMString|USVString|ByteString)$/.test(types[0].idlType)) {\r\n error(\"Record key must be DOMString, USVString, or ByteString\");\r\n }\r\n if (types[0].extAttrs.length) error(\"Record key cannot have extended attribute\");\r\n } else if (value === \"Promise\") {\r\n if (types[0].extAttrs.length) error(\"Promise type cannot have extended attribute\");\r\n }\r\n ret.idlType = types.length === 1 ? types[0] : types;\r\n all_ws();\r\n if (!consume(OTHER, \">\")) error(\"Unterminated generic type \" + value);\r\n type_suffix(ret);\r\n return ret;\r\n } else {\r\n ret.idlType = value;\r\n }\r\n } else {\r\n return;\r\n }\r\n type_suffix(ret);\r\n if (ret.nullable && ret.idlType === \"any\") error(\"Type any cannot be made nullable\");\r\n return ret;\r\n }\r\n\r\n function union_type(typeName) {\r\n all_ws();\r\n if (!consume(OTHER, \"(\")) return;\r\n const ret = Object.assign({ type: typeName || null }, EMPTY_IDLTYPE, { union: true, idlType: [] });\r\n const fst = type_with_extended_attributes() || error(\"Union type with no content\");\r\n ret.idlType.push(fst);\r\n while (true) {\r\n all_ws();\r\n if (!consume(ID, \"or\")) break;\r\n const typ = type_with_extended_attributes() || error(\"No type after 'or' in union type\");\r\n ret.idlType.push(typ);\r\n }\r\n if (!consume(OTHER, \")\")) error(\"Unterminated union type\");\r\n type_suffix(ret);\r\n return ret;\r\n }\r\n\r\n function type(typeName) {\r\n return single_type(typeName) || union_type(typeName);\r\n }\r\n\r\n function type_with_extended_attributes(typeName) {\r\n const extAttrs = extended_attrs();\r\n const ret = single_type(typeName) || union_type(typeName);\r\n if (extAttrs.length && ret) ret.extAttrs = extAttrs;\r\n return ret;\r\n }\r\n\r\n function argument(store) {\r\n const ret = { optional: false, variadic: false };\r\n ret.extAttrs = extended_attrs(store);\r\n all_ws(store, \"pea\");\r\n const opt_token = consume(ID, \"optional\");\r\n if (opt_token) {\r\n ret.optional = true;\r\n all_ws();\r\n }\r\n ret.idlType = type_with_extended_attributes(\"argument-type\");\r\n if (!ret.idlType) {\r\n if (opt_token) tokens.unshift(opt_token);\r\n return;\r\n }\r\n const type_token = last_token;\r\n if (!ret.optional) {\r\n all_ws();\r\n if (tokens.length >= 3 &&\r\n tokens[0].type === \"other\" && tokens[0].value === \".\" &&\r\n tokens[1].type === \"other\" && tokens[1].value === \".\" &&\r\n tokens[2].type === \"other\" && tokens[2].value === \".\"\r\n ) {\r\n tokens.shift();\r\n tokens.shift();\r\n tokens.shift();\r\n ret.variadic = true;\r\n }\r\n }\r\n all_ws();\r\n const name = consume(ID);\r\n if (!name) {\r\n if (opt_token) tokens.unshift(opt_token);\r\n tokens.unshift(type_token);\r\n return;\r\n }\r\n ret.name = name.value;\r\n if (ret.optional) {\r\n all_ws();\r\n const dflt = default_();\r\n if (typeof dflt !== \"undefined\") {\r\n ret[\"default\"] = dflt;\r\n }\r\n }\r\n return ret;\r\n }\r\n\r\n function argument_list(store) {\r\n const ret = [];\r\n const arg = argument(store ? ret : null);\r\n if (!arg) return ret;\r\n ret.push(arg);\r\n while (true) {\r\n all_ws(store ? ret : null);\r\n if (!consume(OTHER, \",\")) return ret;\r\n const nxt = argument(store ? ret : null) || error(\"Trailing comma in arguments list\");\r\n ret.push(nxt);\r\n }\r\n }\r\n\r\n function simple_extended_attr(store) {\r\n all_ws();\r\n const name = consume(ID);\r\n if (!name) return;\r\n const ret = {\r\n name: name.value,\r\n arguments: null,\r\n type: \"extended-attribute\",\r\n rhs: null\r\n };\r\n all_ws();\r\n const eq = consume(OTHER, \"=\");\r\n if (eq) {\r\n all_ws();\r\n ret.rhs = consume(ID) ||\r\n consume(FLOAT) ||\r\n consume(INT) ||\r\n consume(STR);\r\n }\r\n all_ws();\r\n if (consume(OTHER, \"(\")) {\r\n if (eq && !ret.rhs) {\r\n // [Exposed=(Window,Worker)]\r\n ret.rhs = {\r\n type: \"identifier-list\",\r\n value: identifiers()\r\n };\r\n }\r\n else {\r\n // [NamedConstructor=Audio(DOMString src)] or [Constructor(DOMString str)]\r\n ret.arguments = argument_list(store);\r\n }\r\n all_ws();\r\n consume(OTHER, \")\") || error(\"Unexpected token in extended attribute argument list\");\r\n }\r\n if (eq && !ret.rhs) error(\"No right hand side to extended attribute assignment\");\r\n return ret;\r\n }\r\n\r\n // Note: we parse something simpler than the official syntax. It's all that ever\r\n // seems to be used\r\n function extended_attrs(store) {\r\n const eas = [];\r\n all_ws(store);\r\n if (!consume(OTHER, \"[\")) return eas;\r\n eas[0] = simple_extended_attr(store) || error(\"Extended attribute with not content\");\r\n all_ws();\r\n while (consume(OTHER, \",\")) {\r\n eas.push(simple_extended_attr(store) || error(\"Trailing comma in extended attribute\"));\r\n }\r\n all_ws();\r\n consume(OTHER, \"]\") || error(\"No end of extended attribute\");\r\n return eas;\r\n }\r\n\r\n function default_() {\r\n all_ws();\r\n if (consume(OTHER, \"=\")) {\r\n all_ws();\r\n const def = const_value();\r\n if (def) {\r\n return def;\r\n } else if (consume(OTHER, \"[\")) {\r\n if (!consume(OTHER, \"]\")) error(\"Default sequence value must be empty\");\r\n return { type: \"sequence\", value: [] };\r\n } else {\r\n const str = consume(STR) || error(\"No value for default\");\r\n str.value = str.value.slice(1, -1);\r\n return str;\r\n }\r\n }\r\n }\r\n\r\n function const_(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"const\")) return;\r\n const ret = { type: \"const\", nullable: false };\r\n all_ws();\r\n let typ = primitive_type();\r\n if (!typ) {\r\n typ = consume(ID) || error(\"No type for const\");\r\n typ = typ.value;\r\n }\r\n ret.idlType = Object.assign({ type: \"const-type\" }, EMPTY_IDLTYPE, { idlType: typ });\r\n all_ws();\r\n if (consume(OTHER, \"?\")) {\r\n ret.nullable = true;\r\n all_ws();\r\n }\r\n const name = consume(ID) || error(\"No name for const\");\r\n ret.name = name.value;\r\n all_ws();\r\n consume(OTHER, \"=\") || error(\"No value assignment for const\");\r\n all_ws();\r\n const cnt = const_value();\r\n if (cnt) ret.value = cnt;\r\n else error(\"No value for const\");\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated const\");\r\n return ret;\r\n }\r\n\r\n function inheritance() {\r\n all_ws();\r\n if (consume(OTHER, \":\")) {\r\n all_ws();\r\n const inh = consume(ID) || error(\"No type in inheritance\");\r\n return inh.value;\r\n }\r\n }\r\n\r\n function operation_rest(ret, store) {\r\n all_ws();\r\n if (!ret) ret = {};\r\n const name = consume(ID);\r\n ret.name = name ? name.value : null;\r\n all_ws();\r\n consume(OTHER, \"(\") || error(\"Invalid operation\");\r\n ret.arguments = argument_list(store);\r\n all_ws();\r\n consume(OTHER, \")\") || error(\"Unterminated operation\");\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated operation\");\r\n return ret;\r\n }\r\n\r\n function callback(store) {\r\n all_ws(store, \"pea\");\r\n let ret;\r\n if (!consume(ID, \"callback\")) return;\r\n all_ws();\r\n const tok = consume(ID, \"interface\");\r\n if (tok) {\r\n ret = interface_rest(false, store, \"callback interface\");\r\n return ret;\r\n }\r\n const name = consume(ID) || error(\"No name for callback\");\r\n ret = current = { type: \"callback\", name: sanitize_name(name.value, \"callback\") };\r\n all_ws();\r\n consume(OTHER, \"=\") || error(\"No assignment in callback\");\r\n all_ws();\r\n ret.idlType = return_type();\r\n all_ws();\r\n consume(OTHER, \"(\") || error(\"No arguments in callback\");\r\n ret.arguments = argument_list(store);\r\n all_ws();\r\n consume(OTHER, \")\") || error(\"Unterminated callback\");\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated callback\");\r\n return ret;\r\n }\r\n\r\n function attribute(store) {\r\n all_ws(store, \"pea\");\r\n const grabbed = [];\r\n const ret = {\r\n type: \"attribute\",\r\n static: false,\r\n stringifier: false,\r\n inherit: false,\r\n readonly: false\r\n };\r\n const w = all_ws();\r\n if (w) grabbed.push(w);\r\n if (consume(ID, \"inherit\")) {\r\n if (ret.static || ret.stringifier) error(\"Cannot have a static or stringifier inherit\");\r\n ret.inherit = true;\r\n grabbed.push(last_token);\r\n const w = all_ws();\r\n if (w) grabbed.push(w);\r\n }\r\n if (consume(ID, \"readonly\")) {\r\n ret.readonly = true;\r\n grabbed.push(last_token);\r\n const w = all_ws();\r\n if (w) grabbed.push(w);\r\n }\r\n const rest = attribute_rest(ret);\r\n if (!rest) {\r\n tokens = grabbed.concat(tokens);\r\n }\r\n return rest;\r\n }\r\n\r\n function attribute_rest(ret) {\r\n if (!consume(ID, \"attribute\")) {\r\n return;\r\n }\r\n all_ws();\r\n ret.idlType = type_with_extended_attributes(\"attribute-type\") || error(\"No type in attribute\");\r\n if (ret.idlType.sequence) error(\"Attributes cannot accept sequence types\");\r\n if (ret.idlType.generic === \"record\") error(\"Attributes cannot accept record types\");\r\n all_ws();\r\n const name = consume(ID) || error(\"No name in attribute\");\r\n ret.name = name.value;\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated attribute\");\r\n return ret;\r\n }\r\n\r\n function return_type() {\r\n const typ = type(\"return-type\");\r\n if (!typ) {\r\n if (consume(ID, \"void\")) {\r\n return \"void\";\r\n } else error(\"No return type\");\r\n }\r\n return typ;\r\n }\r\n\r\n function operation(store) {\r\n all_ws(store, \"pea\");\r\n const ret = Object.assign({}, EMPTY_OPERATION);\r\n while (true) {\r\n all_ws();\r\n if (consume(ID, \"getter\")) ret.getter = true;\r\n else if (consume(ID, \"setter\")) ret.setter = true;\r\n else if (consume(ID, \"deleter\")) ret.deleter = true;\r\n else break;\r\n }\r\n if (ret.getter || ret.setter || ret.deleter) {\r\n all_ws();\r\n ret.idlType = return_type();\r\n operation_rest(ret, store);\r\n return ret;\r\n }\r\n ret.idlType = return_type();\r\n all_ws();\r\n operation_rest(ret, store);\r\n return ret;\r\n }\r\n\r\n function static_member(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"static\")) return;\r\n all_ws();\r\n return noninherited_attribute(store, \"static\") ||\r\n regular_operation(store, \"static\") ||\r\n error(\"No body in static member\");\r\n }\r\n\r\n function stringifier(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"stringifier\")) return;\r\n all_ws();\r\n if (consume(OTHER, \";\")) {\r\n return Object.assign({}, EMPTY_OPERATION, { stringifier: true });\r\n }\r\n return noninherited_attribute(store, \"stringifier\") ||\r\n regular_operation(store, \"stringifier\") ||\r\n error(\"Unterminated stringifier\");\r\n }\r\n\r\n function identifiers() {\r\n const arr = [];\r\n const id = consume(ID);\r\n if (id) {\r\n arr.push(id.value);\r\n }\r\n else error(\"Expected identifiers but not found\");\r\n while (true) {\r\n all_ws();\r\n if (consume(OTHER, \",\")) {\r\n all_ws();\r\n const name = consume(ID) || error(\"Trailing comma in identifiers list\");\r\n arr.push(name.value);\r\n } else break;\r\n }\r\n return arr;\r\n }\r\n\r\n function iterable_type() {\r\n if (consume(ID, \"iterable\")) return \"iterable\";\r\n else if (consume(ID, \"legacyiterable\")) return \"legacyiterable\";\r\n else if (consume(ID, \"maplike\")) return \"maplike\";\r\n else if (consume(ID, \"setlike\")) return \"setlike\";\r\n else return;\r\n }\r\n\r\n function readonly_iterable_type() {\r\n if (consume(ID, \"maplike\")) return \"maplike\";\r\n else if (consume(ID, \"setlike\")) return \"setlike\";\r\n else return;\r\n }\r\n\r\n function iterable(store) {\r\n all_ws(store, \"pea\");\r\n const grabbed = [];\r\n const ret = { type: null, idlType: null, readonly: false };\r\n if (consume(ID, \"readonly\")) {\r\n ret.readonly = true;\r\n grabbed.push(last_token);\r\n var w = all_ws();\r\n if (w) grabbed.push(w);\r\n }\r\n const consumeItType = ret.readonly ? readonly_iterable_type : iterable_type;\r\n\r\n const ittype = consumeItType();\r\n if (!ittype) {\r\n tokens = grabbed.concat(tokens);\r\n return;\r\n }\r\n\r\n const secondTypeRequired = ittype === \"maplike\";\r\n const secondTypeAllowed = secondTypeRequired || ittype === \"iterable\";\r\n ret.type = ittype;\r\n if (ret.type !== 'maplike' && ret.type !== 'setlike')\r\n delete ret.readonly;\r\n all_ws();\r\n if (consume(OTHER, \"<\")) {\r\n ret.idlType = [type_with_extended_attributes()] || error(`Error parsing ${ittype} declaration`);\r\n all_ws();\r\n if (secondTypeAllowed) {\r\n if (consume(OTHER, \",\")) {\r\n all_ws();\r\n ret.idlType.push(type_with_extended_attributes());\r\n all_ws();\r\n }\r\n else if (secondTypeRequired)\r\n error(`Missing second type argument in ${ittype} declaration`);\r\n }\r\n if (!consume(OTHER, \">\")) error(`Unterminated ${ittype} declaration`);\r\n all_ws();\r\n if (!consume(OTHER, \";\")) error(`Missing semicolon after ${ittype} declaration`);\r\n } else\r\n error(`Error parsing ${ittype} declaration`);\r\n\r\n return ret;\r\n }\r\n\r\n function interface_rest(isPartial, store, typeName = \"interface\") {\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for interface\");\r\n const mems = [];\r\n const ret = current = {\r\n type: typeName,\r\n name: isPartial ? name.value : sanitize_name(name.value, \"interface\"),\r\n partial: isPartial,\r\n members: mems\r\n };\r\n if (!isPartial) ret.inheritance = inheritance() || null;\r\n all_ws();\r\n consume(OTHER, \"{\") || error(\"Bodyless interface\");\r\n while (true) {\r\n all_ws(store ? mems : null);\r\n if (consume(OTHER, \"}\")) {\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Missing semicolon after interface\");\r\n return ret;\r\n }\r\n const ea = extended_attrs(store ? mems : null);\r\n all_ws();\r\n const cnt = const_(store ? mems : null);\r\n if (cnt) {\r\n cnt.extAttrs = ea;\r\n ret.members.push(cnt);\r\n continue;\r\n }\r\n const mem = (opt.allowNestedTypedefs && typedef(store ? mems : null)) ||\r\n static_member(store ? mems : null) ||\r\n stringifier(store ? mems : null) ||\r\n iterable(store ? mems : null) ||\r\n attribute(store ? mems : null) ||\r\n operation(store ? mems : null) ||\r\n error(\"Unknown member\");\r\n mem.extAttrs = ea;\r\n ret.members.push(mem);\r\n }\r\n }\r\n\r\n function mixin_rest(isPartial, store) {\r\n all_ws();\r\n if (!consume(ID, \"mixin\")) return;\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for interface mixin\");\r\n const mems = [];\r\n const ret = current = {\r\n type: \"interface mixin\",\r\n name: isPartial ? name.value : sanitize_name(name.value, \"interface mixin\"),\r\n partial: isPartial,\r\n members: mems\r\n };\r\n all_ws();\r\n consume(OTHER, \"{\") || error(\"Bodyless interface mixin\");\r\n while (true) {\r\n all_ws(store ? mems : null);\r\n if (consume(OTHER, \"}\")) {\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Missing semicolon after interface mixin\");\r\n return ret;\r\n }\r\n const ea = extended_attrs(store ? mems : null);\r\n all_ws();\r\n const cnt = const_(store ? mems : null);\r\n if (cnt) {\r\n cnt.extAttrs = ea;\r\n ret.members.push(cnt);\r\n continue;\r\n }\r\n const mem = stringifier(store ? mems : null) ||\r\n noninherited_attribute(store ? mems : null) ||\r\n regular_operation(store ? mems : null) ||\r\n error(\"Unknown member\");\r\n mem.extAttrs = ea;\r\n ret.members.push(mem);\r\n }\r\n }\r\n\r\n function interface_(isPartial, store) {\r\n all_ws(isPartial ? null : store, \"pea\");\r\n if (!consume(ID, \"interface\")) return;\r\n return mixin_rest(isPartial, store) ||\r\n interface_rest(isPartial, store) ||\r\n error(\"Interface has no proper body\");\r\n }\r\n\r\n function namespace(isPartial, store) {\r\n all_ws(isPartial ? null : store, \"pea\");\r\n if (!consume(ID, \"namespace\")) return;\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for namespace\");\r\n const mems = [];\r\n const ret = current = {\r\n type: \"namespace\",\r\n name: isPartial ? name.value : sanitize_name(name.value, \"namespace\"),\r\n partial: isPartial,\r\n members: mems\r\n };\r\n all_ws();\r\n consume(OTHER, \"{\") || error(\"Bodyless namespace\");\r\n while (true) {\r\n all_ws(store ? mems : null);\r\n if (consume(OTHER, \"}\")) {\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Missing semicolon after namespace\");\r\n return ret;\r\n }\r\n const ea = extended_attrs(store ? mems : null);\r\n all_ws();\r\n const mem = noninherited_attribute(store ? mems : null) ||\r\n regular_operation(store ? mems : null) ||\r\n error(\"Unknown member\");\r\n mem.extAttrs = ea;\r\n ret.members.push(mem);\r\n }\r\n }\r\n\r\n function noninherited_attribute(store, prefix) {\r\n const w = all_ws(store, \"pea\");\r\n const grabbed = [];\r\n const ret = {\r\n type: \"attribute\",\r\n static: false,\r\n stringifier: false,\r\n inherit: false,\r\n readonly: false\r\n };\r\n if (prefix) {\r\n ret[prefix] = true;\r\n }\r\n if (w) grabbed.push(w);\r\n if (consume(ID, \"readonly\")) {\r\n ret.readonly = true;\r\n grabbed.push(last_token);\r\n const w = all_ws();\r\n if (w) grabbed.push(w);\r\n }\r\n const rest = attribute_rest(ret);\r\n if (!rest) {\r\n tokens = grabbed.concat(tokens);\r\n }\r\n return rest;\r\n }\r\n\r\n function regular_operation(store, prefix) {\r\n all_ws(store, \"pea\");\r\n const ret = Object.assign({}, EMPTY_OPERATION);\r\n if (prefix) {\r\n ret[prefix] = true;\r\n }\r\n ret.idlType = return_type();\r\n return operation_rest(ret, store);\r\n }\r\n\r\n function partial(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"partial\")) return;\r\n const thing = dictionary(true, store) ||\r\n interface_(true, store) ||\r\n namespace(true, store) ||\r\n error(\"Partial doesn't apply to anything\");\r\n return thing;\r\n }\r\n\r\n function dictionary(isPartial, store) {\r\n all_ws(isPartial ? null : store, \"pea\");\r\n if (!consume(ID, \"dictionary\")) return;\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for dictionary\");\r\n const mems = [];\r\n const ret = current = {\r\n type: \"dictionary\",\r\n name: isPartial ? name.value : sanitize_name(name.value, \"dictionary\"),\r\n partial: isPartial,\r\n members: mems\r\n };\r\n if (!isPartial) ret.inheritance = inheritance() || null;\r\n all_ws();\r\n consume(OTHER, \"{\") || error(\"Bodyless dictionary\");\r\n while (true) {\r\n all_ws(store ? mems : null);\r\n if (consume(OTHER, \"}\")) {\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Missing semicolon after dictionary\");\r\n return ret;\r\n }\r\n const ea = extended_attrs(store ? mems : null);\r\n all_ws(store ? mems : null, \"pea\");\r\n const required = consume(ID, \"required\");\r\n const typ = type_with_extended_attributes(\"dictionary-type\") || error(\"No type for dictionary member\");\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for dictionary member\");\r\n const dflt = default_();\r\n if (required && dflt) error(\"Required member must not have a default\");\r\n const member = {\r\n type: \"field\",\r\n name: name.value,\r\n required: !!required,\r\n idlType: typ,\r\n extAttrs: ea\r\n };\r\n if (typeof dflt !== \"undefined\") {\r\n member[\"default\"] = dflt;\r\n }\r\n ret.members.push(member);\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated dictionary member\");\r\n }\r\n }\r\n\r\n function enum_(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"enum\")) return;\r\n all_ws();\r\n const name = consume(ID) || error(\"No name for enum\");\r\n const vals = [];\r\n const ret = current = {\r\n type: \"enum\",\r\n name: sanitize_name(name.value, \"enum\"),\r\n values: vals\r\n };\r\n all_ws();\r\n consume(OTHER, \"{\") || error(\"No curly for enum\");\r\n let saw_comma = false;\r\n while (true) {\r\n all_ws(store ? vals : null);\r\n if (consume(OTHER, \"}\")) {\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"No semicolon after enum\");\r\n return ret;\r\n }\r\n const val = consume(STR) || error(\"Unexpected value in enum\");\r\n val.value = val.value.slice(1, -1);\r\n ret.values.push(val);\r\n all_ws(store ? vals : null);\r\n if (consume(OTHER, \",\")) {\r\n if (store) vals.push({ type: \",\" });\r\n all_ws(store ? vals : null);\r\n saw_comma = true;\r\n } else {\r\n saw_comma = false;\r\n }\r\n }\r\n }\r\n\r\n function typedef(store) {\r\n all_ws(store, \"pea\");\r\n if (!consume(ID, \"typedef\")) return;\r\n const ret = {\r\n type: \"typedef\"\r\n };\r\n all_ws();\r\n ret.idlType = type_with_extended_attributes(\"typedef-type\") || error(\"No type in typedef\");\r\n all_ws();\r\n const name = consume(ID) || error(\"No name in typedef\");\r\n ret.name = sanitize_name(name.value, \"typedef\");\r\n current = ret;\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"Unterminated typedef\");\r\n return ret;\r\n }\r\n\r\n function implements_(store) {\r\n all_ws(store, \"pea\");\r\n const target = consume(ID);\r\n if (!target) return;\r\n const w = all_ws();\r\n if (consume(ID, \"implements\")) {\r\n const ret = {\r\n type: \"implements\",\r\n target: target.value\r\n };\r\n all_ws();\r\n const imp = consume(ID) || error(\"Incomplete implements statement\");\r\n ret[\"implements\"] = imp.value;\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"No terminating ; for implements statement\");\r\n return ret;\r\n } else {\r\n // rollback\r\n if (w)\r\n tokens.unshift(w);\r\n tokens.unshift(target);\r\n }\r\n }\r\n\r\n function includes(store) {\r\n all_ws(store, \"pea\");\r\n const target = consume(ID);\r\n if (!target) return;\r\n const w = all_ws();\r\n if (consume(ID, \"includes\")) {\r\n const ret = {\r\n type: \"includes\",\r\n target: target.value\r\n };\r\n all_ws();\r\n const imp = consume(ID) || error(\"Incomplete includes statement\");\r\n ret[\"includes\"] = imp.value;\r\n all_ws();\r\n consume(OTHER, \";\") || error(\"No terminating ; for includes statement\");\r\n return ret;\r\n } else {\r\n // rollback\r\n if (w)\r\n tokens.unshift(w);\r\n tokens.unshift(target);\r\n }\r\n }\r\n\r\n function definition(store) {\r\n return callback(store) ||\r\n interface_(false, store) ||\r\n partial(store) ||\r\n dictionary(false, store) ||\r\n enum_(store) ||\r\n typedef(store) ||\r\n implements_(store) ||\r\n includes(store) ||\r\n namespace(false, store);\r\n }\r\n\r\n function definitions(store) {\r\n if (!tokens.length) return [];\r\n const defs = [];\r\n while (true) {\r\n const ea = extended_attrs(store ? defs : null);\r\n const def = definition(store ? defs : null);\r\n if (!def) {\r\n if (ea.length) error(\"Stray extended attributes\");\r\n break;\r\n }\r\n def.extAttrs = ea;\r\n defs.push(def);\r\n }\r\n return defs;\r\n }\r\n const res = definitions(opt.ws);\r\n if (tokens.length) error(\"Unrecognised tokens\");\r\n return res;\r\n }\r\n\r\n const obj = {\r\n parse(str, opt) {\r\n if (!opt) opt = {};\r\n const tokens = tokenise(str);\r\n return parse(tokens, opt);\r\n }\r\n };\r\n\r\n if (typeof module !== 'undefined' && typeof module.exports !== 'undefined') {\r\n module.exports = obj;\r\n } else if (typeof define === 'function' && define.amd) {\r\n define('deps/webidl2',[], () => obj);\r\n } else {\r\n (self || window).WebIDL2 = obj;\r\n }\r\n})();\r\n\n", - "\ndefine('deps/text!core/css/webidl.css',[],function () { return '/* --- WEB IDL --- */\\n\\npre.idl {\\n padding: 1em;\\n}\\n\\n.respec-idl-separator {\\n padding: 0 0 0.4cm 0;\\n}\\n\\n.respec-idl-separator:last-child {\\n padding: 0;\\n}\\n\\n@media print {\\n pre.idl {\\n white-space: pre-wrap;\\n }\\n}\\n\\npre.idl::before {\\n content: \"WebIDL\";\\n display: block;\\n width: 150px;\\n background: #90b8de;\\n color: #fff;\\n font-family: sans-serif;\\n font-weight: bold;\\n margin: -1em 0 1em -1em;\\n height: 28px;\\n line-height: 28px; \\n}\\n\\n.idlType {\\n color: #ff4500;\\n font-weight: bold;\\n text-decoration: none;\\n}\\n\\n\\n/*.idlModule*/\\n\\n\\n/*.idlModuleID*/\\n\\n\\n/*.idlInterface*/\\n\\n.idlInterfaceID,\\n.idlDictionaryID,\\n.idlCallbackID,\\n.idlEnumID {\\n font-weight: bold;\\n color: #005a9c;\\n}\\n\\na.idlEnumItem {\\n color: #000;\\n border-bottom: 1px dotted #ccc;\\n text-decoration: none;\\n}\\n\\n.idlSuperclass {\\n font-style: italic;\\n color: #005a9c;\\n}\\n\\n\\n/*.idlAttribute*/\\n\\n.idlAttrType,\\n.idlFieldType,\\n.idlMemberType {\\n color: #005a9c;\\n}\\n\\n.idlAttrName,\\n.idlFieldName,\\n.idlMemberName {\\n color: #ff4500;\\n}\\n\\n.idlAttrName a,\\n.idlFieldName a,\\n.idlMemberName a {\\n color: #ff4500;\\n border-bottom: 1px dotted #ff4500;\\n text-decoration: none;\\n}\\n\\n\\n/*.idlMethod*/\\n\\n.idlMethType,\\n.idlCallbackType {\\n color: #005a9c;\\n}\\n\\n.idlMethName {\\n color: #ff4500;\\n}\\n\\n.idlMethName a {\\n color: #ff4500;\\n border-bottom: 1px dotted #ff4500;\\n text-decoration: none;\\n}\\n\\n\\n/*.idlCtor*/\\n\\n.idlCtorName {\\n color: #ff4500;\\n}\\n\\n.idlCtorName a {\\n color: #ff4500;\\n border-bottom: 1px dotted #ff4500;\\n text-decoration: none;\\n}\\n\\n\\n/*.idlParam*/\\n\\n.idlParamType {\\n color: #005a9c;\\n}\\n\\n.idlParamName,\\n.idlDefaultValue {\\n font-style: italic;\\n}\\n\\n.extAttr {\\n color: #666;\\n}\\n\\n\\n/*.idlSectionComment*/\\n\\n.idlSectionComment {\\n color: gray;\\n}\\n\\n\\n/*.idlIterable*/\\n\\n.idlIterableKeyType,\\n.idlIterableValueType {\\n color: #005a9c;\\n}\\n\\n\\n/*.idlMaplike*/\\n\\n.idlMaplikeKeyType,\\n.idlMaplikeValueType {\\n color: #005a9c;\\n}\\n\\n\\n/*.idlConst*/\\n\\n.idlConstType {\\n color: #005a9c;\\n}\\n\\n.idlConstName {\\n color: #ff4500;\\n}\\n\\n.idlConstName a {\\n color: #ff4500;\\n border-bottom: 1px dotted #ff4500;\\n text-decoration: none;\\n}\\n\\n\\n/*.idlException*/\\n\\n.idlExceptionID {\\n font-weight: bold;\\n color: #c00;\\n}\\n\\n.idlTypedefID,\\n.idlTypedefType {\\n color: #005a9c;\\n}\\n\\n.idlRaises,\\n.idlRaises a.idlType,\\n.idlRaises a.idlType code,\\n.excName a,\\n.excName a code {\\n color: #c00;\\n font-weight: normal;\\n}\\n\\n.excName a {\\n font-family: monospace;\\n}\\n\\n.idlRaises a.idlType,\\n.excName a.idlType {\\n border-bottom: 1px dotted #c00;\\n}\\n\\n.excGetSetTrue,\\n.excGetSetFalse,\\n.prmNullTrue,\\n.prmNullFalse,\\n.prmOptTrue,\\n.prmOptFalse {\\n width: 45px;\\n text-align: center;\\n}\\n\\n.excGetSetTrue,\\n.prmNullTrue,\\n.prmOptTrue {\\n color: #0c0;\\n}\\n\\n.excGetSetFalse,\\n.prmNullFalse,\\n.prmOptFalse {\\n color: #c00;\\n}\\n\\n.idlImplements a, .idlIncludes a {\\n font-weight: bold;\\n}\\n\\ndl.attributes,\\ndl.methods,\\ndl.constants,\\ndl.constructors,\\ndl.fields,\\ndl.dictionary-members {\\n margin-left: 2em;\\n}\\n\\n.attributes dt,\\n.methods dt,\\n.constants dt,\\n.constructors dt,\\n.fields dt,\\n.dictionary-members dt {\\n font-weight: normal;\\n}\\n\\n.attributes dt code,\\n.methods dt code,\\n.constants dt code,\\n.constructors dt code,\\n.fields dt code,\\n.dictionary-members dt code {\\n font-weight: bold;\\n color: #000;\\n font-family: monospace;\\n}\\n\\n.attributes dt code,\\n.fields dt code,\\n.dictionary-members dt code {\\n background: #ffffd2;\\n}\\n\\n.attributes dt .idlAttrType code,\\n.fields dt .idlFieldType code,\\n.dictionary-members dt .idlMemberType code {\\n color: #005a9c;\\n background: transparent;\\n font-family: inherit;\\n font-weight: normal;\\n font-style: italic;\\n}\\n\\n.methods dt code {\\n background: #d9e6f8;\\n}\\n\\n.constants dt code {\\n background: #ddffd2;\\n}\\n\\n.constructors dt code {\\n background: #cfc;\\n}\\n\\n.attributes dd,\\n.methods dd,\\n.constants dd,\\n.constructors dd,\\n.fields dd,\\n.dictionary-members dd {\\n margin-bottom: 1em;\\n}\\n\\ntable.parameters,\\ntable.exceptions {\\n border-spacing: 0;\\n border-collapse: collapse;\\n margin: 0.5em 0;\\n width: 100%;\\n}\\n\\ntable.parameters {\\n border-bottom: 1px solid #90b8de;\\n}\\n\\ntable.exceptions {\\n border-bottom: 1px solid #deb890;\\n}\\n\\n.parameters th,\\n.exceptions th {\\n color: inherit;\\n padding: 3px 5px;\\n text-align: left;\\n font-weight: normal;\\n}\\n\\n.parameters th {\\n color: #fff;\\n background: #005a9c;\\n}\\n\\n.exceptions th {\\n background: #deb890;\\n}\\n\\n.parameters td,\\n.exceptions td {\\n padding: 3px 10px;\\n border-top: 1px solid #ddd;\\n vertical-align: top;\\n}\\n\\n.parameters tr:first-child td,\\n.exceptions tr:first-child td {\\n border-top: none;\\n}\\n\\n.parameters td.prmName,\\n.exceptions td.excName,\\n.exceptions td.excCodeName {\\n width: 100px;\\n}\\n\\n.parameters td.prmType {\\n width: 120px;\\n}\\n\\ntable.exceptions table {\\n border-spacing: 0;\\n border-collapse: collapse;\\n width: 100%;\\n}\\n\\n.respec-button-copy-paste:focus {\\n text-decoration: none;\\n border-color: #51a7e8;\\n outline: none;\\n box-shadow: 0 0 5px rgba(81, 167, 232, 0.5);\\n}\\n\\n.respec-button-copy-paste:focus:hover,\\n.respec-button-copy-paste.selected:focus {\\n border-color: #51a7e8;\\n}\\n\\n.respec-button-copy-paste:hover,\\n.respec-button-copy-paste:active,\\n.respec-button-copy-paste.zeroclipboard-is-hover,\\n.respec-button-copy-paste.zeroclipboard-is-active {\\n text-decoration: none;\\n background-color: #ddd;\\n background-image: linear-gradient(#eee, #ddd);\\n border-color: #ccc;\\n}\\n\\n.respec-button-copy-paste:active,\\n.respec-button-copy-paste.selected,\\n.respec-button-copy-paste.zeroclipboard-is-active {\\n background-color: #dcdcdc;\\n background-image: none;\\n border-color: #b5b5b5;\\n box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15)\\n}\\n\\n.respec-button-copy-paste.selected:hover {\\n background-color: #cfcfcf;\\n}\\n\\n.respec-button-copy-paste:disabled,\\n.respec-button-copy-paste:disabled:hover,\\n.respec-button-copy-paste.disabled,\\n.respec-button-copy-paste.disabled:hover {\\n color: rgba(102, 102, 102, 0.5);\\n cursor: default;\\n background-color: rgba(229, 229, 229, 0.5);\\n background-image: none;\\n border-color: rgba(197, 197, 197, 0.5);\\n box-shadow: none;\\n}\\n';});\n\n", - "define('core/webidl',[\"exports\", \"core/pubsubhub\", \"deps/webidl2\", \"handlebars.runtime\", \"deps/text!core/css/webidl.css\", \"templates\", \"core/utils\"], function (exports, _pubsubhub, _webidl, _handlebars, _webidl3, _templates, _utils) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.done = exports.name = undefined;\n exports.run = run;\n\n var _webidl2 = _interopRequireDefault(_webidl);\n\n var _handlebars2 = _interopRequireDefault(_handlebars);\n\n var _webidl4 = _interopRequireDefault(_webidl3);\n\n var _templates2 = _interopRequireDefault(_templates);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n // Module core/webidl\n // Highlights and links WebIDL marked up inside <pre class=\"idl\">.\n\n // TODO:\n // - It could be useful to report parsed IDL items as events\n // - don't use generated content in the CSS!\n const name = exports.name = \"core/webidl\";\n\n var idlAttributeTmpl = _templates2.default[\"attribute.html\"];\n var idlCallbackTmpl = _templates2.default[\"callback.html\"];\n var idlConstTmpl = _templates2.default[\"const.html\"];\n var idlDictionaryTmpl = _templates2.default[\"dictionary.html\"];\n var idlDictMemberTmpl = _templates2.default[\"dict-member.html\"];\n var idlEnumItemTmpl = _templates2.default[\"enum-item.html\"];\n var idlEnumTmpl = _templates2.default[\"enum.html\"];\n var idlExtAttributeTmpl = _templates2.default[\"extended-attribute.html\"];\n var idlFieldTmpl = _templates2.default[\"field.html\"];\n var idlIncludesTmpl = _templates2.default[\"includes.html\"];\n var idlImplementsTmpl = _templates2.default[\"implements.html\"];\n var idlInterfaceTmpl = _templates2.default[\"interface.html\"];\n var idlIterableTmpl = _templates2.default[\"iterable.html\"];\n var idlLineCommentTmpl = _templates2.default[\"line-comment.html\"];\n var idlMaplikeTmpl = _templates2.default[\"maplike.html\"];\n var idlMethodTmpl = _templates2.default[\"method.html\"];\n var idlMultiLineCommentTmpl = _templates2.default[\"multiline-comment.html\"];\n var idlParamTmpl = _templates2.default[\"param.html\"];\n var idlTypedefTmpl = _templates2.default[\"typedef.html\"];\n // TODO: make these linkable somehow.\n // https://github.com/w3c/respec/issues/999\n // https://github.com/w3c/respec/issues/982\n var unlinkable = new Set([\"maplike\", \"setlike\", \"stringifier\"]);\n\n function registerHelpers() {\n _handlebars2.default.registerHelper(\"extAttr\", function (obj, indent) {\n return extAttr(obj.extAttrs, indent, /*singleLine=*/false);\n });\n _handlebars2.default.registerHelper(\"extAttrInline\", function (obj) {\n return extAttr(obj.extAttrs, 0, /*singleLine=*/true);\n });\n _handlebars2.default.registerHelper(\"extAttrClassName\", function () {\n var extAttr = this;\n if (extAttr.name === \"Constructor\" || extAttr.name === \"NamedConstructor\") {\n return \"idlCtor\";\n }\n return \"extAttr\";\n });\n _handlebars2.default.registerHelper(\"extAttrRhs\", function (rhs, options) {\n if (rhs.type === \"identifier\") {\n return options.fn(rhs.value);\n }\n return `(${rhs.value.map(options.fn)})`;\n });\n _handlebars2.default.registerHelper(\"param\", function (obj) {\n return new _handlebars2.default.SafeString(idlParamTmpl({\n obj: obj,\n optional: obj.optional ? \"optional \" : \"\",\n variadic: obj.variadic ? \"...\" : \"\"\n }));\n });\n _handlebars2.default.registerHelper(\"jsIf\", function (condition, options) {\n if (condition) {\n return options.fn(this);\n } else {\n return options.inverse(this);\n }\n });\n _handlebars2.default.registerHelper(\"idn\", function (indent) {\n return new _handlebars2.default.SafeString(idn(indent));\n });\n _handlebars2.default.registerHelper(\"idlType\", function (obj) {\n return new _handlebars2.default.SafeString(idlType2Html(obj.idlType));\n });\n _handlebars2.default.registerHelper(\"stringifyIdlConst\", function (value) {\n switch (value.type) {\n case \"null\":\n return \"null\";\n case \"Infinity\":\n return value.negative ? \"-Infinity\" : \"Infinity\";\n case \"NaN\":\n return \"NaN\";\n case \"number\":\n return value.value;\n case \"string\":\n case \"boolean\":\n case \"sequence\":\n return JSON.stringify(value.value);\n default:\n (0, _pubsubhub.pub)(\"error\", \"Unexpected constant value type: `\" + value.type + \"`.\");\n return \"<Unknown>\";\n }\n });\n _handlebars2.default.registerHelper(\"escapeArgumentName\", escapeArgumentName);\n _handlebars2.default.registerHelper(\"escapeAttributeName\", escapeAttributeName);\n _handlebars2.default.registerHelper(\"escapeIdentifier\", escapeIdentifier);\n _handlebars2.default.registerHelper(\"pads\", function (num) {\n return new _handlebars2.default.SafeString(pads(num));\n });\n _handlebars2.default.registerHelper(\"join\", function (arr, between, options) {\n return arr.map(options.fn).join(between);\n });\n _handlebars2.default.registerHelper(\"joinNonWhitespace\", function (arr, between, options) {\n return arr.filter(elem => elem.type !== \"ws\").map(options.fn).join(between);\n });\n // A block helper that emits an <a title> around its contents\n // if obj.dfn exists. If it exists, that implies that\n // there's another <dfn> for the object.\n _handlebars2.default.registerHelper(\"tryLink\", function (obj, options) {\n const content = options.fn(this);\n const isDefaultJSON = obj.name === \"toJSON\" && obj.extAttrs.some(({ name }) => name === \"Default\");\n // nothing defines this.\n if (!obj.dfn && !isDefaultJSON) {\n return content;\n }\n // We are going to return a hyperlink\n const a = document.createElement(\"a\");\n a.innerText = content;\n // Let's deal with WebIDL's Default toJSON(); first.\n if (!obj.dfn && isDefaultJSON) {\n // If toJSON is not overridden, link directly to WebIDL spec.\n a.dataset.cite = \"WEBIDL#default-tojson-operation\";\n } else {\n // This is an internal IDL reference.\n a.dataset.noDefault = \"\";\n a.dataset.linkFor = obj.linkFor ? _handlebars2.default.Utils.escapeExpression(obj.linkFor).toLowerCase() : \"\";\n a.dataset.lt = obj.dfn[0].dataset.lt || \"\";\n }\n return a.outerHTML;\n });\n }\n\n function idn(lvl) {\n return \" \".repeat(lvl);\n }\n\n function idlType2Html(idlType) {\n if (typeof idlType === \"string\") {\n return `<a>${_handlebars2.default.Utils.escapeExpression(idlType)}</a>`;\n }\n if (Array.isArray(idlType)) {\n return idlType.map(idlType2Html).join(\", \");\n }\n const extAttrs = extAttr(idlType.extAttrs, 0, /*singleLine=*/true);\n const nullable = idlType.nullable ? \"?\" : \"\";\n if (idlType.union) {\n return `${extAttrs}(${idlType.idlType.map(idlType2Html).join(\" or \")})${nullable}`;\n }\n let type = \"\";\n if (idlType.generic) {\n type = standardTypes.has(idlType.generic) ? linkStandardType(idlType.generic) : idlType2Html(idlType.generic);\n type = `${type}<${idlType2Html(idlType.idlType)}>`;\n } else {\n type = standardTypes.has(idlType.idlType) ? linkStandardType(idlType.idlType) : idlType2Html(idlType.idlType);\n }\n return extAttrs + type + nullable;\n }\n\n function linkStandardType(type) {\n if (!standardTypes.has(type)) {\n return type;\n }\n const safeType = _handlebars2.default.Utils.escapeExpression(type);\n return `<a data-cite='${standardTypes.get(safeType)}'>${safeType}</a>`;\n }\n\n function idlType2Text(idlType) {\n if (typeof idlType === \"string\") {\n return idlType;\n }\n const nullable = idlType.nullable ? \"?\" : \"\";\n if (idlType.union) {\n return `(${idlType.idlType.map(idlType2Text).join(\" or \")})${nullable}`;\n }\n if (idlType.generic) {\n const types = [].concat(idlType.idlType).map(idlType2Text).join(\", \");\n return `${idlType.generic}<${types}>${nullable}`;\n }\n return idlType2Text(idlType.idlType) + nullable;\n }\n\n function pads(num) {\n return \" \".repeat(num);\n }\n var whitespaceTypes = {\n ws: true,\n \"ws-pea\": true,\n \"ws-tpea\": true,\n \"line-comment\": true,\n \"multiline-comment\": true\n };\n\n function typeIsWhitespace(webIdlType) {\n return whitespaceTypes[webIdlType];\n }\n\n const extenedAttributesLinks = new Map([[\"CEReactions\", \"HTML#cereactions\"], [\"Clamp\", \"WEBIDL#Clamp\"], [\"Constructor\", \"WEBIDL#Constructor\"], [\"Default\", \"WEBIDL#Default\"], [\"EnforceRange\", \"WEBIDL#EnforceRange\"], [\"Exposed\", \"WEBIDL#Exposed\"], [\"Global\", \"WEBIDL#Global\"], [\"HTMLConstructor\", \"HTML#htmlconstructor\"], [\"LegacyUnenumerableNamedProperties\", \"WEBIDL#LegacyUnenumerableNamedProperties\"], [\"LenientSetter\", \"WEBIDL#LenientSetter\"], [\"LenientThis\", \"WEBIDL#LenientThis\"], [\"NamedConstructor\", \"WEBIDL#NamedConstructor\"], [\"NewObject\", \"WEBIDL#NewObject\"], [\"NoInterfaceObject\", \"WEBIDL#NoInterfaceObject\"], [\"OverrideBuiltins\", \"WEBIDL#OverrideBuiltins\"], [\"PrimaryGlobal\", \"WEBIDL#PrimaryGlobal\"], [\"PutForwards\", \"WEBIDL#PutForwards\"], [\"Replaceable\", \"WEBIDL#Replaceable\"], [\"SameObject\", \"WEBIDL#SameObject\"], [\"SecureContext\", \"WEBIDL#SecureContext\"], [\"TreatNonObjectAsNull\", \"WEBIDL#TreatNonObjectAsNull\"], [\"TreatNullAs\", \"WEBIDL#TreatNullAs\"], [\"Unforgeable\", \"WEBIDL#Unforgeable\"], [\"Unscopable\", \"WEBIDL#Unscopable\"]]);\n\n function extAttr(extAttrs, indent, singleLine) {\n if (extAttrs.length === 0) {\n // If there are no extended attributes, omit the [] entirely.\n return \"\";\n }\n var opt = {\n extAttrs: extAttrs,\n indent: indent,\n sep: singleLine ? \", \" : \",\\n \" + idn(indent),\n end: singleLine ? \" \" : \"\\n\"\n };\n const safeString = new _handlebars2.default.SafeString(idlExtAttributeTmpl(opt));\n const tmpParser = document.createElement(\"div\");\n tmpParser.innerHTML = safeString;\n Array.from(tmpParser.querySelectorAll(\".extAttrName\")).filter(function (elem) {\n return extenedAttributesLinks.has(elem.textContent);\n }).forEach(function (elem) {\n const a = elem.ownerDocument.createElement(\"a\");\n a.dataset.cite = extenedAttributesLinks.get(elem.textContent);\n a.textContent = elem.textContent;\n elem.replaceChild(a, elem.firstChild);\n });\n return new _handlebars2.default.SafeString(tmpParser.innerHTML);\n }\n\n const standardTypes = new Map([[\"any\", \"WEBIDL#idl-any\"], [\"ArrayBuffer\", \"WEBIDL#idl-ArrayBuffer\"], [\"boolean\", \"WEBIDL#idl-boolean\"], [\"Buffer\", \"WEBIDL#idl-Buffer\"], [\"byte\", \"WEBIDL#idl-byte\"], [\"ByteString\", \"WEBIDL#idl-ByteString\"], [\"Callback\", \"WEBIDL#idl-Callback\"], [\"DataView\", \"WEBIDL#idl-DataView\"], [\"DOMException\", \"WEBIDL#idl-DOMException\"], [\"DOMString\", \"WEBIDL#idl-DOMString\"], [\"double\", \"WEBIDL#idl-double\"], [\"Error\", \"WEBIDL#idl-Error\"], [\"EventHandler\", \"HTML#eventhandler\"], [\"float\", \"WEBIDL#idl-float\"], [\"Float32Array\", \"WEBIDL#idl-Float32Array\"], [\"Float64Array\", \"WEBIDL#idl-Float64Array\"], [\"FrozenArray\", \"WEBIDL#idl-frozen-array\"], [\"Int16Array\", \"WEBIDL#idl-Int16Array\"], [\"Int32Array\", \"WEBIDL#idl-Int32Array\"], [\"Int8Array\", \"WEBIDL#idl-Int8Array\"], [\"long long\", \"WEBIDL#idl-long-long\"], [\"long\", \"WEBIDL#idl-long\"], [\"object\", \"WEBIDL#idl-object\"], [\"octet\", \"WEBIDL#idl-octet\"], [\"Promise\", \"WEBIDL#idl-promise\"], [\"record\", \"WEBIDL#idl-record\"], [\"sequence\", \"WEBIDL#idl-sequence\"], [\"short\", \"WEBIDL#idl-short\"], [\"Uint16Array\", \"WEBIDL#idl-Uint16Array\"], [\"Uint32Array\", \"WEBIDL#idl-Uint32Array\"], [\"Uint8Array\", \"WEBIDL#idl-Uint8Array\"], [\"Uint8ClampedArray\", \"WEBIDL#dl-Uint8ClampedArray\"], [\"unrestricted double\", \"WEBIDL#idl-unrestricted-double\"], [\"unrestricted float\", \"WEBIDL#idl-unrestricted-float\"], [\"unsigned long long\", \"WEBIDL#idl-unsigned-long-long\"], [\"unsigned long\", \"WEBIDL#idl-unsigned-long\"], [\"unsigned short\", \"WEBIDL#idl-unsigned-short\"], [\"USVString\", \"WEBIDL#idl-USVString\"]]);\n\n const idlKeywords = new Set([\"any\", \"attribute\", \"boolean\", \"byte\", \"ByteString\", \"callback\", \"const\", \"creator\", \"Date\", \"deleter\", \"dictionary\", \"DOMString\", \"double\", \"enum\", \"false\", \"float\", \"getter\", \"implements\", \"Infinity\", \"inherit\", \"interface\", \"iterable\", \"long\", \"maplike\", \"NaN\", \"null\", \"object\", \"octet\", \"optional\", \"or\", \"partial\", \"readonly\", \"RegExp\", \"required\", \"sequence\", \"setlike\", \"setter\", \"short\", \"static\", \"stringifier\", \"true\", \"typedef\", \"unrestricted\", \"unsigned\", \"USVString\", \"void\"]);\n const argumentNameKeyword = new Set([\"attribute\", \"callback\", \"const\", \"creator\", \"deleter\", \"dictionary\", \"enum\", \"getter\", \"implements\", \"inherit\", \"interface\", \"iterable\", \"maplike\", \"partial\", \"required\", \"setlike\", \"setter\", \"static\", \"stringifier\", \"typedef\", \"unrestricted\"]);\n const attributeNameKeyword = new Set([\"required\"]);\n var operationNames = {};\n var idlPartials = {};\n\n function escapeArgumentName(argumentName) {\n if (idlKeywords.has(argumentName) && !argumentNameKeyword.has(argumentName)) return \"_\" + argumentName;\n return argumentName;\n }\n\n function escapeAttributeName(attributeName) {\n if (idlKeywords.has(attributeName) && !attributeNameKeyword.has(attributeName)) return \"_\" + attributeName;\n return attributeName;\n }\n\n function escapeIdentifier(identifier) {\n if (idlKeywords.has(identifier)) return \"_\" + identifier;\n return identifier;\n }\n\n // Takes the result of WebIDL2.parse(), an array of definitions.\n function makeMarkup(conf, parse) {\n var attr = { class: \"def idl\" };\n var $pre = $(\"<pre></pre>\").attr(attr);\n $pre.html(parse.filter(function (defn) {\n return !typeIsWhitespace(defn.type);\n }).map(function (defn) {\n return writeDefinition(defn, -1);\n }).join(\"\\n\\n\"));\n return $pre;\n }\n\n function writeDefinition(obj, indent) {\n indent++;\n var opt = { indent: indent, obj: obj };\n switch (obj.type) {\n case \"typedef\":\n return idlTypedefTmpl(opt);\n case \"includes\":\n return idlIncludesTmpl(opt);\n case \"implements\":\n return idlImplementsTmpl(opt);\n case \"interface\":\n return writeInterfaceDefinition(opt);\n case \"interface mixin\":\n return writeInterfaceDefinition(opt, { mixin: true });\n case \"callback interface\":\n return writeInterfaceDefinition(opt, { callback: true });\n case \"dictionary\":\n var maxQualifiers = 0,\n maxType = 0;\n var members = obj.members.filter(function (member) {\n return !typeIsWhitespace(member.type);\n });\n for (const it of obj.members) {\n if (typeIsWhitespace(it.type)) {\n continue;\n }\n const qualifiers = it.required ? \"required \" : \"\";\n if (maxQualifiers < qualifiers.length) maxQualifiers = qualifiers.length;\n\n var typeLen = idlType2Text(it.idlType).length;\n if (maxType < typeLen) maxType = typeLen;\n }\n var children = obj.members.map(function (it) {\n switch (it.type) {\n case \"field\":\n return writeMember(it, maxQualifiers, maxType, indent + 1);\n case \"line-comment\":\n return writeLineComment(it, indent + 1);\n case \"multiline-comment\":\n return writeMultiLineComment(it, indent + 1);\n case \"ws\":\n return writeBlankLines(it);\n case \"ws-pea\":\n break;\n default:\n throw new Error(\"Unexpected type in dictionary: `\" + it.type + \"`.\");\n }\n }).join(\"\");\n return idlDictionaryTmpl({\n obj: obj,\n indent: indent,\n children: children,\n partial: obj.partial ? \"partial \" : \"\"\n });\n case \"callback\":\n var paramObjs = obj.arguments.filter(function (it) {\n return !typeIsWhitespace(it.type);\n }).map(function (it) {\n return idlParamTmpl({\n obj: it,\n optional: it.optional ? \"optional \" : \"\",\n variadic: it.variadic ? \"...\" : \"\"\n });\n });\n var callbackObj = {\n obj: obj,\n indent: indent,\n children: paramObjs.join(\", \")\n };\n var ret = idlCallbackTmpl(callbackObj);\n var line = $(ret).text();\n if (line.length > 80) {\n var paramPad = line.indexOf(\"(\") + 1;\n callbackObj.children = paramObjs.join(\",\\n\" + pads(paramPad));\n\n ret = idlCallbackTmpl(callbackObj);\n }\n return ret;\n case \"enum\":\n var children = \"\";\n for (var i = 0; i < obj.values.length; i++) {\n var item = obj.values[i];\n switch (item.type) {\n case \"string\":\n var needsComma = false;\n for (var j = i + 1; j < obj.values.length; j++) {\n var lookahead = obj.values[j];\n if (lookahead.type === undefined) break;\n if (lookahead.type === \",\") {\n needsComma = true;\n break;\n }\n }\n children += idlEnumItemTmpl({\n lname: item.value ? item.value.toLowerCase() : \"the-empty-string\",\n name: item.value,\n parentID: obj.name.toLowerCase(),\n indent: indent + 1,\n needsComma: needsComma\n });\n break;\n case \"line-comment\":\n children += writeLineComment(item, indent + 1);\n break;\n case \"multiline-comment\":\n children += writeMultiLineComment(item, indent + 1);\n break;\n case \"ws\":\n children += writeBlankLines(item);\n break;\n case \",\":\n case \"ws-pea\":\n break;\n default:\n throw new Error(\"Unexpected type in exception: `\" + item.type + \"`.\");\n }\n }\n return idlEnumTmpl({ obj: obj, indent: indent, children: children });\n default:\n (0, _pubsubhub.pub)(\"error\", \"Unexpected object type `\" + obj.type + \"` in \" + JSON.stringify(obj));\n return \"\";\n }\n }\n\n function writeInterfaceDefinition(opt, fixes = {}) {\n var obj = opt.obj,\n indent = opt.indent;\n var maxAttr = 0,\n maxAttrQualifiers = 0,\n maxMeth = 0,\n maxConst = 0;\n for (const it of obj.members) {\n if (typeIsWhitespace(it.type) || it.type === \"maplike\" || it.type === \"iterable\") {\n continue;\n }\n var len = idlType2Text(it.idlType).length;\n if (it.type === \"attribute\") {\n var qualifiersLen = writeAttributeQualifiers(it).length;\n maxAttr = Math.max(len, maxAttr);\n maxAttrQualifiers = Math.max(qualifiersLen, maxAttrQualifiers);\n } else if (it.type === \"operation\") {\n if (it.static) {\n len += \"static \".length;\n } else if (it.stringifier) {\n len += \"stringifier \".length;\n } else if (it.getter) {\n len += \"getter \".length;\n } else if (it.setter) {\n len += \"setter \".length;\n }\n maxMeth = Math.max(len, maxMeth);\n } else if (it.type === \"const\") {\n maxConst = Math.max(len, maxConst);\n }\n }\n var children = obj.members.map(function (ch) {\n switch (ch.type) {\n case \"attribute\":\n return writeAttribute(ch, maxAttr, indent + 1, maxAttrQualifiers);\n case \"operation\":\n return writeMethod(ch, maxMeth, indent + 1);\n case \"const\":\n return writeConst(ch, maxConst, indent + 1);\n case \"maplike\":\n return writeMaplike(ch, indent + 1);\n case \"iterable\":\n return writeIterable(ch, indent + 1);\n case \"ws\":\n return writeBlankLines(ch);\n case \"line-comment\":\n return writeLineComment(ch, indent + 1);\n case \"multiline-comment\":\n return writeMultiLineComment(ch, indent + 1);\n default:\n throw new Error(\"Unexpected member type: `\" + ch.type + \"`.\");\n }\n }).join(\"\");\n return idlInterfaceTmpl({\n obj,\n indent,\n partial: obj.partial ? \"partial \" : \"\",\n callback: fixes.callback ? \"callback \" : \"\",\n mixin: fixes.mixin ? \"mixin \" : \"\",\n children\n });\n }\n\n function writeField(attr, max, indent) {\n var pad = max - idlType2Text(attr.idlType).length;\n return idlFieldTmpl({\n obj: attr,\n indent: indent,\n pad: pad\n });\n }\n\n function writeAttributeQualifiers(attr) {\n var qualifiers = \"\";\n if (attr.static) qualifiers += \"static \";\n if (attr.stringifier) qualifiers += \"stringifier \";\n if (attr.inherit) qualifiers += \"inherit \";\n if (attr.readonly) qualifiers += \"readonly \";\n return qualifiers;\n }\n\n function writeAttribute(attr, max, indent, maxQualifiers) {\n var len = idlType2Text(attr.idlType).length;\n var pad = max - len;\n var qualifiers = writeAttributeQualifiers(attr);\n qualifiers += pads(maxQualifiers);\n qualifiers = qualifiers.slice(0, maxQualifiers);\n return idlAttributeTmpl({\n obj: attr,\n indent: indent,\n qualifiers: qualifiers,\n pad: pad\n });\n }\n\n function writeMethod(meth, max, indent) {\n var paramObjs = meth.arguments.filter(function (it) {\n return !typeIsWhitespace(it.type);\n }).map(function (it) {\n return idlParamTmpl({\n obj: it,\n optional: it.optional ? \"optional \" : \"\",\n variadic: it.variadic ? \"...\" : \"\"\n });\n });\n var params = paramObjs.join(\", \");\n var len = idlType2Text(meth.idlType).length;\n var specialProps = [\"getter\", \"setter\", \"deleter\", \"stringifier\", \"static\"];\n var special = \"\";\n for (var i in specialProps) {\n if (meth[specialProps[i]]) {\n special = specialProps[i] + \" \";\n len += special.length;\n break;\n }\n }\n var pad = max - len;\n var methObj = {\n obj: meth,\n indent: indent,\n special: special,\n pad: pad,\n children: params\n };\n var ret = idlMethodTmpl(methObj);\n var line = $(ret).text();\n if (line.length > 80) {\n var paramPad = line.indexOf(\"(\") + 1;\n methObj.children = paramObjs.join(\",\\n\" + pads(paramPad));\n ret = idlMethodTmpl(methObj);\n }\n return ret;\n }\n\n function writeConst(cons, max, indent) {\n var pad = max - idlType2Text(cons.idlType).length;\n if (cons.nullable) pad--;\n return idlConstTmpl({\n obj: cons,\n indent: indent,\n pad: pad,\n nullable: cons.nullable ? \"?\" : \"\"\n });\n }\n\n // Writes a single blank line if whitespace includes at least one blank line.\n function writeBlankLines(whitespace) {\n if (/\\n.*\\n/.test(whitespace.value)) {\n // Members end with a newline, so we only need 1 extra one to get a blank line.\n return \"\\n\";\n }\n return \"\";\n }\n\n function writeLineComment(comment, indent) {\n return idlLineCommentTmpl({ indent: indent, comment: comment.value });\n }\n\n function writeMultiLineComment(comment, indent) {\n // Split the multi-line comment into lines so we can indent it properly.\n var lines = comment.value.split(/\\r\\n|\\r|\\n/);\n if (lines.length === 0) {\n return \"\";\n } else if (lines.length === 1) {\n return idlLineCommentTmpl({ indent: indent, comment: lines[0] });\n }\n var initialSpaces = Math.max(0, /^ */.exec(lines[1])[0].length - 3);\n\n function trimInitialSpace(line) {\n return line.slice(initialSpaces);\n }\n return idlMultiLineCommentTmpl({\n indent: indent,\n firstLine: lines[0],\n lastLine: trimInitialSpace(lines[lines.length - 1]),\n innerLine: lines.slice(1, -1).map(trimInitialSpace)\n });\n }\n\n function writeMaplike(maplike, indent) {\n return idlMaplikeTmpl({\n obj: maplike,\n qualifiers: maplike.readonly ? \"readonly \" : \"\",\n indent: indent\n });\n }\n\n function writeIterable(iterable, indent) {\n return idlIterableTmpl({\n obj: iterable,\n qualifiers: iterable.readonly ? \"readonly \" : \"\",\n indent: indent\n });\n }\n\n function writeMember(memb, maxQualifiers, maxType, indent) {\n var opt = { obj: memb, indent: indent };\n opt.typePad = maxType - idlType2Text(memb.idlType).length;\n if (memb.required) opt.qualifiers = \"required \";else opt.qualifiers = \" \";\n opt.qualifiers = opt.qualifiers.slice(0, maxQualifiers);\n return idlDictMemberTmpl(opt);\n }\n\n // Each entity defined in IDL is either a top- or second-level entity:\n // Interface or Interface.member. This function finds the <dfn>\n // element defining each entity and attaches it to the entity's\n // 'refTitle' property, and records that it describes an IDL entity by\n // adding a [data-idl] attribute.\n\n function linkDefinitions(parse, definitionMap, parent, idlElem) {\n parse\n // Don't bother with any of these\n .filter(({ type }) => [\"includes\", \"implements\", \"ws\", \"ws-pea\", \"ws-tpea\", \"line-comment\", \"multiline-comment\"].includes(type) === false).forEach(function (defn) {\n var name;\n switch (defn.type) {\n // Top-level entities with linkable members.\n case \"callback interface\":\n case \"dictionary\":\n case \"interface\":\n case \"interface mixin\":\n var partialIdx = \"\";\n if (defn.partial) {\n if (!idlPartials[defn.name]) {\n idlPartials[defn.name] = [];\n }\n idlPartials[defn.name].push(defn);\n partialIdx = \"-partial-\" + idlPartials[defn.name].length;\n }\n linkDefinitions(defn.members, definitionMap, defn.name, idlElem);\n name = defn.name;\n defn.idlId = \"idl-def-\" + name.toLowerCase() + partialIdx;\n break;\n case \"enum\":\n name = defn.name;\n for (const v of defn.values) {\n if (v.type === \"string\") {\n v.dfn = findDfn(name, v.value, definitionMap, defn.type, idlElem);\n }\n }\n defn.idlId = \"idl-def-\" + name.toLowerCase();\n break;\n // Top-level entities without linkable members.\n case \"callback\":\n case \"typedef\":\n name = defn.name;\n defn.idlId = \"idl-def-\" + name.toLowerCase();\n break;\n // Members of top-level entities.\n case \"attribute\":\n case \"const\":\n case \"field\":\n name = defn.name;\n defn.idlId = \"idl-def-\" + parent.toLowerCase() + \"-\" + name.toLowerCase();\n break;\n case \"operation\":\n if (defn.name) {\n name = defn.name;\n var qualifiedName = parent + \".\" + name;\n var fullyQualifiedName = parent + \".\" + name + \"()\";\n if (!operationNames[fullyQualifiedName]) {\n operationNames[fullyQualifiedName] = [];\n }\n if (!operationNames[qualifiedName]) {\n operationNames[qualifiedName] = [];\n } else {\n defn.overload = operationNames[qualifiedName].length;\n name = defn.name + \"!overload-\" + defn.overload;\n }\n operationNames[fullyQualifiedName].push(defn);\n operationNames[qualifiedName].push(defn);\n } else if (defn.getter || defn.setter || defn.deleter || defn.stringifier) {\n name = \"\";\n }\n const idHead = `idl-def-${parent.toLowerCase()}-${name.toLowerCase()}`;\n const idTail = defn.overload || !defn.arguments.length ? \"\" : \"-\" + defn.arguments.filter(arg => !typeIsWhitespace(arg.type)).map(arg => arg.name.toLowerCase()).join(\"-\").replace(/\\s/g, \"_\");\n defn.idlId = idHead + idTail;\n break;\n case \"maplike\":\n name = \"maplike\";\n defn.idlId = (\"idl-def-\" + parent + \"-\" + name).toLowerCase();\n break;\n case \"iterable\":\n name = \"iterable\";\n defn.idlId = \"idl-def-\" + parent.toLowerCase() + \"-\" + name.toLowerCase();\n break;\n default:\n (0, _pubsubhub.pub)(\"error\", new Error(\"ReSpec doesn't know about IDL type: `\" + defn.type + \"`.\"));\n return;\n }\n if (parent) {\n defn.linkFor = parent;\n }\n defn.dfn = findDfn(parent, name, definitionMap, defn.type, idlElem);\n });\n }\n\n // This function looks for a <dfn> element whose title is 'name' and\n // that is \"for\" 'parent', which is the empty string when 'name'\n // refers to a top-level entity. For top-level entities, <dfn>\n // elements that inherit a non-empty [dfn-for] attribute are also\n // counted as matching.\n //\n // When a matching <dfn> is found, it's given <code> formatting,\n // marked as an IDL definition, and returned. If no <dfn> is found,\n // the function returns 'undefined'.\n function findDfn(parent, name, definitionMap, type, idlElem) {\n const originalParent = parent;\n const originalName = name;\n parent = parent.toLowerCase();\n switch (type) {\n case \"operation\":\n // Overloads all have unique names\n if (name.search(\"!overload\") !== -1) {\n name = name.toLowerCase();\n break;\n }\n // Allow linking to both \"method()\" and \"method\" name.\n const asMethodName = name.toLowerCase() + \"()\";\n const asFullyQualifiedName = parent + \".\" + name.toLowerCase() + \"()\";\n\n if (definitionMap[asMethodName] || definitionMap[asFullyQualifiedName]) {\n const lookupName = definitionMap[asMethodName] ? asMethodName : asFullyQualifiedName;\n const dfn = findDfn(parent, lookupName, definitionMap, null, idlElem);\n if (!dfn) {\n break; // try finding dfn using name, using normal search path...\n }\n const lt = dfn[0].dataset.lt ? dfn[0].dataset.lt.split(\"|\") : [];\n lt.push(lookupName, name);\n dfn[0].dataset.lt = lt.join(\"|\");\n if (!definitionMap[name]) {\n definitionMap[name] = [];\n }\n definitionMap[name].push(dfn);\n return dfn;\n }\n // no method alias, so let's find the dfn and add it\n const dfn = findDfn(parent, name, definitionMap, null, idlElem);\n if (!dfn) {\n break;\n }\n const lt = dfn[0].dataset.lt ? dfn[0].dataset.lt.split(\"|\") : [];\n lt.push(asMethodName, name);\n dfn[0].dataset.lt = lt.reverse().join(\"|\");\n definitionMap[asMethodName] = [dfn];\n return dfn;\n case \"enum\":\n if (name === \"\") {\n name = \"the-empty-string\";\n break;\n }\n default:\n name = name.toLowerCase();\n }\n if (unlinkable.has(name)) {\n return;\n }\n var dfnForArray = definitionMap[name];\n var dfns = [];\n if (dfnForArray) {\n // Definitions that have a title and [data-dfn-for] that exactly match the\n // IDL entity:\n dfns = dfnForArray.filter(dfn => dfn[0].dataset.dfnFor === parent);\n // If this is a top-level entity, and we didn't find anything with\n // an explicitly empty [for], try <dfn> that inherited a [for].\n if (dfns.length === 0 && parent === \"\" && dfnForArray.length === 1) {\n dfns = dfnForArray;\n }\n }\n // If we haven't found any definitions with explicit [for]\n // and [title], look for a dotted definition, \"parent.name\".\n if (dfns.length === 0 && parent !== \"\") {\n var dottedName = parent + \".\" + name;\n dfnForArray = definitionMap[dottedName];\n if (dfnForArray !== undefined && dfnForArray.length === 1) {\n dfns = dfnForArray;\n // Found it: update the definition to specify its [for] and data-lt.\n delete definitionMap[dottedName];\n dfns[0].attr(\"data-dfn-for\", parent);\n dfns[0].attr(\"data-lt\", name);\n if (definitionMap[name] === undefined) {\n definitionMap[name] = [];\n }\n definitionMap[name].push(dfns[0]);\n }\n }\n if (dfns.length > 1) {\n const msg = `Multiple \\`<dfn>\\`s for \\`${originalName}\\` ${originalParent ? `in \\`${originalParent}\\`` : \"\"}`;\n (0, _pubsubhub.pub)(\"error\", new Error(msg));\n }\n if (dfns.length === 0) {\n const showWarnings = type && idlElem && name && idlElem.classList.contains(\"no-link-warnings\") === false;\n if (showWarnings) {\n var msg = `No \\`<dfn>\\` for ${type} \\`${originalName}\\`${originalParent ? \" in `\" + originalParent + \"`\" : \"\"}`;\n msg += \". [More info](https://github.com/w3c/respec/wiki/WebIDL-thing-is-not-defined).\";\n (0, _pubsubhub.pub)(\"warn\", msg);\n }\n return;\n }\n const dfn = dfns[0][0]; // work on actual node, not jquery\n const id = \"dom-\" + (parent ? parent + \"-\" : \"\") + name.replace(/[()]/g, \"\");\n dfn.id = id;\n dfn.dataset.idl = \"\";\n dfn.dataset.title = dfn.textContent;\n dfn.dataset.dfnFor = parent;\n // Mark the definition as code.\n if (!dfn.querySelector(\"code\") && !dfn.closest(\"code\") && dfn.children) {\n const code = dfn.ownerDocument.createElement(\"code\");\n while (dfn.hasChildNodes()) {\n code.appendChild(dfn.firstChild);\n }\n dfn.appendChild(code);\n }\n return dfns[0];\n }\n var resolveDone;\n\n const done = exports.done = new Promise(function (resolve) {\n resolveDone = resolve;\n });\n\n function run(conf, doc, cb) {\n var finish = function () {\n resolveDone();\n (0, _pubsubhub.pub)(\"end\", \"core/webidl\");\n cb();\n };\n var $idl = $(\"pre.idl\", doc);\n if (!$idl.length) {\n return finish();\n }\n registerHelpers();\n if (!$(\".idl\", doc).not(\"pre\").length) {\n $(doc).find(\"head link\").first().before($(\"<style/>\").text(_webidl4.default));\n }\n\n $idl.each(function () {\n var parse;\n try {\n parse = _webidl2.default.parse($(this).text(), { ws: true });\n } catch (e) {\n (0, _pubsubhub.pub)(\"error\", `Failed to parse WebIDL: \\`${e.message}\\`.\n <details>\n <pre>${(0, _utils.normalizePadding)(this.textContent)}\\n ${e}</pre>\n </details>`);\n // Skip this <pre> and move on to the next one.\n return;\n }\n linkDefinitions(parse, conf.definitionMap, \"\", this);\n var $df = makeMarkup(conf, parse);\n $df.attr({ id: this.id });\n $df.find(\".idlAttribute,.idlCallback,.idlConst,.idlDictionary,.idlEnum,.idlException,.idlField,.idlInterface,.idlMember,.idlMethod,.idlMaplike,.idlIterable,.idlTypedef\").each(function () {\n var elem = $(this);\n var title = elem.attr(\"data-title\").toLowerCase();\n // Select the nearest ancestor element that can contain members.\n var parent = elem.parent().closest(\".idlDictionary,.idlEnum,.idlException,.idlInterface\");\n if (parent.length) {\n elem.attr(\"data-dfn-for\", parent.attr(\"data-title\").toLowerCase());\n }\n if (!conf.definitionMap[title]) {\n conf.definitionMap[title] = [];\n }\n conf.definitionMap[title].push(elem);\n });\n $(this).replaceWith($df);\n $df[0].classList.add(...this.classList);\n });\n doc.normalize();\n finish();\n }\n});\n//# sourceMappingURL=webidl.js.map;\n", - "define('core/biblio-db',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.biblioDB = exports.name = undefined;\n const name = exports.name = \"core/biblio-db\"; /**\n * Module core/biblio-db\n *\n * Wraps IndexedDB, allowing the storage of references and aliases on the\n * client.\n *\n * It's a standalone module that can be imported into other modules.\n *\n */\n /*globals IDBKeyRange, DOMException, console */\n\n\n const ALLOWED_TYPES = new Set([\"alias\", \"reference\"]);\n // Database initialization, tracked by \"readyPromise\"\n const readyPromise = new Promise((resolve, reject) => {\n let request;\n try {\n request = window.indexedDB.open(\"respec-biblio2\", 12);\n } catch (err) {\n return reject(err);\n }\n request.onerror = () => {\n reject(new DOMException(request.error.message, request.error.name));\n };\n request.onsuccess = () => {\n resolve(request.result);\n };\n request.onupgradeneeded = async () => {\n const db = request.result;\n Array.from(db.objectStoreNames).map(storeName => db.deleteObjectStore(storeName));\n const promisesToCreateSchema = [new Promise((resolve, reject) => {\n try {\n const store = db.createObjectStore(\"alias\", { keyPath: \"id\" });\n store.createIndex(\"aliasOf\", \"aliasOf\", { unique: false });\n store.transaction.oncomplete = resolve;\n store.transaction.onerror = reject;\n } catch (err) {\n reject(err);\n }\n }), new Promise((resolve, reject) => {\n try {\n const transaction = db.createObjectStore(\"reference\", {\n keyPath: \"id\"\n }).transaction;\n transaction.oncomplete = resolve;\n transaction.onerror = reject;\n } catch (err) {\n reject(err);\n }\n })];\n try {\n await Promise.all(promisesToCreateSchema);\n resolve();\n } catch (err) {\n reject(err);\n }\n };\n });\n\n const biblioDB = exports.biblioDB = {\n get ready() {\n return readyPromise;\n },\n /**\n * Finds either a reference or an alias.\n * If it's an alias, it resolves it.\n *\n * @param {String} id The reference or alias to look for.\n * @return {Object?} The reference or null.\n */\n async find(id) {\n if (await this.isAlias(id)) {\n id = await this.resolveAlias(id);\n }\n return this.get(\"reference\", id);\n },\n /**\n * Checks if the database has an id for a given type.\n *\n * @param {String} type One of the ALLOWED_TYPES.\n * @param {String} id The reference to find.\n * @return {Boolean} True if it has it, false otherwise.\n */\n async has(type, id) {\n if (!ALLOWED_TYPES.has(type)) {\n throw new TypeError(\"Invalid type: \" + type);\n }\n if (!id) {\n throw new TypeError(\"id is required\");\n }\n const db = await this.ready;\n return new Promise((resolve, reject) => {\n var objectStore = db.transaction([type], \"readonly\").objectStore(type);\n var range = IDBKeyRange.only(id);\n var request = objectStore.openCursor(range);\n request.onsuccess = () => {\n resolve(!!request.result);\n };\n request.onerror = () => {\n reject(new DOMException(request.error.message, request.error.name));\n };\n });\n },\n /**\n * Checks if a given id is an alias.\n *\n * @param {String} id The reference to check.\n * @return {Promise<Boolean>} Resolves with true if found.\n */\n async isAlias(id) {\n if (!id) {\n throw new TypeError(\"id is required\");\n }\n const db = await this.ready;\n return new Promise((resolve, reject) => {\n var objectStore = db.transaction([\"alias\"], \"readonly\").objectStore(\"alias\");\n var range = IDBKeyRange.only(id);\n var request = objectStore.openCursor(range);\n request.onsuccess = () => {\n resolve(!!request.result);\n };\n request.onerror = () => {\n reject(new DOMException(request.error.message, request.error.name));\n };\n });\n },\n /**\n * Resolves an alias to its corresponding reference id.\n *\n * @param {String} id The id of the alias to look up.\n * @return {Promise<String>} The id of the resolved reference.\n */\n async resolveAlias(id) {\n if (!id) {\n throw new TypeError(\"id is required\");\n }\n const db = await this.ready;\n return new Promise((resolve, reject) => {\n var objectStore = db.transaction(\"alias\", \"readonly\").objectStore(\"alias\");\n var range = IDBKeyRange.only(id);\n var request = objectStore.openCursor(range);\n request.onsuccess = () => {\n if (request.result === null) {\n return resolve(null);\n }\n resolve(request.result.value.aliasOf);\n };\n request.onerror = () => {\n reject(new DOMException(request.error.message, request.error.name));\n };\n });\n },\n /**\n * Get a reference or alias out of the database.\n *\n * @param {String} type The type as per ALLOWED_TYPES.\n * @param {[type]} id The id for what to look up.\n * @return {Promise<Object?>} Resolves with the retrieved object, or null.\n */\n async get(type, id) {\n if (!ALLOWED_TYPES.has(type)) {\n throw new TypeError(\"Invalid type: \" + type);\n }\n if (!id) {\n throw new TypeError(\"id is required\");\n }\n const db = await this.ready;\n return new Promise((resolve, reject) => {\n var objectStore = db.transaction([type], \"readonly\").objectStore(type);\n var range = IDBKeyRange.only(id);\n var request = objectStore.openCursor(range);\n request.onsuccess = () => {\n if (request.result === null) {\n return resolve(null);\n }\n resolve(request.result.value);\n };\n request.onerror = () => {\n reject(new DOMException(request.error.message, request.error.name));\n };\n });\n },\n /**\n * Adds references and aliases to database. This is usually the data from\n * Specref's output (parsed JSON).\n *\n * @param {Object} data An object that contains references and aliases.\n */\n async addAll(data) {\n if (!data) {\n return;\n }\n const aliasesAndRefs = {\n alias: new Set(),\n reference: new Set()\n };\n Object.keys(data).filter(key => {\n if (typeof data[key] === \"string\") {\n let msg = `Legacy SpecRef entries are not supported: \\`[[${key}]]\\`. `;\n msg += \"Please update it to the new format at [specref repo](https://github.com/tobie/specref/)\";\n (0, _pubsubhub.pub)(\"error\", msg);\n return false;\n }\n return true;\n }).map(id => Object.assign({ id }, data[id])).reduce((collector, obj) => {\n if (obj.aliasOf) {\n collector.alias.add(obj);\n } else {\n collector.reference.add(obj);\n }\n return collector;\n }, aliasesAndRefs);\n const promisesToAdd = Object.keys(aliasesAndRefs).map(type => {\n return Array.from(aliasesAndRefs[type]).map(details => this.add(type, details));\n }).reduce((collector, promises) => collector.concat(promises), []);\n await Promise.all(promisesToAdd);\n },\n /**\n * Adds a reference or alias to the database.\n *\n * @param {String} type The type as per ALLOWED_TYPES.\n * @param {String} details The object to store.\n */\n async add(type, details) {\n if (!ALLOWED_TYPES.has(type)) {\n throw new TypeError(\"Invalid type: \" + type);\n }\n if (typeof details !== \"object\") {\n throw new TypeError(\"details should be an object\");\n }\n if (type === \"alias\" && !details.hasOwnProperty(\"aliasOf\")) {\n throw new TypeError(\"Invalid alias object.\");\n }\n const db = await this.ready;\n const isInDB = await this.has(type, details.id);\n return new Promise((resolve, reject) => {\n const store = db.transaction([type], \"readwrite\").objectStore(type);\n // update or add, depending of already having it in db\n var request = isInDB ? store.put(details) : store.add(details);\n request.onsuccess = resolve;\n request.onerror = () => {\n reject(new DOMException(request.error.message, request.error.name));\n };\n });\n },\n /**\n * Closes the underlying database.\n *\n * @return {Promise} Resolves after database closes.\n */\n async close() {\n const db = await this.ready;\n db.close();\n }\n };\n});\n//# sourceMappingURL=biblio-db.js.map;\n", - "define('core/biblio',[\"exports\", \"core/biblio-db\", \"core/utils\", \"core/pubsubhub\"], function (exports, _biblioDb, _utils, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.done = exports.name = undefined;\n exports.wireReference = wireReference;\n exports.stringifyReference = stringifyReference;\n exports.resolveRef = resolveRef;\n exports.run = run;\n const name = exports.name = \"core/biblio\"; // Module core/biblio\n // Handles bibliographic references\n // Configuration:\n // - localBiblio: override or supplement the official biblio with your own.\n\n /*jshint jquery: true*/\n /*globals console*/\n\n\n const bibrefsURL = new URL(\"https://specref.herokuapp.com/bibrefs?refs=\");\n\n // Normative references take precedence over informative ones,\n // so any duplicates ones are removed from the informative set.\n function normalizeReferences(conf) {\n Array.from(conf.informativeReferences).filter(key => conf.normativeReferences.has(key)).forEach(redundantKey => conf.informativeReferences.delete(redundantKey));\n }\n\n function getRefKeys(conf) {\n return {\n informativeReferences: Array.from(conf.informativeReferences),\n normativeReferences: Array.from(conf.normativeReferences)\n };\n }\n\n const REF_STATUSES = new Map([[\"CR\", \"W3C Candidate Recommendation\"], [\"ED\", \"W3C Editor's Draft\"], [\"FPWD\", \"W3C First Public Working Draft\"], [\"LCWD\", \"W3C Last Call Working Draft\"], [\"NOTE\", \"W3C Note\"], [\"PER\", \"W3C Proposed Edited Recommendation\"], [\"PR\", \"W3C Proposed Recommendation\"], [\"REC\", \"W3C Recommendation\"], [\"WD\", \"W3C Working Draft\"], [\"WG-NOTE\", \"W3C Working Group Note\"]]);\n\n const defaultsReference = Object.freeze({\n authors: [],\n date: \"\",\n href: \"\",\n publisher: \"\",\n status: \"\",\n title: \"\",\n etAl: false\n });\n\n const endNormalizer = function (endStr) {\n return str => {\n const trimmed = str.trim();\n const result = !trimmed || trimmed.endsWith(endStr) ? trimmed : trimmed + endStr;\n return result;\n };\n };\n\n const endWithDot = endNormalizer(\".\");\n\n function wireReference(rawRef, target = \"_blank\") {\n if (typeof rawRef !== \"object\") {\n throw new TypeError(\"Only modern object references are allowed\");\n }\n const ref = Object.assign({}, defaultsReference, rawRef);\n const authors = ref.authors.join(\"; \") + (ref.etAl ? \" et al\" : \"\");\n const status = REF_STATUSES.get(ref.status) || ref.status;\n return hyperHTML.wire(ref)`\n <cite>\n <a\n href=\"${ref.href}\"\n target=\"${target}\"\n rel=\"noopener noreferrer\">\n ${ref.title.trim()}</a>.\n </cite>\n <span class=\"authors\">\n ${endWithDot(authors)}\n </span>\n <span class=\"publisher\">\n ${endWithDot(ref.publisher)}\n </span>\n <span class=\"pubDate\">\n ${endWithDot(ref.date)}\n </span>\n <span class=\"pubStatus\">\n ${endWithDot(status)}\n </span>\n `;\n }\n\n function stringifyReference(ref) {\n if (typeof ref === \"string\") return ref;\n let output = `<cite>${ref.title}</cite>`;\n\n output = ref.href ? `<a href=\"${ref.href}\">${output}</a>. ` : `${output}. `;\n\n if (ref.authors && ref.authors.length) {\n output += ref.authors.join(\"; \");\n if (ref.etAl) output += \" et al\";\n output += \".\";\n }\n if (ref.publisher) {\n const publisher = ref.publisher + (/\\.$/.test(ref.publisher) ? \"\" : \".\");\n output = `${output} ${publisher} `;\n }\n if (ref.date) output += ref.date + \". \";\n if (ref.status) output += (REF_STATUSES.get(ref.status) || ref.status) + \". \";\n if (ref.href) output += `URL: <a href=\"${ref.href}\">${ref.href}</a>`;\n return output;\n }\n\n function bibref(conf) {\n // this is in fact the bibref processing portion\n var badrefs = {};\n var refKeys = getRefKeys(conf);\n var informs = refKeys.informativeReferences;\n var norms = refKeys.normativeReferences;\n var aliases = {};\n\n if (!informs.length && !norms.length && !conf.refNote) return;\n var $refsec = $(\"<section id='references' class='appendix'><h2>\" + conf.l10n.references + \"</h2></section>\").appendTo($(\"body\"));\n if (conf.refNote) $(\"<p></p>\").html(conf.refNote).appendTo($refsec);\n\n var types = [\"Normative\", \"Informative\"];\n for (var i = 0; i < types.length; i++) {\n var type = types[i];\n var refs = type === \"Normative\" ? norms : informs;\n var l10nRefs = type === \"Normative\" ? conf.l10n.norm_references : conf.l10n.info_references;\n if (!refs.length) continue;\n var $sec = $(\"<section><h3></h3></section>\").appendTo($refsec).find(\"h3\").text(l10nRefs).end();\n $sec.makeID(null, type + \" references\");\n refs.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));\n var $dl = $(\"<dl class='bibliography'></dl>\").appendTo($sec);\n for (var j = 0; j < refs.length; j++) {\n var ref = refs[j];\n $(\"<dt></dt>\").attr({ id: \"bib-\" + ref }).text(\"[\" + ref + \"]\").appendTo($dl);\n var $dd = $(\"<dd></dd>\").appendTo($dl);\n var refcontent = conf.biblio[ref];\n var circular = {};\n var key = ref;\n circular[ref] = true;\n while (refcontent && refcontent.aliasOf) {\n if (circular[refcontent.aliasOf]) {\n refcontent = null;\n const msg = `Circular reference in biblio DB between [\\`${ref}\\`] and [\\`${key}\\`].`;\n (0, _pubsubhub.pub)(\"error\", msg);\n } else {\n key = refcontent.aliasOf;\n refcontent = conf.biblio[key];\n circular[key] = true;\n }\n }\n aliases[key] = aliases[key] || [];\n if (aliases[key].indexOf(ref) < 0) aliases[key].push(ref);\n if (refcontent) {\n $dd.html(stringifyReference(refcontent) + \"\\n\");\n } else {\n if (!badrefs[ref]) badrefs[ref] = 0;\n badrefs[ref]++;\n $dd.html(\"<em style='color: #f00'>Reference not found.</em>\\n\");\n }\n }\n }\n for (var k in aliases) {\n if (aliases[k].length > 1) {\n let msg = `[${k}] is referenced in ${aliases[k].length} ways: `;\n msg += `(${aliases[k].map(item => `'${item}'`).join(\", \")}). This causes`;\n msg += ` duplicate entries in the References section.`;\n (0, _pubsubhub.pub)(\"warn\", msg);\n }\n }\n for (var item in badrefs) {\n const msg = `Bad reference: [\\`${item}\\`] (appears ${badrefs[item]} times)`;\n if (badrefs.hasOwnProperty(item)) (0, _pubsubhub.pub)(\"error\", msg);\n }\n }\n // Opportunistically dns-prefetch to bibref server, as we don't know yet\n // if we will actually need to download references yet.\n var link = (0, _utils.createResourceHint)({\n hint: \"dns-prefetch\",\n href: bibrefsURL.origin\n });\n document.head.appendChild(link);\n let doneResolver;\n const done = exports.done = new Promise(resolve => {\n doneResolver = resolve;\n });\n\n async function updateFromNetwork(refs, options = { forceUpdate: false }) {\n // Update database if needed, if we are online\n if (!refs.length || navigator.onLine === false) {\n return;\n }\n let response;\n try {\n response = await fetch(bibrefsURL.href + refs.join(\",\"));\n } catch (err) {\n console.error(err);\n return null;\n }\n if (!options.forceUpdate && !response.ok || response.status !== 200) {\n return null;\n }\n const data = await response.json();\n try {\n await _biblioDb.biblioDB.addAll(data);\n } catch (err) {\n console.error(err);\n }\n return data;\n }\n\n async function resolveRef(key) {\n const biblio = await done;\n if (!biblio.hasOwnProperty(key)) {\n return null;\n }\n const entry = biblio[key];\n if (entry.aliasOf) {\n return await resolveRef(entry.aliasOf);\n }\n return entry;\n }\n\n async function run(conf, doc, cb) {\n const finish = () => {\n doneResolver(conf.biblio);\n cb();\n };\n if (!conf.localBiblio) {\n conf.localBiblio = {};\n }\n if (conf.biblio) {\n let msg = \"Overriding `.biblio` in config. Please use \";\n msg += \"`.localBiblio` for custom biblio entries.\";\n (0, _pubsubhub.pub)(\"warn\", msg);\n }\n conf.biblio = {};\n const localAliases = Array.from(Object.keys(conf.localBiblio)).filter(key => conf.localBiblio[key].hasOwnProperty(\"aliasOf\")).map(key => conf.localBiblio[key].aliasOf);\n normalizeReferences(conf);\n const allRefs = getRefKeys(conf);\n const neededRefs = allRefs.normativeReferences.concat(allRefs.informativeReferences)\n // Filter, as to not go to network for local refs\n .filter(key => !conf.localBiblio.hasOwnProperty(key))\n // but include local aliases, in case they refer to external specs\n .concat(localAliases)\n // remove duplicates\n .reduce((collector, item) => {\n if (collector.indexOf(item) === -1) {\n collector.push(item);\n }\n return collector;\n }, []).sort();\n const idbRefs = [];\n\n // See if we have them in IDB\n try {\n await _biblioDb.biblioDB.ready; // can throw\n const promisesToFind = neededRefs.map(async id => ({\n id,\n data: await _biblioDb.biblioDB.find(id)\n }));\n idbRefs.push(...(await Promise.all(promisesToFind)));\n } catch (err) {\n // IndexedDB died, so we need to go to the network for all\n // references\n idbRefs.push(...neededRefs.map(id => ({ id, data: null })));\n console.warn(err);\n }\n const split = { hasData: [], noData: [] };\n idbRefs.reduce((collector, ref) => {\n ref.data ? collector.hasData.push(ref) : collector.noData.push(ref);\n return collector;\n }, split);\n split.hasData.reduce((collector, ref) => {\n collector[ref.id] = ref.data;\n return collector;\n }, conf.biblio);\n const externalRefs = split.noData.map(item => item.id);\n if (externalRefs.length) {\n // Going to the network for refs we don't have\n const data = await updateFromNetwork(externalRefs, { forceUpdate: true });\n Object.assign(conf.biblio, data);\n }\n Object.assign(conf.biblio, conf.localBiblio);\n bibref(conf);\n finish();\n await updateFromNetwork(neededRefs);\n }\n});\n//# sourceMappingURL=biblio.js.map;\n", - "define('core/data-cite',[\"exports\", \"core/pubsubhub\", \"core/biblio\"], function (exports, _pubsubhub, _biblio) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n exports.linkInlineCitations = linkInlineCitations;\n /**\n * Module core/data-cite\n *\n * Allows citing other specifications using\n * anchor elements. Simply add \"data-cite\"\n * and key of specification.\n *\n * This module simply adds the found key\n * to either conf.normativeReferences\n * or to conf.informativeReferences depending on\n * if it starts with a ! or not.\n *\n * Usage:\n * https://github.com/w3c/respec/wiki/data--cite\n */\n const name = exports.name = \"core/data-cite\";\n\n function requestLookup(conf) {\n const toCiteDetails = citeDetailsConverter(conf);\n return async function (elem) {\n const originalKey = elem.dataset.cite;\n let { key, frag, path } = toCiteDetails(elem);\n let href = \"\";\n // This is just referring to this document\n if (key === conf.shortName) {\n href = document.location.href;\n } else {\n // Let's go look it up in spec ref...\n const entry = await (0, _biblio.resolveRef)(key);\n cleanElement(elem);\n if (!entry) {\n var msg = `Couldn't find a match for 'data-cite=${originalKey}'.`;\n console.warn(msg, elem);\n msg += \" Please check developer console for offending element.\";\n (0, _pubsubhub.pub)(\"warn\", msg);\n return;\n }\n href = entry.href;\n }\n if (path) {\n href = new URL(path, href).href;\n }\n if (frag) {\n href = new URL(frag, href).href;\n }\n switch (elem.localName) {\n case \"a\":\n {\n elem.href = href;\n break;\n }\n case \"dfn\":\n {\n const a = elem.ownerDocument.createElement(\"a\");\n a.href = href;\n while (elem.firstChild) {\n a.appendChild(elem.firstChild);\n }\n elem.appendChild(a, elem);\n break;\n }\n }\n };\n }\n\n function cleanElement(elem) {\n [\"data-cite\", \"data-cite-frag\"].filter(attrName => elem.hasAttribute(attrName)).forEach(attrName => elem.removeAttribute(attrName));\n }\n\n function citeDetailsConverter(conf) {\n return function toCiteDetails(elem) {\n const { dataset } = elem;\n let { cite: key, citeFrag: frag, citePath: path } = dataset;\n const isNormative = key.startsWith(\"!\");\n const pathPosition = key.search(\"/\");\n const fragPosition = key.search(\"#\");\n // The key is a fragment, resolve using the shortName as key\n if (key.startsWith(\"#\") && !frag) {\n // Closes data-cite not starting with \"#\"\n const closest = elem.parentElement.closest(`[data-cite]:not([data-cite^=\"#\"])`);\n const { key: parentKey, isNormative: closestIsNormative } = closest ? toCiteDetails(closest) : { key: conf.shortName || \"\", isNormative: false };\n elem.dataset.cite = closestIsNormative ? `!${parentKey}` : parentKey;\n elem.dataset.citeFrag = key; // the key is acting as fragment\n return toCiteDetails(elem);\n }\n if (fragPosition !== -1) {\n frag = !frag ? key.substr(fragPosition) : frag;\n key = key.substring(0, fragPosition);\n }\n if (pathPosition !== -1) {\n path = !path ? key.substr(pathPosition) : path;\n key = key.substring(0, pathPosition);\n }\n if (isNormative) {\n key = key.substr(1);\n }\n if (frag && !frag.startsWith(\"#\")) {\n frag = \"#\" + frag;\n }\n // remove head / for URL resolution\n if (path && path.startsWith(\"/\")) {\n path = path.substr(1);\n }\n return { key, isNormative, frag, path };\n };\n }\n\n async function run(conf) {\n const toCiteDetails = citeDetailsConverter(conf);\n Array.from(document.querySelectorAll([\"dfn[data-cite], a[data-cite]\"])).filter(el => el.dataset.cite).map(toCiteDetails).forEach(({ isNormative, key }) => {\n const refSink = isNormative ? conf.normativeReferences : conf.informativeReferences;\n refSink.add(key);\n });\n }\n\n async function linkInlineCitations(doc, conf = respecConfig) {\n const toLookupRequest = requestLookup(conf);\n const citedSpecs = doc.querySelectorAll(\"dfn[data-cite], a[data-cite]\");\n const lookupRequests = Array.from(citedSpecs).map(toLookupRequest);\n return await Promise.all(lookupRequests);\n }\n});\n//# sourceMappingURL=data-cite.js.map;\n", - "define('core/webidl-index',[\"exports\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.run = run;\n /**\n * Module: core/webidl-index\n * constructs a summary of WebIDL in the document by\n * cloning all the generated WebIDL nodes and\n * appending them to pre element.\n *\n * Usage\n * Add a <section id=\"idl-index\"> to the document.\n * It also supports title elements to generate a header.\n * Or if a header element is an immediate child, then\n * that is preferred.\n */\n const name = exports.name = \"core/webidl-index\";\n\n function run(conf, doc, cb) {\n const idlIndexSec = doc.querySelector(\"section#idl-index\");\n if (!idlIndexSec) {\n return cb();\n }\n // Query for decedents headings, e.g., \"h2:first-child, etc..\"\n const query = [2, 3, 4, 5, 6].map(level => `h${level}:first-child`).join(\",\");\n if (!idlIndexSec.querySelector(query)) {\n const header = document.createElement(\"h2\");\n if (idlIndexSec.title) {\n header.innerHTML = idlIndexSec.title;\n idlIndexSec.removeAttribute(\"title\");\n } else {\n header.innerHTML = \"IDL Index\";\n }\n idlIndexSec.insertAdjacentElement(\"afterbegin\", header);\n }\n if (!document.querySelector(\"pre.idl\")) {\n const text = \"This specification doesn't declare any Web IDL.\";\n const noIDLFound = document.createTextNode(text);\n idlIndexSec.appendChild(noIDLFound);\n return cb();\n }\n const virtualSummary = document.createDocumentFragment();\n const pre = document.createElement(\"pre\");\n pre.classList.add(\"idl\", \"def\");\n pre.id = \"actual-idl-index\";\n Array.from(document.querySelectorAll(\"pre.def.idl\")).map(elem => {\n const span = document.createElement(\"span\");\n const { children } = elem.cloneNode(true);\n for (const child of Array.from(children)) {\n span.appendChild(child);\n span.appendChild(document.createTextNode(\"\\n\"));\n }\n span.classList.add(\"respec-idl-separator\");\n return span;\n }).reduce((collector, elem) => {\n collector.appendChild(elem);\n return collector;\n }, pre);\n // Remove duplicate IDs\n Array.from(pre.querySelectorAll(\"*[id]\")).forEach(elem => elem.removeAttribute(\"id\"));\n virtualSummary.appendChild(pre);\n idlIndexSec.appendChild(virtualSummary);\n cb();\n }\n});\n//# sourceMappingURL=webidl-index.js.map;\n", - "define('core/link-to-dfn',[\"exports\", \"core/data-cite\", \"core/pubsubhub\", \"./l10n\"], function (exports, _dataCite, _pubsubhub, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"core/link-to-dfn\"; // Module core/link-to-dfn\n // Gives definitions in conf.definitionMap IDs and links <a> tags\n // to the matching definitions.\n\n const l10n = {\n en: {\n duplicate: \"This is defined more than once in the document.\"\n }\n };\n const lang = _l10n.lang in l10n ? _l10n.lang : \"en\";\n\n function run(conf, doc, cb) {\n doc.normalize();\n var titles = {};\n Object.keys(conf.definitionMap).forEach(function (title) {\n titles[title] = {};\n var listOfDuplicateDfns = [];\n conf.definitionMap[title].forEach(function (dfn) {\n if (dfn.attr(\"data-idl\") === undefined) {\n // Non-IDL definitions aren't \"for\" an interface.\n dfn.removeAttr(\"data-dfn-for\");\n }\n var dfn_for = dfn.attr(\"data-dfn-for\") || \"\";\n if (dfn_for in titles[title]) {\n // We want <dfn> definitions to take precedence over\n // definitions from WebIDL. WebIDL definitions wind\n // up as <span>s instead of <dfn>.\n var oldIsDfn = titles[title][dfn_for].filter(\"dfn\").length !== 0;\n var newIsDfn = dfn.filter(\"dfn\").length !== 0;\n if (oldIsDfn && newIsDfn) {\n // Only complain if the user provides 2 <dfn>s\n // for the same term.\n dfn.addClass(\"respec-offending-element\");\n if (dfn.attr(\"title\") === undefined) {\n dfn.attr(\"title\", l10n[lang].duplicate);\n }\n if (dfn.attr(\"id\") === undefined) {\n dfn.makeID(null, title);\n }\n listOfDuplicateDfns.push(dfn[0]);\n }\n if (oldIsDfn) {\n // Don't overwrite <dfn> definitions.\n return;\n }\n }\n titles[title][dfn_for] = dfn;\n if (dfn.attr(\"id\") === undefined) {\n if (dfn.attr(\"data-idl\")) {\n dfn.makeID(\"dom\", (dfn_for ? dfn_for + \"-\" : \"\") + title);\n } else {\n dfn.makeID(\"dfn\", title);\n }\n }\n });\n if (listOfDuplicateDfns.length > 0) {\n const dfnsList = listOfDuplicateDfns.map((elem, i) => {\n return `[${i + 1}](#${elem.id})`;\n }).join(\", \");\n (0, _pubsubhub.pub)(\"error\", `Duplicate definitions of '${title}' at: ${dfnsList}.`);\n }\n });\n $(\"a:not([href]):not([data-cite]):not(.logo)\").each(function () {\n const $ant = $(this);\n if ($ant.hasClass(\"externalDFN\")) return;\n const linkTargets = $ant.linkTargets();\n const foundDfn = linkTargets.some(function (target) {\n if (titles[target.title] && titles[target.title][target.for]) {\n const dfn = titles[target.title][target.for];\n if (dfn[0].dataset.cite) {\n $ant[0].dataset.cite = dfn[0].dataset.cite;\n } else {\n const frag = \"#\" + encodeURIComponent(dfn.prop(\"id\"));\n $ant.attr(\"href\", frag).addClass(\"internalDFN\");\n }\n // add a bikeshed style indication of the type of link\n if (!$ant.attr(\"data-link-type\")) {\n $ant.attr(\"data-link-type\", \"dfn\");\n }\n // If a definition is <code>, links to it should\n // also be <code>.\n //\n // Note that contents().length===1 excludes\n // definitions that have either other text, or other\n // whitespace, inside the <dfn>.\n if (dfn.closest(\"code,pre\").length || dfn.contents().length === 1 && dfn.children(\"code\").length === 1) {\n // only add code to IDL when the definition matches\n const term = $ant[0].textContent.trim();\n const isIDL = dfn[0].dataset.hasOwnProperty(\"idl\");\n const isSameText = isIDL ? dfn[0].dataset.title === term : dfn[0].textContent.trim() === term;\n if (isIDL && !isSameText) {\n return true;\n }\n $ant.wrapInner(\"<code></code>\");\n }\n return true;\n }\n return false;\n });\n if (!foundDfn && linkTargets.length !== 0) {\n // ignore WebIDL\n if (!$ant.parents(\".idl:not(.extAttr), dl.methods, dl.attributes, dl.constants, dl.constructors, dl.fields, dl.dictionary-members, span.idlMemberType, span.idlTypedefType, div.idlImplementsDesc\").length) {\n const link_for = linkTargets[0].for;\n const title = linkTargets[0].title;\n this.classList.add(\"respec-offending-element\");\n this.title = \"Linking error: not matching <dfn>\";\n (0, _pubsubhub.pub)(\"warn\", \"Found linkless <a> element \" + (link_for ? \"for '\" + link_for + \"' \" : \"\") + \"with text '\" + title + \"' but no matching `<dfn>`.\");\n console.warn(\"Linkless element:\", $ant[0]);\n return;\n }\n $ant.replaceWith($ant.contents());\n }\n });\n (0, _dataCite.linkInlineCitations)(doc, conf).then(() => {\n // Added message for legacy compat with Aria specs\n // See https://github.com/w3c/respec/issues/793\n (0, _pubsubhub.pub)(\"end\", \"core/link-to-dfn\");\n cb();\n });\n }\n});\n//# sourceMappingURL=link-to-dfn.js.map;\n", - "define('core/contrib',[\"exports\", \"core/github\", \"core/pubsubhub\", \"core/utils\"], function (exports, _github, _pubsubhub, _utils) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"core/contrib\"; // Module core/contrib\n // Fetches names of contributors from github and uses them to fill\n // in the content of elements with key identifiers:\n // #gh-commenters: people having contributed comments to issues.\n // #gh-contributors: people whose PR have been merged.\n // Spec editors get filtered out automatically.\n\n\n function prop(prop) {\n return o => o[prop];\n }\n const nameProp = prop(\"name\");\n const urlProp = prop(\"url\");\n\n function findUserURLs(...thingsWithUsers) {\n const usersURLs = thingsWithUsers.reduce(_utils.flatten, []).filter(thing => thing && thing.user).map(({ user }) => user.url);\n return [...new Set(usersURLs)];\n }\n\n async function toHTML(urls, editors, element, headers) {\n const args = await Promise.all(urls.map(url => fetch(url, { headers })));\n const names = args.map(([user]) => user.name || user.login).filter(name => !editors.includes(name)).sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));\n element.textContent = (0, _utils.joinAnd)(names);\n element.id = null;\n }\n\n async function run(conf) {\n const ghCommenters = document.getElementById(\"gh-commenters\");\n const ghContributors = document.getElementById(\"gh-contributors\");\n if (!ghCommenters && !ghContributors) {\n return;\n }\n const headers = {};\n const { githubAPI, githubUser, githubToken } = conf;\n if (githubUser && githubToken) {\n const credentials = btoa(`${githubUser}:${githubToken}`);\n const Authorization = `Basic ${credentials}`;\n Object.assign(headers, { Authorization });\n }\n if (!githubAPI) {\n const msg = \"Requested list of contributors and/or commenters from GitHub, but \" + \"[`githubAPI`](https://github.com/w3c/respec/wiki/githubAPI) is not set.\";\n (0, _pubsubhub.pub)(\"error\", msg);\n return;\n }\n const response = await fetch(githubAPI, { headers });\n if (!response.ok) {\n const msg = \"Error fetching repository information from GitHub. \" + `(HTTP Status ${response.status}).`;\n (0, _pubsubhub.pub)(\"error\", msg);\n return;\n }\n const indexes = await response.json();\n const { issues_url, issue_comment_url, contributors_url } = indexes;\n\n const [issues, comments, contributors] = await Promise.all([(0, _github.fetchIndex)(issues_url, headers), (0, _github.fetchIndex)(issue_comment_url, headers), (0, _github.fetchIndex)(contributors_url, headers)]);\n const editors = conf.editors.map(nameProp);\n const commenterUrls = ghCommenters ? findUserURLs(issues, comments) : [];\n const contributorUrls = ghContributors ? contributors.map(urlProp) : [];\n try {\n await Promise.all(toHTML(commenterUrls, editors, ghCommenters, headers), toHTML(contributorUrls, editors, ghContributors, headers));\n } catch (error) {\n (0, _pubsubhub.pub)(\"error\", \"Error loading contributors and/or commenters from GitHub.\");\n }\n }\n});\n//# sourceMappingURL=contrib.js.map;\n", - "define('core/fix-headers',[\"exports\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.run = run;\n // Module core/fix-headers\n // Make sure that all h1-h6 headers (that are first direct children of sections) are actually\n // numbered at the right depth level. This makes it possible to just use any of them (conventionally\n // h2) with the knowledge that the proper depth level will be used\n const name = exports.name = \"core/fix-headers\";\n\n function run(conf, doc, cb) {\n var $secs = $(\"section:not(.introductory)\", doc).find(\"h1:first, h2:first, h3:first, h4:first, h5:first, h6:first\");\n $secs.each(function () {\n var depth = $(this).parents(\"section\").length + 1;\n if (depth > 6) depth = 6;\n var h = \"h\" + depth;\n if (this.localName.toLowerCase() !== h) $(this).renameElement(h);\n });\n cb();\n }\n});\n//# sourceMappingURL=fix-headers.js.map;\n", - "define('core/structure',[\"exports\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.run = run;\n // Module core/structure\n // Handles producing the ToC and numbering sections across the document.\n\n // LIMITATION:\n // At this point we don't support having more than 26 appendices.\n // CONFIGURATION:\n // - noTOC: if set to true, no TOC is generated and sections are not numbered\n // - tocIntroductory: if set to true, the introductory material is listed in the TOC\n // - lang: can change the generated text (supported: en, fr)\n // - maxTocLevel: only generate a TOC so many levels deep\n\n var secMap = {};\n var appendixMode = false;\n var lastNonAppendix = 0;\n var alphabet = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n const name = exports.name = \"core/structure\";\n\n function makeTOCAtLevel($parent, doc, current, level, conf) {\n var $secs = $parent.children(conf.tocIntroductory ? \"section\" : \"section:not(.introductory)\");\n if ($secs.length === 0) {\n return null;\n }\n var $ol = $(\"<ol class='toc'></ol>\");\n for (var i = 0; i < $secs.length; i++) {\n var $sec = $($secs[i], doc);\n var isIntro = $sec.hasClass(\"introductory\");\n var noToc = $sec.hasClass(\"notoc\");\n if (!$sec.children().length || noToc) {\n continue;\n }\n var h = $sec.children()[0],\n ln = h.localName.toLowerCase();\n if (ln !== \"h2\" && ln !== \"h3\" && ln !== \"h4\" && ln !== \"h5\" && ln !== \"h6\") {\n continue;\n }\n var title = h.textContent,\n $kidsHolder = $(\"<div></div>\").append($(h).contents().clone());\n $kidsHolder.find(\"a\").renameElement(\"span\").attr(\"class\", \"formerLink\").removeAttr(\"href\");\n $kidsHolder.find(\"dfn\").renameElement(\"span\").removeAttr(\"id\");\n var id = h.id ? h.id : $sec.makeID(null, title);\n\n if (!isIntro) {\n current[current.length - 1]++;\n }\n var secnos = current.slice();\n if ($sec.hasClass(\"appendix\") && current.length === 1 && !appendixMode) {\n lastNonAppendix = current[0];\n appendixMode = true;\n }\n if (appendixMode) {\n secnos[0] = alphabet.charAt(current[0] - lastNonAppendix);\n }\n var secno = secnos.join(\".\"),\n isTopLevel = secnos.length == 1;\n if (isTopLevel) {\n secno = secno + \".\";\n // if this is a top level item, insert\n // an OddPage comment so html2ps will correctly\n // paginate the output\n $(h).before(document.createComment(\"OddPage\"));\n }\n var $span = $(\"<span class='secno'></span>\").text(secno + \" \");\n if (!isIntro) {\n $(h).prepend($span);\n }\n secMap[id] = (isIntro ? \"\" : \"<span class='secno'>\" + secno + \"</span> \") + \"<span class='sec-title'>\" + title + \"</span>\";\n\n var $a = $(\"<a/>\").attr({ href: \"#\" + id, class: \"tocxref\" }).append(isIntro ? \"\" : $span.clone()).append($kidsHolder.contents());\n var $item = $(\"<li class='tocline'/>\").append($a);\n if (conf.maxTocLevel === 0 || level <= conf.maxTocLevel) $ol.append($item);\n current.push(0);\n var $sub = makeTOCAtLevel($sec, doc, current, level + 1, conf);\n if ($sub) {\n $item.append($sub);\n }\n current.pop();\n }\n return $ol;\n }\n\n function run(conf, doc, cb) {\n if (\"tocIntroductory\" in conf === false) {\n conf.tocIntroductory = false;\n }\n if (\"maxTocLevel\" in conf === false) {\n conf.maxTocLevel = 0;\n }\n var $secs = $(\"section:not(.introductory)\", doc).find(\"h1:first, h2:first, h3:first, h4:first, h5:first, h6:first\").toArray().filter(elem => elem.closest(\"section.introductory\") === null);\n $secs = $($secs);\n if (!$secs.length) {\n return cb();\n }\n $secs.each(function () {\n var depth = $(this).parents(\"section\").length + 1;\n if (depth > 6) depth = 6;\n var h = \"h\" + depth;\n if (this.localName.toLowerCase() !== h) $(this).renameElement(h);\n });\n\n // makeTOC\n if (!conf.noTOC) {\n var $ol = makeTOCAtLevel($(\"body\", doc), doc, [0], 1, conf);\n if (!$ol) return;\n var nav = doc.createElement(\"nav\");\n nav.id = \"toc\";\n nav.innerHTML = \"<h2 class='introductory'>\" + conf.l10n.toc + \"</h2>\";\n nav.appendChild($ol[0]);\n var $ref = $(\"#toc\", doc);\n var replace = false;\n if ($ref.length) {\n replace = true;\n }\n if (!$ref.length) {\n $ref = $(\"#sotd\", doc);\n }\n if (!$ref.length) {\n $ref = $(\"#abstract\", doc);\n }\n if (replace) {\n $ref.replaceWith(nav);\n } else {\n $ref.after(nav);\n }\n\n var $link = $(\"<p role='navigation' id='back-to-top'><a href='#title'><abbr title='Back to Top'>↑</abbr></a></p>\");\n $(\"body\").append($link);\n }\n\n // Update all anchors with empty content that reference a section ID\n $(\"a[href^='#']:not(.tocxref)\", doc).each(function () {\n var $a = $(this);\n if ($a.html() !== \"\") return;\n var id = $a.attr(\"href\").slice(1);\n if (secMap[id]) {\n $a.addClass(\"sec-ref\");\n $a.html(($a.hasClass(\"sectionRef\") ? \"section \" : \"\") + secMap[id]);\n }\n });\n\n cb();\n }\n});\n//# sourceMappingURL=structure.js.map;\n", - "define('w3c/informative',[\"exports\", \"deps/hyperhtml\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"w3c/informative\"; // Module w3c/informative\n // Mark specific sections as informative, based on CSS\n function run() {\n Array.from(document.querySelectorAll(\"section.informative\")).map(informative => informative.querySelector(\"h2, h3, h4, h5, h6\")).filter(heading => heading).forEach(heading => {\n heading.parentNode.insertBefore(hyperHTML`<p><em>This section is non-normative.</em></p>`, heading.nextSibling);\n });\n }\n});\n//# sourceMappingURL=informative.js.map;\n", - "define('w3c/permalinks',[\"exports\", \"templates\"], function (exports, _templates) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _templates2 = _interopRequireDefault(_templates);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n const name = exports.name = \"w3c/permalinks\"; // Module w3c/permalinks\n // Adds \"permalinks\" into the document at sections with explicit IDs\n // Introduced by Shane McCarron (shane@aptest.com) from the W3C PFWG\n //\n // Only enabled when the includePermalinks option is set to true.\n // Defaults to false.\n //\n // When includePermalinks is enabled, the following options are\n // supported:\n //\n // permalinkSymbol: the character(s) to use for the link.\n // Defaults to §\n // permalinkEdge: Boolean. The link will be right-justified. Otherwise\n // it will be immediately after the heading text.\n // Defaults to false.\n // permalinkHide: Boolean. The symbol will be hidden until the header is\n // hovered over. Defaults to false.\n function run(conf, doc, cb) {\n if (!conf.includePermalinks) {\n return cb();\n }\n const css = _templates2.default[\"permalinks.css\"];\n var symbol = conf.permalinkSymbol || \"§\";\n var style = \"<style>\" + css(conf) + \"</style>\";\n\n $(doc).find(\"head link\").first().before(style);\n var $secs = $(doc).find(\"h2, h3, h4, h5, h6\");\n $secs.each(function (i, item) {\n var $item = $(item);\n if (!$item.hasClass(\"nolink\")) {\n var resourceID = $item.attr(\"id\");\n var $par = $item.parent();\n if ($par.is(\"section\") || $par.is(\"div\")) {\n if (!$par.hasClass(\"introductory\") && !$par.hasClass(\"nolink\")) {\n resourceID = $par.attr(\"id\");\n } else {\n resourceID = null;\n }\n }\n // if we still have resourceID\n if (resourceID) {\n // we have an id. add a permalink\n // right after the h* element\n var theNode = $(\"<span></span>\");\n theNode.attr(\"class\", \"permalink\");\n var ctext = $item.text();\n var el = $(\"<a></a>\");\n el.attr({\n href: \"#\" + resourceID,\n \"aria-label\": \"Permalink for \" + ctext,\n title: \"Permalink for \" + ctext\n });\n var sym = $(\"<span></span>\");\n sym.append(symbol);\n el.append(sym);\n theNode.append(el);\n // if this is not being put at\n // page edge, then separate it\n // from the heading with a\n // non-breaking space\n if (!conf.permalinkEdge) {\n $item.append(\" \");\n }\n $item.append(theNode);\n }\n }\n });\n cb();\n }\n});\n//# sourceMappingURL=permalinks.js.map;\n", - "define('core/id-headers',[\"exports\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.run = run;\n // Module core/id-headers\n // All headings are expected to have an ID, unless their immediate container has one.\n // This is currently in core though it comes from a W3C rule. It may move in the future.\n\n const name = exports.name = \"core/id-headers\";\n\n function run(conf, doc, cb) {\n Array.from(document.querySelectorAll(\"h2:not([id]), h3:not([id]), h4:not([id]), h5:not([id]), h6:not([id])\")).forEach(elem => {\n $(elem).makeID();\n });\n cb();\n }\n});\n//# sourceMappingURL=id-headers.js.map;\n", - "define('core/location-hash',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"core/location-hash\"; // Module core/location-hash\n // Resets window.location.hash to jump to the right point in the document\n\n function run(conf, doc, cb) {\n // Added message for legacy compat with Aria specs\n // See https://github.com/w3c/respec/issues/793\n (0, _pubsubhub.pub)(\"start\", \"core/location-hash\");\n\n let hash = \"\";\n try {\n hash = decodeURIComponent(window.location.hash).substr(1);\n } catch (err) {\n hash = \"\";\n }\n // Only scroll to the hash if the document hasn't been scrolled yet\n // this ensures that a page refresh maintains the scroll position\n if (!hash && !document.documentElement.scrollTop) {\n return cb();\n }\n // Allow some degree of recovery for legacy fragments format.\n // See https://github.com/w3c/respec/issues/1353\n const hasLink = !!doc.getElementById(hash);\n const isLegacyFrag = /\\W/.test(hash);\n if (!hasLink && isLegacyFrag) {\n const id = hash.replace(/[\\W]+/gim, \"-\").replace(/^-+/, \"\").replace(/-+$/, \"\");\n if (document.getElementById(id)) {\n hash = id;\n }\n }\n window.location.hash = `#${hash}`;\n cb();\n }\n});\n//# sourceMappingURL=location-hash.js.map;\n", - "\ndefine('deps/text!core/css/caniuse.css',[],function () { return '/* container for stats */\\n.caniuse-stats {\\n display: flex;\\n flex-wrap: wrap;\\n justify-content: flex-start;\\n align-items: baseline;\\n cursor: pointer;\\n}\\n\\nbutton.caniuse-cell {\\n margin: 1px 1px 0 0;\\n border: none;\\n}\\n\\n.caniuse-browser {\\n position: relative;\\n}\\n\\n/* reset styles, hide old versions by default */\\n.caniuse-browser ul {\\n display: none;\\n margin: 0;\\n padding: 0;\\n list-style: none;\\n position: absolute;\\n left: 0;\\n z-index: 2;\\n background: #fff;\\n margin-top: 1px;\\n}\\n\\n.caniuse-stats a {\\n white-space: nowrap;\\n align-self: center;\\n margin-left: .5em;\\n}\\n\\n/* a browser version */\\n.caniuse-cell {\\n display: flex;\\n color: rgba(0, 0, 0, 0.8);\\n font-size: 90%;\\n height: 0.8cm;\\n margin-right: 1px;\\n margin-top: 0;\\n min-width: 3cm;\\n overflow: visible;\\n justify-content: center;\\n align-items: center;\\n}\\n\\nli.caniuse-cell {\\n margin-bottom: 1px;\\n}\\n\\n.caniuse-cell:focus {\\n outline: none;\\n}\\n\\n.caniuse-cell:hover {\\n color: rgba(0, 0, 0, 1);\\n}\\n\\n/* supports */\\n.caniuse-cell.y {\\n background: #8bc34a;\\n}\\n\\n/* no support */\\n.caniuse-cell.n {\\n background: #e53935;\\n}\\n\\n/* not supported by default / partial support etc\\nsee https://github.com/Fyrd/caniuse/blob/master/CONTRIBUTING.md for stats */\\n.caniuse-cell.d,\\n.caniuse-cell.a,\\n.caniuse-cell.x,\\n.caniuse-cell.p {\\n background: #ffc107;\\n}\\n\\n/* show rest of the browser versions */\\n.caniuse-stats button:focus + ul,\\n.caniuse-stats .caniuse-browser:hover > ul {\\n display: block;\\n}\\n';});\n\n", - "define('core/caniuse',[\"exports\", \"core/utils\", \"core/pubsubhub\", \"deps/text!core/css/caniuse.css\", \"deps/hyperhtml\"], function (exports, _utils, _pubsubhub, _caniuse) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _caniuse2 = _interopRequireDefault(_caniuse);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _extends = Object.assign || function (target) {\n for (var i = 1; i < arguments.length; i++) {\n var source = arguments[i];\n\n for (var key in source) {\n if (Object.prototype.hasOwnProperty.call(source, key)) {\n target[key] = source[key];\n }\n }\n }\n\n return target;\n };\n\n const name = exports.name = \"core/caniuse\";\n\n const GH_USER_CONTENT_URL = \"https://raw.githubusercontent.com/Fyrd/caniuse/master/features-json/\";\n\n // browser name dictionary\n const BROWSERS = new Map([[\"chrome\", \"Chrome\"], [\"firefox\", \"Firefox\"], [\"ie\", \"IE\"], [\"edge\", \"Edge\"], [\"android\", \"Android\"], [\"safari\", \"Safari\"], [\"opera\", \"Opera\"], [\"bb\", \"Blackberry\"], [\"and_uc\", \"UC (Android)\"], [\"and_ff\", \"Firefox (Android)\"]]);\n\n // Keys from https://github.com/Fyrd/caniuse/blob/master/CONTRIBUTING.md\n const supportTitles = new Map([[\"y\", \"Supported.\"], [\"a\", \"Almost supported (aka Partial support).\"], [\"n\", \"No support, or disabled by default.\"], [\"p\", \"No support, but has Polyfill.\"], [\"u\", \"Support unknown.\"], [\"x\", \"Requires prefix to work.\"], [\"d\", \"Disabled by default (needs to enabled).\"]]);\n\n async function run(conf) {\n if (!conf.caniuse) {\n return; // nothing to do.\n }\n normalizeConf(conf);\n const { caniuse } = conf;\n if (!caniuse.feature) {\n return; // no feature to show\n }\n const { feature } = caniuse;\n const featureURL = \"https://caniuse.com/#feat=\" + feature;\n const link = (0, _utils.createResourceHint)({\n hint: \"preconnect\",\n href: \"https://raw.githubusercontent.com\"\n });\n document.head.appendChild(link);\n document.head.appendChild(hyperHTML`\n <style class=\"removeOnSave\">${_caniuse2.default}</style>`);\n\n const headDlElem = document.querySelector(\".head dl\");\n const contentPromise = new Promise(async resolve => {\n let content;\n try {\n const stats = await fetchAndCacheJson(caniuse);\n content = createTableHTML(caniuse, stats);\n } catch (err) {\n console.error(err);\n const msg = `Couldn't find feature \"${feature}\" on caniuse.com? ` + \"Please check the feature key on [caniuse.com](https://caniuse.com)\";\n (0, _pubsubhub.pub)(\"error\", msg);\n content = hyperHTML`<a href=\"${featureURL}\">caniuse.com</a>`;\n }\n resolve(content);\n });\n const definitionPair = hyperHTML.bind(document.createDocumentFragment())`\n <dt class=\"caniuse-title\">Can I Use this API?</dt>\n <dd class=\"caniuse-stats\">${{\n any: contentPromise,\n placeholder: \"Fetching data from caniuse.com...\"\n }}</dd>`;\n headDlElem.appendChild(definitionPair);\n await contentPromise;\n\n // remove from export\n (0, _pubsubhub.pub)(\"amend-user-config\", { caniuse: feature });\n (0, _pubsubhub.sub)(\"beforesave\", outputDoc => {\n hyperHTML.bind(outputDoc.querySelector(\".caniuse-stats\"))`\n <a href=\"${featureURL}\">caniuse.com</a>`;\n });\n }\n\n /**\n * Normalizes `conf.caniuse` object to hold normalized configuration\n *\n * @param {Object} conf configuration settings\n */\n function normalizeConf(conf) {\n const DEFAULTS = {\n maxAge: 60 * 60 * 24 * 1000, // 24 hours (in ms)\n browsers: [\"chrome\", \"firefox\", \"safari\", \"edge\"],\n versions: 4\n };\n if (typeof conf.caniuse === \"string\") {\n conf.caniuse = _extends({ feature: conf.caniuse }, DEFAULTS);\n return;\n }\n if (Array.isArray(conf.caniuse.browsers)) {\n conf.caniuse.browsers = conf.caniuse.browsers.map(b => b.toLowerCase()).filter(isValidBrowser);\n } else {\n conf.caniuse.browsers = DEFAULTS.browsers;\n }\n Object.assign(conf.caniuse, DEFAULTS, _extends({}, conf.caniuse));\n function isValidBrowser(browser) {\n if (BROWSERS.has(browser)) {\n return true;\n }\n (0, _pubsubhub.pub)(\"warn\", `Ignoring invalid browser \"\\`${browser}\\`\" in ` + \"[`respecConfig.caniuse.browsers`](https://github.com/w3c/respec/wiki/caniuse)\");\n return false;\n }\n }\n\n /**\n * Get stats for canIUse table.\n *\n * @param {Object} caniuseConf normalized respecConfig.caniuse\n * @return {Object} Can I Use stats\n * @throws {Error} on failure\n */\n async function fetchAndCacheJson(caniuseConf) {\n const { apiURL, feature, maxAge } = caniuseConf;\n const url = apiURL ? apiURL.replace(\"{FEATURE}\", feature) : `${GH_USER_CONTENT_URL}${feature}.json`;\n const request = new Request(url);\n const response = await (0, _utils.fetchAndCache)(request, maxAge);\n const { stats } = await response.json();\n return stats;\n }\n\n /**\n * Get HTML element for the canIUse support table.\n *\n * @param {Object} stats CanIUse API results\n * @param {Object} conf respecConfig.caniuse\n */\n function createTableHTML(conf, stats) {\n // render the support table\n return hyperHTML`\n ${conf.browsers.map(browser => addBrowser(browser, conf.versions, stats[browser])).filter(elem => elem)}\n <a href=\"${`https://caniuse.com/#feat=${conf.feature}`}\"\n title=\"Get details at caniuse.com\">More info\n </a>`;\n\n /**\n * Add a browser and it's support to table.\n *\n * @param {String} browser name of browser (as in CanIUse API response)\n * @param {Number} numVersions number of old browser versions to show\n * @param {Object} browserData stats data from api response\n * @param {Number} tabindex\n */\n function addBrowser(browser, numVersions, browserData) {\n if (!browserData) return;\n const getSupport = version => {\n const supportKeys = browserData[version].split(\"#\", 1)[0] // don't care about footnotes.\n .split(\" \").filter(item => item);\n const titles = supportKeys.filter(key => supportTitles.has(key)).map(key => supportTitles.get(key));\n return {\n support: supportKeys.join(\" \"),\n title: titles.join(\" \")\n };\n };\n const addBrowserVersion = version => {\n const { support, title } = getSupport(version);\n const cssClass = \"caniuse-cell \" + support;\n return `<li class=\"${cssClass}\" title=\"${title}\">${version}</li>`;\n };\n\n const [latestVersion, ...olderVersions] = Object.keys(browserData).sort(_utils.semverCompare).slice(-numVersions).reverse();\n const { support, title } = getSupport(latestVersion);\n const cssClass = `caniuse-cell ${support}`;\n return hyperHTML`\n <div class=\"caniuse-browser\">\n <button class=\"${cssClass}\" title=\"${title}\">\n ${BROWSERS.get(browser) || browser} ${latestVersion}\n </button>\n <ul>\n ${olderVersions.map(addBrowserVersion)}\n </ul>\n </div>`;\n }\n }\n});\n//# sourceMappingURL=caniuse.js.map;\n", - "define('core/exporter',[\"exports\", \"core/utils\", \"core/pubsubhub\", \"deps/hyperhtml\"], function (exports, _utils, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.rsDocToDataURL = rsDocToDataURL;\n\n\n const mimeTypes = new Map([[\"text/html\", \"html\"], [\"application/xml\", \"xml\"]]);\n\n /**\n * Creates a dataURI from a ReSpec document. It also cleans up the document\n * removing various things.\n *\n * @param {String} mimeType mimetype. one of `mimeTypes` above\n * @param {Document} doc document to export. useful for testing purposes\n * @returns a stringified data-uri of document that can be saved.\n */\n /**\n * module: core/exporter\n * Exports a ReSpec document, based on mime type, so it can be saved, etc.\n * Also performs cleanup, removing things that shouldn't be in published documents.\n * That is, elements that have a \"removeOnSave\" css class.\n */\n\n function rsDocToDataURL(mimeType, doc = document) {\n const format = mimeTypes.get(mimeType);\n if (!format) {\n const validTypes = [...mimeTypes.values()].join(\", \");\n const msg = `Invalid format: ${mimeType}. Expected one of: ${validTypes}.`;\n throw new TypeError(msg);\n }\n const data = serialize(format, doc);\n const encodedString = encodeURIComponent(data);\n return `data:${mimeType};charset=utf-8,${encodedString}`;\n }\n\n function serialize(format, doc) {\n const cloneDoc = doc.cloneNode(true);\n cleanup(cloneDoc);\n let result = \"\";\n switch (format) {\n case \"xml\":\n result = new XMLSerializer().serializeToString(cloneDoc);\n break;\n default:\n {\n if (cloneDoc.doctype) {\n result += new XMLSerializer().serializeToString(cloneDoc.doctype);\n }\n result += cloneDoc.documentElement.outerHTML;\n }\n }\n return result;\n }\n\n function cleanup(cloneDoc) {\n const { head, body, documentElement } = cloneDoc;\n cleanupHyper(cloneDoc);\n\n cloneDoc.querySelectorAll(\".removeOnSave, #toc-nav\").forEach(elem => elem.remove());\n body.classList.remove(\"toc-sidebar\");\n (0, _utils.removeReSpec)(documentElement);\n\n const insertions = cloneDoc.createDocumentFragment();\n\n // Move meta viewport, as it controls the rendering on mobile.\n const metaViewport = cloneDoc.querySelector(\"meta[name='viewport']\");\n if (metaViewport && head.firstChild !== metaViewport) {\n insertions.appendChild(metaViewport);\n }\n\n // Move charset to near top, as it needs to be in the first 512 bytes.\n let metaCharset = cloneDoc.querySelector(\"meta[charset], meta[content*='charset=']\");\n if (!metaCharset) {\n metaCharset = hyperHTML`<meta charset=\"utf-8\">`;\n }\n insertions.appendChild(metaCharset);\n\n // Add meta generator\n const respecVersion = `ReSpec ${window.respecVersion || \"Developer Channel\"}`;\n const metaGenerator = hyperHTML`\n <meta name=\"generator\" content=\"${respecVersion}\">\n `;\n\n insertions.appendChild(metaGenerator);\n head.insertBefore(insertions, head.firstChild);\n (0, _pubsubhub.pub)(\"beforesave\", documentElement);\n }\n\n function cleanupHyper({ documentElement: node }) {\n // collect first, or walker will cease too early\n const filter = comment => comment.textContent.startsWith(\"_hyper\");\n const walker = document.createTreeWalker(node, NodeFilter.SHOW_COMMENT, filter);\n for (const comment of [...walkTree(walker)]) {\n comment.remove();\n }\n }\n\n function* walkTree(walker) {\n while (walker.nextNode()) {\n yield walker.currentNode;\n }\n }\n});\n//# sourceMappingURL=exporter.js.map;\n", - "define('ui/save-html',[\"exports\", \"core/ui\", \"core/l10n\", \"core/pubsubhub\", \"core/exporter\", \"deps/hyperhtml\"], function (exports, _ui, _l10n, _pubsubhub, _exporter) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.show = show;\n exports.exportDocument = exportDocument;\n const name = exports.name = \"ui/save-html\";\n\n // Create and download an EPUB 3 version of the content\n // Using (by default) the EPUB 3 conversion service set up at labs.w3.org/epub-generator\n // For more details on that service, see https://github.com/iherman/respec2epub\n // Module ui/save-html\n // Saves content to HTML when asked to\n const epubURL = new URL(\"https://labs.w3.org/epub-generator/cgi-bin/epub-generator.py\");\n epubURL.searchParams.append(\"type\", \"respec\");\n epubURL.searchParams.append(\"url\", document.location.href);\n\n const downloadLinks = [{\n id: \"respec-save-as-html\",\n fileName: \"index.html\",\n title: \"HTML\",\n type: \"text/html\",\n get href() {\n return (0, _exporter.rsDocToDataURL)(this.type);\n }\n }, {\n id: \"respec-save-as-xml\",\n fileName: \"index.xhtml\",\n title: \"XML\",\n type: \"application/xml\",\n get href() {\n return (0, _exporter.rsDocToDataURL)(this.type);\n }\n }, {\n id: \"respec-save-as-epub\",\n fileName: \"spec.epub\",\n title: \"EPUB 3\",\n type: \"application/epub+zip\",\n href: epubURL.href\n }];\n\n function toDownloadLink(details) {\n const { id, href, fileName, title, type } = details;\n return hyperHTML`\n <a\n href=\"${href}\"\n id=\"${id}\"\n download=\"${fileName}\"\n type=\"${type}\"\n class=\"respec-save-button\"\n onclick=${() => _ui.ui.closeModal()}\n >${title}</a>`;\n }\n\n const saveDialog = {\n async show(button) {\n await document.respecIsReady;\n const div = hyperHTML`\n <div class=\"respec-save-buttons\">\n ${downloadLinks.map(toDownloadLink)}\n </div>`;\n _ui.ui.freshModal(_l10n.l10n[_l10n.lang].save_snapshot, div, button);\n }\n };\n\n const supportsDownload = \"download\" in HTMLAnchorElement.prototype;\n let button;\n if (supportsDownload) {\n button = _ui.ui.addCommand(_l10n.l10n[_l10n.lang].save_snapshot, \"ui/save-html\", \"Ctrl+Shift+Alt+S\", \"💾\");\n }\n\n function show() {\n if (!supportsDownload) return;\n saveDialog.show(button);\n }\n\n function exportDocument(format, mimeType) {\n const msg = \"Exporting via ui/save-html module's `exportDocument()` is deprecated and will be removed. \" + \"Use core/exporter `rsDocToDataURL()` instead.\";\n (0, _pubsubhub.pub)(\"warn\", msg);\n console.warn(msg);\n return (0, _exporter.rsDocToDataURL)(mimeType);\n }\n});\n//# sourceMappingURL=save-html.js.map;\n", - "define('ui/search-specref',[\"exports\", \"core/ui\", \"core/biblio\", \"core/l10n\"], function (exports, _ui, _biblio, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.show = undefined;\n\n\n const button = _ui.ui.addCommand(_l10n.l10n[_l10n.lang].search_specref, \"ui/search-specref\", \"Ctrl+Shift+Alt+space\", \"🔎\"); // Module ui/search-specref\n // Search Specref database\n\n const specrefURL = \"https://specref.herokuapp.com/\";\n const refSearchURL = `${specrefURL}search-refs`;\n const reveseLookupURL = `${specrefURL}reverse-lookup`;\n const form = document.createElement(\"form\");\n const renderer = window.hyperHTML.bind(form);\n const resultList = hyperHTML.bind(document.createElement(\"div\"));\n\n form.id = \"specref-ui\";\n\n function renderResults(resultMap, query, timeTaken) {\n if (!resultMap.size) {\n return resultList`\n <p class=\"state\">\n Your search - <strong> ${query} </strong> -\n did not match any references.\n </p>\n `;\n }\n const wires = Array.from(resultMap.entries()).slice(0, 99).map(toDefinitionPair).reduce((collector, pair) => collector.concat(pair), []);\n return resultList`\n <p class=\"result-stats\">\n ${resultMap.size} results (${timeTaken} seconds).\n ${resultMap.size > 99 ? \"First 100 results.\" : \"\"}\n </p>\n <dl class=\"specref-results\">${wires}</dl>\n `;\n }\n\n function toDefinitionPair([key, entry]) {\n return hyperHTML.wire(entry)`\n <dt>\n [${key}]\n </dt>\n <dd>${(0, _biblio.wireReference)(entry)}</dd>\n `;\n }\n\n function resultProcessor({ includeVersions } = { includeVersions: false }) {\n return (...fetchedData) => {\n const combinedResults = fetchedData.reduce((collector, resultObj) => Object.assign(collector, resultObj), {});\n const results = new Map(Object.entries(combinedResults));\n // remove aliases\n Array.from(results.entries()).filter(([, entry]) => entry.aliasOf).map(([key]) => key).reduce((results, key) => results.delete(key) && results, results);\n // Remove versions, if asked to\n if (!includeVersions) {\n Array.from(results.values()).filter(entry => typeof entry === \"object\" && \"versions\" in entry).reduce((collector, entry) => collector.concat(entry.versions), []).forEach(version => {\n results.delete(version);\n });\n }\n // Remove legacy string entries\n Array.from(results.entries()).filter(([, entry]) => typeof entry !== \"object\").reduce((result, [key]) => results.delete(key) && results, results);\n return results;\n };\n }\n\n form.addEventListener(\"submit\", async ev => {\n ev.preventDefault();\n const { searchBox } = form;\n const query = searchBox.value;\n if (!query) {\n searchBox.focus();\n return;\n }\n render({ state: \"Searching Specref…\" });\n const refSearch = new URL(refSearchURL);\n refSearch.searchParams.set(\"q\", query);\n const reverseLookup = new URL(reveseLookupURL);\n reverseLookup.searchParams.set(\"urls\", query);\n try {\n const startTime = performance.now();\n const jsonData = await Promise.all([fetch(refSearch).then(response => response.json()), fetch(reverseLookup).then(response => response.json())]);\n const { checked: includeVersions } = form.includeVersions;\n const processResults = resultProcessor({ includeVersions });\n const results = processResults(...jsonData);\n render({\n query,\n results,\n state: \"\",\n timeTaken: Math.round(performance.now() - startTime) / 1000\n });\n } catch (err) {\n console.error(err);\n render({ state: \"Error! Couldn't do search.\" });\n } finally {\n searchBox.focus();\n }\n });\n\n function show() {\n render();\n _ui.ui.freshModal(_l10n.l10n[_l10n.lang].search_specref, form, button);\n form.querySelector(\"input[type=search]\").focus();\n }\n\n const mast = hyperHTML.wire()`\n <header>\n <p>\n An Open-Source, Community-Maintained Database of\n Web Standards & Related References.\n </p>\n </header>\n <div class=\"searchcomponent\">\n <input\n name=\"searchBox\"\n type=\"search\"\n autocomplete=\"off\"\n placeholder=\"Keywords, titles, authors, urls…\">\n <button\n type=\"submit\">\n Search\n </button>\n <label>\n <input type=\"checkbox\" name=\"includeVersions\"> Include all versions.\n </label>\n </div>\n`;\n\n function render({ state, results, timeTaken, query } = { state: \"\" }) {\n if (!results) {\n renderer`<div>${mast}</div>`;\n return;\n }\n renderer`\n <div>${mast}</div>\n <p class=\"state\" hidden=\"${!state}\">\n ${state}\n </p>\n <section hidden=\"${!results}\">${results ? renderResults(results, query, timeTaken) : []}</section>\n `;\n }\n\n exports.show = show;\n});\n//# sourceMappingURL=search-specref.js.map;\n", - "define('ui/dfn-list',[\"exports\", \"core/ui\", \"core/l10n\", \"deps/hyperhtml\"], function (exports, _ui, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.show = undefined;\n\n\n const button = _ui.ui.addCommand(_l10n.l10n[_l10n.lang].definition_list, \"ui/dfn-list\", \"Ctrl+Shift+Alt+D\", \"📔\"); /// Module ui/dfn-list\n // Displays all definitions with links to the defining element.\n\n\n const ul = document.createElement(\"ul\");\n ul.classList.add(\"respec-dfn-list\");\n const render = window.hyperHTML.bind(ul);\n\n ul.addEventListener(\"click\", ev => {\n _ui.ui.closeModal();\n ev.stopPropagation();\n });\n\n function show() {\n const definitionLinks = Object.entries(respecConfig.definitionMap).sort(([keyA], [keyB]) => keyA.localeCompare(keyB)).map(([key, $dfns]) => {\n const [dfn] = $dfns[0];\n return window.hyperHTML.wire(dfn, \":li>a\")`\n <li>\n <a href=\"${\"#\" + dfn.id}\">\n ${dfn.textContent}\n </a>\n </li>\n `;\n });\n render`${definitionLinks}`;\n _ui.ui.freshModal(_l10n.l10n[_l10n.lang].list_of_definitions, ul, button);\n }\n\n exports.show = show;\n});\n//# sourceMappingURL=dfn-list.js.map;\n", - "define('ui/about-respec',[\"exports\", \"core/ui\", \"core/l10n\", \"deps/hyperhtml\"], function (exports, _ui, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.show = undefined;\n\n\n // window.respecVersion is added at build time (see tools/builder.js)\n window.respecVersion = window.respecVersion || \"Developer Edition\"; // Module ui/about-respec\n // A simple about dialog with pointer to the help\n\n const div = document.createElement(\"div\");\n const render = hyperHTML.bind(div);\n const button = _ui.ui.addCommand(`About ${window.respecVersion}`, \"ui/about-respec\", \"Ctrl+Shift+Alt+A\", \"ℹ️\");\n\n function show() {\n _ui.ui.freshModal(`${_l10n.l10n[_l10n.lang].about_respec} - ${window.respecVersion}`, div, button);\n let entries = [];\n if (\"getEntriesByType\" in performance) {\n performance.getEntriesByType(\"measure\").sort((a, b) => b.duration - a.duration).map(({ name, duration }) => {\n const fixedSize = duration.toFixed(2);\n const humanDuration = fixedSize > 1000 ? `${Math.round(fixedSize / 1000.0)} second(s)` : `${fixedSize} milliseconds`;\n return { name, duration: humanDuration };\n }).map(perfEntryToTR).reduce((collector, entry) => {\n collector.push(entry);\n return collector;\n }, entries);\n }\n render`\n <p>\n ReSpec is a document production toolchain, with a notable focus on W3C specifications.\n </p>\n <p>\n <a href='https://github.com/w3c/respec/wiki'>Documentation</a>,\n <a href='https://github.com/w3c/respec/issues'>Bugs</a>.\n </p>\n <table border=\"1\" width=\"100%\" hidden=\"${entries.length ? false : true}\">\n <caption>\n Loaded plugins\n </caption>\n <thead>\n <tr>\n <th>\n Plugin Name\n </th>\n <th>\n Processing time\n </th>\n </tr>\n </thead>\n <tbody>${entries}</tbody>\n </table>\n`;\n }\n\n function perfEntryToTR({ name, duration }) {\n const render = hyperHTML.bind(document.createElement(\"tr\"));\n const moduleURL = `https://github.com/w3c/respec/tree/develop/src/${name}.js`;\n return render`\n <td>\n <a href=\"${moduleURL}\">\n ${name}\n </a>\n </td>\n <td>\n ${duration} \n </td>\n `;\n }\n\n exports.show = show;\n});\n//# sourceMappingURL=about-respec.js.map;\n", - "define('core/seo',[\"exports\"], function (exports) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.run = run;\n /**\n * This Module adds a metatag description to the document, based on the\n * first paragraph of the abstract.\n */\n\n const name = exports.name = \"core/seo\";\n\n async function run(conf, doc, cb) {\n // This is not critical, so let's continue other processing first\n cb();\n await doc.respecIsReady;\n const firstParagraph = doc.querySelector(\"#abstract p:first-of-type\");\n if (!firstParagraph) {\n return; // no abstract, so nothing to do\n }\n insertMetaDescription(firstParagraph);\n }\n\n function insertMetaDescription(firstParagraph) {\n // Normalize whitespace: trim, remove new lines, tabs, etc.\n const doc = firstParagraph.ownerDocument;\n const content = firstParagraph.textContent.replace(/\\s+/, \" \").trim();\n const metaElem = doc.createElement(\"meta\");\n metaElem.name = \"description\";\n metaElem.content = content;\n doc.head.appendChild(metaElem);\n }\n});\n//# sourceMappingURL=seo.js.map;\n", - "define('w3c/seo',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n const name = exports.name = \"w3c/seo\"; // Module w3c/seo\n // Manages SEO information for documents\n // e.g. set the canonical URL for the document if configured\n function run(conf, doc, cb) {\n var trLatestUri = conf.shortName ? \"https://www.w3.org/TR/\" + conf.shortName + \"/\" : null;\n switch (conf.canonicalURI) {\n case \"edDraft\":\n if (conf.edDraftURI) {\n conf.canonicalURI = new URL(conf.edDraftURI, doc.location).href;\n } else {\n (0, _pubsubhub.pub)(\"warn\", \"Canonical URI set to edDraft, \" + \"but no edDraftURI is set in configuration\");\n conf.canonicalURI = null;\n }\n break;\n case \"TR\":\n if (trLatestUri) {\n conf.canonicalURI = trLatestUri;\n } else {\n (0, _pubsubhub.pub)(\"warn\", \"Canonical URI set to TR, but \" + \"no shortName is set in configuration\");\n conf.canonicalURI = null;\n }\n break;\n default:\n if (conf.canonicalURI) {\n try {\n conf.canonicalURI = new URL(conf.canonicalURI, doc.location).href;\n } catch (err) {\n (0, _pubsubhub.pub)(\"warn\", \"CanonicalURI is an invalid URL: \" + err.message);\n conf.canonicalURI = null;\n }\n } else if (trLatestUri) {\n conf.canonicalURI = trLatestUri;\n }\n }\n if (conf.canonicalURI) {\n var linkElem = doc.createElement(\"link\");\n linkElem.setAttribute(\"rel\", \"canonical\");\n linkElem.setAttribute(\"href\", conf.canonicalURI);\n doc.head.appendChild(linkElem);\n }\n cb();\n if (conf.doJsonLd) {\n addJSONLDInfo(conf, doc);\n }\n }\n\n async function addJSONLDInfo(conf, doc) {\n await doc.respecIsReady;\n // Content for JSON\n const type = [\"TechArticle\"];\n if (conf.rdfStatus) type.push(conf.rdfStatus);\n\n const jsonld = {\n \"@context\": [\"http://schema.org\", {\n \"@vocab\": \"http://schema.org/\",\n \"@language\": doc.documentElement.lang || \"en\",\n w3p: \"http://www.w3.org/2001/02pd/rec54#\",\n foaf: \"http://xmlns.com/foaf/0.1/\",\n datePublished: { \"@type\": \"http://www.w3.org/2001/XMLSchema#date\" },\n inLanguage: { \"@language\": null },\n isBasedOn: { \"@type\": \"@id\" },\n license: { \"@type\": \"@id\" }\n }],\n id: conf.canonicalURI || conf.thisVersion,\n type,\n name: conf.title,\n inLanguage: doc.documentElement.lang || \"en\",\n license: conf.licenseInfo.url,\n datePublished: conf.dashDate,\n copyrightHolder: {\n name: \"World Wide Web Consortium\",\n url: \"https://www.w3.org/\"\n },\n discussionUrl: conf.issueBase,\n alternativeHeadline: conf.subtitle,\n isBasedOn: conf.prevVersion\n };\n\n // add any additional copyright holders\n if (conf.additionalCopyrightHolders) {\n const addl = Array.isArray(conf.additionalCopyrightHolders) ? conf.additionalCopyrightHolders : [conf.additionalCopyrightHolders];\n jsonld.copyrightHolder = [jsonld.copyrightHolder, ...addl.map(h => ({ name: h }))];\n }\n\n // description from meta description\n const description = doc.head.querySelector(\"meta[name=description]\");\n if (description) {\n jsonld.description = description.content;\n }\n\n // Editors\n if (conf.editors) {\n jsonld.editor = conf.editors.map(addPerson);\n }\n if (conf.authors) {\n jsonld.contributor = conf.authors.map(addPerson);\n }\n\n // normative and informative references\n jsonld.citation = [...conf.normativeReferences, ...conf.informativeReferences].map(ref => conf.biblio[ref]).filter(ref => typeof ref === \"object\").map(addRef);\n\n const script = doc.createElement(\"script\");\n script.type = \"application/ld+json\";\n script.textContent = JSON.stringify(jsonld, null, 2);\n doc.head.appendChild(script);\n }\n\n // Turn editors and authors into a list of JSON-LD relationships\n function addPerson({ name, url, mailto, company, companyURL }) {\n const ed = {\n type: \"Person\",\n name,\n url,\n \"foaf:mbox\": mailto\n };\n if (company || companyURL) {\n ed.worksFor = {\n name: company,\n url: companyURL\n };\n }\n return ed;\n }\n\n // Create a reference URL from the ref\n function addRef(ref) {\n const { href: id, title: name, href: url } = ref;\n return {\n id,\n type: \"TechArticle\",\n name,\n url\n };\n }\n});\n//# sourceMappingURL=seo.js.map;\n", - "\ndefine('deps/text!core/css/github.css',[],function () { return '/*\\n\\ngithub.com style (c) Vasily Polovnyov <vast@whiteants.net>\\n\\n*/\\n\\n.hljs {\\n display: block;\\n overflow-x: auto;\\n padding: 0.5em;\\n color: #333;\\n background: #f8f8f8;\\n}\\n\\n.hljs-comment,\\n.hljs-quote {\\n color: #998;\\n font-style: italic;\\n}\\n\\n.hljs-keyword,\\n.hljs-selector-tag,\\n.hljs-subst {\\n color: #333;\\n font-weight: bold;\\n}\\n\\n.hljs-number,\\n.hljs-literal,\\n.hljs-variable,\\n.hljs-template-variable,\\n.hljs-tag .hljs-attr {\\n color: #008080;\\n}\\n\\n.hljs-string,\\n.hljs-doctag {\\n color: #d14;\\n}\\n\\n.hljs-title,\\n.hljs-section,\\n.hljs-selector-id {\\n color: #900;\\n font-weight: bold;\\n}\\n\\n.hljs-subst {\\n font-weight: normal;\\n}\\n\\n.hljs-type,\\n.hljs-class .hljs-title {\\n color: #458;\\n font-weight: bold;\\n}\\n\\n.hljs-tag,\\n.hljs-name,\\n.hljs-attribute {\\n color: #000080;\\n font-weight: normal;\\n}\\n\\n.hljs-regexp,\\n.hljs-link {\\n color: #009926;\\n}\\n\\n.hljs-symbol,\\n.hljs-bullet {\\n color: #990073;\\n}\\n\\n.hljs-built_in,\\n.hljs-builtin-name {\\n color: #0086b3;\\n}\\n\\n.hljs-meta {\\n color: #999;\\n font-weight: bold;\\n}\\n\\n.hljs-deletion {\\n background: #fdd;\\n}\\n\\n.hljs-addition {\\n background: #dfd;\\n}\\n\\n.hljs-emphasis {\\n font-style: italic;\\n}\\n\\n.hljs-strong {\\n font-weight: bold;\\n}\\n';});\n\n", - "\ndefine('deps/text!core/../../worker/respec-worker.js',[],function () { return '// ReSpec Worker v0.1.1\\n\"use strict\";\\ntry {\\n importScripts(\"https://www.w3.org/Tools/respec/respec-highlight.js\");\\n hljs.configure({\\n tabReplace: \" \", // 2 spaces\\n languages: [\"abnf\", \"css\", \"http\", \"javascript\", \"json\", \"markdown\", \"xml\"],\\n });\\n} catch (err) {\\n console.error(\"Network error loading/configuring highlighter\", err);\\n}\\n\\nself.addEventListener(\"message\", ({ data: originalData }) => {\\n const data = Object.assign({}, originalData);\\n switch (data.action) {\\n case \"highlight\":\\n const { code } = data;\\n const langs = data.languages.length ? data.languages : undefined;\\n try {\\n const { value, language } = self.hljs.highlightAuto(code, langs);\\n Object.assign(data, { value, language });\\n } catch (err) {\\n console.error(\"Could not transform some code?\", err);\\n // Post back the original code\\n Object.assign(data, { value: code, language: \"\" });\\n }\\n }\\n self.postMessage(data);\\n});\\n';});\n\n", - "define('core/worker',[\"exports\", \"core/utils\", \"deps/text!../../worker/respec-worker.js\"], function (exports, _utils, _respecWorker) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.worker = exports.name = undefined;\n\n var _respecWorker2 = _interopRequireDefault(_respecWorker);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n /**\n * Module core/worker\n *\n * Exports a Web Worker for ReSpec, allowing for\n * multi-threaded processing of things.\n */\n const name = exports.name = \"core/worker\";\n\n // Opportunistically preload syntax highlighter, which is used by the worker\n\n // Opportunistically preload syntax highlighter\n const hint = {\n hint: \"preload\",\n href: \"https://www.w3.org/Tools/respec/respec-highlight.js\",\n as: \"script\"\n };\n const link = (0, _utils.createResourceHint)(hint);\n document.head.appendChild(link);\n\n const workerURL = URL.createObjectURL(new Blob([_respecWorker2.default], { type: \"application/javascript\" }));\n const worker = exports.worker = new Worker(workerURL);\n});\n//# sourceMappingURL=worker.js.map;\n", - "define('core/highlight',[\"exports\", \"deps/text!core/css/github.css\", \"core/worker\"], function (exports, _github, _worker) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _github2 = _interopRequireDefault(_github);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n /**\n * Module core/highlight\n *\n * Performs syntax highlighting to all pre and code elements.\n */\n const name = exports.name = \"core/highlight\";\n\n // Opportunistically insert the style into the head to reduce FOUC.\n const codeStyle = document.createElement(\"style\");\n codeStyle.textContent = _github2.default;\n document.head.appendChild(codeStyle);\n function getLanguageHint(classList) {\n return Array.from(classList).filter(item => item !== \"highlight\" && item !== \"nolinks\").map(item => item.toLowerCase());\n }\n\n async function run(conf) {\n // Nothing to highlight\n if (conf.noHighlightCSS) {\n codeStyle.remove();\n return;\n }\n const highlightables = Array.from(document.querySelectorAll(\"pre:not(.idl):not(.nohighlight), code.highlight\"));\n // Nothing to highlight\n if (highlightables.length === 0) {\n codeStyle.remove();\n return;\n }\n const promisesToHighlight = highlightables.map((element, i) => {\n return new Promise(resolve => {\n if (element.textContent.trim() === \"\") {\n return resolve(); // no work to do\n }\n const done = () => {\n element.setAttribute(\"aria-busy\", \"false\");\n resolve();\n };\n // We always resolve, even if we couldn't actually highlight\n const timeoutId = setTimeout(() => {\n console.error(\"Timed-out waiting for highlight:\", element);\n done();\n }, 4000);\n const msg = {\n action: \"highlight\",\n code: element.textContent,\n id: `highlight:${i}`,\n languages: getLanguageHint(element.classList)\n };\n _worker.worker.addEventListener(\"message\", function listener(ev) {\n const { data: { id, code, language, value } } = ev;\n if (id !== msg.id) {\n return; // not for us!\n }\n element.innerHTML = value;\n if (element.localName === \"pre\") {\n element.classList.add(\"hljs\");\n }\n if (language) {\n element.classList.add(language);\n }\n clearTimeout(timeoutId);\n _worker.worker.removeEventListener(\"message\", listener);\n done();\n });\n element.setAttribute(\"aria-busy\", \"true\");\n _worker.worker.postMessage(msg);\n });\n });\n await Promise.all(promisesToHighlight);\n }\n});\n//# sourceMappingURL=highlight.js.map;\n", - "\ndefine('deps/text!core/images/clipboard.svg',[],function () { return '<svg height=\"16\" viewBox=\"0 0 14 16\" width=\"14\"><path fill-rule=\"evenodd\" d=\"M2 13h4v1H2v-1zm5-6H2v1h5V7zm2 3V8l-3 3 3 3v-2h5v-2H9zM4.5 9H2v1h2.5V9zM2 12h2.5v-1H2v1zm9 1h1v2c-.02.28-.11.52-.3.7-.19.18-.42.28-.7.3H1c-.55 0-1-.45-1-1V4c0-.55.45-1 1-1h3c0-1.11.89-2 2-2 1.11 0 2 .89 2 2h3c.55 0 1 .45 1 1v5h-1V6H1v9h10v-2zM2 5h8c0-.55-.45-1-1-1H8c-.55 0-1-.45-1-1s-.45-1-1-1-1 .45-1 1-.45 1-1 1H3c-.55 0-1 .45-1 1z\"/></svg>';});\n\n", - "/*!\n * clipboard.js v2.0.1\n * https://zenorocha.github.io/clipboard.js\n * \n * Licensed MIT © Zeno Rocha\n */\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine('deps/clipboard',[], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ClipboardJS\"] = factory();\n\telse\n\t\troot[\"ClipboardJS\"] = factory();\n})(this, function() {\nreturn /******/ (function(modules) { // webpackBootstrap\n/******/ \t// The module cache\n/******/ \tvar installedModules = {};\n/******/\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(installedModules[moduleId]) {\n/******/ \t\t\treturn installedModules[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = installedModules[moduleId] = {\n/******/ \t\t\ti: moduleId,\n/******/ \t\t\tl: false,\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/\n/******/ \t\t// Execute the module function\n/******/ \t\tmodules[moduleId].call(module.exports, module, module.exports, __webpack_require__);\n/******/\n/******/ \t\t// Flag the module as loaded\n/******/ \t\tmodule.l = true;\n/******/\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/\n/******/\n/******/ \t// expose the modules object (__webpack_modules__)\n/******/ \t__webpack_require__.m = modules;\n/******/\n/******/ \t// expose the module cache\n/******/ \t__webpack_require__.c = installedModules;\n/******/\n/******/ \t// identity function for calling harmony imports with the correct context\n/******/ \t__webpack_require__.i = function(value) { return value; };\n/******/\n/******/ \t// define getter function for harmony exports\n/******/ \t__webpack_require__.d = function(exports, name, getter) {\n/******/ \t\tif(!__webpack_require__.o(exports, name)) {\n/******/ \t\t\tObject.defineProperty(exports, name, {\n/******/ \t\t\t\tconfigurable: false,\n/******/ \t\t\t\tenumerable: true,\n/******/ \t\t\t\tget: getter\n/******/ \t\t\t});\n/******/ \t\t}\n/******/ \t};\n/******/\n/******/ \t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t__webpack_require__.n = function(module) {\n/******/ \t\tvar getter = module && module.__esModule ?\n/******/ \t\t\tfunction getDefault() { return module['default']; } :\n/******/ \t\t\tfunction getModuleExports() { return module; };\n/******/ \t\t__webpack_require__.d(getter, 'a', getter);\n/******/ \t\treturn getter;\n/******/ \t};\n/******/\n/******/ \t// Object.prototype.hasOwnProperty.call\n/******/ \t__webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };\n/******/\n/******/ \t// __webpack_public_path__\n/******/ \t__webpack_require__.p = \"\";\n/******/\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(__webpack_require__.s = 3);\n/******/ })\n/************************************************************************/\n/******/ ([\n/* 0 */\n/***/ (function(module, exports, __webpack_require__) {\n\nvar __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_ARRAY__, __WEBPACK_AMD_DEFINE_RESULT__;(function (global, factory) {\n if (true) {\n !(__WEBPACK_AMD_DEFINE_ARRAY__ = [module, __webpack_require__(7)], __WEBPACK_AMD_DEFINE_FACTORY__ = (factory),\n\t\t\t\t__WEBPACK_AMD_DEFINE_RESULT__ = (typeof __WEBPACK_AMD_DEFINE_FACTORY__ === 'function' ?\n\t\t\t\t(__WEBPACK_AMD_DEFINE_FACTORY__.apply(exports, __WEBPACK_AMD_DEFINE_ARRAY__)) : __WEBPACK_AMD_DEFINE_FACTORY__),\n\t\t\t\t__WEBPACK_AMD_DEFINE_RESULT__ !== undefined && (module.exports = __WEBPACK_AMD_DEFINE_RESULT__));\n } else if (typeof exports !== \"undefined\") {\n factory(module, require('select'));\n } else {\n var mod = {\n exports: {}\n };\n factory(mod, global.select);\n global.clipboardAction = mod.exports;\n }\n})(this, function (module, _select) {\n 'use strict';\n\n var _select2 = _interopRequireDefault(_select);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _typeof = typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\" ? function (obj) {\n return typeof obj;\n } : function (obj) {\n return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj;\n };\n\n function _classCallCheck(instance, Constructor) {\n if (!(instance instanceof Constructor)) {\n throw new TypeError(\"Cannot call a class as a function\");\n }\n }\n\n var _createClass = function () {\n function defineProperties(target, props) {\n for (var i = 0; i < props.length; i++) {\n var descriptor = props[i];\n descriptor.enumerable = descriptor.enumerable || false;\n descriptor.configurable = true;\n if (\"value\" in descriptor) descriptor.writable = true;\n Object.defineProperty(target, descriptor.key, descriptor);\n }\n }\n\n return function (Constructor, protoProps, staticProps) {\n if (protoProps) defineProperties(Constructor.prototype, protoProps);\n if (staticProps) defineProperties(Constructor, staticProps);\n return Constructor;\n };\n }();\n\n var ClipboardAction = function () {\n /**\n * @param {Object} options\n */\n function ClipboardAction(options) {\n _classCallCheck(this, ClipboardAction);\n\n this.resolveOptions(options);\n this.initSelection();\n }\n\n /**\n * Defines base properties passed from constructor.\n * @param {Object} options\n */\n\n\n _createClass(ClipboardAction, [{\n key: 'resolveOptions',\n value: function resolveOptions() {\n var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n this.action = options.action;\n this.container = options.container;\n this.emitter = options.emitter;\n this.target = options.target;\n this.text = options.text;\n this.trigger = options.trigger;\n\n this.selectedText = '';\n }\n }, {\n key: 'initSelection',\n value: function initSelection() {\n if (this.text) {\n this.selectFake();\n } else if (this.target) {\n this.selectTarget();\n }\n }\n }, {\n key: 'selectFake',\n value: function selectFake() {\n var _this = this;\n\n var isRTL = document.documentElement.getAttribute('dir') == 'rtl';\n\n this.removeFake();\n\n this.fakeHandlerCallback = function () {\n return _this.removeFake();\n };\n this.fakeHandler = this.container.addEventListener('click', this.fakeHandlerCallback) || true;\n\n this.fakeElem = document.createElement('textarea');\n // Prevent zooming on iOS\n this.fakeElem.style.fontSize = '12pt';\n // Reset box model\n this.fakeElem.style.border = '0';\n this.fakeElem.style.padding = '0';\n this.fakeElem.style.margin = '0';\n // Move element out of screen horizontally\n this.fakeElem.style.position = 'absolute';\n this.fakeElem.style[isRTL ? 'right' : 'left'] = '-9999px';\n // Move element to the same position vertically\n var yPosition = window.pageYOffset || document.documentElement.scrollTop;\n this.fakeElem.style.top = yPosition + 'px';\n\n this.fakeElem.setAttribute('readonly', '');\n this.fakeElem.value = this.text;\n\n this.container.appendChild(this.fakeElem);\n\n this.selectedText = (0, _select2.default)(this.fakeElem);\n this.copyText();\n }\n }, {\n key: 'removeFake',\n value: function removeFake() {\n if (this.fakeHandler) {\n this.container.removeEventListener('click', this.fakeHandlerCallback);\n this.fakeHandler = null;\n this.fakeHandlerCallback = null;\n }\n\n if (this.fakeElem) {\n this.container.removeChild(this.fakeElem);\n this.fakeElem = null;\n }\n }\n }, {\n key: 'selectTarget',\n value: function selectTarget() {\n this.selectedText = (0, _select2.default)(this.target);\n this.copyText();\n }\n }, {\n key: 'copyText',\n value: function copyText() {\n var succeeded = void 0;\n\n try {\n succeeded = document.execCommand(this.action);\n } catch (err) {\n succeeded = false;\n }\n\n this.handleResult(succeeded);\n }\n }, {\n key: 'handleResult',\n value: function handleResult(succeeded) {\n this.emitter.emit(succeeded ? 'success' : 'error', {\n action: this.action,\n text: this.selectedText,\n trigger: this.trigger,\n clearSelection: this.clearSelection.bind(this)\n });\n }\n }, {\n key: 'clearSelection',\n value: function clearSelection() {\n if (this.trigger) {\n this.trigger.focus();\n }\n\n window.getSelection().removeAllRanges();\n }\n }, {\n key: 'destroy',\n value: function destroy() {\n this.removeFake();\n }\n }, {\n key: 'action',\n set: function set() {\n var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'copy';\n\n this._action = action;\n\n if (this._action !== 'copy' && this._action !== 'cut') {\n throw new Error('Invalid \"action\" value, use either \"copy\" or \"cut\"');\n }\n },\n get: function get() {\n return this._action;\n }\n }, {\n key: 'target',\n set: function set(target) {\n if (target !== undefined) {\n if (target && (typeof target === 'undefined' ? 'undefined' : _typeof(target)) === 'object' && target.nodeType === 1) {\n if (this.action === 'copy' && target.hasAttribute('disabled')) {\n throw new Error('Invalid \"target\" attribute. Please use \"readonly\" instead of \"disabled\" attribute');\n }\n\n if (this.action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {\n throw new Error('Invalid \"target\" attribute. You can\\'t cut text from elements with \"readonly\" or \"disabled\" attributes');\n }\n\n this._target = target;\n } else {\n throw new Error('Invalid \"target\" value, use a valid Element');\n }\n }\n },\n get: function get() {\n return this._target;\n }\n }]);\n\n return ClipboardAction;\n }();\n\n module.exports = ClipboardAction;\n});\n\n/***/ }),\n/* 1 */\n/***/ (function(module, exports, __webpack_require__) {\n\nvar is = __webpack_require__(6);\nvar delegate = __webpack_require__(5);\n\n/**\n * Validates all params and calls the right\n * listener function based on its target type.\n *\n * @param {String|HTMLElement|HTMLCollection|NodeList} target\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listen(target, type, callback) {\n if (!target && !type && !callback) {\n throw new Error('Missing required arguments');\n }\n\n if (!is.string(type)) {\n throw new TypeError('Second argument must be a String');\n }\n\n if (!is.fn(callback)) {\n throw new TypeError('Third argument must be a Function');\n }\n\n if (is.node(target)) {\n return listenNode(target, type, callback);\n }\n else if (is.nodeList(target)) {\n return listenNodeList(target, type, callback);\n }\n else if (is.string(target)) {\n return listenSelector(target, type, callback);\n }\n else {\n throw new TypeError('First argument must be a String, HTMLElement, HTMLCollection, or NodeList');\n }\n}\n\n/**\n * Adds an event listener to a HTML element\n * and returns a remove listener function.\n *\n * @param {HTMLElement} node\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNode(node, type, callback) {\n node.addEventListener(type, callback);\n\n return {\n destroy: function() {\n node.removeEventListener(type, callback);\n }\n }\n}\n\n/**\n * Add an event listener to a list of HTML elements\n * and returns a remove listener function.\n *\n * @param {NodeList|HTMLCollection} nodeList\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNodeList(nodeList, type, callback) {\n Array.prototype.forEach.call(nodeList, function(node) {\n node.addEventListener(type, callback);\n });\n\n return {\n destroy: function() {\n Array.prototype.forEach.call(nodeList, function(node) {\n node.removeEventListener(type, callback);\n });\n }\n }\n}\n\n/**\n * Add an event listener to a selector\n * and returns a remove listener function.\n *\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenSelector(selector, type, callback) {\n return delegate(document.body, selector, type, callback);\n}\n\nmodule.exports = listen;\n\n\n/***/ }),\n/* 2 */\n/***/ (function(module, exports) {\n\nfunction E () {\n // Keep this empty so it's easier to inherit from\n // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n on: function (name, callback, ctx) {\n var e = this.e || (this.e = {});\n\n (e[name] || (e[name] = [])).push({\n fn: callback,\n ctx: ctx\n });\n\n return this;\n },\n\n once: function (name, callback, ctx) {\n var self = this;\n function listener () {\n self.off(name, listener);\n callback.apply(ctx, arguments);\n };\n\n listener._ = callback\n return this.on(name, listener, ctx);\n },\n\n emit: function (name) {\n var data = [].slice.call(arguments, 1);\n var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n var i = 0;\n var len = evtArr.length;\n\n for (i; i < len; i++) {\n evtArr[i].fn.apply(evtArr[i].ctx, data);\n }\n\n return this;\n },\n\n off: function (name, callback) {\n var e = this.e || (this.e = {});\n var evts = e[name];\n var liveEvents = [];\n\n if (evts && callback) {\n for (var i = 0, len = evts.length; i < len; i++) {\n if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n liveEvents.push(evts[i]);\n }\n }\n\n // Remove event from queue to prevent memory leak\n // Suggested by https://github.com/lazd\n // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n (liveEvents.length)\n ? e[name] = liveEvents\n : delete e[name];\n\n return this;\n }\n};\n\nmodule.exports = E;\n\n\n/***/ }),\n/* 3 */\n/***/ (function(module, exports, __webpack_require__) {\n\nvar __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_ARRAY__, __WEBPACK_AMD_DEFINE_RESULT__;(function (global, factory) {\n if (true) {\n !(__WEBPACK_AMD_DEFINE_ARRAY__ = [module, __webpack_require__(0), __webpack_require__(2), __webpack_require__(1)], __WEBPACK_AMD_DEFINE_FACTORY__ = (factory),\n\t\t\t\t__WEBPACK_AMD_DEFINE_RESULT__ = (typeof __WEBPACK_AMD_DEFINE_FACTORY__ === 'function' ?\n\t\t\t\t(__WEBPACK_AMD_DEFINE_FACTORY__.apply(exports, __WEBPACK_AMD_DEFINE_ARRAY__)) : __WEBPACK_AMD_DEFINE_FACTORY__),\n\t\t\t\t__WEBPACK_AMD_DEFINE_RESULT__ !== undefined && (module.exports = __WEBPACK_AMD_DEFINE_RESULT__));\n } else if (typeof exports !== \"undefined\") {\n factory(module, require('./clipboard-action'), require('tiny-emitter'), require('good-listener'));\n } else {\n var mod = {\n exports: {}\n };\n factory(mod, global.clipboardAction, global.tinyEmitter, global.goodListener);\n global.clipboard = mod.exports;\n }\n})(this, function (module, _clipboardAction, _tinyEmitter, _goodListener) {\n 'use strict';\n\n var _clipboardAction2 = _interopRequireDefault(_clipboardAction);\n\n var _tinyEmitter2 = _interopRequireDefault(_tinyEmitter);\n\n var _goodListener2 = _interopRequireDefault(_goodListener);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n var _typeof = typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\" ? function (obj) {\n return typeof obj;\n } : function (obj) {\n return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj;\n };\n\n function _classCallCheck(instance, Constructor) {\n if (!(instance instanceof Constructor)) {\n throw new TypeError(\"Cannot call a class as a function\");\n }\n }\n\n var _createClass = function () {\n function defineProperties(target, props) {\n for (var i = 0; i < props.length; i++) {\n var descriptor = props[i];\n descriptor.enumerable = descriptor.enumerable || false;\n descriptor.configurable = true;\n if (\"value\" in descriptor) descriptor.writable = true;\n Object.defineProperty(target, descriptor.key, descriptor);\n }\n }\n\n return function (Constructor, protoProps, staticProps) {\n if (protoProps) defineProperties(Constructor.prototype, protoProps);\n if (staticProps) defineProperties(Constructor, staticProps);\n return Constructor;\n };\n }();\n\n function _possibleConstructorReturn(self, call) {\n if (!self) {\n throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\");\n }\n\n return call && (typeof call === \"object\" || typeof call === \"function\") ? call : self;\n }\n\n function _inherits(subClass, superClass) {\n if (typeof superClass !== \"function\" && superClass !== null) {\n throw new TypeError(\"Super expression must either be null or a function, not \" + typeof superClass);\n }\n\n subClass.prototype = Object.create(superClass && superClass.prototype, {\n constructor: {\n value: subClass,\n enumerable: false,\n writable: true,\n configurable: true\n }\n });\n if (superClass) Object.setPrototypeOf ? Object.setPrototypeOf(subClass, superClass) : subClass.__proto__ = superClass;\n }\n\n var Clipboard = function (_Emitter) {\n _inherits(Clipboard, _Emitter);\n\n /**\n * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n * @param {Object} options\n */\n function Clipboard(trigger, options) {\n _classCallCheck(this, Clipboard);\n\n var _this = _possibleConstructorReturn(this, (Clipboard.__proto__ || Object.getPrototypeOf(Clipboard)).call(this));\n\n _this.resolveOptions(options);\n _this.listenClick(trigger);\n return _this;\n }\n\n /**\n * Defines if attributes would be resolved using internal setter functions\n * or custom functions that were passed in the constructor.\n * @param {Object} options\n */\n\n\n _createClass(Clipboard, [{\n key: 'resolveOptions',\n value: function resolveOptions() {\n var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n this.action = typeof options.action === 'function' ? options.action : this.defaultAction;\n this.target = typeof options.target === 'function' ? options.target : this.defaultTarget;\n this.text = typeof options.text === 'function' ? options.text : this.defaultText;\n this.container = _typeof(options.container) === 'object' ? options.container : document.body;\n }\n }, {\n key: 'listenClick',\n value: function listenClick(trigger) {\n var _this2 = this;\n\n this.listener = (0, _goodListener2.default)(trigger, 'click', function (e) {\n return _this2.onClick(e);\n });\n }\n }, {\n key: 'onClick',\n value: function onClick(e) {\n var trigger = e.delegateTarget || e.currentTarget;\n\n if (this.clipboardAction) {\n this.clipboardAction = null;\n }\n\n this.clipboardAction = new _clipboardAction2.default({\n action: this.action(trigger),\n target: this.target(trigger),\n text: this.text(trigger),\n container: this.container,\n trigger: trigger,\n emitter: this\n });\n }\n }, {\n key: 'defaultAction',\n value: function defaultAction(trigger) {\n return getAttributeValue('action', trigger);\n }\n }, {\n key: 'defaultTarget',\n value: function defaultTarget(trigger) {\n var selector = getAttributeValue('target', trigger);\n\n if (selector) {\n return document.querySelector(selector);\n }\n }\n }, {\n key: 'defaultText',\n value: function defaultText(trigger) {\n return getAttributeValue('text', trigger);\n }\n }, {\n key: 'destroy',\n value: function destroy() {\n this.listener.destroy();\n\n if (this.clipboardAction) {\n this.clipboardAction.destroy();\n this.clipboardAction = null;\n }\n }\n }], [{\n key: 'isSupported',\n value: function isSupported() {\n var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['copy', 'cut'];\n\n var actions = typeof action === 'string' ? [action] : action;\n var support = !!document.queryCommandSupported;\n\n actions.forEach(function (action) {\n support = support && !!document.queryCommandSupported(action);\n });\n\n return support;\n }\n }]);\n\n return Clipboard;\n }(_tinyEmitter2.default);\n\n /**\n * Helper function to retrieve attribute value.\n * @param {String} suffix\n * @param {Element} element\n */\n function getAttributeValue(suffix, element) {\n var attribute = 'data-clipboard-' + suffix;\n\n if (!element.hasAttribute(attribute)) {\n return;\n }\n\n return element.getAttribute(attribute);\n }\n\n module.exports = Clipboard;\n});\n\n/***/ }),\n/* 4 */\n/***/ (function(module, exports) {\n\nvar DOCUMENT_NODE_TYPE = 9;\n\n/**\n * A polyfill for Element.matches()\n */\nif (typeof Element !== 'undefined' && !Element.prototype.matches) {\n var proto = Element.prototype;\n\n proto.matches = proto.matchesSelector ||\n proto.mozMatchesSelector ||\n proto.msMatchesSelector ||\n proto.oMatchesSelector ||\n proto.webkitMatchesSelector;\n}\n\n/**\n * Finds the closest parent that matches a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @return {Function}\n */\nfunction closest (element, selector) {\n while (element && element.nodeType !== DOCUMENT_NODE_TYPE) {\n if (typeof element.matches === 'function' &&\n element.matches(selector)) {\n return element;\n }\n element = element.parentNode;\n }\n}\n\nmodule.exports = closest;\n\n\n/***/ }),\n/* 5 */\n/***/ (function(module, exports, __webpack_require__) {\n\nvar closest = __webpack_require__(4);\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction _delegate(element, selector, type, callback, useCapture) {\n var listenerFn = listener.apply(this, arguments);\n\n element.addEventListener(type, listenerFn, useCapture);\n\n return {\n destroy: function() {\n element.removeEventListener(type, listenerFn, useCapture);\n }\n }\n}\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element|String|Array} [elements]\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction delegate(elements, selector, type, callback, useCapture) {\n // Handle the regular Element usage\n if (typeof elements.addEventListener === 'function') {\n return _delegate.apply(null, arguments);\n }\n\n // Handle Element-less usage, it defaults to global delegation\n if (typeof type === 'function') {\n // Use `document` as the first parameter, then apply arguments\n // This is a short way to .unshift `arguments` without running into deoptimizations\n return _delegate.bind(null, document).apply(null, arguments);\n }\n\n // Handle Selector-based usage\n if (typeof elements === 'string') {\n elements = document.querySelectorAll(elements);\n }\n\n // Handle Array-like based usage\n return Array.prototype.map.call(elements, function (element) {\n return _delegate(element, selector, type, callback, useCapture);\n });\n}\n\n/**\n * Finds closest match and invokes callback.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Function}\n */\nfunction listener(element, selector, type, callback) {\n return function(e) {\n e.delegateTarget = closest(e.target, selector);\n\n if (e.delegateTarget) {\n callback.call(element, e);\n }\n }\n}\n\nmodule.exports = delegate;\n\n\n/***/ }),\n/* 6 */\n/***/ (function(module, exports) {\n\n/**\n * Check if argument is a HTML element.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.node = function(value) {\n return value !== undefined\n && value instanceof HTMLElement\n && value.nodeType === 1;\n};\n\n/**\n * Check if argument is a list of HTML elements.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.nodeList = function(value) {\n var type = Object.prototype.toString.call(value);\n\n return value !== undefined\n && (type === '[object NodeList]' || type === '[object HTMLCollection]')\n && ('length' in value)\n && (value.length === 0 || exports.node(value[0]));\n};\n\n/**\n * Check if argument is a string.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.string = function(value) {\n return typeof value === 'string'\n || value instanceof String;\n};\n\n/**\n * Check if argument is a function.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.fn = function(value) {\n var type = Object.prototype.toString.call(value);\n\n return type === '[object Function]';\n};\n\n\n/***/ }),\n/* 7 */\n/***/ (function(module, exports) {\n\nfunction select(element) {\n var selectedText;\n\n if (element.nodeName === 'SELECT') {\n element.focus();\n\n selectedText = element.value;\n }\n else if (element.nodeName === 'INPUT' || element.nodeName === 'TEXTAREA') {\n var isReadOnly = element.hasAttribute('readonly');\n\n if (!isReadOnly) {\n element.setAttribute('readonly', '');\n }\n\n element.select();\n element.setSelectionRange(0, element.value.length);\n\n if (!isReadOnly) {\n element.removeAttribute('readonly');\n }\n\n selectedText = element.value;\n }\n else {\n if (element.hasAttribute('contenteditable')) {\n element.focus();\n }\n\n var selection = window.getSelection();\n var range = document.createRange();\n\n range.selectNodeContents(element);\n selection.removeAllRanges();\n selection.addRange(range);\n\n selectedText = selection.toString();\n }\n\n return selectedText;\n}\n\nmodule.exports = select;\n\n\n/***/ })\n/******/ ]);\n});\n", - "define('core/webidl-clipboard',[\"exports\", \"deps/text!core/images/clipboard.svg\", \"deps/clipboard\"], function (exports, _clipboard, _clipboard3) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _clipboard2 = _interopRequireDefault(_clipboard);\n\n var _clipboard4 = _interopRequireDefault(_clipboard3);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n /**\n * Module core/webidl-clipboard\n *\n * This module adds a button to each IDL pre making it possible to copy\n * well-formatted IDL to the clipboard.\n *\n */\n const name = exports.name = \"core/webidl-clipboard\";\n\n // This button serves a prototype that we clone as needed.\n const copyButton = document.createElement(\"button\");\n copyButton.innerHTML = _clipboard2.default;\n copyButton.title = \"Copy IDL to clipboard\";\n copyButton.classList.add(\"respec-button-copy-paste\", \"removeOnSave\");\n\n const clipboardOps = {\n text: trigger => {\n return document.querySelector(trigger.dataset.clipboardTarget).textContent.replace(/\\ +/gm, \" \").replace(/^\\ /gm, \" \").replace(/^};\\n/gm, \"};\\n\").trim();\n }\n };\n\n async function run(conf, doc, cb) {\n Array.from(doc.querySelectorAll(\"pre.idl\")).map(elem => {\n const button = copyButton.cloneNode(true);\n const definition = elem.querySelector(`span[id^=\"idl-def-\"], span[id^=\"dom-\"]`);\n let target = \"#\";\n if (definition === null && elem.id === \"\") {\n if (elem.parentElement.id === \"idl-index\") {\n target += \"actual-idl-index\";\n } else {\n elem.id = `idl-${String(Math.random()).substr(2)}`;\n target += elem.id;\n }\n } else {\n target += elem.id || definition.id;\n }\n return { button, elem, target };\n }).forEach(({ elem, button, target }) => {\n const wrapper = doc.createElement(\"div\");\n button.dataset.clipboardTarget = target;\n elem.parentElement.replaceChild(wrapper, elem);\n wrapper.appendChild(button);\n wrapper.appendChild(elem);\n });\n const clipboard = new _clipboard4.default(\".respec-button-copy-paste\", clipboardOps);\n clipboard.on(\"success\", e => e.clearSelection());\n cb();\n }\n});\n//# sourceMappingURL=webidl-clipboard.js.map;\n", - "define('core/data-tests',[\"exports\", \"core/pubsubhub\", \"core/l10n\"], function (exports, _pubsubhub, _l10n) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n /**\n * Module core/data-tests\n *\n * Allows specs to link to test files in a test suite, by adding `details` of where\n * particular tests for a testable assertion can be found.\n *\n * `data-tests` takes a space separated list of URLs, e.g. data-test=\"foo.html bar.html\".\n *\n * Docs: https://github.com/w3c/respec/wiki/data-tests\n */\n const l10n = {\n en: {\n missing_test_suite_uri: \"Found tests in your spec, but missing '\" + \"[`testSuiteURI`](https://github.com/w3c/respec/wiki/testSuiteURI)' in your ReSpec config.\",\n tests: \"tests\",\n test: \"test\"\n }\n };\n\n const name = exports.name = \"core/data-tests\";\n\n const lang = _l10n.lang in l10n ? _l10n.lang : \"en\";\n\n function toListItem(href) {\n const emojiList = [];\n const [testFile] = new URL(href).pathname.split(\"/\").reverse();\n const testParts = testFile.split(\".\");\n let [testFileName] = testParts;\n\n const isSecureTest = testParts.find(part => part === \"https\");\n if (isSecureTest) {\n const requiresConnectionEmoji = document.createElement(\"span\");\n requiresConnectionEmoji.innerHTML = \"🔒\";\n requiresConnectionEmoji.setAttribute(\"aria-label\", \"requires a secure connection\");\n requiresConnectionEmoji.setAttribute(\"title\", \"Test requires HTTPS\");\n testFileName = testFileName.replace(\".https\", \"\");\n emojiList.push(requiresConnectionEmoji);\n }\n\n const isManualTest = testFileName.split(\".\").join(\"-\").split(\"-\").find(part => part === \"manual\");\n if (isManualTest) {\n const manualPerformEmoji = document.createElement(\"span\");\n manualPerformEmoji.innerHTML = \"💪\";\n manualPerformEmoji.setAttribute(\"aria-label\", \"the test must be run manually\");\n manualPerformEmoji.setAttribute(\"title\", \"Manual test\");\n testFileName = testFileName.replace(\"-manual\", \"\");\n emojiList.push(manualPerformEmoji);\n }\n\n const testList = hyperHTML.bind(document.createElement(\"li\"))`\n <a href=\"${href}\">\n ${testFileName}\n </a> ${emojiList}\n `;\n return testList;\n }\n\n function run(conf) {\n const testables = document.querySelectorAll(\"[data-tests]\");\n if (!testables.length) {\n return;\n }\n if (!conf.testSuiteURI) {\n (0, _pubsubhub.pub)(\"error\", l10n[lang].missing_test_suite_uri);\n return;\n }\n Array.from(testables).filter(elem => elem.dataset.tests)\n // Render details + ul, returns HTMLDetailsElement\n .map(elem => {\n const details = document.createElement(\"details\");\n const renderer = hyperHTML.bind(details);\n const testURLs = elem.dataset.tests.split(/,/gm).map(url => url.trim()).map(url => {\n let href = \"\";\n try {\n href = new URL(url, conf.testSuiteURI).href;\n } catch (err) {\n (0, _pubsubhub.pub)(\"warn\", `${l10n[lang].bad_uri}: ${url}`);\n }\n return href;\n });\n details.classList.add(\"respec-tests-details\", \"removeOnSave\");\n renderer`\n <summary>\n tests: ${testURLs.length}\n </summary>\n <ul>${testURLs.map(toListItem)}</ul>\n `;\n return { elem, details };\n }).forEach(({ elem, details }) => {\n delete elem.dataset.tests;\n elem.insertAdjacentElement(\"beforeend\", details);\n });\n }\n});\n//# sourceMappingURL=data-tests.js.map;\n", - "define('core/list-sorter',[\"exports\", \"core/pubsubhub\"], function (exports, _pubsubhub) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.sortListItems = sortListItems;\n exports.sortDefinitionTerms = sortDefinitionTerms;\n exports.run = run;\n const name = exports.name = \"core/list-sorter\";\n\n function makeSorter(direction) {\n return ({ textContent: a }, { textContent: b }) => {\n return direction === \"ascending\" ? a.localeCompare(b) : b.localeCompare(a);\n };\n }\n /**\n * Shallow sort list items in OL, and UL elements.\n *\n * @param {HTMLUListElement} elem\n * @returns {DocumentFragment}\n */\n function sortListItems(elem, dir) {\n const elements = getDirectDescendents(elem, \"li\");\n const sortedElements = elements.sort(makeSorter(dir)).reduce((frag, elem) => {\n frag.appendChild(elem);\n return frag;\n }, document.createDocumentFragment());\n return sortedElements;\n }\n\n function getDirectDescendents(elem, wantedDescendentName) {\n let elements;\n try {\n elements = elem.querySelectorAll(`:scope > ${wantedDescendentName}`);\n } catch (err) {\n let tempId = \"\";\n // We give a temporary id, to overcome lack of \":scope\" support in Edge.\n if (!elem.id) {\n tempId = `temp-${String(Math.random()).substr(2)}`;\n elem.id = tempId;\n }\n const query = `#${elem.id} > ${wantedDescendentName}`;\n elements = elem.parentElement.querySelectorAll(query);\n if (tempId) {\n elem.id = \"\";\n }\n }\n return [...elements];\n }\n\n /**\n * Shallow sort a definition list based on its definition terms (dt) elements.\n *\n * @param {HTMLDListElement} dl\n * @returns {DocumentFragment}\n */\n function sortDefinitionTerms(dl, dir) {\n const elements = getDirectDescendents(dl, \"dt\");\n const sortedElements = elements.sort(makeSorter(dir)).reduce((frag, elem) => {\n const { nodeType, nodeName } = elem;\n const children = document.createDocumentFragment();\n let { nextSibling: next } = elem;\n while (next) {\n if (!next.nextSibling) {\n break;\n }\n children.appendChild(next.cloneNode(true));\n const { nodeType: nextType, nodeName: nextName } = next.nextSibling;\n const isSameType = nextType === nodeType && nextName === nodeName;\n if (isSameType) {\n break;\n }\n next = next.nextSibling;\n }\n children.prepend(elem.cloneNode(true));\n frag.appendChild(children);\n return frag;\n }, document.createDocumentFragment());\n return sortedElements;\n }\n\n function run(conf, doc, cb) {\n for (const elem of document.querySelectorAll(\"[data-sort]\")) {\n let sortedElems;\n const dir = elem.dataset.sort || \"ascending\";\n switch (elem.localName) {\n case \"dl\":\n sortedElems = sortDefinitionTerms(elem, dir);\n break;\n case \"ol\":\n case \"ul\":\n sortedElems = sortListItems(elem, dir);\n break;\n default:\n (0, _pubsubhub.pub)(\"warning\", `ReSpec can't sort ${elem.localName} elements.`);\n }\n if (sortedElems) {\n const range = document.createRange();\n range.selectNodeContents(elem);\n range.deleteContents();\n elem.appendChild(sortedElems);\n }\n }\n cb();\n }\n});\n//# sourceMappingURL=list-sorter.js.map;\n", - "\ndefine('deps/text!core/css/var.css',[],function () { return 'var:hover {\\n border-bottom: 1px dotted;\\n cursor: pointer;\\n}\\n\\nvar.respec-hl {\\n color: var(--color, #000);\\n background-color: var(--bg-color);\\n box-shadow: 0 0 0px 2px var(--bg-color);\\n}\\n\\n/* highlight colors\\n https://github.com/w3c/tr-design/issues/152\\n*/\\nvar.respec-hl-c1 {\\n --bg-color: #f4d200;\\n}\\n\\nvar.respec-hl-c2 {\\n --bg-color: #ff87a2;\\n}\\n\\nvar.respec-hl-c3 {\\n --bg-color: #96e885;\\n}\\n\\nvar.respec-hl-c4 {\\n --bg-color: #3eeed2;\\n}\\n\\nvar.respec-hl-c5 {\\n --bg-color: #eacfb6;\\n}\\n\\nvar.respec-hl-c6 {\\n --bg-color: #82ddff;\\n}\\n\\nvar.respec-hl-c7 {\\n --bg-color: #ffbcf2;\\n}\\n\\n@media print {\\n var.respec-hl {\\n background: none;\\n color: #000;\\n box-shadow: unset;\\n }\\n}\\n';});\n\n", - "define('core/highlight-vars',[\"exports\", \"core/pubsubhub\", \"deps/text!core/css/var.css\"], function (exports, _pubsubhub, _var) {\n \"use strict\";\n\n Object.defineProperty(exports, \"__esModule\", {\n value: true\n });\n exports.name = undefined;\n exports.run = run;\n\n var _var2 = _interopRequireDefault(_var);\n\n function _interopRequireDefault(obj) {\n return obj && obj.__esModule ? obj : {\n default: obj\n };\n }\n\n /**\n * Module core/highlight-vars\n * Highlights occurrences of a <var> within a section on click.\n * Set `conf.highlightVars = true` to enable.\n * Removes highlights from <var> if clicked anywhere else.\n * All is done while keeping in mind that exported html stays clean\n * on export.\n */\n const name = exports.name = \"core/highlight-vars\";\n\n function run(conf) {\n if (!conf.highlightVars) {\n return;\n }\n const styleElement = document.createElement(\"style\");\n styleElement.textContent = _var2.default;\n styleElement.classList.add(\"removeOnSave\");\n document.head.appendChild(styleElement);\n\n [...document.querySelectorAll(\"var\")].forEach(varElem => varElem.addEventListener(\"click\", hightlightListener));\n\n // remove highlights, cleanup empty class/style attributes\n (0, _pubsubhub.sub)(\"beforesave\", outputDoc => {\n [...outputDoc.querySelectorAll(\"var.respec-hl\")].forEach(removeHighlight);\n });\n }\n\n function hightlightListener(ev) {\n ev.stopPropagation();\n const { target: varElem } = ev;\n const hightligtedElems = highlightVars(varElem);\n const resetListener = () => {\n const hlColor = getHighlightColor(varElem);\n hightligtedElems.forEach(el => removeHighlight(el, hlColor));\n [...HL_COLORS.keys()].forEach(key => HL_COLORS.set(key, true));\n };\n if (hightligtedElems.length) {\n document.body.addEventListener(\"click\", resetListener, { once: true });\n }\n }\n\n // availability of highlight colors. colors from var.css\n const HL_COLORS = new Map([[\"respec-hl-c1\", true], [\"respec-hl-c2\", true], [\"respec-hl-c3\", true], [\"respec-hl-c4\", true], [\"respec-hl-c5\", true], [\"respec-hl-c6\", true], [\"respec-hl-c7\", true]]);\n\n function getHighlightColor(target) {\n // return current colors if applicable\n const { value } = target.classList;\n const re = /respec-hl-\\w+/;\n const activeClass = re.test(value) && value.match(re);\n if (activeClass) return activeClass[0];\n\n // first color preference\n if (HL_COLORS.get(\"respec-hl-c1\") === true) return \"respec-hl-c1\";\n\n // otherwise get some other available color\n return [...HL_COLORS.keys()].find(c => HL_COLORS.get(c)) || \"respec-hl-c1\";\n }\n\n function highlightVars(varElem) {\n const textContent = varElem.textContent.trim();\n const parent = varElem.closest(\"section\");\n const highlightColor = getHighlightColor(varElem);\n\n const varsToHighlight = [...parent.querySelectorAll(\"var\")].filter(el => el.textContent.trim() === textContent);\n\n // update availability of highlight color\n const colorStatus = varsToHighlight[0].classList.contains(\"respec-hl\");\n HL_COLORS.set(highlightColor, colorStatus);\n\n // highlight vars\n if (colorStatus) {\n varsToHighlight.forEach(el => removeHighlight(el, highlightColor));\n return [];\n } else {\n varsToHighlight.forEach(el => addHighlight(el, highlightColor));\n }\n return varsToHighlight;\n }\n\n function removeHighlight(el, highlightColor) {\n el.classList.remove(\"respec-hl\", highlightColor);\n // clean up empty class attributes so they don't come in export\n if (!el.classList.length) el.removeAttribute(\"class\");\n }\n\n function addHighlight(elem, highlightColor) {\n elem.classList.add(\"respec-hl\", highlightColor);\n }\n});\n//# sourceMappingURL=highlight-vars.js.map;\n", - "\"use strict\";\n// In case everything else fails, we want the error\nwindow.addEventListener(\"error\", ev => {\n console.error(ev.error, ev.message, ev);\n});\n\n// this is only set in a build, not at all in the dev environment\nrequire.config({\n shim: {\n shortcut: {\n exports: \"shortcut\",\n },\n highlight: {\n exports: \"hljs\",\n },\n },\n paths: {\n \"handlebars.runtime\": \"deps/handlebars\",\n \"deps/highlight\": \"https://www.w3.org/Tools/respec/respec-highlight\",\n },\n deps: [\"deps/hyperhtml\", \"deps/url-search-params\"],\n});\n\ndefine(\n 'profile-oai',[\n // order is significant\n \"deps/domReady\",\n \"core/base-runner\",\n \"core/ui\",\n \"core/l10n\",\n //\"w3c/defaults\",\n \"oai/defaults\",\n \"core/style\",\n \"w3c/style\",\n \"w3c/l10n\",\n \"core/github\",\n \"core/data-include\",\n \"core/markdown\",\n //\"w3c/headers\",\n \"oai/headers\",\n \"w3c/abstract\",\n \"w3c/conformance\",\n \"core/data-transform\",\n \"core/inlines\",\n \"core/dfn\",\n \"w3c/rfc2119\",\n \"core/examples\",\n \"core/issues-notes\",\n \"core/requirements\",\n \"core/best-practices\",\n \"core/figures\",\n \"core/webidl\",\n \"core/data-cite\",\n \"core/biblio\",\n \"core/webidl-index\",\n \"core/link-to-dfn\",\n \"core/contrib\",\n \"core/fix-headers\",\n \"core/structure\",\n \"w3c/informative\",\n \"w3c/permalinks\",\n \"core/id-headers\",\n \"core/location-hash\",\n \"core/caniuse\",\n \"ui/save-html\",\n \"ui/search-specref\",\n \"ui/dfn-list\",\n \"ui/about-respec\",\n \"core/seo\",\n \"w3c/seo\",\n \"core/highlight\",\n \"core/webidl-clipboard\",\n \"core/data-tests\",\n \"core/list-sorter\",\n \"core/highlight-vars\",\n /*Linter must be the last thing to run*/\n \"core/linter\",\n ],\n (domReady, runner, { ui }, ...plugins) => {\n ui.show();\n domReady(async () => {\n try {\n await runner.runAll(plugins);\n await document.respecIsReady;\n } catch (err) {\n console.error(err);\n } finally {\n ui.enable();\n }\n });\n }\n);\n\n" - ] -} \ No newline at end of file diff --git a/docs/js/respec-oai.js b/docs/js/respec-oai.js deleted file mode 100644 index 008663cec0..0000000000 --- a/docs/js/respec-oai.js +++ /dev/null @@ -1,565 +0,0 @@ -"use strict";var requirejs,require,define;window.respecVersion="21.0.1",function(global,setTimeout){var req,s,head,baseElement,dataMain,src,interactiveScript,currentlyAddingScript,mainScript,subPath,version="2.3.5",commentRegExp=/\/\*[\s\S]*?\*\/|([^:"'=]|^)\/\/.*$/gm,cjsRequireRegExp=/[^.]\s*require\s*\(\s*["']([^'"\s]+)["']\s*\)/g,jsSuffixRegExp=/\.js$/,currDirRegExp=/^\.\//,op=Object.prototype,ostring=op.toString,hasOwn=op.hasOwnProperty,isBrowser=!("undefined"==typeof window||"undefined"==typeof navigator||!window.document),isWebWorker=!isBrowser&&"undefined"!=typeof importScripts,readyRegExp=isBrowser&&"PLAYSTATION 3"===navigator.platform?/^complete$/:/^(complete|loaded)$/,defContextName="_",isOpera="undefined"!=typeof opera&&"[object Opera]"===opera.toString(),contexts={},cfg={},globalDefQueue=[],useInteractive=!1;function commentReplace(e,t){return t||""}function isFunction(e){return"[object Function]"===ostring.call(e)}function isArray(e){return"[object Array]"===ostring.call(e)}function each(e,t){var n;if(e)for(n=0;n<e.length&&(!e[n]||!t(e[n],n,e));n+=1);}function eachReverse(e,t){var n;if(e)for(n=e.length-1;n>-1&&(!e[n]||!t(e[n],n,e));n-=1);}function hasProp(e,t){return hasOwn.call(e,t)}function getOwn(e,t){return hasProp(e,t)&&e[t]}function eachProp(e,t){var n;for(n in e)if(hasProp(e,n)&&t(e[n],n))break}function mixin(e,t,n,r){return t&&eachProp(t,function(t,i){!n&&hasProp(e,i)||(!r||"object"!=typeof t||!t||isArray(t)||isFunction(t)||t instanceof RegExp?e[i]=t:(e[i]||(e[i]={}),mixin(e[i],t,n,r)))}),e}function bind(e,t){return function(){return t.apply(e,arguments)}}function scripts(){return document.getElementsByTagName("script")}function defaultOnError(e){throw e}function getGlobal(e){if(!e)return e;var t=global;return each(e.split("."),function(e){t=t[e]}),t}function makeError(e,t,n,r){var i=new Error(t+"\nhttp://requirejs.org/docs/errors.html#"+e);return i.requireType=e,i.requireModules=r,n&&(i.originalError=n),i}if(void 0===define){if(void 0!==requirejs){if(isFunction(requirejs))return;cfg=requirejs,requirejs=void 0}void 0===require||isFunction(require)||(cfg=require,require=void 0),req=requirejs=function(e,t,n,r){var i,o,a=defContextName;return isArray(e)||"string"==typeof e||(o=e,isArray(t)?(e=t,t=n,n=r):e=[]),o&&o.context&&(a=o.context),(i=getOwn(contexts,a))||(i=contexts[a]=req.s.newContext(a)),o&&i.configure(o),i.require(e,t,n)},req.config=function(e){return req(e)},req.nextTick=void 0!==setTimeout?function(e){setTimeout(e,4)}:function(e){e()},require||(require=req),req.version=version,req.jsExtRegExp=/^\/|:|\?|\.js$/,req.isBrowser=isBrowser,s=req.s={contexts:contexts,newContext:newContext},req({}),each(["toUrl","undef","defined","specified"],function(e){req[e]=function(){var t=contexts[defContextName];return t.require[e].apply(t,arguments)}}),isBrowser&&(head=s.head=document.getElementsByTagName("head")[0],baseElement=document.getElementsByTagName("base")[0],baseElement&&(head=s.head=baseElement.parentNode)),req.onError=defaultOnError,req.createNode=function(e,t,n){var r=e.xhtml?document.createElementNS("http://www.w3.org/1999/xhtml","html:script"):document.createElement("script");return r.type=e.scriptType||"text/javascript",r.charset="utf-8",r.async=!0,r},req.load=function(e,t,n){var r,i=e&&e.config||{};if(isBrowser)return(r=req.createNode(i,t,n)).setAttribute("data-requirecontext",e.contextName),r.setAttribute("data-requiremodule",t),!r.attachEvent||r.attachEvent.toString&&r.attachEvent.toString().indexOf("[native code")<0||isOpera?(r.addEventListener("load",e.onScriptLoad,!1),r.addEventListener("error",e.onScriptError,!1)):(useInteractive=!0,r.attachEvent("onreadystatechange",e.onScriptLoad)),r.src=n,i.onNodeCreated&&i.onNodeCreated(r,i,t,n),currentlyAddingScript=r,baseElement?head.insertBefore(r,baseElement):head.appendChild(r),currentlyAddingScript=null,r;if(isWebWorker)try{setTimeout(function(){},0),importScripts(n),e.completeLoad(t)}catch(r){e.onError(makeError("importscripts","importScripts failed for "+t+" at "+n,r,[t]))}},isBrowser&&!cfg.skipDataMain&&eachReverse(scripts(),function(e){if(head||(head=e.parentNode),dataMain=e.getAttribute("data-main"))return mainScript=dataMain,cfg.baseUrl||-1!==mainScript.indexOf("!")||(src=mainScript.split("/"),mainScript=src.pop(),subPath=src.length?src.join("/")+"/":"./",cfg.baseUrl=subPath),mainScript=mainScript.replace(jsSuffixRegExp,""),req.jsExtRegExp.test(mainScript)&&(mainScript=dataMain),cfg.deps=cfg.deps?cfg.deps.concat(mainScript):[mainScript],!0}),define=function(e,t,n){var r,i;"string"!=typeof e&&(n=t,t=e,e=null),isArray(t)||(n=t,t=null),!t&&isFunction(n)&&(t=[],n.length&&(n.toString().replace(commentRegExp,commentReplace).replace(cjsRequireRegExp,function(e,n){t.push(n)}),t=(1===n.length?["require"]:["require","exports","module"]).concat(t))),useInteractive&&(r=currentlyAddingScript||getInteractiveScript())&&(e||(e=r.getAttribute("data-requiremodule")),i=contexts[r.getAttribute("data-requirecontext")]),i?(i.defQueue.push([e,t,n]),i.defQueueMap[e]=!0):globalDefQueue.push([e,t,n])},define.amd={jQuery:!0},req.exec=function(text){return eval(text)},req(cfg)}function newContext(e){var t,n,r,i,o,a={waitSeconds:7,baseUrl:"./",paths:{},bundles:{},pkgs:{},shim:{},config:{}},s={},l={},c={},u=[],d={},p={},f={},h=1,m=1;function g(e,t,n){var r,i,o,s,l,c,u,d,p,f,h=t&&t.split("/"),m=a.map,g=m&&m["*"];if(e&&(c=(e=e.split("/")).length-1,a.nodeIdCompat&&jsSuffixRegExp.test(e[c])&&(e[c]=e[c].replace(jsSuffixRegExp,"")),"."===e[0].charAt(0)&&h&&(e=h.slice(0,h.length-1).concat(e)),function(e){var t,n;for(t=0;t<e.length;t++)if("."===(n=e[t]))e.splice(t,1),t-=1;else if(".."===n){if(0===t||1===t&&".."===e[2]||".."===e[t-1])continue;t>0&&(e.splice(t-1,2),t-=2)}}(e),e=e.join("/")),n&&m&&(h||g)){i=e.split("/");e:for(o=i.length;o>0;o-=1){if(l=i.slice(0,o).join("/"),h)for(s=h.length;s>0;s-=1)if((r=getOwn(m,h.slice(0,s).join("/")))&&(r=getOwn(r,l))){u=r,d=o;break e}!p&&g&&getOwn(g,l)&&(p=getOwn(g,l),f=o)}!u&&p&&(u=p,d=f),u&&(i.splice(0,d,u),e=i.join("/"))}return getOwn(a.pkgs,e)||e}function b(e){isBrowser&&each(scripts(),function(t){if(t.getAttribute("data-requiremodule")===e&&t.getAttribute("data-requirecontext")===r.contextName)return t.parentNode.removeChild(t),!0})}function y(e){var t=getOwn(a.paths,e);if(t&&isArray(t)&&t.length>1)return t.shift(),r.require.undef(e),r.makeRequire(null,{skipMap:!0})([e]),!0}function v(e){var t,n=e?e.indexOf("!"):-1;return n>-1&&(t=e.substring(0,n),e=e.substring(n+1,e.length)),[t,e]}function w(e,t,n,i){var o,a,s,l,c=null,u=t?t.name:null,p=e,f=!0,b="";return e||(f=!1,e="_@r"+(h+=1)),c=(l=v(e))[0],e=l[1],c&&(c=g(c,u,i),a=getOwn(d,c)),e&&(c?b=n?e:a&&a.normalize?a.normalize(e,function(e){return g(e,u,i)}):-1===e.indexOf("!")?g(e,u,i):e:(c=(l=v(b=g(e,u,i)))[0],b=l[1],n=!0,o=r.nameToUrl(b))),{prefix:c,name:b,parentMap:t,unnormalized:!!(s=!c||a||n?"":"_unnormalized"+(m+=1)),url:o,originalName:p,isDefine:f,id:(c?c+"!"+b:b)+s}}function x(e){var t=e.id,n=getOwn(s,t);return n||(n=s[t]=new r.Module(e)),n}function k(e,t,n){var r=e.id,i=getOwn(s,r);!hasProp(d,r)||i&&!i.defineEmitComplete?(i=x(e)).error&&"error"===t?n(i.error):i.on(t,n):"defined"===t&&n(d[r])}function C(e,t){var n=e.requireModules,r=!1;t?t(e):(each(n,function(t){var n=getOwn(s,t);n&&(n.error=e,n.events.error&&(r=!0,n.emit("error",e)))}),r||req.onError(e))}function E(){globalDefQueue.length&&(each(globalDefQueue,function(e){var t=e[0];"string"==typeof t&&(r.defQueueMap[t]=!0),u.push(e)}),globalDefQueue=[])}function $(e){delete s[e],delete l[e]}function T(){var e,n,i=1e3*a.waitSeconds,c=i&&r.startTime+i<(new Date).getTime(),u=[],p=[],f=!1,h=!0;if(!t){if(t=!0,eachProp(l,function(e){var t=e.map,r=t.id;if(e.enabled&&(t.isDefine||p.push(e),!e.error))if(!e.inited&&c)y(r)?(n=!0,f=!0):(u.push(r),b(r));else if(!e.inited&&e.fetched&&t.isDefine&&(f=!0,!t.prefix))return h=!1}),c&&u.length)return(e=makeError("timeout","Load timeout for modules: "+u,null,u)).contextName=r.contextName,C(e);h&&each(p,function(e){!function e(t,n,r){var i=t.map.id;t.error?t.emit("error",t.error):(n[i]=!0,each(t.depMaps,function(i,o){var a=i.id,l=getOwn(s,a);!l||t.depMatched[o]||r[a]||(getOwn(n,a)?(t.defineDep(o,d[a]),t.check()):e(l,n,r))}),r[i]=!0)}(e,{},{})}),c&&!n||!f||!isBrowser&&!isWebWorker||o||(o=setTimeout(function(){o=0,T()},50)),t=!1}}function S(e){hasProp(d,e[0])||x(w(e[0],null,!0)).init(e[1],e[2])}function A(e,t,n,r){e.detachEvent&&!isOpera?r&&e.detachEvent(r,t):e.removeEventListener(n,t,!1)}function L(e){var t=e.currentTarget||e.srcElement;return A(t,r.onScriptLoad,"load","onreadystatechange"),A(t,r.onScriptError,"error"),{node:t,id:t&&t.getAttribute("data-requiremodule")}}function j(){var e;for(E();u.length;){if(null===(e=u.shift())[0])return C(makeError("mismatch","Mismatched anonymous define() module: "+e[e.length-1]));S(e)}r.defQueueMap={}}return i={require:function(e){return e.require?e.require:e.require=r.makeRequire(e.map)},exports:function(e){if(e.usingExports=!0,e.map.isDefine)return e.exports?d[e.map.id]=e.exports:e.exports=d[e.map.id]={}},module:function(e){return e.module?e.module:e.module={id:e.map.id,uri:e.map.url,config:function(){return getOwn(a.config,e.map.id)||{}},exports:e.exports||(e.exports={})}}},(n=function(e){this.events=getOwn(c,e.id)||{},this.map=e,this.shim=getOwn(a.shim,e.id),this.depExports=[],this.depMaps=[],this.depMatched=[],this.pluginMaps={},this.depCount=0}).prototype={init:function(e,t,n,r){r=r||{},this.inited||(this.factory=t,n?this.on("error",n):this.events.error&&(n=bind(this,function(e){this.emit("error",e)})),this.depMaps=e&&e.slice(0),this.errback=n,this.inited=!0,this.ignore=r.ignore,r.enabled||this.enabled?this.enable():this.check())},defineDep:function(e,t){this.depMatched[e]||(this.depMatched[e]=!0,this.depCount-=1,this.depExports[e]=t)},fetch:function(){if(!this.fetched){this.fetched=!0,r.startTime=(new Date).getTime();var e=this.map;if(!this.shim)return e.prefix?this.callPlugin():this.load();r.makeRequire(this.map,{enableBuildCallback:!0})(this.shim.deps||[],bind(this,function(){return e.prefix?this.callPlugin():this.load()}))}},load:function(){var e=this.map.url;p[e]||(p[e]=!0,r.load(this.map.id,e))},check:function(){if(this.enabled&&!this.enabling){var e,t,n=this.map.id,i=this.depExports,o=this.exports,a=this.factory;if(this.inited){if(this.error)this.emit("error",this.error);else if(!this.defining){if(this.defining=!0,this.depCount<1&&!this.defined){if(isFunction(a)){if(this.events.error&&this.map.isDefine||req.onError!==defaultOnError)try{o=r.execCb(n,a,i,o)}catch(t){e=t}else o=r.execCb(n,a,i,o);if(this.map.isDefine&&void 0===o&&((t=this.module)?o=t.exports:this.usingExports&&(o=this.exports)),e)return e.requireMap=this.map,e.requireModules=this.map.isDefine?[this.map.id]:null,e.requireType=this.map.isDefine?"define":"require",C(this.error=e)}else o=a;if(this.exports=o,this.map.isDefine&&!this.ignore&&(d[n]=o,req.onResourceLoad)){var s=[];each(this.depMaps,function(e){s.push(e.normalizedMap||e)}),req.onResourceLoad(r,this.map,s)}$(n),this.defined=!0}this.defining=!1,this.defined&&!this.defineEmitted&&(this.defineEmitted=!0,this.emit("defined",this.exports),this.defineEmitComplete=!0)}}else hasProp(r.defQueueMap,n)||this.fetch()}},callPlugin:function(){var e=this.map,t=e.id,n=w(e.prefix);this.depMaps.push(n),k(n,"defined",bind(this,function(n){var i,o,l,c=getOwn(f,this.map.id),u=this.map.name,d=this.map.parentMap?this.map.parentMap.name:null,p=r.makeRequire(e.parentMap,{enableBuildCallback:!0});return this.map.unnormalized?(n.normalize&&(u=n.normalize(u,function(e){return g(e,d,!0)})||""),k(o=w(e.prefix+"!"+u,this.map.parentMap,!0),"defined",bind(this,function(e){this.map.normalizedMap=o,this.init([],function(){return e},null,{enabled:!0,ignore:!0})})),void((l=getOwn(s,o.id))&&(this.depMaps.push(o),this.events.error&&l.on("error",bind(this,function(e){this.emit("error",e)})),l.enable()))):c?(this.map.url=r.nameToUrl(c),void this.load()):((i=bind(this,function(e){this.init([],function(){return e},null,{enabled:!0})})).error=bind(this,function(e){this.inited=!0,this.error=e,e.requireModules=[t],eachProp(s,function(e){0===e.map.id.indexOf(t+"_unnormalized")&&$(e.map.id)}),C(e)}),i.fromText=bind(this,function(n,o){var s=e.name,l=w(s),c=useInteractive;o&&(n=o),c&&(useInteractive=!1),x(l),hasProp(a.config,t)&&(a.config[s]=a.config[t]);try{req.exec(n)}catch(e){return C(makeError("fromtexteval","fromText eval for "+t+" failed: "+e,e,[t]))}c&&(useInteractive=!0),this.depMaps.push(l),r.completeLoad(s),p([s],i)}),void n.load(e.name,p,i,a))})),r.enable(n,this),this.pluginMaps[n.id]=n},enable:function(){l[this.map.id]=this,this.enabled=!0,this.enabling=!0,each(this.depMaps,bind(this,function(e,t){var n,o,a;if("string"==typeof e){if(e=w(e,this.map.isDefine?this.map:this.map.parentMap,!1,!this.skipMap),this.depMaps[t]=e,a=getOwn(i,e.id))return void(this.depExports[t]=a(this));this.depCount+=1,k(e,"defined",bind(this,function(e){this.undefed||(this.defineDep(t,e),this.check())})),this.errback?k(e,"error",bind(this,this.errback)):this.events.error&&k(e,"error",bind(this,function(e){this.emit("error",e)}))}n=e.id,o=s[n],hasProp(i,n)||!o||o.enabled||r.enable(e,this)})),eachProp(this.pluginMaps,bind(this,function(e){var t=getOwn(s,e.id);t&&!t.enabled&&r.enable(e,this)})),this.enabling=!1,this.check()},on:function(e,t){var n=this.events[e];n||(n=this.events[e]=[]),n.push(t)},emit:function(e,t){each(this.events[e],function(e){e(t)}),"error"===e&&delete this.events[e]}},(r={config:a,contextName:e,registry:s,defined:d,urlFetched:p,defQueue:u,defQueueMap:{},Module:n,makeModuleMap:w,nextTick:req.nextTick,onError:C,configure:function(e){if(e.baseUrl&&"/"!==e.baseUrl.charAt(e.baseUrl.length-1)&&(e.baseUrl+="/"),"string"==typeof e.urlArgs){var t=e.urlArgs;e.urlArgs=function(e,n){return(-1===n.indexOf("?")?"?":"&")+t}}var n=a.shim,i={paths:!0,bundles:!0,config:!0,map:!0};eachProp(e,function(e,t){i[t]?(a[t]||(a[t]={}),mixin(a[t],e,!0,!0)):a[t]=e}),e.bundles&&eachProp(e.bundles,function(e,t){each(e,function(e){e!==t&&(f[e]=t)})}),e.shim&&(eachProp(e.shim,function(e,t){isArray(e)&&(e={deps:e}),!e.exports&&!e.init||e.exportsFn||(e.exportsFn=r.makeShimExports(e)),n[t]=e}),a.shim=n),e.packages&&each(e.packages,function(e){var t;t=(e="string"==typeof e?{name:e}:e).name,e.location&&(a.paths[t]=e.location),a.pkgs[t]=e.name+"/"+(e.main||"main").replace(currDirRegExp,"").replace(jsSuffixRegExp,"")}),eachProp(s,function(e,t){e.inited||e.map.unnormalized||(e.map=w(t,null,!0))}),(e.deps||e.callback)&&r.require(e.deps||[],e.callback)},makeShimExports:function(e){return function(){var t;return e.init&&(t=e.init.apply(global,arguments)),t||e.exports&&getGlobal(e.exports)}},makeRequire:function(t,n){function o(a,l,c){var u,p;return n.enableBuildCallback&&l&&isFunction(l)&&(l.__requireJsBuild=!0),"string"==typeof a?isFunction(l)?C(makeError("requireargs","Invalid require call"),c):t&&hasProp(i,a)?i[a](s[t.id]):req.get?req.get(r,a,t,o):(u=w(a,t,!1,!0).id,hasProp(d,u)?d[u]:C(makeError("notloaded",'Module name "'+u+'" has not been loaded yet for context: '+e+(t?"":". Use require([])")))):(j(),r.nextTick(function(){j(),(p=x(w(null,t))).skipMap=n.skipMap,p.init(a,l,c,{enabled:!0}),T()}),o)}return n=n||{},mixin(o,{isBrowser:isBrowser,toUrl:function(e){var n,i=e.lastIndexOf("."),o=e.split("/")[0];return-1!==i&&(!("."===o||".."===o)||i>1)&&(n=e.substring(i,e.length),e=e.substring(0,i)),r.nameToUrl(g(e,t&&t.id,!0),n,!0)},defined:function(e){return hasProp(d,w(e,t,!1,!0).id)},specified:function(e){return e=w(e,t,!1,!0).id,hasProp(d,e)||hasProp(s,e)}}),t||(o.undef=function(e){E();var n=w(e,t,!0),i=getOwn(s,e);i.undefed=!0,b(e),delete d[e],delete p[n.url],delete c[e],eachReverse(u,function(t,n){t[0]===e&&u.splice(n,1)}),delete r.defQueueMap[e],i&&(i.events.defined&&(c[e]=i.events),$(e))}),o},enable:function(e){getOwn(s,e.id)&&x(e).enable()},completeLoad:function(e){var t,n,i,o=getOwn(a.shim,e)||{},l=o.exports;for(E();u.length;){if(null===(n=u.shift())[0]){if(n[0]=e,t)break;t=!0}else n[0]===e&&(t=!0);S(n)}if(r.defQueueMap={},i=getOwn(s,e),!t&&!hasProp(d,e)&&i&&!i.inited){if(!(!a.enforceDefine||l&&getGlobal(l)))return y(e)?void 0:C(makeError("nodefine","No define call for "+e,null,[e]));S([e,o.deps||[],o.exportsFn])}T()},nameToUrl:function(e,t,n){var i,o,s,l,c,u,d=getOwn(a.pkgs,e);if(d&&(e=d),u=getOwn(f,e))return r.nameToUrl(u,t,n);if(req.jsExtRegExp.test(e))l=e+(t||"");else{for(i=a.paths,s=(o=e.split("/")).length;s>0;s-=1)if(c=getOwn(i,o.slice(0,s).join("/"))){isArray(c)&&(c=c[0]),o.splice(0,s,c);break}l=o.join("/"),l=("/"===(l+=t||(/^data\:|^blob\:|\?/.test(l)||n?"":".js")).charAt(0)||l.match(/^[\w\+\.\-]+:/)?"":a.baseUrl)+l}return a.urlArgs&&!/^blob\:/.test(l)?l+a.urlArgs(e,l):l},load:function(e,t){req.load(r,e,t)},execCb:function(e,t,n,r){return t.apply(r,n)},onScriptLoad:function(e){if("load"===e.type||readyRegExp.test((e.currentTarget||e.srcElement).readyState)){interactiveScript=null;var t=L(e);r.completeLoad(t.id)}},onScriptError:function(e){var t=L(e);if(!y(t.id)){var n=[];return eachProp(s,function(e,r){0!==r.indexOf("_@r")&&each(e.depMaps,function(e){if(e.id===t.id)return n.push(r),!0})}),C(makeError("scripterror",'Script error for "'+t.id+(n.length?'", needed by: '+n.join(", "):'"'),e,[t.id]))}}}).require=r.makeRequire(),r}function getInteractiveScript(){return interactiveScript&&"interactive"===interactiveScript.readyState?interactiveScript:(eachReverse(scripts(),function(e){if("interactive"===e.readyState)return interactiveScript=e}),interactiveScript)}}(this,"undefined"==typeof setTimeout?void 0:setTimeout),define("deps/require",function(){});var hyperHTML=function(e){var t=document.defaultView,n=1,r=/^area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|source|track|wbr$/i,i="ownerSVGElement",o="http://www.w3.org/2000/svg",a="connected",s="dis"+a,l=/^style|textarea$/i,c="_hyper: "+(Math.random()*new Date|0)+";",u="\x3c!--"+c+"--\x3e",d=t.Event;try{new d("Event")}catch(e){d=function(e){var t=document.createEvent("Event");return t.initEvent(e,!1,!1),t}}var p,f=t.Map||function(){var e=[],t=[];return{get:function(n){return t[e.indexOf(n)]},set:function(n,r){t[e.push(n)-1]=r}}},h=0,m=t.WeakMap||function(){var e=c+h++;return{get:function(t){return t[e]},set:function(t,n){Object.defineProperty(t,e,{configurable:!0,value:n})}}},g=t.WeakSet||function(){var e=new m;return{add:function(t){e.set(t,!0)},has:function(t){return!0===e.get(t)}}},b=Array.isArray||(p={}.toString,function(e){return"[object Array]"===p.call(e)}),y=c.trim||function(){return this.replace(/^\s+|\s+$/g,"")};function v(){return this}var w=function(e,t){var n="_"+e+"$";return{get:function(){return this[n]||(this[e]=t.call(this,e))},set:function(e){Object.defineProperty(this,n,{configurable:!0,value:e})}}},x={},k=[],C=x.hasOwnProperty,E=0,$=function(e,t){e in x||(E=k.push(e)),x[e]=t},T=function(e,t){for(var n=0;n<E;n++){var r=k[n];if(C.call(e,r))return x[r](e[r],t)}},S=function(e,t){return A(e).createElement(t)},A=function(e){return e.ownerDocument||e},L=function(e){return A(e).createDocumentFragment()},j=function(e,t){return A(e).createTextNode(t)},D=" \\f\\n\\r\\t",_="[^ "+D+"\\/>\"'=]+",N="[ "+D+"]+"+_,R="<([A-Za-z]+[A-Za-z0-9:_-]*)((?:",P="(?:=(?:'[^']*?'|\"[^\"]*?\"|<[^>]*?>|"+_+"))?)",M=new RegExp(R+N+P+"+)([ "+D+"]*/?>)","g"),O=new RegExp(R+N+P+"*)([ "+D+"]*/>)","g"),I=L(document),q="append"in I,U="content"in S(document,"template");I.appendChild(j(I,"g")),I.appendChild(j(I,""));var W=1===I.cloneNode(!0).childNodes.length,H="importNode"in document,B=q?function(e,t){e.append.apply(e,t)}:function(e,t){for(var n=t.length,r=0;r<n;r++)e.appendChild(t[r])},F=new RegExp("("+N+"=)(['\"]?)"+u+"\\2","gi"),z=function(e,t,n,r){return"<"+t+n.replace(F,G)+r},G=function(e,t,n){return t+(n||'"')+c+(n||'"')},V=function(e,t){return(i in e?ee:K)(e,t.replace(M,z))},X=W?function(e){for(var t=e.cloneNode(),n=e.childNodes||[],r=n.length,i=0;i<r;i++)t.appendChild(X(n[i]));return t}:function(e){return e.cloneNode(!0)},Z=H?function(e,t){return e.importNode(t,!0)}:function(e,t){return X(t)},Y=[].slice,Q=function(e){return J(e)},J=function(e){if(e.propertyIsEnumerable("raw")||/Firefox\/(\d+)/.test((t.navigator||{}).userAgent)&&parseFloat(RegExp.$1)<55){var n={};J=function(e){var t="_"+e.join(c);return n[t]||(n[t]=e)}}else J=function(e){return e};return J(e)},K=U?function(e,t){var n=S(e,"template");return n.innerHTML=t,n.content}:function(e,t){var n=S(e,"template"),r=L(e);if(/^[^\S]*?<(col(?:group)?|t(?:head|body|foot|r|d|h))/i.test(t)){var i=RegExp.$1;n.innerHTML="<table>"+t+"</table>",B(r,Y.call(n.querySelectorAll(i)))}else n.innerHTML=t,B(r,Y.call(n.childNodes));return r},ee=U?function(e,t){var n=L(e),r=A(e).createElementNS(o,"svg");return r.innerHTML=t,B(n,Y.call(r.childNodes)),n}:function(e,t){var n=L(e),r=S(e,"div");return r.innerHTML='<svg xmlns="'+o+'">'+t+"</svg>",B(n,Y.call(r.firstChild.childNodes)),n};function te(e){this.childNodes=e,this.length=e.length,this.first=e[0],this.last=e[this.length-1]}te.prototype.insert=function(){var e=L(this.first);return B(e,this.childNodes),e},te.prototype.remove=function(){var e=this.first,t=this.last;if(2===this.length)t.parentNode.removeChild(t);else{var n=A(e).createRange();n.setStartBefore(this.childNodes[1]),n.setEndAfter(t),n.deleteContents()}return e};var ne=function(e,t,n){e.unshift(e.indexOf.call(t.childNodes,n))},re=function(e,t,r){return{type:e,name:r,node:t,path:function(e){var t=[],r=void 0;switch(e.nodeType){case n:case 11:r=e;break;case 8:r=e.parentNode,ne(t,r,e);break;default:r=e.ownerElement}for(e=r;r=r.parentNode;e=r)ne(t,r,e);return t}(t)}},ie=function(e,t){for(var n=t.length,r=0;r<n;r++)e=e.childNodes[t[r]];return e},oe=/acit|ex(?:s|g|n|p|$)|rph|ows|mnc|ntw|ine[ch]|zoo|^ord/i,ae=function(e,t){var n=void 0,r=void 0;return function(i){switch(typeof i){case"object":if(i){if("object"===n){if(!t&&r!==i)for(var o in r)o in i||(e[o]="")}else t?e.value="":e.cssText="";var a=t?{}:e;for(var s in i){var l=i[s];a[s]="number"!=typeof l||oe.test(s)?l:l+"px"}n="object",t?e.value=ce(r=a):r=i;break}default:r!=i&&(n="string",r=i,t?e.value=i||"":e.cssText=i||"")}}},se=/([^A-Z])([A-Z]+)/g,le=function(e,t,n){return t+"-"+n.toLowerCase()},ce=function(e){var t=[];for(var n in e)t.push(n.replace(se,le),":",e[n],";");return t.join("")},ue=function(e){return e},de=function(e,t,n){var r=e.ownerDocument.createRange();r.setStartBefore(t),r.setEndAfter(n),r.deleteContents()},pe=function(e,t,n,r,i){for(var o=r||ue,a=null==i?null:o(i,0),s=0,l=0,c=t.length-1,u=t[0],d=t[c],p=n.length-1,f=n[0],h=n[p];s<=c&&l<=p;)if(null==u)u=t[++s];else if(null==d)d=t[--c];else if(null==f)f=n[++l];else if(null==h)h=n[--p];else if(u==f)u=t[++s],f=n[++l];else if(d==h)d=t[--c],h=n[--p];else if(u==h)e.insertBefore(o(u,1),o(d,-0).nextSibling),u=t[++s],h=n[--p];else if(d==f)e.insertBefore(o(d,1),o(u,0)),d=t[--c],f=n[++l];else{var m=t.indexOf(f);if(m<0)e.insertBefore(o(f,1),o(u,0)),f=n[++l];else{for(var g=m,b=l;g<=c&&b<=p&&t[g]===n[b];)g++,b++;if(1<g-m)--m===s?e.removeChild(o(u,-1)):de(e,o(u,-1),o(t[m],-1)),s=g,l=b,u=t[g],f=n[b];else{var y=t[m];t[m]=null,e.insertBefore(o(y,1),o(u,0)),f=n[++l]}}}if(s<=c||l<=p)if(s>c){var v=n[p+1],w=null==v?a:o(v,0);if(l===p)e.insertBefore(o(n[l],1),w);else{for(var x=e.ownerDocument.createDocumentFragment();l<=p;)x.appendChild(o(n[l++],1));e.insertBefore(x,w)}}else null==t[s]&&s++,s===c?e.removeChild(o(t[s],-1)):de(e,o(t[s],-1),o(t[c],-1));return n},fe=new g;function he(){}he.prototype=Object.create(null);var me=function(e){return{html:e}},ge=function e(t,n){return"ELEMENT_NODE"in t?t:t.constructor===te?1/n<0?n?t.remove():t.last:n?t.insert():t.first:e(t.render(),n)},be=function(e,t,n){for(var r=new he,i=e.attributes,o=Y.call(i),a=[],s=o.length,l=0;l<s;l++){var u=o[l];if(u.value===c){var d=u.name;if(!(d in r)){var p=n.shift().replace(/^(?:|[\S\s]*?\s)(\S+?)=['"]?$/,"$1");r[d]=i[p]||i[p.toLowerCase()],t.push(re("attr",r[d],p))}a.push(u)}}for(var f=a.length,h=0;h<f;h++){var m=a[h];/^id$/i.test(m.name)?e.removeAttribute(m.name):e.removeAttributeNode(a[h])}var g=e.nodeName;if(/^script$/i.test(g)){for(var b=document.createElement(g),y=0;y<i.length;y++)b.setAttributeNode(i[y].cloneNode(!0));b.textContent=e.textContent,e.parentNode.replaceChild(b,e)}},ye=function(e,t){t(e.placeholder),"text"in e?Promise.resolve(e.text).then(String).then(t):"any"in e?Promise.resolve(e.any).then(t):"html"in e?Promise.resolve(e.html).then(me).then(t):Promise.resolve(T(e,t)).then(t)},ve=function(e){return null!=e&&"then"in e},we=function(e,t){var n=!1,r=void 0;return function i(o){switch(typeof o){case"string":case"number":case"boolean":n?r!==o&&(r=o,t[0].textContent=o):(n=!0,r=o,t=pe(e.parentNode,t,[j(e,o)],ge,e));break;case"object":case"undefined":if(null==o){n=!1,t=pe(e.parentNode,t,[],ge,e);break}default:if(n=!1,r=o,b(o))if(0===o.length)t.length&&(t=pe(e.parentNode,t,[],ge,e));else switch(typeof o[0]){case"string":case"number":case"boolean":i({html:o});break;case"object":if(b(o[0])&&(o=o.concat.apply([],o)),ve(o[0])){Promise.all(o).then(i);break}default:t=pe(e.parentNode,t,o,ge,e)}else a=o,"ELEMENT_NODE"in a||a instanceof te||a instanceof v?t=pe(e.parentNode,t,11===o.nodeType?Y.call(o.childNodes):[o],ge,e):ve(o)?o.then(i):"placeholder"in o?ye(o,i):"text"in o?i(String(o.text)):"any"in o?i(o.any):"html"in o?t=pe(e.parentNode,t,Y.call(V(e,[].concat(o.html).join("")).childNodes),ge,e):i("length"in o?Y.call(o):T(o,i))}var a}},xe=function(e,t,r){var o=i in e,l=void 0;if("style"===t)return function(e,t,n){if(n){var r=t.cloneNode(!0);return r.value="",e.setAttributeNode(r),ae(r,n)}return ae(e.style,n)}(e,r,o);if(/^on/.test(t)){var c=t.slice(2);return c===a||c===s?(Ee&&(Ee=!1,function(){var e=function(e,r){for(var i=new d(r),o=e.length,a=0;a<o;a++){var s=e[a];s.nodeType===n&&t(s,i)}},t=function e(t,n){fe.has(t)&&t.dispatchEvent(n);for(var r=t.children,i=r.length,o=0;o<i;o++)e(r[o],n)};try{new MutationObserver(function(t){for(var n=t.length,r=0;r<n;r++){var i=t[r];e(i.removedNodes,s),e(i.addedNodes,a)}}).observe(document,{subtree:!0,childList:!0})}catch(t){document.addEventListener("DOMNodeRemoved",function(t){e([t.target],s)},!1),document.addEventListener("DOMNodeInserted",function(t){e([t.target],a)},!1)}}()),fe.add(e)):t.toLowerCase()in e&&(c=c.toLowerCase()),function(t){l!==t&&(l&&e.removeEventListener(c,l,!1),l=t,t&&e.addEventListener(c,t,!1))}}if("data"===t||!o&&t in e)return function(n){l!==n&&(l=n,e[t]!==n&&(e[t]=n,null==n&&e.removeAttribute(t)))};var u=!1,p=r.cloneNode(!0);return function(t){l!==t&&(l=t,p.value!==t&&(null==t?(u&&(u=!1,e.removeAttributeNode(p)),p.value=t):(p.value=t,u||(u=!0,e.setAttributeNode(p)))))}},ke=function(e){var t=void 0;return function n(r){t!==r&&(t=r,"object"==typeof r&&r?ve(r)?r.then(n):"placeholder"in r?ye(r,n):n("text"in r?String(r.text):"any"in r?r.any:"html"in r?[].concat(r.html).join(""):"length"in r?Y.call(r).join(""):T(r,n)):e.textContent=null==r?"":r)}},Ce={create:function(e,t){for(var n=[],r=t.length,i=0;i<r;i++){var o=t[i],a=ie(e,o.path);switch(o.type){case"any":n.push(we(a,[]));break;case"attr":n.push(xe(a,o.name,o.node));break;case"text":n.push(ke(a)),a.textContent=""}}return n},find:function e(t,r,i){for(var o=t.childNodes,a=o.length,s=0;s<a;s++){var d=o[s];switch(d.nodeType){case n:be(d,r,i),e(d,r,i);break;case 8:d.textContent===c&&(i.shift(),r.push(l.test(t.nodeName)?re("text",t):re("any",d)));break;case 3:l.test(t.nodeName)&&y.call(d.textContent)===u&&(i.shift(),r.push(re("text",t)))}}}},Ee=!0;var $e=new m,Te=new f;function Se(e){var t=$e.get(this);return t&&t.template===Q(e)?Ae.apply(t.updates,arguments):function(e){e=Q(e);var t=Te.get(e)||function(e){var t=[],n=e.join(u).replace(Ne,Re),r=V(this,n);Ce.find(r,t,e.slice());var i={fragment:r,paths:t};return Te.set(e,i),i}.call(this,e),n=Z(this.ownerDocument,t.fragment),r=Ce.create(n,t.paths);$e.set(this,{template:e,updates:r}),Ae.apply(r,arguments),this.textContent="",this.appendChild(n)}.apply(this,arguments),this}function Ae(){for(var e=arguments.length,t=1;t<e;t++)this[t-1](arguments[t])}var Le,je,De,_e,Ne=O,Re=function(e,t,n){return r.test(t)?e:"<"+t+n+"></"+t+">"},Pe=new m,Me=function(e){var t=void 0,n=void 0,r=void 0,i=void 0,a=void 0;return function(s){s=Q(s);var l=i!==s;return l&&(i=s,r=L(document),n="svg"===e?document.createElementNS(o,"svg"):r,a=Se.bind(n)),a.apply(null,arguments),l&&("svg"===e&&B(r,Y.call(n.childNodes)),t=Ie(r)),t}},Oe=function(e,t){var n=t.indexOf(":"),r=Pe.get(e),i=t;return-1<n&&(i=t.slice(n+1),t=t.slice(0,n)||"html"),r||Pe.set(e,r={}),r[i]||(r[i]=Me(t))},Ie=function(e){for(var t=e.childNodes,r=t.length,i=[],o=0;o<r;o++){var a=t[o];a.nodeType!==n&&0===y.call(a.textContent).length||i.push(a)}return 1===i.length?i[0]:new te(i)},qe=$;function Ue(e){return arguments.length<2?null==e?Me("html"):"string"==typeof e?Ue.wire(null,e):"raw"in e?Me("html")(e):"nodeType"in e?Ue.bind(e):Oe(e,"html"):("raw"in e?Me("html"):Ue.wire).apply(null,arguments)}return Ue.Component=v,Ue.bind=function(e){return Se.bind(e)},Ue.define=qe,Ue.diff=pe,Ue.hyper=Ue,Ue.wire=function(e,t){return null==e?Me(t||"html"):Oe(e,t||"html")},Le=Me,je=new m,De=Object.create,_e=function(e,t){var n={w:null,p:null};return t.set(e,n),n},Object.defineProperties(v,{for:{configurable:!0,value:function(e,t){return function(e,t,n,r){var i,o,a,s=t.get(e)||_e(e,t);switch(typeof r){case"object":case"function":var l=s.w||(s.w=new m);return l.get(r)||(i=l,o=r,a=new e(n),i.set(o,a),a);default:var c=s.p||(s.p=De(null));return c[r]||(c[r]=new e(n))}}(this,je.get(e)||(n=e,r=new f,je.set(n,r),r),e,null==t?"default":t);var n,r}}}),Object.defineProperties(v.prototype,{handleEvent:{value:function(e){var t=e.currentTarget;this["getAttribute"in t&&t.getAttribute("data-call")||"on"+e.type](e)}},html:w("html",Le),svg:w("svg",Le),state:w("state",function(){return this.defaultState}),defaultState:{get:function(){return{}}},setState:{value:function(e,t){var n=this.state,r="function"==typeof e?e.call(this,n):e;for(var i in r)n[i]=r[i];return!1!==t&&this.render(),this}}}),Ue}(window);define("deps/hyperhtml",function(){});var URLSearchParams=URLSearchParams||function(){function e(e){var n,r,i,o,a,u,d=Object.create(null);if(this[s]=d,e)if("string"==typeof e)for("?"===e.charAt(0)&&(e=e.slice(1)),a=0,u=(o=e.split("&")).length;a<u;a++)-1<(n=(i=o[a]).indexOf("="))?l(d,c(i.slice(0,n)),c(i.slice(n+1))):i.length&&l(d,c(i),"");else if(t(e))for(a=0,u=e.length;a<u;a++)l(d,(i=e[a])[0],i[1]);else for(r in e)l(d,r,e[r])}var t=Array.isArray,n=e.prototype,r=/[!'\(\)~]|%20|%00/g,i=/\+/g,o={"!":"%21","'":"%27","(":"%28",")":"%29","~":"%7E","%20":"+","%00":"\0"},a=function(e){return o[e]},s="__URLSearchParams__:"+Math.random();function l(e,n,r){n in e?e[n].push(""+r):e[n]=t(r)?r:[""+r]}function c(e){return decodeURIComponent(e.replace(i," "))}function u(e){return encodeURIComponent(e).replace(r,a)}n.append=function(e,t){l(this[s],e,t)},n.delete=function(e){delete this[s][e]},n.get=function(e){var t=this[s];return e in t?t[e][0]:null},n.getAll=function(e){var t=this[s];return e in t?t[e].slice(0):[]},n.has=function(e){return e in this[s]},n.set=function(e,t){this[s][e]=[""+t]},n.forEach=function(e,t){var n=this[s];Object.getOwnPropertyNames(n).forEach(function(r){n[r].forEach(function(n){e.call(t,n,r,this)},this)},this)},n.toJSON=function(){return{}},n.toString=function(){var e,t,n,r,i=this[s],o=[];for(t in i)for(n=u(t),e=0,r=i[t];e<r.length;e++)o.push(n+"="+u(r[e]));return o.join("&")};var d=Object.defineProperty,p=Object.getOwnPropertyDescriptor,f=function(t){var r=t.append;t.append=n.append,e.call(t,t._usp.search.slice(1)),t.append=r},h=function(e,t){if(!(e instanceof t))throw new TypeError("'searchParams' accessed on an object that does not implement interface "+t.name)},m=function(t){var r,i,o=t.prototype,a=p(o,"searchParams"),s=p(o,"href"),l=p(o,"search");!a&&l&&l.set&&(i=function(e){function t(t,r){n.append.call(this,t,r),t=this.toString(),e.set.call(this._usp,t?"?"+t:"")}function r(t){n.delete.call(this,t),t=this.toString(),e.set.call(this._usp,t?"?"+t:"")}function i(t,r){n.set.call(this,t,r),t=this.toString(),e.set.call(this._usp,t?"?"+t:"")}return function(e,n){return e.append=t,e.delete=r,e.set=i,d(e,"_usp",{configurable:!0,writable:!0,value:n})}}(l),r=function(e,t){return d(e,"_searchParams",{configurable:!0,writable:!0,value:i(t,e)}),t},Object.defineProperties(o,{href:{get:function(){return s.get.call(this)},set:function(e){var t=this._searchParams;s.set.call(this,e),t&&f(t)}},search:{get:function(){return l.get.call(this)},set:function(e){var t=this._searchParams;l.set.call(this,e),t&&f(t)}},searchParams:{get:function(){return h(this,t),this._searchParams||r(this,new e(this.search.slice(1)))},set:function(e){h(this,t),r(this,e)}}}))};return m(HTMLAnchorElement),/^function|object$/.test(typeof URL)&&URL.prototype&&m(URL),e}(),qp,rp;qp=URLSearchParams.prototype,rp=function(){try{return!!Symbol.iterator}catch(e){return!1}}(),"forEach"in qp||(qp.forEach=function(e,t){var n=Object.create(null);this.toString().replace(/=[\s\S]*?(?:&|$)/g,"=").split("=").forEach(function(r){!r.length||r in n||(n[r]=this.getAll(r)).forEach(function(n){e.call(t,n,r,this)},this)},this)}),"keys"in qp||(qp.keys=function(){var e=[];this.forEach(function(t,n){e.push(n)});var t={next:function(){var t=e.shift();return{done:void 0===t,value:t}}};return rp&&(t[Symbol.iterator]=function(){return t}),t}),"values"in qp||(qp.values=function(){var e=[];this.forEach(function(t){e.push(t)});var t={next:function(){var t=e.shift();return{done:void 0===t,value:t}}};return rp&&(t[Symbol.iterator]=function(){return t}),t}),"entries"in qp||(qp.entries=function(){var e=[];this.forEach(function(t,n){e.push([n,t])});var t={next:function(){var t=e.shift();return{done:void 0===t,value:t}}};return rp&&(t[Symbol.iterator]=function(){return t}),t}),!rp||Symbol.iterator in qp||(qp[Symbol.iterator]=qp.entries),"sort"in qp||(qp.sort=function(){for(var e,t,n,r=this.entries(),i=r.next(),o=i.done,a=[],s=Object.create(null);!o;)t=(n=i.value)[0],a.push(t),t in s||(s[t]=[]),s[t].push(n[1]),o=(i=r.next()).done;for(a.sort(),e=0;e<a.length;e++)this.delete(a[e]);for(e=0;e<a.length;e++)t=a[e],this.append(t,s[t].shift())}),define("deps/url-search-params",function(){}),define("deps/domReady",[],function(){var e,t,n,r="undefined"!=typeof window&&window.document,i=!r,o=r?document:null,a=[];function s(){var e=a;i&&e.length&&(a=[],function(e){var t;for(t=0;t<e.length;t+=1)e[t](o)}(e))}function l(){i||(i=!0,n&&clearInterval(n),s())}if(r){if(document.addEventListener)document.addEventListener("DOMContentLoaded",l,!1),window.addEventListener("load",l,!1);else if(window.attachEvent){window.attachEvent("onload",l),t=document.createElement("div");try{e=null===window.frameElement}catch(e){}t.doScroll&&e&&window.external&&(n=setInterval(function(){try{t.doScroll(),l()}catch(e){}},30))}"complete"===document.readyState&&l()}function c(e){return i?e(o):a.push(e),c}return c.version="2.0.1",c.load=function(e,t,n,r){r.isBuild?n(null):c(n)},c}),define("core/pubsubhub",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.pub=function(e,...n){if(!t.has(e))return;if(Array.from(t.get(e)).forEach(e=>e.apply(void 0,n)),window.parent===window.self)return;var r=n.map(e=>String(JSON.stringify(e.stack||e)));window.parent.postMessage({topic:e,args:r},window.parent.location.origin)},e.sub=n,e.unsub=r;e.name="core/pubsubhub";const t=new Map;function n(e,i,o={once:!1}){return o.once?n(e,function t(...n){r({topic:e,cb:t}),i(...n)}):(t.has(e)?t.get(e).add(i):t.set(e,new Set([i])),{topic:e,cb:i})}function r({topic:e,cb:n}){const r=t.get(e);return r&&r.has(n)?r.delete(n):(console.warn("Already unsubscribed:",e,n),!1)}n("error",e=>{console.error(e,e.stack)}),n("warn",e=>{console.warn(e)})}),function(e){var t={newline:/^\n+/,code:/^( {4}[^\n]+\n*)+/,fences:h,hr:/^ {0,3}((?:- *){3,}|(?:_ *){3,}|(?:\* *){3,})(?:\n+|$)/,heading:/^ *(#{1,6}) *([^\n]+?) *(?:#+ *)?(?:\n+|$)/,nptable:h,blockquote:/^( {0,3}> ?(paragraph|[^\n]*)(?:\n|$))+/,list:/^( *)(bull) [\s\S]+?(?:hr|def|\n{2,}(?! )(?!\1bull )\n*|\s*$)/,html:"^ {0,3}(?:<(script|pre|style)[\\s>][\\s\\S]*?(?:</\\1>[^\\n]*\\n+|$)|comment[^\\n]*(\\n+|$)|<\\?[\\s\\S]*?\\?>\\n*|<![A-Z][\\s\\S]*?>\\n*|<!\\[CDATA\\[[\\s\\S]*?\\]\\]>\\n*|</?(tag)(?: +|\\n|/?>)[\\s\\S]*?(?:\\n{2,}|$)|<(?!script|pre|style)([a-z][\\w-]*)(?:attribute)*? */?>(?=\\h*\\n)[\\s\\S]*?(?:\\n{2,}|$)|</(?!script|pre|style)[a-z][\\w-]*\\s*>(?=\\h*\\n)[\\s\\S]*?(?:\\n{2,}|$))",def:/^ {0,3}\[(label)\]: *\n? *<?([^\s>]+)>?(?:(?: +\n? *| *\n *)(title))? *(?:\n+|$)/,table:h,lheading:/^([^\n]+)\n *(=|-){2,} *(?:\n+|$)/,paragraph:/^([^\n]+(?:\n(?!hr|heading|lheading| {0,3}>|<\/?(?:tag)(?: +|\n|\/?>)|<(?:script|pre|style|!--))[^\n]+)*)/,text:/^[^\n]+/};function n(e){this.tokens=[],this.tokens.links={},this.options=e||b.defaults,this.rules=t.normal,this.options.pedantic?this.rules=t.pedantic:this.options.gfm&&(this.options.tables?this.rules=t.tables:this.rules=t.gfm)}t._label=/(?!\s*\])(?:\\[\[\]]|[^\[\]])+/,t._title=/(?:"(?:\\"?|[^"\\])*"|'[^'\n]*(?:\n[^'\n]+)*\n?'|\([^()]*\))/,t.def=u(t.def).replace("label",t._label).replace("title",t._title).getRegex(),t.bullet=/(?:[*+-]|\d+\.)/,t.item=/^( *)(bull) [^\n]*(?:\n(?!\1bull )[^\n]*)*/,t.item=u(t.item,"gm").replace(/bull/g,t.bullet).getRegex(),t.list=u(t.list).replace(/bull/g,t.bullet).replace("hr","\\n+(?=\\1?(?:(?:- *){3,}|(?:_ *){3,}|(?:\\* *){3,})(?:\\n+|$))").replace("def","\\n+(?="+t.def.source+")").getRegex(),t._tag="address|article|aside|base|basefont|blockquote|body|caption|center|col|colgroup|dd|details|dialog|dir|div|dl|dt|fieldset|figcaption|figure|footer|form|frame|frameset|h[1-6]|head|header|hr|html|iframe|legend|li|link|main|menu|menuitem|meta|nav|noframes|ol|optgroup|option|p|param|section|source|summary|table|tbody|td|tfoot|th|thead|title|tr|track|ul",t._comment=/<!--(?!-?>)[\s\S]*?-->/,t.html=u(t.html,"i").replace("comment",t._comment).replace("tag",t._tag).replace("attribute",/ +[a-zA-Z:_][\w.:-]*(?: *= *"[^"\n]*"| *= *'[^'\n]*'| *= *[^\s"'=<>`]+)?/).getRegex(),t.paragraph=u(t.paragraph).replace("hr",t.hr).replace("heading",t.heading).replace("lheading",t.lheading).replace("tag",t._tag).getRegex(),t.blockquote=u(t.blockquote).replace("paragraph",t.paragraph).getRegex(),t.normal=m({},t),t.gfm=m({},t.normal,{fences:/^ *(`{3,}|~{3,})[ \.]*(\S+)? *\n([\s\S]*?)\n? *\1 *(?:\n+|$)/,paragraph:/^/,heading:/^ *(#{1,6}) +([^\n]+?) *#* *(?:\n+|$)/}),t.gfm.paragraph=u(t.paragraph).replace("(?!","(?!"+t.gfm.fences.source.replace("\\1","\\2")+"|"+t.list.source.replace("\\1","\\3")+"|").getRegex(),t.tables=m({},t.gfm,{nptable:/^ *([^|\n ].*\|.*)\n *([-:]+ *\|[-| :]*)(?:\n((?:.*[^>\n ].*(?:\n|$))*)\n*|$)/,table:/^ *\|(.+)\n *\|?( *[-:]+[-| :]*)(?:\n((?: *[^>\n ].*(?:\n|$))*)\n*|$)/}),t.pedantic=m({},t.normal,{html:u("^ *(?:comment *(?:\\n|\\s*$)|<(tag)[\\s\\S]+?</\\1> *(?:\\n{2,}|\\s*$)|<tag(?:\"[^\"]*\"|'[^']*'|\\s[^'\"/>\\s]*)*?/?> *(?:\\n{2,}|\\s*$))").replace("comment",t._comment).replace(/tag/g,"(?!(?:a|em|strong|small|s|cite|q|dfn|abbr|data|time|code|var|samp|kbd|sub|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo|span|br|wbr|ins|del|img)\\b)\\w+(?!:|[^\\w\\s@]*@)\\b").getRegex(),def:/^ *\[([^\]]+)\]: *<?([^\s>]+)>?(?: +(["(][^\n]+[")]))? *(?:\n+|$)/}),n.rules=t,n.lex=function(e,t){return new n(t).lex(e)},n.prototype.lex=function(e){return e=e.replace(/\r\n|\r/g,"\n").replace(/\t/g," ").replace(/\u00a0/g," ").replace(/\u2424/g,"\n"),this.token(e,!0)},n.prototype.token=function(e,n){var r,i,o,a,s,l,c,u,d,p,f,h,m;for(e=e.replace(/^ +$/gm,"");e;)if((o=this.rules.newline.exec(e))&&(e=e.substring(o[0].length),o[0].length>1&&this.tokens.push({type:"space"})),o=this.rules.code.exec(e))e=e.substring(o[0].length),o=o[0].replace(/^ {4}/gm,""),this.tokens.push({type:"code",text:this.options.pedantic?o:o.replace(/\n+$/,"")});else if(o=this.rules.fences.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"code",lang:o[2],text:o[3]||""});else if(o=this.rules.heading.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"heading",depth:o[1].length,text:o[2]});else if(n&&(o=this.rules.nptable.exec(e))&&(l={type:"table",header:g(o[1].replace(/^ *| *\| *$/g,"")),align:o[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:o[3]?o[3].replace(/\n$/,"").split("\n"):[]}).header.length===l.align.length){for(e=e.substring(o[0].length),u=0;u<l.align.length;u++)/^ *-+: *$/.test(l.align[u])?l.align[u]="right":/^ *:-+: *$/.test(l.align[u])?l.align[u]="center":/^ *:-+ *$/.test(l.align[u])?l.align[u]="left":l.align[u]=null;for(u=0;u<l.cells.length;u++)l.cells[u]=g(l.cells[u],l.header.length);this.tokens.push(l)}else if(o=this.rules.hr.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"hr"});else if(o=this.rules.blockquote.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"blockquote_start"}),o=o[0].replace(/^ *> ?/gm,""),this.token(o,n),this.tokens.push({type:"blockquote_end"});else if(o=this.rules.list.exec(e)){for(e=e.substring(o[0].length),f=(a=o[2]).length>1,this.tokens.push({type:"list_start",ordered:f,start:f?+a:""}),r=!1,p=(o=o[0].match(this.rules.item)).length,u=0;u<p;u++)c=(l=o[u]).length,~(l=l.replace(/^ *([*+-]|\d+\.) +/,"")).indexOf("\n ")&&(c-=l.length,l=this.options.pedantic?l.replace(/^ {1,4}/gm,""):l.replace(new RegExp("^ {1,"+c+"}","gm"),"")),this.options.smartLists&&u!==p-1&&(a===(s=t.bullet.exec(o[u+1])[0])||a.length>1&&s.length>1||(e=o.slice(u+1).join("\n")+e,u=p-1)),i=r||/\n\n(?!\s*$)/.test(l),u!==p-1&&(r="\n"===l.charAt(l.length-1),i||(i=r)),m=void 0,(h=/^\[[ xX]\] /.test(l))&&(m=" "!==l[1],l=l.replace(/^\[[ xX]\] +/,"")),this.tokens.push({type:i?"loose_item_start":"list_item_start",task:h,checked:m}),this.token(l,!1),this.tokens.push({type:"list_item_end"});this.tokens.push({type:"list_end"})}else if(o=this.rules.html.exec(e))e=e.substring(o[0].length),this.tokens.push({type:this.options.sanitize?"paragraph":"html",pre:!this.options.sanitizer&&("pre"===o[1]||"script"===o[1]||"style"===o[1]),text:o[0]});else if(n&&(o=this.rules.def.exec(e)))e=e.substring(o[0].length),o[3]&&(o[3]=o[3].substring(1,o[3].length-1)),d=o[1].toLowerCase().replace(/\s+/g," "),this.tokens.links[d]||(this.tokens.links[d]={href:o[2],title:o[3]});else if(n&&(o=this.rules.table.exec(e))&&(l={type:"table",header:g(o[1].replace(/^ *| *\| *$/g,"")),align:o[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:o[3]?o[3].replace(/(?: *\| *)?\n$/,"").split("\n"):[]}).header.length===l.align.length){for(e=e.substring(o[0].length),u=0;u<l.align.length;u++)/^ *-+: *$/.test(l.align[u])?l.align[u]="right":/^ *:-+: *$/.test(l.align[u])?l.align[u]="center":/^ *:-+ *$/.test(l.align[u])?l.align[u]="left":l.align[u]=null;for(u=0;u<l.cells.length;u++)l.cells[u]=g(l.cells[u].replace(/^ *\| *| *\| *$/g,""),l.header.length);this.tokens.push(l)}else if(o=this.rules.lheading.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"heading",depth:"="===o[2]?1:2,text:o[1]});else if(n&&(o=this.rules.paragraph.exec(e)))e=e.substring(o[0].length),this.tokens.push({type:"paragraph",text:"\n"===o[1].charAt(o[1].length-1)?o[1].slice(0,-1):o[1]});else if(o=this.rules.text.exec(e))e=e.substring(o[0].length),this.tokens.push({type:"text",text:o[0]});else if(e)throw new Error("Infinite loop on byte: "+e.charCodeAt(0));return this.tokens};var r={escape:/^\\([!"#$%&'()*+,\-./:;<=>?@\[\]\\^_`{|}~])/,autolink:/^<(scheme:[^\s\x00-\x1f<>]*|email)>/,url:h,tag:"^comment|^</[a-zA-Z][\\w:-]*\\s*>|^<[a-zA-Z][\\w-]*(?:attribute)*?\\s*/?>|^<\\?[\\s\\S]*?\\?>|^<![a-zA-Z]+\\s[\\s\\S]*?>|^<!\\[CDATA\\[[\\s\\S]*?\\]\\]>",link:/^!?\[(label)\]\(href(?:\s+(title))?\s*\)/,reflink:/^!?\[(label)\]\[(?!\s*\])((?:\\[\[\]]?|[^\[\]\\])+)\]/,nolink:/^!?\[(?!\s*\])((?:\[[^\[\]]*\]|\\[\[\]]|[^\[\]])*)\](?:\[\])?/,strong:/^__([^\s][\s\S]*?[^\s])__(?!_)|^\*\*([^\s][\s\S]*?[^\s])\*\*(?!\*)|^__([^\s])__(?!_)|^\*\*([^\s])\*\*(?!\*)/,em:/^_([^\s][\s\S]*?[^\s_])_(?!_)|^_([^\s_][\s\S]*?[^\s])_(?!_)|^\*([^\s][\s\S]*?[^\s*])\*(?!\*)|^\*([^\s*][\s\S]*?[^\s])\*(?!\*)|^_([^\s_])_(?!_)|^\*([^\s*])\*(?!\*)/,code:/^(`+)\s*([\s\S]*?[^`]?)\s*\1(?!`)/,br:/^ {2,}\n(?!\s*$)/,del:h,text:/^[\s\S]+?(?=[\\<!\[`*]|\b_| {2,}\n|$)/};function i(e,t){if(this.options=t||b.defaults,this.links=e,this.rules=r.normal,this.renderer=this.options.renderer||new o,this.renderer.options=this.options,!this.links)throw new Error("Tokens array requires a `links` property.");this.options.pedantic?this.rules=r.pedantic:this.options.gfm&&(this.options.breaks?this.rules=r.breaks:this.rules=r.gfm)}function o(e){this.options=e||b.defaults}function a(){}function s(e){this.tokens=[],this.token=null,this.options=e||b.defaults,this.options.renderer=this.options.renderer||new o,this.renderer=this.options.renderer,this.renderer.options=this.options}function l(e,t){return e.replace(t?/&/g:/&(?!#?\w+;)/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""").replace(/'/g,"'")}function c(e){return e.replace(/&(#(?:\d+)|(?:#x[0-9A-Fa-f]+)|(?:\w+));?/gi,function(e,t){return"colon"===(t=t.toLowerCase())?":":"#"===t.charAt(0)?"x"===t.charAt(1)?String.fromCharCode(parseInt(t.substring(2),16)):String.fromCharCode(+t.substring(1)):""})}function u(e,t){return e=e.source||e,t=t||"",{replace:function(t,n){return n=(n=n.source||n).replace(/(^|[^\[])\^/g,"$1"),e=e.replace(t,n),this},getRegex:function(){return new RegExp(e,t)}}}function d(e,t){return p[" "+e]||(/^[^:]+:\/*[^/]*$/.test(e)?p[" "+e]=e+"/":p[" "+e]=e.replace(/[^/]*$/,"")),e=p[" "+e],"//"===t.slice(0,2)?e.replace(/:[\s\S]*/,":")+t:"/"===t.charAt(0)?e.replace(/(:\/*[^/]*)[\s\S]*/,"$1")+t:e+t}r._escapes=/\\([!"#$%&'()*+,\-./:;<=>?@\[\]\\^_`{|}~])/g,r._scheme=/[a-zA-Z][a-zA-Z0-9+.-]{1,31}/,r._email=/[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+(@)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+(?![-_])/,r.autolink=u(r.autolink).replace("scheme",r._scheme).replace("email",r._email).getRegex(),r._attribute=/\s+[a-zA-Z:_][\w.:-]*(?:\s*=\s*"[^"]*"|\s*=\s*'[^']*'|\s*=\s*[^\s"'=<>`]+)?/,r.tag=u(r.tag).replace("comment",t._comment).replace("attribute",r._attribute).getRegex(),r._label=/(?:\[[^\[\]]*\]|\\[\[\]]?|`[^`]*`|[^\[\]\\])*?/,r._href=/\s*(<(?:\\[<>]?|[^\s<>\\])*>|(?:\\[()]?|\([^\s\x00-\x1f()\\]*\)|[^\s\x00-\x1f()\\])*?)/,r._title=/"(?:\\"?|[^"\\])*"|'(?:\\'?|[^'\\])*'|\((?:\\\)?|[^)\\])*\)/,r.link=u(r.link).replace("label",r._label).replace("href",r._href).replace("title",r._title).getRegex(),r.reflink=u(r.reflink).replace("label",r._label).getRegex(),r.normal=m({},r),r.pedantic=m({},r.normal,{strong:/^__(?=\S)([\s\S]*?\S)__(?!_)|^\*\*(?=\S)([\s\S]*?\S)\*\*(?!\*)/,em:/^_(?=\S)([\s\S]*?\S)_(?!_)|^\*(?=\S)([\s\S]*?\S)\*(?!\*)/,link:u(/^!?\[(label)\]\((.*?)\)/).replace("label",r._label).getRegex(),reflink:u(/^!?\[(label)\]\s*\[([^\]]*)\]/).replace("label",r._label).getRegex()}),r.gfm=m({},r.normal,{escape:u(r.escape).replace("])","~|])").getRegex(),url:u(/^((?:ftp|https?):\/\/|www\.)(?:[a-zA-Z0-9\-]+\.?)+[^\s<]*|^email/).replace("email",r._email).getRegex(),_backpedal:/(?:[^?!.,:;*_~()&]+|\([^)]*\)|&(?![a-zA-Z0-9]+;$)|[?!.,:;*_~)]+(?!$))+/,del:/^~~(?=\S)([\s\S]*?\S)~~/,text:u(r.text).replace("]|","~]|").replace("|","|https?://|ftp://|www\\.|[a-zA-Z0-9.!#$%&'*+/=?^_`{\\|}~-]+@|").getRegex()}),r.breaks=m({},r.gfm,{br:u(r.br).replace("{2,}","*").getRegex(),text:u(r.gfm.text).replace("{2,}","*").getRegex()}),i.rules=r,i.output=function(e,t,n){return new i(t,n).output(e)},i.prototype.output=function(e){for(var t,n,r,o,a,s="";e;)if(a=this.rules.escape.exec(e))e=e.substring(a[0].length),s+=a[1];else if(a=this.rules.autolink.exec(e))e=e.substring(a[0].length),r="@"===a[2]?"mailto:"+(n=l(this.mangle(a[1]))):n=l(a[1]),s+=this.renderer.link(r,null,n);else if(this.inLink||!(a=this.rules.url.exec(e))){if(a=this.rules.tag.exec(e))!this.inLink&&/^<a /i.test(a[0])?this.inLink=!0:this.inLink&&/^<\/a>/i.test(a[0])&&(this.inLink=!1),e=e.substring(a[0].length),s+=this.options.sanitize?this.options.sanitizer?this.options.sanitizer(a[0]):l(a[0]):a[0];else if(a=this.rules.link.exec(e))e=e.substring(a[0].length),this.inLink=!0,r=a[2],this.options.pedantic?(t=/^([^'"]*[^\s])\s+(['"])(.*)\2/.exec(r))?(r=t[1],o=t[3]):o="":o=a[3]?a[3].slice(1,-1):"",r=r.trim().replace(/^<([\s\S]*)>$/,"$1"),s+=this.outputLink(a,{href:i.escapes(r),title:i.escapes(o)}),this.inLink=!1;else if((a=this.rules.reflink.exec(e))||(a=this.rules.nolink.exec(e))){if(e=e.substring(a[0].length),t=(a[2]||a[1]).replace(/\s+/g," "),!(t=this.links[t.toLowerCase()])||!t.href){s+=a[0].charAt(0),e=a[0].substring(1)+e;continue}this.inLink=!0,s+=this.outputLink(a,t),this.inLink=!1}else if(a=this.rules.strong.exec(e))e=e.substring(a[0].length),s+=this.renderer.strong(this.output(a[4]||a[3]||a[2]||a[1]));else if(a=this.rules.em.exec(e))e=e.substring(a[0].length),s+=this.renderer.em(this.output(a[6]||a[5]||a[4]||a[3]||a[2]||a[1]));else if(a=this.rules.code.exec(e))e=e.substring(a[0].length),s+=this.renderer.codespan(l(a[2].trim(),!0));else if(a=this.rules.br.exec(e))e=e.substring(a[0].length),s+=this.renderer.br();else if(a=this.rules.del.exec(e))e=e.substring(a[0].length),s+=this.renderer.del(this.output(a[1]));else if(a=this.rules.text.exec(e))e=e.substring(a[0].length),s+=this.renderer.text(l(this.smartypants(a[0])));else if(e)throw new Error("Infinite loop on byte: "+e.charCodeAt(0))}else a[0]=this.rules._backpedal.exec(a[0])[0],e=e.substring(a[0].length),"@"===a[2]?r="mailto:"+(n=l(a[0])):(n=l(a[0]),r="www."===a[1]?"http://"+n:n),s+=this.renderer.link(r,null,n);return s},i.escapes=function(e){return e?e.replace(i.rules._escapes,"$1"):e},i.prototype.outputLink=function(e,t){var n=t.href,r=t.title?l(t.title):null;return"!"!==e[0].charAt(0)?this.renderer.link(n,r,this.output(e[1])):this.renderer.image(n,r,l(e[1]))},i.prototype.smartypants=function(e){return this.options.smartypants?e.replace(/---/g,"—").replace(/--/g,"–").replace(/(^|[-\u2014/(\[{"\s])'/g,"$1‘").replace(/'/g,"’").replace(/(^|[-\u2014/(\[{\u2018\s])"/g,"$1“").replace(/"/g,"”").replace(/\.{3}/g,"…"):e},i.prototype.mangle=function(e){if(!this.options.mangle)return e;for(var t,n="",r=e.length,i=0;i<r;i++)t=e.charCodeAt(i),Math.random()>.5&&(t="x"+t.toString(16)),n+="&#"+t+";";return n},o.prototype.code=function(e,t,n){if(this.options.highlight){var r=this.options.highlight(e,t);null!=r&&r!==e&&(n=!0,e=r)}return t?'<pre><code class="'+this.options.langPrefix+l(t,!0)+'">'+(n?e:l(e,!0))+"</code></pre>\n":"<pre><code>"+(n?e:l(e,!0))+"</code></pre>"},o.prototype.blockquote=function(e){return"<blockquote>\n"+e+"</blockquote>\n"},o.prototype.html=function(e){return e},o.prototype.heading=function(e,t,n){return this.options.headerIds?"<h"+t+' id="'+this.options.headerPrefix+n.toLowerCase().replace(/[^\w]+/g,"-")+'">'+e+"</h"+t+">\n":"<h"+t+">"+e+"</h"+t+">\n"},o.prototype.hr=function(){return this.options.xhtml?"<hr/>\n":"<hr>\n"},o.prototype.list=function(e,t,n){var r=t?"ol":"ul";return"<"+r+(t&&1!==n?' start="'+n+'"':"")+">\n"+e+"</"+r+">\n"},o.prototype.listitem=function(e){return"<li>"+e+"</li>\n"},o.prototype.checkbox=function(e){return"<input "+(e?'checked="" ':"")+'disabled="" type="checkbox"'+(this.options.xhtml?" /":"")+"> "},o.prototype.paragraph=function(e){return"<p>"+e+"</p>\n"},o.prototype.table=function(e,t){return t&&(t="<tbody>"+t+"</tbody>"),"<table>\n<thead>\n"+e+"</thead>\n"+t+"</table>\n"},o.prototype.tablerow=function(e){return"<tr>\n"+e+"</tr>\n"},o.prototype.tablecell=function(e,t){var n=t.header?"th":"td";return(t.align?"<"+n+' align="'+t.align+'">':"<"+n+">")+e+"</"+n+">\n"},o.prototype.strong=function(e){return"<strong>"+e+"</strong>"},o.prototype.em=function(e){return"<em>"+e+"</em>"},o.prototype.codespan=function(e){return"<code>"+e+"</code>"},o.prototype.br=function(){return this.options.xhtml?"<br/>":"<br>"},o.prototype.del=function(e){return"<del>"+e+"</del>"},o.prototype.link=function(e,t,n){if(this.options.sanitize){try{var r=decodeURIComponent(c(e)).replace(/[^\w:]/g,"").toLowerCase()}catch(e){return n}if(0===r.indexOf("javascript:")||0===r.indexOf("vbscript:")||0===r.indexOf("data:"))return n}this.options.baseUrl&&!f.test(e)&&(e=d(this.options.baseUrl,e));try{e=encodeURI(e).replace(/%25/g,"%")}catch(e){return n}var i='<a href="'+l(e)+'"';return t&&(i+=' title="'+t+'"'),i+=">"+n+"</a>"},o.prototype.image=function(e,t,n){this.options.baseUrl&&!f.test(e)&&(e=d(this.options.baseUrl,e));var r='<img src="'+e+'" alt="'+n+'"';return t&&(r+=' title="'+t+'"'),r+=this.options.xhtml?"/>":">"},o.prototype.text=function(e){return e},a.prototype.strong=a.prototype.em=a.prototype.codespan=a.prototype.del=a.prototype.text=function(e){return e},a.prototype.link=a.prototype.image=function(e,t,n){return""+n},a.prototype.br=function(){return""},s.parse=function(e,t){return new s(t).parse(e)},s.prototype.parse=function(e){this.inline=new i(e.links,this.options),this.inlineText=new i(e.links,m({},this.options,{renderer:new a})),this.tokens=e.reverse();for(var t="";this.next();)t+=this.tok();return t},s.prototype.next=function(){return this.token=this.tokens.pop()},s.prototype.peek=function(){return this.tokens[this.tokens.length-1]||0},s.prototype.parseText=function(){for(var e=this.token.text;"text"===this.peek().type;)e+="\n"+this.next().text;return this.inline.output(e)},s.prototype.tok=function(){switch(this.token.type){case"space":return"";case"hr":return this.renderer.hr();case"heading":return this.renderer.heading(this.inline.output(this.token.text),this.token.depth,c(this.inlineText.output(this.token.text)));case"code":return this.renderer.code(this.token.text,this.token.lang,this.token.escaped);case"table":var e,t,n,r,i="",o="";for(n="",e=0;e<this.token.header.length;e++)n+=this.renderer.tablecell(this.inline.output(this.token.header[e]),{header:!0,align:this.token.align[e]});for(i+=this.renderer.tablerow(n),e=0;e<this.token.cells.length;e++){for(t=this.token.cells[e],n="",r=0;r<t.length;r++)n+=this.renderer.tablecell(this.inline.output(t[r]),{header:!1,align:this.token.align[r]});o+=this.renderer.tablerow(n)}return this.renderer.table(i,o);case"blockquote_start":for(o="";"blockquote_end"!==this.next().type;)o+=this.tok();return this.renderer.blockquote(o);case"list_start":o="";for(var a=this.token.ordered,s=this.token.start;"list_end"!==this.next().type;)o+=this.tok();return this.renderer.list(o,a,s);case"list_item_start":for(o="",this.token.task&&(o+=this.renderer.checkbox(this.token.checked));"list_item_end"!==this.next().type;)o+="text"===this.token.type?this.parseText():this.tok();return this.renderer.listitem(o);case"loose_item_start":for(o="";"list_item_end"!==this.next().type;)o+=this.tok();return this.renderer.listitem(o);case"html":return this.renderer.html(this.token.text);case"paragraph":return this.renderer.paragraph(this.inline.output(this.token.text));case"text":return this.renderer.paragraph(this.parseText())}};var p={},f=/^$|^[a-z][a-z0-9+.-]*:|^[?#]/i;function h(){}function m(e){for(var t,n,r=1;r<arguments.length;r++){t=arguments[r];for(n in t)Object.prototype.hasOwnProperty.call(t,n)&&(e[n]=t[n])}return e}function g(e,t){var n=e.replace(/([^\\])\|/g,"$1 |").split(/ +\| */),r=0;if(n.length>t)n.splice(t);else for(;n.length<t;)n.push("");for(;r<n.length;r++)n[r]=n[r].replace(/\\\|/g,"|");return n}function b(e,t,r){if(void 0===e||null===e)throw new Error("marked(): input parameter is undefined or null");if("string"!=typeof e)throw new Error("marked(): input parameter is of type "+Object.prototype.toString.call(e)+", string expected");if(r||"function"==typeof t){r||(r=t,t=null);var i,o,a=(t=m({},b.defaults,t||{})).highlight,c=0;try{i=n.lex(e,t)}catch(e){return r(e)}o=i.length;var u=function(e){if(e)return t.highlight=a,r(e);var n;try{n=s.parse(i,t)}catch(t){e=t}return t.highlight=a,e?r(e):r(null,n)};if(!a||a.length<3)return u();if(delete t.highlight,!o)return u();for(;c<i.length;c++)!function(e){"code"!==e.type?--o||u():a(e.text,e.lang,function(t,n){return t?u(t):null==n||n===e.text?--o||u():(e.text=n,e.escaped=!0,void(--o||u()))})}(i[c])}else try{return t&&(t=m({},b.defaults,t)),s.parse(n.lex(e,t),t)}catch(e){if(e.message+="\nPlease report this to https://github.com/markedjs/marked.",(t||b.defaults).silent)return"<p>An error occurred:</p><pre>"+l(e.message+"",!0)+"</pre>";throw e}}h.exec=h,b.options=b.setOptions=function(e){return m(b.defaults,e),b},b.getDefaults=function(){return{baseUrl:null,breaks:!1,gfm:!0,headerIds:!0,headerPrefix:"",highlight:null,langPrefix:"language-",mangle:!0,pedantic:!1,renderer:new o,sanitize:!1,sanitizer:null,silent:!1,smartLists:!1,smartypants:!1,tables:!0,xhtml:!1}},b.defaults=b.getDefaults(),b.Parser=s,b.parser=s.parse,b.Renderer=o,b.TextRenderer=a,b.Lexer=n,b.lexer=n.lex,b.InlineLexer=i,b.inlineLexer=i.output,b.parse=b,"undefined"!=typeof module&&"object"==typeof exports?module.exports=b:"function"==typeof define&&define.amd?define("deps/marked",[],function(){return b}):e.marked=b}(this||("undefined"!=typeof window?window:global)),define("core/utils",["exports","core/pubsubhub","deps/marked"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.ISODate=e.name=void 0,e.markdownToHtml=function(e){const t=h(e).replace(l,">").replace(c,"&");return(0,i.default)(t)},e.makeOwnerSwapper=function(e){if(!e)throw new TypeError("Expected instance of Node.");return t=>{if(t.ownerDocument.adoptNode(e),t.firstElementChild)return t.insertBefore(e,t.firstElementChild);t.appendChild(e)}},e.calculateLeftPad=function(e){if("string"!=typeof e)throw new TypeError("Invalid input");var t=e.split("\n").filter(e=>e).reduce((e,t)=>{if(0===e)return e;const n=t.match(o)[0]||"";return Math.min(n.length,e)},1/0);return t===1/0?0:t},e.createResourceHint=function(e){if(!e||"object"!=typeof e)throw new TypeError("Missing options");if(!p.has(e.hint))throw new TypeError("Invalid resources hint");const t=new URL(e.href,document.location),n=document.createElement("link");let r=t.href;switch(n.rel=e.hint,n.rel){case"dns-prefetch":case"preconnect":r=t.origin,(e.corsMode||t.origin!==document.location.origin)&&(n.crossOrigin=e.corsMode||"anonymous");break;case"preload":"as"in e&&"string"==typeof e.as&&(f.has(e.as)||console.warn(`Unknown request destination: ${e.as}`),n.setAttribute("as",e.as))}n.href=r,e.dontRemove||n.classList.add("removeOnSave");return n},e.normalizePadding=h,e.removeReSpec=function(e){Array.from(e.querySelectorAll(".remove, script[data-requiremodule]")).forEach(e=>{e.remove()})},e.joinAnd=function(e=[],t=(e=>e)){const n=e.map(t);switch(n.length){case 0:case 1:return n.toString();case 2:return n.join(" and ");default:const e=n.join(", "),t=e.lastIndexOf(",");return`${e.substr(0,t+1)} and ${e.slice(t+2)}`}},e.xmlEscape=function(e){return e.replace(/&/g,"&").replace(/>/g,">").replace(/"/g,""").replace(/</g,"<")},e.norm=function(e){return e.trim().replace(/\s+/g," ")},e.semverCompare=function(e,t){const n=e.split("."),r=t.split(".");for(let e=0;e<3;e++){const t=Number(n[e]),i=Number(r[e]);if(t>i)return 1;if(i>t)return-1;if(!isNaN(t)&&isNaN(i))return 1;if(isNaN(t)&&!isNaN(i))return-1}return 0},e.concatDate=function(e,t=""){return u.format(e).replace(s,t)},e.toShortIsoDate=function(e){return u.format(e)},e.lead0=function(e){return 1===String(e).length?"0"+e:e},e.parseSimpleDate=function(e){return new Date(e)},e.parseLastModified=function(e){return e?new Date(Date.parse(e)):new Date},e.humanDate=function(e=new Date,t=document.documentElement.lang||"en"){e instanceof Date||(e=new Date(e));const n=[t,"en"],r=e.toLocaleString(n,{day:"2-digit",timeZone:"UTC"}),i=e.toLocaleString(n,{month:"long",timeZone:"UTC"}),o=e.toLocaleString(n,{year:"numeric",timeZone:"UTC"});return`${r} ${i} ${o}`},e.isoDate=function(e){return(e instanceof Date?e:new Date(e)).toISOString()},e.toKeyValuePairs=function(e,t=", ",n="="){return Array.from(Object.entries(e)).map(([e,t])=>`${e}${n}${JSON.stringify(t)}`).join(t)},e.linkCSS=function(e,t){const n=[].concat(t).map(t=>{var n=e.createElement("link");return n.rel="stylesheet",n.href=t,n}).reduce(function(e,t){return e.appendChild(t),e},e.createDocumentFragment());e.head.appendChild(n)},e.runTransforms=function(e,n){var r=[this,e],i=Array.from(arguments);if(i.shift(),i.shift(),r=r.concat(i),n)for(var o=n.split(/\s+/),a=0;a<o.length;a++){var s=o[a];if(window[s])try{e=window[s].apply(this,r)}catch(e){(0,t.pub)("warn",`call to \`${s}()\` failed with: ${e}. See error console for stack trace.`),console.error(e)}}return e},e.fetchAndCache=async function(e,t=864e5){("string"==typeof e||e instanceof URL)&&(e=new Request(e));const n=new URL(e.url);let r,i;if("caches"in window)try{if(r=await caches.open(n.origin),(i=await r.match(e))&&new Date(i.headers.get("Expires"))>new Date)return i}catch(e){console.error("Failed to use Cache API.",e)}const o=await fetch(e);if(!o.ok&&i)return console.warn(`Returning a stale cached response for ${n}`),i;if(r){const n=o.clone(),i=new Headers(o.headers),a=new Date(Date.now()+t);i.set("Expires",a);const s=new Response(await n.blob(),{headers:i});return await r.put(e,s).catch(console.error),await r.match(e)}return o},e.flatten=function e(t,n){const r="object"==typeof n;const i=Object(n)[Symbol.iterator]&&"function"==typeof n.values;const o=r?i?[...n.values()].reduce(e,[]):Object.values(n):[n];return[...t,...o]};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/utils";i.default.setOptions({sanitize:!1,gfm:!0});const o=/^[\ |\t]*/,a=/\s+$/gm,s=/\-/g,l=/>/gm,c=/&/gm;const u=e.ISODate=new Intl.DateTimeFormat(["en-ca-iso8601"],{timeZone:"UTC",year:"numeric",month:"2-digit",day:"2-digit"}),d=new Set(["a","abbr","acronym","b","bdo","big","br","button","cite","code","dfn","em","i","img","input","kbd","label","map","object","q","samp","script","select","small","span","strong","sub","sup","textarea","time","tt","var"]),p=new Set(["dns-prefetch","preconnect","preload","prerender"]),f=new Set(["document","embed","font","image","manifest","media","object","report","script","serviceworker","sharedworker","style","worker","xslt",""]);function h(e=""){if(!e)return"";if("string"!=typeof e)throw TypeError("Invalid input");if("\n"===e)return"\n";function t(e){return null!==e&&e.nodeType===Node.TEXT_NODE}var n="<body>"+e,r=(new DOMParser).parseFromString(n,"text/html");Array.from(r.body.children).filter(e=>!d.has(e.localName)).filter(e=>"pre"!==e.localName).filter(e=>"table"!==e.localName).forEach(e=>{e.innerHTML=h(e.innerHTML)}),Array.from(r.body.childNodes).filter(e=>t(e)&&""===e.textContent.trim()).forEach(e=>e.parentElement.replaceChild(r.createTextNode("\n"),e)),t(r.body.firstChild)||Array.from(r.body.firstChild.children).filter(e=>"table"!==e.localName).forEach(e=>{e.innerHTML=h(e.innerHTML)}),r.normalize();const i=r.body.innerText.replace(/^\ *\n/,"").split("\n").filter(e=>e&&e.startsWith(" "))[0];var o=i?i.match(/\ +/)[0].length:0;if(o){Array.from(r.body.childNodes).filter(e=>"pre"!==e.localName).filter(t).filter(e=>{const t=e.previousElementSibling,n=t?t.localName:e.parentElement.localName;return!d.has(n)||e.textContent.trim().includes("\n")}).reduce((e,t)=>{let n="";const r=t.previousElementSibling,i=r?r.localName:t.parentElement.localName;return/^[\t\ ]/.test(t.textContent)&&d.has(i)&&(n=t.textContent.match(/^\s+/)[0]),t.textContent=n+t.textContent.replace(e,""),e},new RegExp("^ {1,"+o+"}","gm"));const e=new RegExp(`\\ {${o}}$`,"gm");Array.from(r.body.querySelectorAll("pre")).map(e=>e.previousSibling).filter(t).reduce((t,n)=>(e.test(n.textContent)&&(n.textContent=n.textContent.substr(0,n.textContent.length-t)),t),o)}return a.test(r.body.innerHTML)?r.body.innerHTML.trimRight()+"\n":r.body.innerHTML}}),define("core/post-process",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0;e.name="core/post-process";let n;e.done=new Promise(e=>{n=e});(0,t.sub)("plugins-done",async e=>{const t=[];if(Array.isArray(e.postProcess)){const n=await Promise.all(e.postProcess.filter(e=>"function"==typeof e).map(t=>Promise.resolve(t(e,document))));t.push(...n)}"function"==typeof e.afterEnd&&t.push(await Promise.resolve(e.afterEnd(e,document))),n(t)},{once:!0})}),define("core/pre-process",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0;e.name="core/pre-process";let n;e.done=new Promise(e=>{n=e});(0,t.sub)("start-all",async e=>{const t=[];if(Array.isArray(e.preProcess)){const n=await Promise.all(e.preProcess.filter(e=>"function"==typeof e).map(t=>Promise.resolve(t(e,document))));t.push(...n)}n(t)},{once:!0})}),define("core/include-config",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/include-config";const n={},r=e=>Object.assign(n,e);(0,t.sub)("start-all",r),(0,t.sub)("amend-user-config",r),(0,t.sub)("end-all",()=>{const e=document.createElement("script");e.id="initialUserConfig",e.type="application/json",e.innerHTML=JSON.stringify(n,null,2),document.head.appendChild(e)})}),define("core/override-configuration",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/override-configuration";(0,t.sub)("start-all",function(e){const n=document.location.search.replace(/;/g,"&"),r=new URLSearchParams(n),i=Array.from(r.entries()).filter(([e,t])=>!!e&&!!t).map(([e,t])=>{const n=decodeURIComponent(e),r=decodeURIComponent(t.replace(/%3D/g,"="));let i;try{i=JSON.parse(r)}catch(e){i=r}return{key:n,value:i}}).reduce((e,{key:t,value:n})=>(e[t]=n,e),{});Object.assign(e,i),(0,t.pub)("amend-user-config",i)},{once:!0})}),define("core/respec-ready",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/respec-ready";const n=new Promise(e=>{(0,t.sub)("end-all",e,{once:!0})});Object.defineProperty(document,"respecIsReady",{get:()=>n})}),define("core/base-runner",["exports","core/utils","core/post-process","core/pre-process","core/pubsubhub","core/include-config","core/override-configuration","core/respec-ready"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.runAll=async function(e){(0,i.pub)("start-all",respecConfig),a&&performance.mark(o+"-start");await r.done;const l=e.filter(e=>e&&e.run).map(s);for(const e of l)try{await e(respecConfig)}catch(e){console.error(e)}(0,i.pub)("plugins-done",respecConfig),await n.done,(0,i.pub)("end-all",respecConfig),(0,t.removeReSpec)(document),a&&(performance.mark(o+"-end"),performance.measure(o,o+"-start",o+"-end"))};const o=e.name="core/base-runner",a=performance.mark&&performance.measure;function s(e){const t=e.name||"";return t||console.warn("Plugin lacks name:",e),n=>new Promise(async(r,i)=>{const o=setTimeout(()=>{const n=`Plugin ${t} took too long.`;console.error(n,e),i(new Error(n))},15e3);a&&performance.mark(t+"-start");try{e.run.length<=1?(await e.run(n),r()):e.run(n,document,r)}catch(e){i(e)}finally{clearTimeout(o)}a&&(performance.mark(t+"-end"),performance.measure(t,t+"-start",t+"-end"))})}});var shortcut={all_shortcuts:{},add:function(e,t,n){var r={type:"keydown",propagate:!1,disable_in_input:!1,target:document,keycode:!1};if(n)for(var i in r)void 0===n[i]&&(n[i]=r[i]);else n=r;var o=n.target;"string"==typeof n.target&&(o=document.getElementById(n.target));e=e.toLowerCase();var a=function(r){var i,o;if((r=r||window.event,n.disable_in_input)&&(r.target?o=r.target:r.srcElement&&(o=r.srcElement),3==o.nodeType&&(o=o.parentNode),"INPUT"==o.tagName||"TEXTAREA"==o.tagName))return;r.keyCode?i=r.keyCode:r.which&&(i=r.which);var a=String.fromCharCode(i).toLowerCase();188==i&&(a=","),190==i&&(a=".");var s=e.split("+"),l=0,c={"`":"~",1:"!",2:"@",3:"#",4:"$",5:"%",6:"^",7:"&",8:"*",9:"(",0:")","-":"_","=":"+",";":":","'":'"',",":"<",".":">","/":"?","\\":"|"},u={esc:27,escape:27,tab:9,space:32,return:13,enter:13,backspace:8,scrolllock:145,scroll_lock:145,scroll:145,capslock:20,caps_lock:20,caps:20,numlock:144,num_lock:144,num:144,pause:19,break:19,insert:45,home:36,delete:46,end:35,pageup:33,page_up:33,pu:33,pagedown:34,page_down:34,pd:34,left:37,up:38,right:39,down:40,f1:112,f2:113,f3:114,f4:115,f5:116,f6:117,f7:118,f8:119,f9:120,f10:121,f11:122,f12:123},d={shift:{wanted:!1,pressed:!1},ctrl:{wanted:!1,pressed:!1},alt:{wanted:!1,pressed:!1},meta:{wanted:!1,pressed:!1}};r.ctrlKey&&(d.ctrl.pressed=!0),r.shiftKey&&(d.shift.pressed=!0),r.altKey&&(d.alt.pressed=!0),r.metaKey&&(d.meta.pressed=!0);for(var p,f=0;p=s[f],f<s.length;f++)"ctrl"==p||"control"==p?(l++,d.ctrl.wanted=!0):"shift"==p?(l++,d.shift.wanted=!0):"alt"==p?(l++,d.alt.wanted=!0):"meta"==p?(l++,d.meta.wanted=!0):p.length>1?u[p]==i&&l++:n.keycode?n.keycode==i&&l++:a==p?l++:c[a]&&r.shiftKey&&(a=c[a])==p&&l++;if(l==s.length&&d.ctrl.pressed==d.ctrl.wanted&&d.shift.pressed==d.shift.wanted&&d.alt.pressed==d.alt.wanted&&d.meta.pressed==d.meta.wanted&&(t(r),!n.propagate))return r.cancelBubble=!0,r.returnValue=!1,r.stopPropagation&&(r.stopPropagation(),r.preventDefault()),!1};this.all_shortcuts[e]={callback:a,target:o,event:n.type},o.addEventListener?o.addEventListener(n.type,a,!1):o.attachEvent?o.attachEvent("on"+n.type,a):o["on"+n.type]=a}},Zx,t0,u0,Dha,Eha,mta,nta,eXa,fXa;define("shortcut",(Zx=this,function(){return Zx.shortcut})),define("deps/text",["module"],function(e){var t,n,r,i,o,a=["Msxml2.XMLHTTP","Microsoft.XMLHTTP","Msxml2.XMLHTTP.4.0"],s=/^\s*<\?xml(\s)+version=[\'\"](\d)*.(\d)*[\'\"](\s)*\?>/im,l=/<body[^>]*>\s*([\s\S]+)\s*<\/body>/im,c="undefined"!=typeof location&&location.href,u=c&&location.protocol&&location.protocol.replace(/\:/,""),d=c&&location.hostname,p=c&&(location.port||void 0),f={},h=e.config&&e.config()||{};function m(e,t){return void 0===e||""===e?t:e}return t={version:"2.0.15",strip:function(e){if(e){var t=(e=e.replace(s,"")).match(l);t&&(e=t[1])}else e="";return e},jsEscape:function(e){return e.replace(/(['\\])/g,"\\$1").replace(/[\f]/g,"\\f").replace(/[\b]/g,"\\b").replace(/[\n]/g,"\\n").replace(/[\t]/g,"\\t").replace(/[\r]/g,"\\r").replace(/[\u2028]/g,"\\u2028").replace(/[\u2029]/g,"\\u2029")},createXhr:h.createXhr||function(){var e,t,n;if("undefined"!=typeof XMLHttpRequest)return new XMLHttpRequest;if("undefined"!=typeof ActiveXObject)for(t=0;t<3;t+=1){n=a[t];try{e=new ActiveXObject(n)}catch(e){}if(e){a=[n];break}}return e},parseName:function(e){var t,n,r,i=!1,o=e.lastIndexOf("."),a=0===e.indexOf("./")||0===e.indexOf("../");return-1!==o&&(!a||o>1)?(t=e.substring(0,o),n=e.substring(o+1)):t=e,-1!==(o=(r=n||t).indexOf("!"))&&(i="strip"===r.substring(o+1),r=r.substring(0,o),n?n=r:t=r),{moduleName:t,ext:n,strip:i}},xdRegExp:/^((\w+)\:)?\/\/([^\/\\]+)/,useXhr:function(e,n,r,i){var o,a,s,l=t.xdRegExp.exec(e);return!l||(o=l[2],s=(a=(a=l[3]).split(":"))[1],a=a[0],(!o||o===n)&&(!a||a.toLowerCase()===r.toLowerCase())&&(!s&&!a||function(e,t,n,r){if(t===r)return!0;if(e===n){if("http"===e)return m(t,"80")===m(r,"80");if("https"===e)return m(t,"443")===m(r,"443")}return!1}(o,s,n,i)))},finishLoad:function(e,n,r,i){r=n?t.strip(r):r,h.isBuild&&(f[e]=r),i(r)},load:function(e,n,r,i){if(i&&i.isBuild&&!i.inlineText)r();else{h.isBuild=i&&i.isBuild;var o=t.parseName(e),a=o.moduleName+(o.ext?"."+o.ext:""),s=n.toUrl(a),l=h.useXhr||t.useXhr;0!==s.indexOf("empty:")?!c||l(s,u,d,p)?t.get(s,function(n){t.finishLoad(e,o.strip,n,r)},function(e){r.error&&r.error(e)}):n([a],function(e){t.finishLoad(o.moduleName+"."+o.ext,o.strip,e,r)}):r()}},write:function(e,n,r,i){if(f.hasOwnProperty(n)){var o=t.jsEscape(f[n]);r.asModule(e+"!"+n,"define(function () { return '"+o+"';});\n")}},writeFile:function(e,n,r,i,o){var a=t.parseName(n),s=a.ext?"."+a.ext:"",l=a.moduleName+s,c=r.toUrl(a.moduleName+s)+".js";t.load(l,r,function(n){var r=function(e){return i(c,e)};r.asModule=function(e,t){return i.asModule(e,c,t)},t.write(e,l,r,o)},o)}},"node"===h.env||!h.env&&"undefined"!=typeof process&&process.versions&&process.versions.node&&!process.versions["node-webkit"]&&!process.versions["atom-shell"]?(n=require.nodeRequire("fs"),t.get=function(e,t,r){try{var i=n.readFileSync(e,"utf8");"\ufeff"===i[0]&&(i=i.substring(1)),t(i)}catch(e){r&&r(e)}}):"xhr"===h.env||!h.env&&t.createXhr()?t.get=function(e,n,r,i){var o,a=t.createXhr();if(a.open("GET",e,!0),i)for(o in i)i.hasOwnProperty(o)&&a.setRequestHeader(o.toLowerCase(),i[o]);h.onXhr&&h.onXhr(a,e),a.onreadystatechange=function(t){var i,o;4===a.readyState&&((i=a.status||0)>399&&i<600?((o=new Error(e+" HTTP status: "+i)).xhr=a,r&&r(o)):n(a.responseText),h.onXhrComplete&&h.onXhrComplete(a,e))},a.send(null)}:"rhino"===h.env||!h.env&&"undefined"!=typeof Packages&&"undefined"!=typeof java?t.get=function(e,t){var n,r,i=new java.io.File(e),o=java.lang.System.getProperty("line.separator"),a=new java.io.BufferedReader(new java.io.InputStreamReader(new java.io.FileInputStream(i),"utf-8")),s="";try{for(n=new java.lang.StringBuffer,(r=a.readLine())&&r.length()&&65279===r.charAt(0)&&(r=r.substring(1)),null!==r&&n.append(r);null!==(r=a.readLine());)n.append(o),n.append(r);s=String(n.toString())}finally{a.close()}t(s)}:("xpconnect"===h.env||!h.env&&"undefined"!=typeof Components&&Components.classes&&Components.interfaces)&&(r=Components.classes,i=Components.interfaces,Components.utils.import("resource://gre/modules/FileUtils.jsm"),o="@mozilla.org/windows-registry-key;1"in r,t.get=function(e,t){var n,a,s,l={};o&&(e=e.replace(/\//g,"\\")),s=new FileUtils.File(e);try{(n=r["@mozilla.org/network/file-input-stream;1"].createInstance(i.nsIFileInputStream)).init(s,1,0,!1),(a=r["@mozilla.org/intl/converter-input-stream;1"].createInstance(i.nsIConverterInputStream)).init(n,"utf-8",n.available(),i.nsIConverterInputStream.DEFAULT_REPLACEMENT_CHARACTER),a.readString(n.available(),l),a.close(),n.close(),t(l.value)}catch(e){throw new Error((s&&s.path||"")+": "+e)}}),t}),define("deps/text!ui/ui.css",[],function(){return'#respec-ui {\n position: fixed;\n display: flex;\n flex-direction: row-reverse;\n top: 20px;\n right: 20px;\n width: 202px;\n text-align: right;\n z-index: 9000;\n}\n\n#respec-pill,\n.respec-info-button {\n background: #fff;\n height: 2.5em;\n color: rgb(120, 120, 120);\n border: 1px solid #ccc;\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\n}\n\n.respec-info-button {\n border: none;\n opacity: 0.75;\n border-radius: 2em;\n margin-right: 1em;\n min-width: 3.5em;\n}\n\n.respec-info-button:focus,\n.respec-info-button:hover {\n opacity: 1;\n transition: opacity 0.2s;\n}\n\n#respec-pill:disabled {\n font-size: 2.8px;\n text-indent: -9999em;\n border-top: 1.1em solid rgba(40, 40, 40, 0.2);\n border-right: 1.1em solid rgba(40, 40, 40, 0.2);\n border-bottom: 1.1em solid rgba(40, 40, 40, 0.2);\n border-left: 1.1em solid #ffffff;\n transform: translateZ(0);\n animation: respec-spin 0.5s infinite linear;\n box-shadow: none;\n}\n\n#respec-pill:disabled,\n#respec-pill:disabled:after {\n border-radius: 50%;\n width: 10em;\n height: 10em;\n}\n\n@keyframes respec-spin {\n 0% {\n transform: rotate(0deg);\n }\n 100% {\n transform: rotate(360deg);\n }\n}\n\n.respec-hidden {\n visibility: hidden;\n opacity: 0;\n transition: visibility 0s 0.2s, opacity 0.2s linear;\n}\n\n.respec-visible {\n visibility: visible;\n opacity: 1;\n transition: opacity 0.2s linear;\n}\n\n#respec-pill:hover,\n#respec-pill:focus {\n color: rgb(0, 0, 0);\n background-color: rgb(245, 245, 245);\n transition: color 0.2s;\n}\n\n#respec-menu {\n position: absolute;\n margin: 0;\n padding: 0;\n font-family: sans-serif;\n background: #fff;\n box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, 0.5);\n width: 200px;\n display: none;\n text-align: left;\n margin-top: 32px;\n font-size: 0.8em;\n}\n\n#respec-menu:not([hidden]) {\n display: block;\n}\n\n#respec-menu li {\n list-style-type: none;\n margin: 0;\n padding: 0;\n}\n\n.respec-save-buttons {\n display: grid;\n grid-template-columns: repeat(auto-fill, minmax(47%, 2fr));\n grid-gap: 0.5cm;\n padding: 0.5cm;\n}\n\n.respec-save-button:link {\n padding-top: 16px;\n color: rgb(240, 240, 240);\n background: rgb(42, 90, 168);\n justify-self: stretch;\n height: 1cm;\n text-decoration: none;\n text-align: center;\n font-size: inherit;\n border: none;\n border-radius: 0.2cm;\n}\n\n.respec-save-button:link:hover {\n color: white;\n background: rgb(42, 90, 168);\n padding: 0;\n margin: 0;\n border: 0;\n padding-top: 16px;\n}\n\n#respec-ui button:focus,\n#respec-pill:focus,\n.respec-option:focus {\n outline: 0;\n outline-style: none;\n}\n\n#respec-pill-error {\n background-color: red;\n color: white;\n}\n\n#respec-pill-warning {\n background-color: orange;\n color: white;\n}\n\n.respec-warning-list,\n.respec-error-list {\n margin: 0;\n padding: 0;\n list-style: none;\n font-family: sans-serif;\n background-color: rgb(255, 251, 230);\n font-size: 0.85em;\n}\n\n.respec-warning-list > li,\n.respec-error-list > li {\n padding: 0.4em 0.7em;\n}\n\n.respec-warning-list > li::before {\n content: "⚠️";\n padding-right: 0.5em;\n}\n.respec-warning-list p,\n.respec-error-list p {\n padding: 0;\n margin: 0;\n}\n\n.respec-warning-list li {\n color: rgb(92, 59, 0);\n border-bottom: thin solid rgb(255, 245, 194);\n}\n\n.respec-error-list,\n.respec-error-list li {\n background-color: rgb(255, 240, 240);\n}\n\n.respec-error-list li::before {\n content: "💥";\n padding-right: 0.5em;\n}\n\n.respec-error-list li {\n padding: 0.4em 0.7em;\n color: rgb(92, 59, 0);\n border-bottom: thin solid rgb(255, 215, 215);\n}\n\n.respec-error-list li > p {\n margin: 0;\n padding: 0;\n display: inline-block;\n}\n\n#respec-overlay {\n display: block;\n position: fixed;\n z-index: 10000;\n top: 0px;\n left: 0px;\n height: 100%;\n width: 100%;\n background: #000;\n}\n\n.respec-show-overlay {\n transition: opacity 0.2s linear;\n opacity: 0.5;\n}\n\n.respec-hide-overlay {\n transition: opacity 0.2s linear;\n opacity: 0;\n}\n\n.respec-modal {\n display: block;\n position: fixed;\n z-index: 11000;\n margin: auto;\n top: 10%;\n background: #fff;\n border: 5px solid #666;\n min-width: 20%;\n width: 79%;\n padding: 0;\n max-height: 80%;\n overflow-y: auto;\n margin: 0 -0.5cm;\n}\n\n@media screen and (min-width: 78em) {\n .respec-modal {\n width: 62%;\n }\n}\n\n.respec-modal h3 {\n margin: 0;\n padding: 0.2em;\n text-align: center;\n color: black;\n background: linear-gradient(\n to bottom,\n rgba(238, 238, 238, 1) 0%,\n rgba(238, 238, 238, 1) 50%,\n rgba(204, 204, 204, 1) 100%\n );\n font-size: 1em;\n}\n\n.respec-modal .inside div p {\n padding-left: 1cm;\n}\n\n#respec-menu button.respec-option {\n background: white;\n padding: 0 0.2cm;\n border: none;\n width: 100%;\n text-align: left;\n font-size: inherit;\n padding: 1.2em 1.2em;\n}\n\n#respec-menu button.respec-option:hover,\n#respec-menu button:focus {\n background-color: #eeeeee;\n}\n\n.respec-cmd-icon {\n padding-right: 0.5em;\n}\n\n#respec-ui button.respec-option:last-child {\n border: none;\n border-radius: inherit;\n}\n\n.respec-offending-element {\n display: inline-block;\n position: relative;\n background: url(data:image/gif;base64,R0lGODdhBAADAPEAANv///8AAP///wAAACwAAAAABAADAEACBZQjmIAFADs=)\n bottom repeat-x;\n}\n\n@supports (text-decoration-style: wavy) {\n .respec-offending-element {\n background: none;\n text-decoration-line: underline;\n text-decoration-style: wavy;\n text-decoration-color: red;\n }\n}\n\n.respec-button-copy-paste {\n position: absolute;\n display: block;\n padding: 0px 8px;\n height: 28px;\n width: 40px;\n color: #333;\n white-space: nowrap;\n vertical-align: middle;\n cursor: pointer;\n background-color: #eee;\n background-image: linear-gradient(#fcfcfc, #eee);\n border: 1px solid rgb(144, 184, 222);\n border-radius: 0px 0px 3px 0;\n -webkit-user-select: none;\n -moz-user-select: none;\n -ms-user-select: none;\n user-select: none;\n -webkit-appearance: none;\n margin: 0px 127px;\n border-left: 0;\n}\n\np + .respec-button-copy-paste {\n margin: 1px 127px;\n}\n\n#specref-ui {\n margin: 0 2%;\n margin-bottom: 0.5cm;\n}\n\n#specref-ui header {\n font-size: 0.7em;\n background-color: #eee;\n text-align: center;\n padding: 0.2cm;\n margin-bottom: 0.5cm;\n border-radius: 0 0 0.2cm 0.2cm;\n}\n\n#specref-ui header h1 {\n padding: 0;\n margin: 0;\n color: black;\n}\n\n#specref-ui p {\n padding: 0;\n margin: 0;\n font-size: 0.8em;\n text-align: center;\n}\n\n#specref-ui p.state {\n margin: 1cm;\n}\n\n#specref-ui .searchcomponent {\n font-size: 16px;\n display: grid;\n grid-template-columns: auto 2cm;\n}\n#specref-ui .searchcomponent:focus {\n}\n\n#specref-ui input,\n#specref-ui button {\n border: 0;\n padding: 6px 12px;\n}\n\n#specref-ui label {\n font-size: 0.6em;\n grid-column-end: 3;\n text-align: right;\n grid-column-start: 1;\n}\n\n#specref-ui input[type="search"] {\n -webkit-appearance: none;\n font-size: 16px;\n border-radius: 0.1cm 0 0 0.1cm;\n border: 1px solid rgb(204, 204, 204);\n}\n\n#specref-ui button[type="submit"] {\n color: white;\n border-radius: 0 0.1cm 0.1cm 0;\n background-color: rgb(51, 122, 183);\n}\n\n#specref-ui button[type="submit"]:hover {\n background-color: #286090;\n border-color: #204d74;\n}\n\n#specref-ui .result-stats {\n margin: 0;\n padding: 0;\n color: rgb(128, 128, 128);\n font-size: 0.7em;\n font-weight: bold;\n}\n\n#specref-ui .specref-results {\n font-size: 0.8em;\n}\n\n#specref-ui .specref-results dd + dt {\n margin-top: 0.51cm;\n}\n\n#specref-ui .specref-results a {\n text-transform: capitalize;\n}\n#specref-ui .specref-results .authors {\n display: block;\n color: #006621;\n}\n\n@media print {\n #respec-ui {\n display: none;\n }\n}\n'}),t0="undefined"!=typeof window?window:this,u0=function(e,t){var n=[],r=e.document,i=Object.getPrototypeOf,o=n.slice,a=n.concat,s=n.push,l=n.indexOf,c={},u=c.toString,d=c.hasOwnProperty,p=d.toString,f=p.call(Object),h={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType},g=function(e){return null!=e&&e===e.window},b={type:!0,src:!0,noModule:!0};function y(e,t,n){var i,o=(t=t||r).createElement("script");if(o.text=e,n)for(i in b)n[i]&&(o[i]=n[i]);t.head.appendChild(o).parentNode.removeChild(o)}function v(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?c[u.call(e)]||"object":typeof e}var w="3.3.1 -ajax,-ajax/jsonp,-ajax/load,-ajax/parseXML,-ajax/script,-ajax/var/location,-ajax/var/nonce,-ajax/var/rquery,-ajax/xhr,-manipulation/_evalUrl,-event/ajax,-effects,-effects/Tween,-effects/animatedSelector",x=function(e,t){return new x.fn.init(e,t)},k=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;function C(e){var t=!!e&&"length"in e&&e.length,n=v(e);return!m(e)&&!g(e)&&("array"===n||0===t||"number"==typeof t&&t>0&&t-1 in e)}x.fn=x.prototype={jquery:w,constructor:x,length:0,toArray:function(){return o.call(this)},get:function(e){return null==e?o.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=x.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return x.each(this,e)},map:function(e){return this.pushStack(x.map(this,function(t,n){return e.call(t,n,t)}))},slice:function(){return this.pushStack(o.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(n>=0&&n<t?[this[n]]:[])},end:function(){return this.prevObject||this.constructor()},push:s,sort:n.sort,splice:n.splice},x.extend=x.fn.extend=function(){var e,t,n,r,i,o,a=arguments[0]||{},s=1,l=arguments.length,c=!1;for("boolean"==typeof a&&(c=a,a=arguments[s]||{},s++),"object"==typeof a||m(a)||(a={}),s===l&&(a=this,s--);s<l;s++)if(null!=(e=arguments[s]))for(t in e)n=a[t],a!==(r=e[t])&&(c&&r&&(x.isPlainObject(r)||(i=Array.isArray(r)))?(i?(i=!1,o=n&&Array.isArray(n)?n:[]):o=n&&x.isPlainObject(n)?n:{},a[t]=x.extend(c,o,r)):void 0!==r&&(a[t]=r));return a},x.extend({expando:"jQuery"+(w+Math.random()).replace(/\D/g,""),isReady:!0,error:function(e){throw new Error(e)},noop:function(){},isPlainObject:function(e){var t,n;return!(!e||"[object Object]"!==u.call(e))&&(!(t=i(e))||"function"==typeof(n=d.call(t,"constructor")&&t.constructor)&&p.call(n)===f)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},globalEval:function(e){y(e)},each:function(e,t){var n,r=0;if(C(e))for(n=e.length;r<n&&!1!==t.call(e[r],r,e[r]);r++);else for(r in e)if(!1===t.call(e[r],r,e[r]))break;return e},trim:function(e){return null==e?"":(e+"").replace(k,"")},makeArray:function(e,t){var n=t||[];return null!=e&&(C(Object(e))?x.merge(n,"string"==typeof e?[e]:e):s.call(n,e)),n},inArray:function(e,t,n){return null==t?-1:l.call(t,e,n)},merge:function(e,t){for(var n=+t.length,r=0,i=e.length;r<n;r++)e[i++]=t[r];return e.length=i,e},grep:function(e,t,n){for(var r=[],i=0,o=e.length,a=!n;i<o;i++)!t(e[i],i)!==a&&r.push(e[i]);return r},map:function(e,t,n){var r,i,o=0,s=[];if(C(e))for(r=e.length;o<r;o++)null!=(i=t(e[o],o,n))&&s.push(i);else for(o in e)null!=(i=t(e[o],o,n))&&s.push(i);return a.apply([],s)},guid:1,support:h}),"function"==typeof Symbol&&(x.fn[Symbol.iterator]=n[Symbol.iterator]),x.each("Boolean Number String Function Array Date RegExp Object Error Symbol".split(" "),function(e,t){c["[object "+t+"]"]=t.toLowerCase()});var E=function(e){var t,n,r,i,o,a,s,l,c,u,d,p,f,h,m,g,b,y,v,w="sizzle"+1*new Date,x=e.document,k=0,C=0,E=ae(),$=ae(),T=ae(),S=function(e,t){return e===t&&(d=!0),0},A={}.hasOwnProperty,L=[],j=L.pop,D=L.push,_=L.push,N=L.slice,R=function(e,t){for(var n=0,r=e.length;n<r;n++)if(e[n]===t)return n;return-1},P="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",M="[\\x20\\t\\r\\n\\f]",O="(?:\\\\.|[\\w-]|[^\0-\\xa0])+",I="\\["+M+"*("+O+")(?:"+M+"*([*^$|!~]?=)"+M+"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|("+O+"))|)"+M+"*\\]",q=":("+O+")(?:\\((('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|((?:\\\\.|[^\\\\()[\\]]|"+I+")*)|.*)\\)|)",U=new RegExp(M+"+","g"),W=new RegExp("^"+M+"+|((?:^|[^\\\\])(?:\\\\.)*)"+M+"+$","g"),H=new RegExp("^"+M+"*,"+M+"*"),B=new RegExp("^"+M+"*([>+~]|"+M+")"+M+"*"),F=new RegExp("="+M+"*([^\\]'\"]*?)"+M+"*\\]","g"),z=new RegExp(q),G=new RegExp("^"+O+"$"),V={ID:new RegExp("^#("+O+")"),CLASS:new RegExp("^\\.("+O+")"),TAG:new RegExp("^("+O+"|[*])"),ATTR:new RegExp("^"+I),PSEUDO:new RegExp("^"+q),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+P+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},X=/^(?:input|select|textarea|button)$/i,Z=/^h\d$/i,Y=/^[^{]+\{\s*\[native \w/,Q=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,J=/[+~]/,K=new RegExp("\\\\([\\da-f]{1,6}"+M+"?|("+M+")|.)","ig"),ee=function(e,t,n){var r="0x"+t-65536;return r!=r||n?t:r<0?String.fromCharCode(r+65536):String.fromCharCode(r>>10|55296,1023&r|56320)},te=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ne=function(e,t){return t?"\0"===e?"�":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},re=function(){p()},ie=ye(function(e){return!0===e.disabled&&("form"in e||"label"in e)},{dir:"parentNode",next:"legend"});try{_.apply(L=N.call(x.childNodes),x.childNodes),L[x.childNodes.length].nodeType}catch(e){_={apply:L.length?function(e,t){D.apply(e,N.call(t))}:function(e,t){for(var n=e.length,r=0;e[n++]=t[r++];);e.length=n-1}}}function oe(e,t,r,i){var o,s,c,u,d,h,b,y=t&&t.ownerDocument,k=t?t.nodeType:9;if(r=r||[],"string"!=typeof e||!e||1!==k&&9!==k&&11!==k)return r;if(!i&&((t?t.ownerDocument||t:x)!==f&&p(t),t=t||f,m)){if(11!==k&&(d=Q.exec(e)))if(o=d[1]){if(9===k){if(!(c=t.getElementById(o)))return r;if(c.id===o)return r.push(c),r}else if(y&&(c=y.getElementById(o))&&v(t,c)&&c.id===o)return r.push(c),r}else{if(d[2])return _.apply(r,t.getElementsByTagName(e)),r;if((o=d[3])&&n.getElementsByClassName&&t.getElementsByClassName)return _.apply(r,t.getElementsByClassName(o)),r}if(n.qsa&&!T[e+" "]&&(!g||!g.test(e))){if(1!==k)y=t,b=e;else if("object"!==t.nodeName.toLowerCase()){for((u=t.getAttribute("id"))?u=u.replace(te,ne):t.setAttribute("id",u=w),s=(h=a(e)).length;s--;)h[s]="#"+u+" "+be(h[s]);b=h.join(","),y=J.test(e)&&me(t.parentNode)||t}if(b)try{return _.apply(r,y.querySelectorAll(b)),r}catch(e){}finally{u===w&&t.removeAttribute("id")}}}return l(e.replace(W,"$1"),t,r,i)}function ae(){var e=[];return function t(n,i){return e.push(n+" ")>r.cacheLength&&delete t[e.shift()],t[n+" "]=i}}function se(e){return e[w]=!0,e}function le(e){var t=f.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function ce(e,t){for(var n=e.split("|"),i=n.length;i--;)r.attrHandle[n[i]]=t}function ue(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)for(;n=n.nextSibling;)if(n===t)return-1;return e?1:-1}function de(e){return function(t){return"input"===t.nodeName.toLowerCase()&&t.type===e}}function pe(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function fe(e){return function(t){return"form"in t?t.parentNode&&!1===t.disabled?"label"in t?"label"in t.parentNode?t.parentNode.disabled===e:t.disabled===e:t.isDisabled===e||t.isDisabled!==!e&&ie(t)===e:t.disabled===e:"label"in t&&t.disabled===e}}function he(e){return se(function(t){return t=+t,se(function(n,r){for(var i,o=e([],n.length,t),a=o.length;a--;)n[i=o[a]]&&(n[i]=!(r[i]=n[i]))})})}function me(e){return e&&void 0!==e.getElementsByTagName&&e}n=oe.support={},o=oe.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return!!t&&"HTML"!==t.nodeName},p=oe.setDocument=function(e){var t,i,a=e?e.ownerDocument||e:x;return a!==f&&9===a.nodeType&&a.documentElement?(h=(f=a).documentElement,m=!o(f),x!==f&&(i=f.defaultView)&&i.top!==i&&(i.addEventListener?i.addEventListener("unload",re,!1):i.attachEvent&&i.attachEvent("onunload",re)),n.attributes=le(function(e){return e.className="i",!e.getAttribute("className")}),n.getElementsByTagName=le(function(e){return e.appendChild(f.createComment("")),!e.getElementsByTagName("*").length}),n.getElementsByClassName=Y.test(f.getElementsByClassName),n.getById=le(function(e){return h.appendChild(e).id=w,!f.getElementsByName||!f.getElementsByName(w).length}),n.getById?(r.filter.ID=function(e){var t=e.replace(K,ee);return function(e){return e.getAttribute("id")===t}},r.find.ID=function(e,t){if(void 0!==t.getElementById&&m){var n=t.getElementById(e);return n?[n]:[]}}):(r.filter.ID=function(e){var t=e.replace(K,ee);return function(e){var n=void 0!==e.getAttributeNode&&e.getAttributeNode("id");return n&&n.value===t}},r.find.ID=function(e,t){if(void 0!==t.getElementById&&m){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];for(i=t.getElementsByName(e),r=0;o=i[r++];)if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),r.find.TAG=n.getElementsByTagName?function(e,t){return void 0!==t.getElementsByTagName?t.getElementsByTagName(e):n.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){for(;n=o[i++];)1===n.nodeType&&r.push(n);return r}return o},r.find.CLASS=n.getElementsByClassName&&function(e,t){if(void 0!==t.getElementsByClassName&&m)return t.getElementsByClassName(e)},b=[],g=[],(n.qsa=Y.test(f.querySelectorAll))&&(le(function(e){h.appendChild(e).innerHTML="<a id='"+w+"'></a><select id='"+w+"-\r\\' msallowcapture=''><option selected=''></option></select>",e.querySelectorAll("[msallowcapture^='']").length&&g.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||g.push("\\["+M+"*(?:value|"+P+")"),e.querySelectorAll("[id~="+w+"-]").length||g.push("~="),e.querySelectorAll(":checked").length||g.push(":checked"),e.querySelectorAll("a#"+w+"+*").length||g.push(".#.+[+~]")}),le(function(e){e.innerHTML="<a href='' disabled='disabled'></a><select disabled='disabled'><option/></select>";var t=f.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&g.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&g.push(":enabled",":disabled"),h.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&g.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),g.push(",.*:")})),(n.matchesSelector=Y.test(y=h.matches||h.webkitMatchesSelector||h.mozMatchesSelector||h.oMatchesSelector||h.msMatchesSelector))&&le(function(e){n.disconnectedMatch=y.call(e,"*"),y.call(e,"[s!='']:x"),b.push("!=",q)}),g=g.length&&new RegExp(g.join("|")),b=b.length&&new RegExp(b.join("|")),t=Y.test(h.compareDocumentPosition),v=t||Y.test(h.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)for(;t=t.parentNode;)if(t===e)return!0;return!1},S=t?function(e,t){if(e===t)return d=!0,0;var r=!e.compareDocumentPosition-!t.compareDocumentPosition;return r||(1&(r=(e.ownerDocument||e)===(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!n.sortDetached&&t.compareDocumentPosition(e)===r?e===f||e.ownerDocument===x&&v(x,e)?-1:t===f||t.ownerDocument===x&&v(x,t)?1:u?R(u,e)-R(u,t):0:4&r?-1:1)}:function(e,t){if(e===t)return d=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e===f?-1:t===f?1:i?-1:o?1:u?R(u,e)-R(u,t):0;if(i===o)return ue(e,t);for(n=e;n=n.parentNode;)a.unshift(n);for(n=t;n=n.parentNode;)s.unshift(n);for(;a[r]===s[r];)r++;return r?ue(a[r],s[r]):a[r]===x?-1:s[r]===x?1:0},f):f},oe.matches=function(e,t){return oe(e,null,null,t)},oe.matchesSelector=function(e,t){if((e.ownerDocument||e)!==f&&p(e),t=t.replace(F,"='$1']"),n.matchesSelector&&m&&!T[t+" "]&&(!b||!b.test(t))&&(!g||!g.test(t)))try{var r=y.call(e,t);if(r||n.disconnectedMatch||e.document&&11!==e.document.nodeType)return r}catch(e){}return oe(t,f,null,[e]).length>0},oe.contains=function(e,t){return(e.ownerDocument||e)!==f&&p(e),v(e,t)},oe.attr=function(e,t){(e.ownerDocument||e)!==f&&p(e);var i=r.attrHandle[t.toLowerCase()],o=i&&A.call(r.attrHandle,t.toLowerCase())?i(e,t,!m):void 0;return void 0!==o?o:n.attributes||!m?e.getAttribute(t):(o=e.getAttributeNode(t))&&o.specified?o.value:null},oe.escape=function(e){return(e+"").replace(te,ne)},oe.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},oe.uniqueSort=function(e){var t,r=[],i=0,o=0;if(d=!n.detectDuplicates,u=!n.sortStable&&e.slice(0),e.sort(S),d){for(;t=e[o++];)t===e[o]&&(i=r.push(o));for(;i--;)e.splice(r[i],1)}return u=null,e},i=oe.getText=function(e){var t,n="",r=0,o=e.nodeType;if(o){if(1===o||9===o||11===o){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=i(e)}else if(3===o||4===o)return e.nodeValue}else for(;t=e[r++];)n+=i(t);return n},(r=oe.selectors={cacheLength:50,createPseudo:se,match:V,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(K,ee),e[3]=(e[3]||e[4]||e[5]||"").replace(K,ee),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||oe.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&oe.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return V.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&z.test(n)&&(t=a(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(K,ee).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=E[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&E(e,function(e){return t.test("string"==typeof e.className&&e.className||void 0!==e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r){var i=oe.attr(r,e);return null==i?"!="===t:!t||(i+="","="===t?i===n:"!="===t?i!==n:"^="===t?n&&0===i.indexOf(n):"*="===t?n&&i.indexOf(n)>-1:"$="===t?n&&i.slice(-n.length)===n:"~="===t?(" "+i.replace(U," ")+" ").indexOf(n)>-1:"|="===t&&(i===n||i.slice(0,n.length+1)===n+"-"))}},CHILD:function(e,t,n,r,i){var o="nth"!==e.slice(0,3),a="last"!==e.slice(-4),s="of-type"===t;return 1===r&&0===i?function(e){return!!e.parentNode}:function(t,n,l){var c,u,d,p,f,h,m=o!==a?"nextSibling":"previousSibling",g=t.parentNode,b=s&&t.nodeName.toLowerCase(),y=!l&&!s,v=!1;if(g){if(o){for(;m;){for(p=t;p=p[m];)if(s?p.nodeName.toLowerCase()===b:1===p.nodeType)return!1;h=m="only"===e&&!h&&"nextSibling"}return!0}if(h=[a?g.firstChild:g.lastChild],a&&y){for(v=(f=(c=(u=(d=(p=g)[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]||[])[0]===k&&c[1])&&c[2],p=f&&g.childNodes[f];p=++f&&p&&p[m]||(v=f=0)||h.pop();)if(1===p.nodeType&&++v&&p===t){u[e]=[k,f,v];break}}else if(y&&(v=f=(c=(u=(d=(p=t)[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]||[])[0]===k&&c[1]),!1===v)for(;(p=++f&&p&&p[m]||(v=f=0)||h.pop())&&((s?p.nodeName.toLowerCase()!==b:1!==p.nodeType)||!++v||(y&&((u=(d=p[w]||(p[w]={}))[p.uniqueID]||(d[p.uniqueID]={}))[e]=[k,v]),p!==t)););return(v-=i)===r||v%r==0&&v/r>=0}}},PSEUDO:function(e,t){var n,i=r.pseudos[e]||r.setFilters[e.toLowerCase()]||oe.error("unsupported pseudo: "+e);return i[w]?i(t):i.length>1?(n=[e,e,"",t],r.setFilters.hasOwnProperty(e.toLowerCase())?se(function(e,n){for(var r,o=i(e,t),a=o.length;a--;)e[r=R(e,o[a])]=!(n[r]=o[a])}):function(e){return i(e,0,n)}):i}},pseudos:{not:se(function(e){var t=[],n=[],r=s(e.replace(W,"$1"));return r[w]?se(function(e,t,n,i){for(var o,a=r(e,null,i,[]),s=e.length;s--;)(o=a[s])&&(e[s]=!(t[s]=o))}):function(e,i,o){return t[0]=e,r(t,null,o,n),t[0]=null,!n.pop()}}),has:se(function(e){return function(t){return oe(e,t).length>0}}),contains:se(function(e){return e=e.replace(K,ee),function(t){return(t.textContent||t.innerText||i(t)).indexOf(e)>-1}}),lang:se(function(e){return G.test(e||"")||oe.error("unsupported lang: "+e),e=e.replace(K,ee).toLowerCase(),function(t){var n;do{if(n=m?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return(n=n.toLowerCase())===e||0===n.indexOf(e+"-")}while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===h},focus:function(e){return e===f.activeElement&&(!f.hasFocus||f.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:fe(!1),disabled:fe(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!r.pseudos.empty(e)},header:function(e){return Z.test(e.nodeName)},input:function(e){return X.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:he(function(){return[0]}),last:he(function(e,t){return[t-1]}),eq:he(function(e,t,n){return[n<0?n+t:n]}),even:he(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:he(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:he(function(e,t,n){for(var r=n<0?n+t:n;--r>=0;)e.push(r);return e}),gt:he(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}}).pseudos.nth=r.pseudos.eq;for(t in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})r.pseudos[t]=de(t);for(t in{submit:!0,reset:!0})r.pseudos[t]=pe(t);function ge(){}function be(e){for(var t=0,n=e.length,r="";t<n;t++)r+=e[t].value;return r}function ye(e,t,n){var r=t.dir,i=t.next,o=i||r,a=n&&"parentNode"===o,s=C++;return t.first?function(t,n,i){for(;t=t[r];)if(1===t.nodeType||a)return e(t,n,i);return!1}:function(t,n,l){var c,u,d,p=[k,s];if(l){for(;t=t[r];)if((1===t.nodeType||a)&&e(t,n,l))return!0}else for(;t=t[r];)if(1===t.nodeType||a)if(u=(d=t[w]||(t[w]={}))[t.uniqueID]||(d[t.uniqueID]={}),i&&i===t.nodeName.toLowerCase())t=t[r]||t;else{if((c=u[o])&&c[0]===k&&c[1]===s)return p[2]=c[2];if(u[o]=p,p[2]=e(t,n,l))return!0}return!1}}function ve(e){return e.length>1?function(t,n,r){for(var i=e.length;i--;)if(!e[i](t,n,r))return!1;return!0}:e[0]}function we(e,t,n,r,i){for(var o,a=[],s=0,l=e.length,c=null!=t;s<l;s++)(o=e[s])&&(n&&!n(o,r,i)||(a.push(o),c&&t.push(s)));return a}function xe(e,t,n,r,i,o){return r&&!r[w]&&(r=xe(r)),i&&!i[w]&&(i=xe(i,o)),se(function(o,a,s,l){var c,u,d,p=[],f=[],h=a.length,m=o||function(e,t,n){for(var r=0,i=t.length;r<i;r++)oe(e,t[r],n);return n}(t||"*",s.nodeType?[s]:s,[]),g=!e||!o&&t?m:we(m,p,e,s,l),b=n?i||(o?e:h||r)?[]:a:g;if(n&&n(g,b,s,l),r)for(c=we(b,f),r(c,[],s,l),u=c.length;u--;)(d=c[u])&&(b[f[u]]=!(g[f[u]]=d));if(o){if(i||e){if(i){for(c=[],u=b.length;u--;)(d=b[u])&&c.push(g[u]=d);i(null,b=[],c,l)}for(u=b.length;u--;)(d=b[u])&&(c=i?R(o,d):p[u])>-1&&(o[c]=!(a[c]=d))}}else b=we(b===a?b.splice(h,b.length):b),i?i(null,a,b,l):_.apply(a,b)})}function ke(e){for(var t,n,i,o=e.length,a=r.relative[e[0].type],s=a||r.relative[" "],l=a?1:0,u=ye(function(e){return e===t},s,!0),d=ye(function(e){return R(t,e)>-1},s,!0),p=[function(e,n,r){var i=!a&&(r||n!==c)||((t=n).nodeType?u(e,n,r):d(e,n,r));return t=null,i}];l<o;l++)if(n=r.relative[e[l].type])p=[ye(ve(p),n)];else{if((n=r.filter[e[l].type].apply(null,e[l].matches))[w]){for(i=++l;i<o&&!r.relative[e[i].type];i++);return xe(l>1&&ve(p),l>1&&be(e.slice(0,l-1).concat({value:" "===e[l-2].type?"*":""})).replace(W,"$1"),n,l<i&&ke(e.slice(l,i)),i<o&&ke(e=e.slice(i)),i<o&&be(e))}p.push(n)}return ve(p)}return ge.prototype=r.filters=r.pseudos,r.setFilters=new ge,a=oe.tokenize=function(e,t){var n,i,o,a,s,l,c,u=$[e+" "];if(u)return t?0:u.slice(0);for(s=e,l=[],c=r.preFilter;s;){n&&!(i=H.exec(s))||(i&&(s=s.slice(i[0].length)||s),l.push(o=[])),n=!1,(i=B.exec(s))&&(n=i.shift(),o.push({value:n,type:i[0].replace(W," ")}),s=s.slice(n.length));for(a in r.filter)!(i=V[a].exec(s))||c[a]&&!(i=c[a](i))||(n=i.shift(),o.push({value:n,type:a,matches:i}),s=s.slice(n.length));if(!n)break}return t?s.length:s?oe.error(e):$(e,l).slice(0)},s=oe.compile=function(e,t){var n,i,o,s,l,u,d=[],h=[],g=T[e+" "];if(!g){for(t||(t=a(e)),n=t.length;n--;)(g=ke(t[n]))[w]?d.push(g):h.push(g);(g=T(e,(i=h,s=(o=d).length>0,l=i.length>0,u=function(e,t,n,a,u){var d,h,g,b=0,y="0",v=e&&[],w=[],x=c,C=e||l&&r.find.TAG("*",u),E=k+=null==x?1:Math.random()||.1,$=C.length;for(u&&(c=t===f||t||u);y!==$&&null!=(d=C[y]);y++){if(l&&d){for(h=0,t||d.ownerDocument===f||(p(d),n=!m);g=i[h++];)if(g(d,t||f,n)){a.push(d);break}u&&(k=E)}s&&((d=!g&&d)&&b--,e&&v.push(d))}if(b+=y,s&&y!==b){for(h=0;g=o[h++];)g(v,w,t,n);if(e){if(b>0)for(;y--;)v[y]||w[y]||(w[y]=j.call(a));w=we(w)}_.apply(a,w),u&&!e&&w.length>0&&b+o.length>1&&oe.uniqueSort(a)}return u&&(k=E,c=x),v},s?se(u):u))).selector=e}return g},l=oe.select=function(e,t,n,i){var o,l,c,u,d,p="function"==typeof e&&e,f=!i&&a(e=p.selector||e);if(n=n||[],1===f.length){if((l=f[0]=f[0].slice(0)).length>2&&"ID"===(c=l[0]).type&&9===t.nodeType&&m&&r.relative[l[1].type]){if(!(t=(r.find.ID(c.matches[0].replace(K,ee),t)||[])[0]))return n;p&&(t=t.parentNode),e=e.slice(l.shift().value.length)}for(o=V.needsContext.test(e)?0:l.length;o--&&(c=l[o],!r.relative[u=c.type]);)if((d=r.find[u])&&(i=d(c.matches[0].replace(K,ee),J.test(l[0].type)&&me(t.parentNode)||t))){if(l.splice(o,1),!(e=i.length&&be(l)))return _.apply(n,i),n;break}}return(p||s(e,f))(i,t,!m,n,!t||J.test(e)&&me(t.parentNode)||t),n},n.sortStable=w.split("").sort(S).join("")===w,n.detectDuplicates=!!d,p(),n.sortDetached=le(function(e){return 1&e.compareDocumentPosition(f.createElement("fieldset"))}),le(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||ce("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),n.attributes&&le(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||ce("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),le(function(e){return null==e.getAttribute("disabled")})||ce(P,function(e,t,n){var r;if(!n)return!0===e[t]?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),oe}(e);x.find=E,x.expr=E.selectors,x.expr[":"]=x.expr.pseudos,x.uniqueSort=x.unique=E.uniqueSort,x.text=E.getText,x.isXMLDoc=E.isXML,x.contains=E.contains,x.escapeSelector=E.escape;var $=function(e,t,n){for(var r=[],i=void 0!==n;(e=e[t])&&9!==e.nodeType;)if(1===e.nodeType){if(i&&x(e).is(n))break;r.push(e)}return r},T=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},S=x.expr.match.needsContext;function A(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var L=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,t,n){return m(t)?x.grep(e,function(e,r){return!!t.call(e,r,e)!==n}):t.nodeType?x.grep(e,function(e){return e===t!==n}):"string"!=typeof t?x.grep(e,function(e){return l.call(t,e)>-1!==n}):x.filter(t,e,n)}x.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?x.find.matchesSelector(r,e)?[r]:[]:x.find.matches(e,x.grep(t,function(e){return 1===e.nodeType}))},x.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(x(e).filter(function(){for(t=0;t<r;t++)if(x.contains(i[t],this))return!0}));for(n=this.pushStack([]),t=0;t<r;t++)x.find(e,i[t],n);return r>1?x.uniqueSort(n):n},filter:function(e){return this.pushStack(j(this,e||[],!1))},not:function(e){return this.pushStack(j(this,e||[],!0))},is:function(e){return!!j(this,"string"==typeof e&&S.test(e)?x(e):e||[],!1).length}});var D,_=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/;(x.fn.init=function(e,t,n){var i,o;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(i="<"===e[0]&&">"===e[e.length-1]&&e.length>=3?[null,e,null]:_.exec(e))||!i[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(i[1]){if(t=t instanceof x?t[0]:t,x.merge(this,x.parseHTML(i[1],t&&t.nodeType?t.ownerDocument||t:r,!0)),L.test(i[1])&&x.isPlainObject(t))for(i in t)m(this[i])?this[i](t[i]):this.attr(i,t[i]);return this}return(o=r.getElementById(i[2]))&&(this[0]=o,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(x):x.makeArray(e,this)}).prototype=x.fn,D=x(r);var N=/^(?:parents|prev(?:Until|All))/,R={children:!0,contents:!0,next:!0,prev:!0};function P(e,t){for(;(e=e[t])&&1!==e.nodeType;);return e}x.fn.extend({has:function(e){var t=x(e,this),n=t.length;return this.filter(function(){for(var e=0;e<n;e++)if(x.contains(this,t[e]))return!0})},closest:function(e,t){var n,r=0,i=this.length,o=[],a="string"!=typeof e&&x(e);if(!S.test(e))for(;r<i;r++)for(n=this[r];n&&n!==t;n=n.parentNode)if(n.nodeType<11&&(a?a.index(n)>-1:1===n.nodeType&&x.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(o.length>1?x.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?l.call(x(e),this[0]):l.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(x.uniqueSort(x.merge(this.get(),x(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),x.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return $(e,"parentNode")},parentsUntil:function(e,t,n){return $(e,"parentNode",n)},next:function(e){return P(e,"nextSibling")},prev:function(e){return P(e,"previousSibling")},nextAll:function(e){return $(e,"nextSibling")},prevAll:function(e){return $(e,"previousSibling")},nextUntil:function(e,t,n){return $(e,"nextSibling",n)},prevUntil:function(e,t,n){return $(e,"previousSibling",n)},siblings:function(e){return T((e.parentNode||{}).firstChild,e)},children:function(e){return T(e.firstChild)},contents:function(e){return A(e,"iframe")?e.contentDocument:(A(e,"template")&&(e=e.content||e),x.merge([],e.childNodes))}},function(e,t){x.fn[e]=function(n,r){var i=x.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(i=x.filter(r,i)),this.length>1&&(R[e]||x.uniqueSort(i),N.test(e)&&i.reverse()),this.pushStack(i)}});var M=/[^\x20\t\r\n\f]+/g;function O(e){return e}function I(e){throw e}function q(e,t,n,r){var i;try{e&&m(i=e.promise)?i.call(e).done(t).fail(n):e&&m(i=e.then)?i.call(e,t,n):t.apply(void 0,[e].slice(r))}catch(e){n.apply(void 0,[e])}}x.Callbacks=function(e){var t,n;e="string"==typeof e?(t=e,n={},x.each(t.match(M)||[],function(e,t){n[t]=!0}),n):x.extend({},e);var r,i,o,a,s=[],l=[],c=-1,u=function(){for(a=a||e.once,o=r=!0;l.length;c=-1)for(i=l.shift();++c<s.length;)!1===s[c].apply(i[0],i[1])&&e.stopOnFalse&&(c=s.length,i=!1);e.memory||(i=!1),r=!1,a&&(s=i?[]:"")},d={add:function(){return s&&(i&&!r&&(c=s.length-1,l.push(i)),function t(n){x.each(n,function(n,r){m(r)?e.unique&&d.has(r)||s.push(r):r&&r.length&&"string"!==v(r)&&t(r)})}(arguments),i&&!r&&u()),this},remove:function(){return x.each(arguments,function(e,t){for(var n;(n=x.inArray(t,s,n))>-1;)s.splice(n,1),n<=c&&c--}),this},has:function(e){return e?x.inArray(e,s)>-1:s.length>0},empty:function(){return s&&(s=[]),this},disable:function(){return a=l=[],s=i="",this},disabled:function(){return!s},lock:function(){return a=l=[],i||r||(s=i=""),this},locked:function(){return!!a},fireWith:function(e,t){return a||(t=[e,(t=t||[]).slice?t.slice():t],l.push(t),r||u()),this},fire:function(){return d.fireWith(this,arguments),this},fired:function(){return!!o}};return d},x.extend({Deferred:function(t){var n=[["notify","progress",x.Callbacks("memory"),x.Callbacks("memory"),2],["resolve","done",x.Callbacks("once memory"),x.Callbacks("once memory"),0,"resolved"],["reject","fail",x.Callbacks("once memory"),x.Callbacks("once memory"),1,"rejected"]],r="pending",i={state:function(){return r},always:function(){return o.done(arguments).fail(arguments),this},catch:function(e){return i.then(null,e)},pipe:function(){var e=arguments;return x.Deferred(function(t){x.each(n,function(n,r){var i=m(e[r[4]])&&e[r[4]];o[r[1]](function(){var e=i&&i.apply(this,arguments);e&&m(e.promise)?e.promise().progress(t.notify).done(t.resolve).fail(t.reject):t[r[0]+"With"](this,i?[e]:arguments)})}),e=null}).promise()},then:function(t,r,i){var o=0;function a(t,n,r,i){return function(){var s=this,l=arguments,c=function(){var e,c;if(!(t<o)){if((e=r.apply(s,l))===n.promise())throw new TypeError("Thenable self-resolution");c=e&&("object"==typeof e||"function"==typeof e)&&e.then,m(c)?i?c.call(e,a(o,n,O,i),a(o,n,I,i)):(o++,c.call(e,a(o,n,O,i),a(o,n,I,i),a(o,n,O,n.notifyWith))):(r!==O&&(s=void 0,l=[e]),(i||n.resolveWith)(s,l))}},u=i?c:function(){try{c()}catch(e){x.Deferred.exceptionHook&&x.Deferred.exceptionHook(e,u.stackTrace),t+1>=o&&(r!==I&&(s=void 0,l=[e]),n.rejectWith(s,l))}};t?u():(x.Deferred.getStackHook&&(u.stackTrace=x.Deferred.getStackHook()),e.setTimeout(u))}}return x.Deferred(function(e){n[0][3].add(a(0,e,m(i)?i:O,e.notifyWith)),n[1][3].add(a(0,e,m(t)?t:O)),n[2][3].add(a(0,e,m(r)?r:I))}).promise()},promise:function(e){return null!=e?x.extend(e,i):i}},o={};return x.each(n,function(e,t){var a=t[2],s=t[5];i[t[1]]=a.add,s&&a.add(function(){r=s},n[3-e][2].disable,n[3-e][3].disable,n[0][2].lock,n[0][3].lock),a.add(t[3].fire),o[t[0]]=function(){return o[t[0]+"With"](this===o?void 0:this,arguments),this},o[t[0]+"With"]=a.fireWith}),i.promise(o),t&&t.call(o,o),o},when:function(e){var t=arguments.length,n=t,r=Array(n),i=o.call(arguments),a=x.Deferred(),s=function(e){return function(n){r[e]=this,i[e]=arguments.length>1?o.call(arguments):n,--t||a.resolveWith(r,i)}};if(t<=1&&(q(e,a.done(s(n)).resolve,a.reject,!t),"pending"===a.state()||m(i[n]&&i[n].then)))return a.then();for(;n--;)q(i[n],s(n),a.reject);return a.promise()}});var U=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;x.Deferred.exceptionHook=function(t,n){e.console&&e.console.warn&&t&&U.test(t.name)&&e.console.warn("jQuery.Deferred exception: "+t.message,t.stack,n)},x.readyException=function(t){e.setTimeout(function(){throw t})};var W=x.Deferred();function H(){r.removeEventListener("DOMContentLoaded",H),e.removeEventListener("load",H),x.ready()}x.fn.ready=function(e){return W.then(e).catch(function(e){x.readyException(e)}),this},x.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--x.readyWait:x.isReady)||(x.isReady=!0,!0!==e&&--x.readyWait>0||W.resolveWith(r,[x]))}}),x.ready.then=W.then,"complete"===r.readyState||"loading"!==r.readyState&&!r.documentElement.doScroll?e.setTimeout(x.ready):(r.addEventListener("DOMContentLoaded",H),e.addEventListener("load",H));var B=function(e,t,n,r,i,o,a){var s=0,l=e.length,c=null==n;if("object"===v(n)){i=!0;for(s in n)B(e,t,s,n[s],!0,o,a)}else if(void 0!==r&&(i=!0,m(r)||(a=!0),c&&(a?(t.call(e,r),t=null):(c=t,t=function(e,t,n){return c.call(x(e),n)})),t))for(;s<l;s++)t(e[s],n,a?r:r.call(e[s],s,t(e[s],n)));return i?e:c?t.call(e):l?t(e[0],n):o},F=/^-ms-/,z=/-([a-z])/g;function G(e,t){return t.toUpperCase()}function V(e){return e.replace(F,"ms-").replace(z,G)}var X=function(e){return 1===e.nodeType||9===e.nodeType||!+e.nodeType};function Z(){this.expando=x.expando+Z.uid++}Z.uid=1,Z.prototype={cache:function(e){var t=e[this.expando];return t||(t={},X(e)&&(e.nodeType?e[this.expando]=t:Object.defineProperty(e,this.expando,{value:t,configurable:!0}))),t},set:function(e,t,n){var r,i=this.cache(e);if("string"==typeof t)i[V(t)]=n;else for(r in t)i[V(r)]=t[r];return i},get:function(e,t){return void 0===t?this.cache(e):e[this.expando]&&e[this.expando][V(t)]},access:function(e,t,n){return void 0===t||t&&"string"==typeof t&&void 0===n?this.get(e,t):(this.set(e,t,n),void 0!==n?n:t)},remove:function(e,t){var n,r=e[this.expando];if(void 0!==r){if(void 0!==t){n=(t=Array.isArray(t)?t.map(V):(t=V(t))in r?[t]:t.match(M)||[]).length;for(;n--;)delete r[t[n]]}(void 0===t||x.isEmptyObject(r))&&(e.nodeType?e[this.expando]=void 0:delete e[this.expando])}},hasData:function(e){var t=e[this.expando];return void 0!==t&&!x.isEmptyObject(t)}};var Y=new Z,Q=new Z,J=/^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,K=/[A-Z]/g;function ee(e,t,n){var r,i;if(void 0===n&&1===e.nodeType)if(r="data-"+t.replace(K,"-$&").toLowerCase(),"string"==typeof(n=e.getAttribute(r))){try{n="true"===(i=n)||"false"!==i&&("null"===i?null:i===+i+""?+i:J.test(i)?JSON.parse(i):i)}catch(e){}Q.set(e,t,n)}else n=void 0;return n}x.extend({hasData:function(e){return Q.hasData(e)||Y.hasData(e)},data:function(e,t,n){return Q.access(e,t,n)},removeData:function(e,t){Q.remove(e,t)},_data:function(e,t,n){return Y.access(e,t,n)},_removeData:function(e,t){Y.remove(e,t)}}),x.fn.extend({data:function(e,t){var n,r,i,o=this[0],a=o&&o.attributes;if(void 0===e){if(this.length&&(i=Q.get(o),1===o.nodeType&&!Y.get(o,"hasDataAttrs"))){for(n=a.length;n--;)a[n]&&0===(r=a[n].name).indexOf("data-")&&(r=V(r.slice(5)),ee(o,r,i[r]));Y.set(o,"hasDataAttrs",!0)}return i}return"object"==typeof e?this.each(function(){Q.set(this,e)}):B(this,function(t){var n;if(o&&void 0===t)return void 0!==(n=Q.get(o,e))?n:void 0!==(n=ee(o,e))?n:void 0;this.each(function(){Q.set(this,e,t)})},null,t,arguments.length>1,null,!0)},removeData:function(e){return this.each(function(){Q.remove(this,e)})}}),x.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Y.get(e,t),n&&(!r||Array.isArray(n)?r=Y.access(e,t,x.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=x.queue(e,t),r=n.length,i=n.shift(),o=x._queueHooks(e,t);"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,function(){x.dequeue(e,t)},o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Y.get(e,n)||Y.access(e,n,{empty:x.Callbacks("once memory").add(function(){Y.remove(e,[t+"queue",n])})})}}),x.fn.extend({queue:function(e,t){var n=2;return"string"!=typeof e&&(t=e,e="fx",n--),arguments.length<n?x.queue(this[0],e):void 0===t?this:this.each(function(){var n=x.queue(this,e,t);x._queueHooks(this,e),"fx"===e&&"inprogress"!==n[0]&&x.dequeue(this,e)})},dequeue:function(e){return this.each(function(){x.dequeue(this,e)})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,t){var n,r=1,i=x.Deferred(),o=this,a=this.length,s=function(){--r||i.resolveWith(o,[o])};for("string"!=typeof e&&(t=e,e=void 0),e=e||"fx";a--;)(n=Y.get(o[a],e+"queueHooks"))&&n.empty&&(r++,n.empty.add(s));return s(),i.promise(t)}});var te=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,ne=new RegExp("^(?:([+-])=|)("+te+")([a-z%]*)$","i"),re=["Top","Right","Bottom","Left"],ie=function(e,t){return"none"===(e=t||e).style.display||""===e.style.display&&x.contains(e.ownerDocument,e)&&"none"===x.css(e,"display")},oe=function(e,t,n,r){var i,o,a={};for(o in t)a[o]=e.style[o],e.style[o]=t[o];i=n.apply(e,r||[]);for(o in t)e.style[o]=a[o];return i};var ae={};function se(e,t){for(var n,r,i,o,a,s,l,c=[],u=0,d=e.length;u<d;u++)(r=e[u]).style&&(n=r.style.display,t?("none"===n&&(c[u]=Y.get(r,"display")||null,c[u]||(r.style.display="")),""===r.style.display&&ie(r)&&(c[u]=(o=void 0,a=void 0,void 0,l=void 0,a=(i=r).ownerDocument,s=i.nodeName,(l=ae[s])||(o=a.body.appendChild(a.createElement(s)),l=x.css(o,"display"),o.parentNode.removeChild(o),"none"===l&&(l="block"),ae[s]=l,l)))):"none"!==n&&(c[u]="none",Y.set(r,"display",n)));for(u=0;u<d;u++)null!=c[u]&&(e[u].style.display=c[u]);return e}x.fn.extend({show:function(){return se(this,!0)},hide:function(){return se(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){ie(this)?x(this).show():x(this).hide()})}});var le=/^(?:checkbox|radio)$/i,ce=/<([a-z][^\/\0>\x20\t\r\n\f]+)/i,ue=/^$|^module$|\/(?:java|ecma)script/i,de={option:[1,"<select multiple='multiple'>","</select>"],thead:[1,"<table>","</table>"],col:[2,"<table><colgroup>","</colgroup></table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:[0,"",""]};function pe(e,t){var n;return n=void 0!==e.getElementsByTagName?e.getElementsByTagName(t||"*"):void 0!==e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&A(e,t)?x.merge([e],n):n}function fe(e,t){for(var n=0,r=e.length;n<r;n++)Y.set(e[n],"globalEval",!t||Y.get(t[n],"globalEval"))}de.optgroup=de.option,de.tbody=de.tfoot=de.colgroup=de.caption=de.thead,de.th=de.td;var he,me,ge=/<|&#?\w+;/;function be(e,t,n,r,i){for(var o,a,s,l,c,u,d=t.createDocumentFragment(),p=[],f=0,h=e.length;f<h;f++)if((o=e[f])||0===o)if("object"===v(o))x.merge(p,o.nodeType?[o]:o);else if(ge.test(o)){for(a=a||d.appendChild(t.createElement("div")),s=(ce.exec(o)||["",""])[1].toLowerCase(),l=de[s]||de._default,a.innerHTML=l[1]+x.htmlPrefilter(o)+l[2],u=l[0];u--;)a=a.lastChild;x.merge(p,a.childNodes),(a=d.firstChild).textContent=""}else p.push(t.createTextNode(o));for(d.textContent="",f=0;o=p[f++];)if(r&&x.inArray(o,r)>-1)i&&i.push(o);else if(c=x.contains(o.ownerDocument,o),a=pe(d.appendChild(o),"script"),c&&fe(a),n)for(u=0;o=a[u++];)ue.test(o.type||"")&&n.push(o);return d}he=r.createDocumentFragment().appendChild(r.createElement("div")),(me=r.createElement("input")).setAttribute("type","radio"),me.setAttribute("checked","checked"),me.setAttribute("name","t"),he.appendChild(me),h.checkClone=he.cloneNode(!0).cloneNode(!0).lastChild.checked,he.innerHTML="<textarea>x</textarea>",h.noCloneChecked=!!he.cloneNode(!0).lastChild.defaultValue;var ye=r.documentElement,ve=/^key/,we=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,xe=/^([^.]*)(?:\.(.+)|)/;function ke(){return!0}function Ce(){return!1}function Ee(){try{return r.activeElement}catch(e){}}function $e(e,t,n,r,i,o){var a,s;if("object"==typeof t){"string"!=typeof n&&(r=r||n,n=void 0);for(s in t)$e(e,s,n,r,t[s],o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=Ce;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return x().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=x.guid++)),e.each(function(){x.event.add(this,t,i,r,n)})}x.event={global:{},add:function(e,t,n,r,i){var o,a,s,l,c,u,d,p,f,h,m,g=Y.get(e);if(g)for(n.handler&&(n=(o=n).handler,i=o.selector),i&&x.find.matchesSelector(ye,i),n.guid||(n.guid=x.guid++),(l=g.events)||(l=g.events={}),(a=g.handle)||(a=g.handle=function(t){return void 0!==x&&x.event.triggered!==t.type?x.event.dispatch.apply(e,arguments):void 0}),c=(t=(t||"").match(M)||[""]).length;c--;)f=m=(s=xe.exec(t[c])||[])[1],h=(s[2]||"").split(".").sort(),f&&(d=x.event.special[f]||{},f=(i?d.delegateType:d.bindType)||f,d=x.event.special[f]||{},u=x.extend({type:f,origType:m,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&x.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=l[f])||((p=l[f]=[]).delegateCount=0,d.setup&&!1!==d.setup.call(e,r,h,a)||e.addEventListener&&e.addEventListener(f,a)),d.add&&(d.add.call(e,u),u.handler.guid||(u.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,u):p.push(u),x.event.global[f]=!0)},remove:function(e,t,n,r,i){var o,a,s,l,c,u,d,p,f,h,m,g=Y.hasData(e)&&Y.get(e);if(g&&(l=g.events)){for(c=(t=(t||"").match(M)||[""]).length;c--;)if(f=m=(s=xe.exec(t[c])||[])[1],h=(s[2]||"").split(".").sort(),f){for(d=x.event.special[f]||{},p=l[f=(r?d.delegateType:d.bindType)||f]||[],s=s[2]&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;o--;)u=p[o],!i&&m!==u.origType||n&&n.guid!==u.guid||s&&!s.test(u.namespace)||r&&r!==u.selector&&("**"!==r||!u.selector)||(p.splice(o,1),u.selector&&p.delegateCount--,d.remove&&d.remove.call(e,u));a&&!p.length&&(d.teardown&&!1!==d.teardown.call(e,h,g.handle)||x.removeEvent(e,f,g.handle),delete l[f])}else for(f in l)x.event.remove(e,f+t[c],n,r,!0);x.isEmptyObject(l)&&Y.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=x.event.fix(e),l=new Array(arguments.length),c=(Y.get(this,"events")||{})[s.type]||[],u=x.event.special[s.type]||{};for(l[0]=s,t=1;t<arguments.length;t++)l[t]=arguments[t];if(s.delegateTarget=this,!u.preDispatch||!1!==u.preDispatch.call(this,s)){for(a=x.event.handlers.call(this,s,c),t=0;(i=a[t++])&&!s.isPropagationStopped();)for(s.currentTarget=i.elem,n=0;(o=i.handlers[n++])&&!s.isImmediatePropagationStopped();)s.rnamespace&&!s.rnamespace.test(o.namespace)||(s.handleObj=o,s.data=o.data,void 0!==(r=((x.event.special[o.origType]||{}).handle||o.handler).apply(i.elem,l))&&!1===(s.result=r)&&(s.preventDefault(),s.stopPropagation()));return u.postDispatch&&u.postDispatch.call(this,s),s.result}},handlers:function(e,t){var n,r,i,o,a,s=[],l=t.delegateCount,c=e.target;if(l&&c.nodeType&&!("click"===e.type&&e.button>=1))for(;c!==this;c=c.parentNode||this)if(1===c.nodeType&&("click"!==e.type||!0!==c.disabled)){for(o=[],a={},n=0;n<l;n++)void 0===a[i=(r=t[n]).selector+" "]&&(a[i]=r.needsContext?x(i,this).index(c)>-1:x.find(i,this,null,[c]).length),a[i]&&o.push(r);o.length&&s.push({elem:c,handlers:o})}return c=this,l<t.length&&s.push({elem:c,handlers:t.slice(l)}),s},addProp:function(e,t){Object.defineProperty(x.Event.prototype,e,{enumerable:!0,configurable:!0,get:m(t)?function(){if(this.originalEvent)return t(this.originalEvent)}:function(){if(this.originalEvent)return this.originalEvent[e]},set:function(t){Object.defineProperty(this,e,{enumerable:!0,configurable:!0,writable:!0,value:t})}})},fix:function(e){return e[x.expando]?e:new x.Event(e)},special:{load:{noBubble:!0},focus:{trigger:function(){if(this!==Ee()&&this.focus)return this.focus(),!1},delegateType:"focusin"},blur:{trigger:function(){if(this===Ee()&&this.blur)return this.blur(),!1},delegateType:"focusout"},click:{trigger:function(){if("checkbox"===this.type&&this.click&&A(this,"input"))return this.click(),!1},_default:function(e){return A(e.target,"a")}},beforeunload:{postDispatch:function(e){void 0!==e.result&&e.originalEvent&&(e.originalEvent.returnValue=e.result)}}}},x.removeEvent=function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n)},x.Event=function(e,t){if(!(this instanceof x.Event))return new x.Event(e,t);e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||void 0===e.defaultPrevented&&!1===e.returnValue?ke:Ce,this.target=e.target&&3===e.target.nodeType?e.target.parentNode:e.target,this.currentTarget=e.currentTarget,this.relatedTarget=e.relatedTarget):this.type=e,t&&x.extend(this,t),this.timeStamp=e&&e.timeStamp||Date.now(),this[x.expando]=!0},x.Event.prototype={constructor:x.Event,isDefaultPrevented:Ce,isPropagationStopped:Ce,isImmediatePropagationStopped:Ce,isSimulated:!1,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=ke,e&&!this.isSimulated&&e.preventDefault()},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=ke,e&&!this.isSimulated&&e.stopPropagation()},stopImmediatePropagation:function(){var e=this.originalEvent;this.isImmediatePropagationStopped=ke,e&&!this.isSimulated&&e.stopImmediatePropagation(),this.stopPropagation()}},x.each({altKey:!0,bubbles:!0,cancelable:!0,changedTouches:!0,ctrlKey:!0,detail:!0,eventPhase:!0,metaKey:!0,pageX:!0,pageY:!0,shiftKey:!0,view:!0,char:!0,charCode:!0,key:!0,keyCode:!0,button:!0,buttons:!0,clientX:!0,clientY:!0,offsetX:!0,offsetY:!0,pointerId:!0,pointerType:!0,screenX:!0,screenY:!0,targetTouches:!0,toElement:!0,touches:!0,which:function(e){var t=e.button;return null==e.which&&ve.test(e.type)?null!=e.charCode?e.charCode:e.keyCode:!e.which&&void 0!==t&&we.test(e.type)?1&t?1:2&t?3:4&t?2:0:e.which}},x.event.addProp),x.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(e,t){x.event.special[e]={delegateType:t,bindType:t,handle:function(e){var n,r=e.relatedTarget,i=e.handleObj;return r&&(r===this||x.contains(this,r))||(e.type=i.origType,n=i.handler.apply(this,arguments),e.type=t),n}}}),x.fn.extend({on:function(e,t,n,r){return $e(this,e,t,n,r)},one:function(e,t,n,r){return $e(this,e,t,n,r,1)},off:function(e,t,n){var r,i;if(e&&e.preventDefault&&e.handleObj)return r=e.handleObj,x(e.delegateTarget).off(r.namespace?r.origType+"."+r.namespace:r.origType,r.selector,r.handler),this;if("object"==typeof e){for(i in e)this.off(i,t,e[i]);return this}return!1!==t&&"function"!=typeof t||(n=t,t=void 0),!1===n&&(n=Ce),this.each(function(){x.event.remove(this,e,n,t)})}});var Te=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([a-z][^\/\0>\x20\t\r\n\f]*)[^>]*)\/>/gi,Se=/<script|<style|<link/i,Ae=/checked\s*(?:[^=]|=\s*.checked.)/i,Le=/^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&x(e).children("tbody")[0]||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function _e(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Ne(e,t){var n,r,i,o,a,s,l,c;if(1===t.nodeType){if(Y.hasData(e)&&(o=Y.access(e),a=Y.set(t,o),c=o.events)){delete a.handle,a.events={};for(i in c)for(n=0,r=c[i].length;n<r;n++)x.event.add(t,i,c[i][n])}Q.hasData(e)&&(s=Q.access(e),l=x.extend({},s),Q.set(t,l))}}function Re(e,t,n,r){t=a.apply([],t);var i,o,s,l,c,u,d=0,p=e.length,f=p-1,g=t[0],b=m(g);if(b||p>1&&"string"==typeof g&&!h.checkClone&&Ae.test(g))return e.each(function(i){var o=e.eq(i);b&&(t[0]=g.call(this,i,o.html())),Re(o,t,n,r)});if(p&&(o=(i=be(t,e[0].ownerDocument,!1,e,r)).firstChild,1===i.childNodes.length&&(i=o),o||r)){for(l=(s=x.map(pe(i,"script"),De)).length;d<p;d++)c=i,d!==f&&(c=x.clone(c,!0,!0),l&&x.merge(s,pe(c,"script"))),n.call(e[d],c,d);if(l)for(u=s[s.length-1].ownerDocument,x.map(s,_e),d=0;d<l;d++)c=s[d],ue.test(c.type||"")&&!Y.access(c,"globalEval")&&x.contains(u,c)&&(c.src&&"module"!==(c.type||"").toLowerCase()?x._evalUrl&&x._evalUrl(c.src):y(c.textContent.replace(Le,""),u,c))}return e}function Pe(e,t,n){for(var r,i=t?x.filter(t,e):e,o=0;null!=(r=i[o]);o++)n||1!==r.nodeType||x.cleanData(pe(r)),r.parentNode&&(n&&x.contains(r.ownerDocument,r)&&fe(pe(r,"script")),r.parentNode.removeChild(r));return e}x.extend({htmlPrefilter:function(e){return e.replace(Te,"<$1></$2>")},clone:function(e,t,n){var r,i,o,a,s,l,c,u=e.cloneNode(!0),d=x.contains(e.ownerDocument,e);if(!(h.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||x.isXMLDoc(e)))for(a=pe(u),r=0,i=(o=pe(e)).length;r<i;r++)s=o[r],l=a[r],void 0,"input"===(c=l.nodeName.toLowerCase())&&le.test(s.type)?l.checked=s.checked:"input"!==c&&"textarea"!==c||(l.defaultValue=s.defaultValue);if(t)if(n)for(o=o||pe(e),a=a||pe(u),r=0,i=o.length;r<i;r++)Ne(o[r],a[r]);else Ne(e,u);return(a=pe(u,"script")).length>0&&fe(a,!d&&pe(e,"script")),u},cleanData:function(e){for(var t,n,r,i=x.event.special,o=0;void 0!==(n=e[o]);o++)if(X(n)){if(t=n[Y.expando]){if(t.events)for(r in t.events)i[r]?x.event.remove(n,r):x.removeEvent(n,r,t.handle);n[Y.expando]=void 0}n[Q.expando]&&(n[Q.expando]=void 0)}}}),x.fn.extend({detach:function(e){return Pe(this,e,!0)},remove:function(e){return Pe(this,e)},text:function(e){return B(this,function(e){return void 0===e?x.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return Re(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||je(this,e).appendChild(e)})},prepend:function(){return Re(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=je(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(x.cleanData(pe(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return x.clone(this,e,t)})},html:function(e){return B(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!Se.test(e)&&!de[(ce.exec(e)||["",""])[1].toLowerCase()]){e=x.htmlPrefilter(e);try{for(;n<r;n++)1===(t=this[n]||{}).nodeType&&(x.cleanData(pe(t,!1)),t.innerHTML=e);t=0}catch(e){}}t&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var e=[];return Re(this,arguments,function(t){var n=this.parentNode;x.inArray(this,e)<0&&(x.cleanData(pe(this)),n&&n.replaceChild(t,this))},e)}}),x.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,t){x.fn[e]=function(e){for(var n,r=[],i=x(e),o=i.length-1,a=0;a<=o;a++)n=a===o?this:this.clone(!0),x(i[a])[t](n),s.apply(r,n.get());return this.pushStack(r)}});var Me=new RegExp("^("+te+")(?!px)[a-z%]+$","i"),Oe=function(t){var n=t.ownerDocument.defaultView;return n&&n.opener||(n=e),n.getComputedStyle(t)},Ie=new RegExp(re.join("|"),"i");function qe(e,t,n){var r,i,o,a,s=e.style;return(n=n||Oe(e))&&(""!==(a=n.getPropertyValue(t)||n[t])||x.contains(e.ownerDocument,e)||(a=x.style(e,t)),!h.pixelBoxStyles()&&Me.test(a)&&Ie.test(t)&&(r=s.width,i=s.minWidth,o=s.maxWidth,s.minWidth=s.maxWidth=s.width=a,a=n.width,s.width=r,s.minWidth=i,s.maxWidth=o)),void 0!==a?a+"":a}function Ue(e,t){return{get:function(){if(!e())return(this.get=t).apply(this,arguments);delete this.get}}}!function(){function t(){if(u){c.style.cssText="position:absolute;left:-11111px;width:60px;margin-top:1px;padding:0;border:0",u.style.cssText="position:relative;display:block;box-sizing:border-box;overflow:scroll;margin:auto;border:1px;padding:1px;width:60%;top:1%",ye.appendChild(c).appendChild(u);var t=e.getComputedStyle(u);i="1%"!==t.top,l=12===n(t.marginLeft),u.style.right="60%",s=36===n(t.right),o=36===n(t.width),u.style.position="absolute",a=36===u.offsetWidth||"absolute",ye.removeChild(c),u=null}}function n(e){return Math.round(parseFloat(e))}var i,o,a,s,l,c=r.createElement("div"),u=r.createElement("div");u.style&&(u.style.backgroundClip="content-box",u.cloneNode(!0).style.backgroundClip="",h.clearCloneStyle="content-box"===u.style.backgroundClip,x.extend(h,{boxSizingReliable:function(){return t(),o},pixelBoxStyles:function(){return t(),s},pixelPosition:function(){return t(),i},reliableMarginLeft:function(){return t(),l},scrollboxSize:function(){return t(),a}}))}();var We,He,Be=/^(none|table(?!-c[ea]).+)/,Fe=/^--/,ze={position:"absolute",visibility:"hidden",display:"block"},Ge={letterSpacing:"0",fontWeight:"400"},Ve=["Webkit","Moz","ms"],Xe=r.createElement("div").style;function Ze(e){var t=x.cssProps[e];return t||(t=x.cssProps[e]=function(e){if(e in Xe)return e;for(var t=e[0].toUpperCase()+e.slice(1),n=Ve.length;n--;)if((e=Ve[n]+t)in Xe)return e}(e)||e),t}function Ye(e,t,n){var r=ne.exec(t);return r?Math.max(0,r[2]-(n||0))+(r[3]||"px"):t}function Qe(e,t,n,r,i,o){var a="width"===t?1:0,s=0,l=0;if(n===(r?"border":"content"))return 0;for(;a<4;a+=2)"margin"===n&&(l+=x.css(e,n+re[a],!0,i)),r?("content"===n&&(l-=x.css(e,"padding"+re[a],!0,i)),"margin"!==n&&(l-=x.css(e,"border"+re[a]+"Width",!0,i))):(l+=x.css(e,"padding"+re[a],!0,i),"padding"!==n?l+=x.css(e,"border"+re[a]+"Width",!0,i):s+=x.css(e,"border"+re[a]+"Width",!0,i));return!r&&o>=0&&(l+=Math.max(0,Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-o-l-s-.5))),l}function Je(e,t,n){var r=Oe(e),i=qe(e,t,r),o="border-box"===x.css(e,"boxSizing",!1,r),a=o;if(Me.test(i)){if(!n)return i;i="auto"}return a=a&&(h.boxSizingReliable()||i===e.style[t]),("auto"===i||!parseFloat(i)&&"inline"===x.css(e,"display",!1,r))&&(i=e["offset"+t[0].toUpperCase()+t.slice(1)],a=!0),(i=parseFloat(i)||0)+Qe(e,t,n||(o?"border":"content"),a,r,i)+"px"}x.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=qe(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=V(t),l=Fe.test(t),c=e.style;if(l||(t=Ze(s)),a=x.cssHooks[t]||x.cssHooks[s],void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:c[t];"string"===(o=typeof n)&&(i=ne.exec(n))&&i[1]&&(n=function(e,t,n,r){var i,o,a=20,s=r?function(){return r.cur()}:function(){return x.css(e,t,"")},l=s(),c=n&&n[3]||(x.cssNumber[t]?"":"px"),u=(x.cssNumber[t]||"px"!==c&&+l)&&ne.exec(x.css(e,t));if(u&&u[3]!==c){for(l/=2,c=c||u[3],u=+l||1;a--;)x.style(e,t,u+c),(1-o)*(1-(o=s()/l||.5))<=0&&(a=0),u/=o;u*=2,x.style(e,t,u+c),n=n||[]}return n&&(u=+u||+l||0,i=n[1]?u+(n[1]+1)*n[2]:+n[2],r&&(r.unit=c,r.start=u,r.end=i)),i}(e,t,i),o="number"),null!=n&&n==n&&("number"===o&&(n+=i&&i[3]||(x.cssNumber[s]?"":"px")),h.clearCloneStyle||""!==n||0!==t.indexOf("background")||(c[t]="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(l?c.setProperty(t,n):c[t]=n))}},css:function(e,t,n,r){var i,o,a,s=V(t);return Fe.test(t)||(t=Ze(s)),(a=x.cssHooks[t]||x.cssHooks[s])&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=qe(e,t,r)),"normal"===i&&t in Ge&&(i=Ge[t]),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),x.each(["height","width"],function(e,t){x.cssHooks[t]={get:function(e,n,r){if(n)return!Be.test(x.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?Je(e,t,r):oe(e,ze,function(){return Je(e,t,r)})},set:function(e,n,r){var i,o=Oe(e),a="border-box"===x.css(e,"boxSizing",!1,o),s=r&&Qe(e,t,r,a,o);return a&&h.scrollboxSize()===o.position&&(s-=Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-parseFloat(o[t])-Qe(e,t,"border",!1,o)-.5)),s&&(i=ne.exec(n))&&"px"!==(i[3]||"px")&&(e.style[t]=n,n=x.css(e,t)),Ye(0,n,s)}}}),x.cssHooks.marginLeft=Ue(h.reliableMarginLeft,function(e,t){if(t)return(parseFloat(qe(e,"marginLeft"))||e.getBoundingClientRect().left-oe(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),x.each({margin:"",padding:"",border:"Width"},function(e,t){x.cssHooks[e+t]={expand:function(n){for(var r=0,i={},o="string"==typeof n?n.split(" "):[n];r<4;r++)i[e+re[r]+t]=o[r]||o[r-2]||o[0];return i}},"margin"!==e&&(x.cssHooks[e+t].set=Ye)}),x.fn.extend({css:function(e,t){return B(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=Oe(e),i=t.length;a<i;a++)o[t[a]]=x.css(e,t[a],!1,r);return o}return void 0!==n?x.style(e,t,n):x.css(e,t)},e,t,arguments.length>1)}}),x.fn.delay=function(t,n){return t=x.fx&&x.fx.speeds[t]||t,n=n||"fx",this.queue(n,function(n,r){var i=e.setTimeout(n,t);r.stop=function(){e.clearTimeout(i)}})},We=r.createElement("input"),He=r.createElement("select").appendChild(r.createElement("option")),We.type="checkbox",h.checkOn=""!==We.value,h.optSelected=He.selected,(We=r.createElement("input")).value="t",We.type="radio",h.radioValue="t"===We.value;var Ke,et=x.expr.attrHandle;x.fn.extend({attr:function(e,t){return B(this,x.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){x.removeAttr(this,e)})}}),x.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return void 0===e.getAttribute?x.prop(e,t,n):(1===o&&x.isXMLDoc(e)||(i=x.attrHooks[t.toLowerCase()]||(x.expr.match.bool.test(t)?Ke:void 0)),void 0!==n?null===n?void x.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=x.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!h.radioValue&&"radio"===t&&A(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(M);if(i&&1===e.nodeType)for(;n=i[r++];)e.removeAttribute(n)}}),Ke={set:function(e,t,n){return!1===t?x.removeAttr(e,n):e.setAttribute(n,n),n}},x.each(x.expr.match.bool.source.match(/\w+/g),function(e,t){var n=et[t]||x.find.attr;et[t]=function(e,t,r){var i,o,a=t.toLowerCase();return r||(o=et[a],et[a]=i,i=null!=n(e,t,r)?a:null,et[a]=o),i}});var tt=/^(?:input|select|textarea|button)$/i,nt=/^(?:a|area)$/i;function rt(e){return(e.match(M)||[]).join(" ")}function it(e){return e.getAttribute&&e.getAttribute("class")||""}function ot(e){return Array.isArray(e)?e:"string"==typeof e&&e.match(M)||[]}x.fn.extend({prop:function(e,t){return B(this,x.prop,e,t,arguments.length>1)},removeProp:function(e){return this.each(function(){delete this[x.propFix[e]||e]})}}),x.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&x.isXMLDoc(e)||(t=x.propFix[t]||t,i=x.propHooks[t]),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=x.find.attr(e,"tabindex");return t?parseInt(t,10):tt.test(e.nodeName)||nt.test(e.nodeName)&&e.href?0:-1}}},propFix:{for:"htmlFor",class:"className"}}),h.optSelected||(x.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),x.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){x.propFix[this.toLowerCase()]=this}),x.fn.extend({addClass:function(e){var t,n,r,i,o,a,s,l=0;if(m(e))return this.each(function(t){x(this).addClass(e.call(this,t,it(this)))});if((t=ot(e)).length)for(;n=this[l++];)if(i=it(n),r=1===n.nodeType&&" "+rt(i)+" "){for(a=0;o=t[a++];)r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=rt(r))&&n.setAttribute("class",s)}return this},removeClass:function(e){var t,n,r,i,o,a,s,l=0;if(m(e))return this.each(function(t){x(this).removeClass(e.call(this,t,it(this)))});if(!arguments.length)return this.attr("class","");if((t=ot(e)).length)for(;n=this[l++];)if(i=it(n),r=1===n.nodeType&&" "+rt(i)+" "){for(a=0;o=t[a++];)for(;r.indexOf(" "+o+" ")>-1;)r=r.replace(" "+o+" "," ");i!==(s=rt(r))&&n.setAttribute("class",s)}return this},toggleClass:function(e,t){var n=typeof e,r="string"===n||Array.isArray(e);return"boolean"==typeof t&&r?t?this.addClass(e):this.removeClass(e):m(e)?this.each(function(n){x(this).toggleClass(e.call(this,n,it(this),t),t)}):this.each(function(){var t,i,o,a;if(r)for(i=0,o=x(this),a=ot(e);t=a[i++];)o.hasClass(t)?o.removeClass(t):o.addClass(t);else void 0!==e&&"boolean"!==n||((t=it(this))&&Y.set(this,"__className__",t),this.setAttribute&&this.setAttribute("class",t||!1===e?"":Y.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;for(t=" "+e+" ";n=this[r++];)if(1===n.nodeType&&(" "+rt(it(n))+" ").indexOf(t)>-1)return!0;return!1}});var at=/\r/g;x.fn.extend({val:function(e){var t,n,r,i=this[0];return arguments.length?(r=m(e),this.each(function(n){var i;1===this.nodeType&&(null==(i=r?e.call(this,n,x(this).val()):e)?i="":"number"==typeof i?i+="":Array.isArray(i)&&(i=x.map(i,function(e){return null==e?"":e+""})),(t=x.valHooks[this.type]||x.valHooks[this.nodeName.toLowerCase()])&&"set"in t&&void 0!==t.set(this,i,"value")||(this.value=i))})):i?(t=x.valHooks[i.type]||x.valHooks[i.nodeName.toLowerCase()])&&"get"in t&&void 0!==(n=t.get(i,"value"))?n:"string"==typeof(n=i.value)?n.replace(at,""):null==n?"":n:void 0}}),x.extend({valHooks:{option:{get:function(e){var t=x.find.attr(e,"value");return null!=t?t:rt(x.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:[],l=a?o+1:i.length;for(r=o<0?l:a?o:0;r<l;r++)if(((n=i[r]).selected||r===o)&&!n.disabled&&(!n.parentNode.disabled||!A(n.parentNode,"optgroup"))){if(t=x(n).val(),a)return t;s.push(t)}return s},set:function(e,t){for(var n,r,i=e.options,o=x.makeArray(t),a=i.length;a--;)((r=i[a]).selected=x.inArray(x.valHooks.option.get(r),o)>-1)&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),x.each(["radio","checkbox"],function(){x.valHooks[this]={set:function(e,t){if(Array.isArray(t))return e.checked=x.inArray(x(e).val(),t)>-1}},h.checkOn||(x.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})}),h.focusin="onfocusin"in e;var st=/^(?:focusinfocus|focusoutblur)$/,lt=function(e){e.stopPropagation()};x.extend(x.event,{trigger:function(t,n,i,o){var a,s,l,c,u,p,f,h,b=[i||r],y=d.call(t,"type")?t.type:t,v=d.call(t,"namespace")?t.namespace.split("."):[];if(s=h=l=i=i||r,3!==i.nodeType&&8!==i.nodeType&&!st.test(y+x.event.triggered)&&(y.indexOf(".")>-1&&(y=(v=y.split(".")).shift(),v.sort()),u=y.indexOf(":")<0&&"on"+y,(t=t[x.expando]?t:new x.Event(y,"object"==typeof t&&t)).isTrigger=o?2:3,t.namespace=v.join("."),t.rnamespace=t.namespace?new RegExp("(^|\\.)"+v.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,t.result=void 0,t.target||(t.target=i),n=null==n?[t]:x.makeArray(n,[t]),f=x.event.special[y]||{},o||!f.trigger||!1!==f.trigger.apply(i,n))){if(!o&&!f.noBubble&&!g(i)){for(c=f.delegateType||y,st.test(c+y)||(s=s.parentNode);s;s=s.parentNode)b.push(s),l=s;l===(i.ownerDocument||r)&&b.push(l.defaultView||l.parentWindow||e)}for(a=0;(s=b[a++])&&!t.isPropagationStopped();)h=s,t.type=a>1?c:f.bindType||y,(p=(Y.get(s,"events")||{})[t.type]&&Y.get(s,"handle"))&&p.apply(s,n),(p=u&&s[u])&&p.apply&&X(s)&&(t.result=p.apply(s,n),!1===t.result&&t.preventDefault());return t.type=y,o||t.isDefaultPrevented()||f._default&&!1!==f._default.apply(b.pop(),n)||!X(i)||u&&m(i[y])&&!g(i)&&((l=i[u])&&(i[u]=null),x.event.triggered=y,t.isPropagationStopped()&&h.addEventListener(y,lt),i[y](),t.isPropagationStopped()&&h.removeEventListener(y,lt),x.event.triggered=void 0,l&&(i[u]=l)),t.result}},simulate:function(e,t,n){var r=x.extend(new x.Event,n,{type:e,isSimulated:!0});x.event.trigger(r,null,t)}}),x.fn.extend({trigger:function(e,t){return this.each(function(){x.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return x.event.trigger(e,t,n,!0)}}),h.focusin||x.each({focus:"focusin",blur:"focusout"},function(e,t){var n=function(e){x.event.simulate(t,e.target,x.event.fix(e))};x.event.special[t]={setup:function(){var r=this.ownerDocument||this,i=Y.access(r,t);i||r.addEventListener(e,n,!0),Y.access(r,t,(i||0)+1)},teardown:function(){var r=this.ownerDocument||this,i=Y.access(r,t)-1;i?Y.access(r,t,i):(r.removeEventListener(e,n,!0),Y.remove(r,t))}}});var ct,ut=/\[\]$/,dt=/\r?\n/g,pt=/^(?:submit|button|image|reset|file)$/i,ft=/^(?:input|select|textarea|keygen)/i;function ht(e,t,n,r){var i;if(Array.isArray(t))x.each(t,function(t,i){n||ut.test(e)?r(e,i):ht(e+"["+("object"==typeof i&&null!=i?t:"")+"]",i,n,r)});else if(n||"object"!==v(t))r(e,t);else for(i in t)ht(e+"["+i+"]",t[i],n,r)}x.param=function(e,t){var n,r=[],i=function(e,t){var n=m(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(Array.isArray(e)||e.jquery&&!x.isPlainObject(e))x.each(e,function(){i(this.name,this.value)});else for(n in e)ht(n,e[n],t,i);return r.join("&")},x.fn.extend({serialize:function(){return x.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=x.prop(this,"elements");return e?x.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!x(this).is(":disabled")&&ft.test(this.nodeName)&&!pt.test(e)&&(this.checked||!le.test(e))}).map(function(e,t){var n=x(this).val();return null==n?null:Array.isArray(n)?x.map(n,function(e){return{name:t.name,value:e.replace(dt,"\r\n")}}):{name:t.name,value:n.replace(dt,"\r\n")}}).get()}}),x.fn.extend({wrapAll:function(e){var t;return this[0]&&(m(e)&&(e=e.call(this[0])),t=x(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){for(var e=this;e.firstElementChild;)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(e){return m(e)?this.each(function(t){x(this).wrapInner(e.call(this,t))}):this.each(function(){var t=x(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=m(e);return this.each(function(n){x(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(e){return this.parent(e).not("body").each(function(){x(this).replaceWith(this.childNodes)}),this}}),x.expr.pseudos.hidden=function(e){return!x.expr.pseudos.visible(e)},x.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},h.createHTMLDocument=((ct=r.implementation.createHTMLDocument("").body).innerHTML="<form></form><form></form>",2===ct.childNodes.length),x.parseHTML=function(e,t,n){return"string"!=typeof e?[]:("boolean"==typeof t&&(n=t,t=!1),t||(h.createHTMLDocument?((i=(t=r.implementation.createHTMLDocument("")).createElement("base")).href=r.location.href,t.head.appendChild(i)):t=r),o=L.exec(e),a=!n&&[],o?[t.createElement(o[1])]:(o=be([e],t,a),a&&a.length&&x(a).remove(),x.merge([],o.childNodes)));var i,o,a},x.offset={setOffset:function(e,t,n){var r,i,o,a,s,l,c=x.css(e,"position"),u=x(e),d={};"static"===c&&(e.style.position="relative"),s=u.offset(),o=x.css(e,"top"),l=x.css(e,"left"),("absolute"===c||"fixed"===c)&&(o+l).indexOf("auto")>-1?(a=(r=u.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(l)||0),m(t)&&(t=t.call(e,n,x.extend({},s))),null!=t.top&&(d.top=t.top-s.top+a),null!=t.left&&(d.left=t.left-s.left+i),"using"in t?t.using.call(e,d):u.css(d)}},x.fn.extend({offset:function(e){if(arguments.length)return void 0===e?this:this.each(function(t){x.offset.setOffset(this,e,t)});var t,n,r=this[0];return r?r.getClientRects().length?(t=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:t.top+n.pageYOffset,left:t.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this[0]){var e,t,n,r=this[0],i={top:0,left:0};if("fixed"===x.css(r,"position"))t=r.getBoundingClientRect();else{for(t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;e&&(e===n.body||e===n.documentElement)&&"static"===x.css(e,"position");)e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=x(e).offset()).top+=x.css(e,"borderTopWidth",!0),i.left+=x.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-x.css(r,"marginTop",!0),left:t.left-i.left-x.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){for(var e=this.offsetParent;e&&"static"===x.css(e,"position");)e=e.offsetParent;return e||ye})}}),x.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,t){var n="pageYOffset"===t;x.fn[e]=function(r){return B(this,function(e,r,i){var o;if(g(e)?o=e:9===e.nodeType&&(o=e.defaultView),void 0===i)return o?o[t]:e[r];o?o.scrollTo(n?o.pageXOffset:i,n?i:o.pageYOffset):e[r]=i},e,r,arguments.length)}}),x.each(["top","left"],function(e,t){x.cssHooks[t]=Ue(h.pixelPosition,function(e,n){if(n)return n=qe(e,t),Me.test(n)?x(e).position()[t]+"px":n})}),x.each({Height:"height",Width:"width"},function(e,t){x.each({padding:"inner"+e,content:t,"":"outer"+e},function(n,r){x.fn[r]=function(i,o){var a=arguments.length&&(n||"boolean"!=typeof i),s=n||(!0===i||!0===o?"margin":"border");return B(this,function(t,n,i){var o;return g(t)?0===r.indexOf("outer")?t["inner"+e]:t.document.documentElement["client"+e]:9===t.nodeType?(o=t.documentElement,Math.max(t.body["scroll"+e],o["scroll"+e],t.body["offset"+e],o["offset"+e],o["client"+e])):void 0===i?x.css(t,n,s):x.style(t,n,i,s)},t,a?i:void 0,a)}})}),x.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,t){x.fn[t]=function(e,n){return arguments.length>0?this.on(t,null,e,n):this.trigger(t)}}),x.fn.extend({hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),x.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)}}),x.proxy=function(e,t){var n,r,i;if("string"==typeof t&&(n=e[t],t=e,e=n),m(e))return r=o.call(arguments,2),(i=function(){return e.apply(t||this,r.concat(o.call(arguments)))}).guid=e.guid=e.guid||x.guid++,i},x.holdReady=function(e){e?x.readyWait++:x.ready(!0)},x.isArray=Array.isArray,x.parseJSON=JSON.parse,x.nodeName=A,x.isFunction=m,x.isWindow=g,x.camelCase=V,x.type=v,x.now=Date.now,x.isNumeric=function(e){var t=x.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},"function"==typeof define&&define.amd&&define("jquery",[],function(){return x});var mt=e.jQuery,gt=e.$;return x.noConflict=function(t){return e.$===x&&(e.$=gt),t&&e.jQuery===x&&(e.jQuery=mt),x},t||(e.jQuery=e.$=x),x},"object"==typeof module&&"object"==typeof module.exports?module.exports=t0.document?u0(t0,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return u0(e)}:u0(t0),define("deps/jquery",function(){}),define("core/jquery-enhanced",["exports","core/pubsubhub","core/utils","deps/jquery"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="core/jquery-enhanced";window.$=$,window.$.fn.renameElement=function(e){var n=[];return this.each(function(){for(var r=$(this.ownerDocument.createElement(e)),i=0,o=this.attributes.length;i<o;i++){var a=this.attributes[i];try{r[0].setAttributeNS(a.namespaceURI,a.name,a.value)}catch(e){var s="Your HTML markup is malformed. Error in: \n";s+="```HTML\n"+this.outerHTML+"\n```",(0,t.pub)("error",s);break}}$(this).contents().appendTo(r),$(this).replaceWith(r),n.push(r[0])}),$(n)},window.$.fn.getDfnTitles=function(e){var t="",r="",i="";return void 0===this.attr("data-lt-noDefault")&&(i=(0,n.norm)(this.text()).toLowerCase()),this.attr("data-lt")?(t=this.attr("data-lt")?"data-lt":"lt",r=this.attr(t).toLowerCase(),""!==i&&(r.startsWith(`${i}|`)||(r=r+"|"+i))):r=1===this.contents().length&&1===this.children("abbr, acronym").length&&this.find(":first-child").attr("title")?this.find(":first-child").attr("title"):'""'===this.text()?"the-empty-string":this.text(),r=(0,n.norm)(r).toLowerCase(),e&&!0===e.isDefinition&&(t&&this.attr("data-lt",r),"data-lt"!==t&&this.removeAttr(t),this.attr("dfn-type")?(this.attr("data-dfn-type",this.attr("dfn-type")),this.removeAttr("dfn-type")):this.attr("data-dfn-type","dfn")),[...r.split("|").filter(e=>""!==e).reduce((e,t)=>e.add(t),new Set)]},window.$.fn.linkTargets=function(){var e=this[0].closest("[data-link-for]"),t=e?e.dataset.linkFor.toLowerCase():"",n=this.getDfnTitles(),r=[];for(const e of n){r.push({for:t,title:e});const n=e.split(".");2===n.length&&r.push({for:n[0],title:n[1]}),r.push({for:"",title:e})}return r},window.$.fn.makeID=function(e="",t="",n=!1){const r=this[0];if(r.id)return r.id;t||(t=(r.title?r.title:r.textContent).trim());var i=n?t:t.toLowerCase();if((i=i.replace(/[\W]+/gim,"-").replace(/^-+/,"").replace(/-+$/,""))?!/\.$/.test(i)&&/^[a-z]/i.test(i)||(i="x"+i):i="generatedID",e&&(i=`${e}-${i}`),r.ownerDocument.getElementById(i)){let e=0,t=i+"-"+e;for(;r.ownerDocument.getElementById(t);)t=i+"-"+e++;i=t}return r.id=i,i},window.$.fn.allTextNodes=function(e){for(var t=[],n={},r=0,i=e.length;r<i;r++)n[e[r]]=!0;return function e(r){if(1!==r.nodeType||!n[r.localName.toLowerCase()])if(3===r.nodeType)t.push(r);else for(var i=0,o=r.childNodes.length;i<o;++i)e(r.childNodes[i])}(this[0]),t}}),define("core/ui",["exports","shortcut","core/pubsubhub","deps/text!ui/ui.css","core/utils","core/jquery-enhanced"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0}),e.ui=e.name=void 0;var o=s(t),a=s(r);function s(e){return e&&e.__esModule?e:{default:e}}e.name="core/ui";const l=document.createElement("style");function c(e,t){e&&Array.from(t.entries()).reduce((e,[t,n])=>(e.setAttribute("aria-"+t,n),e),e)}l.id="respec-ui-styles",l.textContent=a.default,l.classList.add("removeOnSave"),document.head.appendChild(l);const u=$("<div id='respec-ui' class='removeOnSave' hidden></div>"),d=$("<ul id=respec-menu role=menu aria-labelledby='respec-pill' hidden></ul>");var p,f;const h=[],m=[],g={};(0,n.sub)("start-all",()=>{document.body.insertAdjacentElement("afterbegin",u[0])},{once:!0}),(0,n.sub)("end-all",()=>{document.body.insertAdjacentElement("afterbegin",u[0])},{once:!0});const b=$("<button id='respec-pill' disabled>ReSpec</button>");b.click(function(e){e.stopPropagation(),d[0].hidden?(d[0].classList.remove("respec-hidden"),d[0].classList.add("respec-visible")):(d[0].classList.add("respec-hidden"),d[0].classList.remove("respec-visible")),this.setAttribute("aria-expanded",String(d[0].hidden)),d[0].hidden=!d[0].hidden}).appendTo(u),document.documentElement.addEventListener("click",function(){d[0].hidden||(d[0].classList.remove("respec-visible"),d[0].classList.add("respec-hidden"),d[0].hidden=!0)}),d.appendTo(u);const y=new Map([["controls","respec-menu"],["expanded","false"],["haspopup","true"],["label","ReSpec Menu"]]);function v(e,t,n,r){if(t.push(e),g.hasOwnProperty(n))return void g[n].text(t.length);g[n]=$("<button id='respec-pill-"+n+"' class='respec-info-button'>"+t.length+"</button>").appendTo(u).click(function(){this.setAttribute("aria-expanded","true");for(var e=$("<ol class='respec-"+n+"-list'></ol>"),o=0,a=t.length;o<a;o++){var s=t[o];if(s instanceof Error)$("<li><span></span> <a>⊞</a><pre></pre></li>").appendTo(e).find("span").text("["+s.name+"] "+s.message).end().find("a").css({fontSize:"1.1em",color:"#999",cursor:"pointer"}).click(function(){var e=$(this),t=e.text(),n=e.parent().find("pre");"⊞"===t?(e.text("⊟"),n.show()):(e.text("⊞"),n.hide())}).end().find("pre").text(s.stack).css({marginLeft:"0",maxWidth:"100%",overflowY:"hidden",overflowX:"scroll"}).hide().end();else{const t=document.createElement("tmp");t.innerHTML=(0,i.markdownToHtml)(s);const n=document.createElement("li");if(t.firstElementChild===t.lastElementChild)for(;t.firstElementChild&&t.firstElementChild.hasChildNodes();)n.appendChild(t.firstElementChild.firstChild);else n.innerHTML=t.innerHTML;e[0].appendChild(n)}}w.freshModal(r,e,this)});const o=new Map([["expanded","false"],["haspopup","true"],["controls","respec-pill-"+n+"-modal"],["label","Document "+r.toLowerCase()]]);c(g[n][0],o)}c(b[0],y);const w=e.ui={show:function(){try{u[0].hidden=!1}catch(e){console.error(e)}},hide:function(){u[0].hidden=!0},enable:function(){b[0].removeAttribute("disabled")},addCommand:function(e,t,n,r){r=r||"";var i=function(){require([t],function(e){e.show()})},a="respec-button-"+e.toLowerCase().replace(/\s+/,"-"),s=$('<li role=menuitem><button id="'+a+'" class="respec-option" title="'+n+'"><span class="respec-cmd-icon">'+r+"</span> "+e+"… </button></li>").click(i).appendTo(d);return n&&o.default.add(n,i),s[0].querySelector("button")},error:function(e){v(e,h,"error","Errors")},warning:function(e){v(e,m,"warning","Warnings")},closeModal:function(e){f&&(f[0].classList.remove("respec-show-overlay"),f[0].classList.add("respec-hide-overlay"),f[0].addEventListener("transitionend",()=>{f.remove(),f=null})),e&&e.setAttribute("aria-expanded","false"),p&&(p.remove(),p=null)},freshModal:function(e,t,n){p&&p.remove(),f&&f.remove(),f=$("<div id='respec-overlay' class='removeOnSave'></div>");const r=n.id+"-modal",i=r+"-heading";(p=$("<div id='"+r+"' class='respec-modal removeOnSave' role='dialog'><h3></h3><div class='inside'></div></div>")).find("h3").text(e),p.find("h3")[0].id=i;const o=new Map([["labelledby",i]]);c(p[0],o),p.find(".inside").append(t),$(document.body).append(f).append(p),f.click(()=>{this.closeModal(n)}),f[0].classList.toggle("respec-show-overlay"),p[0].hidden=!1}};o.default.add("Esc",function(){w.closeModal()}),o.default.add("Ctrl+Alt+Shift+E",function(){g.error&&g.error.click()}),o.default.add("Ctrl+Alt+Shift+W",function(){g.warning&&g.warning.click()}),window.respecUI=w,(0,n.sub)("error",function(e){w.error(e)}),(0,n.sub)("warn",function(e){w.warning(e)})}),define("core/l10n",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e){e.l10n=i[o]||i.en};var t=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="core/l10n";const n=document.documentElement;n&&!n.hasAttribute("lang")&&(n.lang="en",n.hasAttribute("dir")||(n.dir="ltr"));const r={about_respec:"About",abstract:"What is the OpenAPI Specification?",author:"Author:",authors:"Authors:",bug_tracker:"Bug tracker:",close_parens:")",commit_history:"Commit history",definition_list:"Definitions",editor:"Editor:",editors_note:"Editor's note",editors:"Editors:",example:"Example",feature_at_risk:"Feature at Risk",fig:"Figure ",file_a_bug:"File a bug",former_editor:"Former editor:",former_editors:"Former editors:",info_references:"Informative references",issue_summary:"Issue Summary",issue:"Issue",latest_editors_draft:"Latest editor's draft:",latest_published_version:"Latest published version:",list_of_definitions:"List of Definitions",norm_references:"Normative references",note:"Note",open_bugs:"open bugs",open_parens:"(",participate:"Participate",pull_requests:"Pull requests",references:"References",save_as:"Save as",save_snapshot:"Export",search_specref:"Search Specref",sotd:"Status of This Document",table_of_fig:"Table of Figures",this_version:"This version:",toc:"Table of Contents",warning:"Warning"},i=e.l10n={en:t({},r),ko:t({},r,{abstract:"요약",author:"저자:",authors:"저자:",fig:"그림 ",latest_published_version:"최신 버전:",sotd:"현재 문서의 상태",this_version:"현재 버전:"}),zh:t({},r,{abstract:"摘要",bug_tracker:"错误跟踪:",editor:"编辑:",editors:"编辑们:",fig:"圖",file_a_bug:"反馈错误",latest_editors_draft:"最新编辑草稿:",latest_published_version:"最新发布草稿:",note:"注",open_bugs:"修正中的错误",sotd:"关于本文档",this_version:"本版本:",toc:"内容大纲"}),ja:t({},r,{abstract:"要約",author:"著者:",authors:"著者:",bug_tracker:"バグの追跡履歴:",editor:"編者:",editors:"編者:",fig:"図",latest_editors_draft:"最新の編集用草案:",latest_published_version:"最新バージョン:",note:"注",open_bugs:"改修されていないバグ",sotd:"この文書の位置付け",this_version:"このバージョン:",toc:"目次"}),nl:t({},r,{about_respec:"Over",abstract:"Samenvatting",author:"Auteur:",authors:"Auteurs:",bug_tracker:"Meldingensysteem:",commit_history:"Revisiehistorie",definition_list:"Lijst van Definities",editor:"Redacteur:",editors_note:"Redactionele noot",editors:"Redacteurs:",example:"Voorbeeld",fig:"Figuur ",file_a_bug:"Dien een melding in",info_references:"Informatieve referenties",issue_summary:"Lijst met issues",latest_editors_draft:"Laatste werkversie:",latest_published_version:"Laatst gepubliceerde versie:",list_of_definitions:"Lijst van Definities",norm_references:"Normatieve referenties",note:"Noot",open_bugs:"open meldingen",participate:"Doe mee",references:"Referenties",save_as:"Bewaar als",save_snapshot:"Bewaar Snapshot",search_specref:"Doorzoek Specref",sotd:"Status van dit document",table_of_fig:"Lijst met figuren",this_version:"Deze versie:",toc:"Inhoudsopgave",warning:"Waarschuwing"}),es:t({},r,{abstract:"Resumen",author:"Autor:",authors:"Autores:",bug_tracker:"Repositorio de bugs:",close_parens:")",commit_history:"Historia de cambios",editor:"Editor:",editors_note:"Nota de editor",editors:"Editores:",example:"Ejemplo",fig:"Figura ",file_a_bug:"Nota un bug",info_references:"Referencias informativas",issue_summary:"Resumen de la cuestión",issue:"Cuestión",latest_editors_draft:"Borrador de editor mas reciente:",latest_published_version:"Versión publicada mas reciente:",norm_references:"Referencias normativas",note:"Nota",open_bugs:"Bugs abiertos",open_parens:"(",participate:"Participad",references:"Referencias",sotd:"Estado de este Document",table_of_fig:"Tabla de Figuras",this_version:"Ésta versión:",toc:"Tabla de Contenidos",warning:"Aviso"})};i["zh-hans"]=i.zh,i["zh-cn"]=i.zh;const o=e.lang=n&&n.lang in i?n.lang:"en"}),define("core/linter",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e,t,n){if(n(),!1===e.lint)return;await document.respecReady;try{await i.lint(e,t)}catch(e){console.error("Error ocurred while running the linter",e)}};var n=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="core/linter";const r=new WeakMap;const i=new class{constructor(){r.set(this,{rules:new Set})}get rules(){return r.get(this).rules}register(...e){e.reduce((e,t)=>e.add(t),this.rules)}async lint(e,i=window.document){const a=[...r.get(this).rules].map(r=>(async function(e){(await e).map(async e=>{const t=await e,r=n({},o,t),{description:i,help:a,howToFix:s,name:l,occurrences:c,offendingElements:u}=r,d=`${i} ${s} ${a} ("${l}" x ${c})`;return u.forEach(e=>{e.classList.add("respec-offending-element")}),console.warn(`Linter (${l}):`,i,...u),d}).forEach(async e=>{(0,t.pub)("warn",await e)})})(r.lint(e,i)));await a}};e.default=i;const o={name:"unknown",description:"",occurrences:0,howToFix:"",offendingElements:[],help:""}}),define("core/LinterRule",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0});const t=new WeakMap;e.default=class{constructor(e,n){t.set(this,{name:e,lintingFunction:n})}get name(){return t.get(this).name}lint(e={lint:{[this.name]:!1}},n=document){return r=e,i=this.name,!1!==r.hasOwnProperty("lint")&&!1!==r.lint&&r.lint[i]?[].concat(t.get(this).lintingFunction(e,n)):[];var r,i}}}),define("core/linter-rules/no-headingless-sections",["exports","core/LinterRule","../l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=t)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};const a="no-headingless-sections",s={en:{description:"All sections must start with a `h2-6` element.",howToFix:"Add a `h2-6` to the offending section or use a `<div>`.",help:"See developer console."},nl:{description:"Alle secties moeten beginnen met een `h2-6` element.",howToFix:"Voeg een `h2-6` toe aan de conflicterende sectie of gebruik een `<div>`.",help:"Zie de developer console."}},l=n.lang in s?n.lang:"en",c=({firstElementChild:e})=>null===e||!1===/^h[1-6]$/.test(e.localName);e.rule=new i.default(a,function(e,t){const n=Array.from(t.querySelectorAll("section")).filter(c);return n.length?o({name:a,offendingElements:n,occurrences:n.length},s[l]):[]})}),define("core/linter-rules/no-http-props",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};const a="no-http-props",s={en:{description:"Insecure URLs are not allowed in `respecConfig`.",howToFix:"Please change the following properties to 'https://': "}},l=t.lang in s?t.lang:"en";e.rule=new i.default(a,function(e,t){if(!t.location.href.startsWith("http"))return[];const n=Object.getOwnPropertyNames(e).filter(e=>e.endsWith("URI")||"prevED"===e).filter(n=>new URL(e[n],t.location.href).href.startsWith("http://")).reduce((e,t)=>e.concat(t),[]);if(!n.length)return[];const r=o({name:a,occurrences:n.length},s[l]);return r.howToFix+=n.map(e=>"`"+e+"`").join(", ")+".",r})}),define("w3c/l10n",["exports","core/l10n"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0;e.name="w3c/l10n";const n={en:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the <a href='https://www.w3.org/TR/'>W3C technical reports index</a> at https://www.w3.org/TR/."},ko:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the <a href='https://www.w3.org/TR/'>W3C technical reports index</a> at https://www.w3.org/TR/."},zh:{status_at_publication:"本章节描述了本文档的发布状态。其它更新版本可能会覆盖本文档。W3C的文档列 表和最新版本可通过<a href='https://www.w3.org/TR/'>W3C技术报告</a>索引访问。"},ja:{status_at_publication:"この節には、公開時点でのこの文書の位置づけが記されている。他の文書によって置き換えられる可能性がある。現時点でのW3Cの発行文書とこのテクニカルレポートの最新版は、下記から参照できる。 <a href='https://www.w3.org/TR/'>W3C technical reports index</a> (https://www.w3.org/TR/)"},nl:{status_at_publication:"This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the <a href='https://www.w3.org/TR/'>W3C technical reports index</a> at https://www.w3.org/TR/."}};Object.keys(n).reduce((e,t)=>(Object.assign(e[t],n[t]),e),t.l10n)}),define("w3c/linter-rules/privsec-section",["exports","core/LinterRule","../l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=t)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};const a="privsec-section",s={en:{description:"Document must a 'Privacy and/or Security' Considerations section.",howToFix:"Add a privacy and/or security considerations section.",help:"See the [Self-Review Questionnaire](https://w3ctag.github.io/security-questionnaire/)."}},l=n.lang in s?n.lang:"en";e.rule=new i.default(a,function(e,t){const n=[];var r;return e.isRecTrack&&(r=t,!Array.from(r.querySelectorAll("h2, h3, h4, h5, h6")).some(({textContent:e})=>{const t=/(privacy|security)/im.test(e),n=/(considerations)/im.test(e);return t&&n||t}))&&n.push(o({name:a,occurrences:1},s[l])),n})}),define("core/linter-rules/check-punctuation",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};const a="check-punctuation",s=[".",":","!","?"],l={en:{description:"`p` elements should end with a punctuation mark.",howToFix:`Please make sure \`p\` elements end with one of: ${s.map(e=>`"${e}"`).join(", ")}.`}},c=t.lang in l?t.lang:"en";e.rule=new i.default(a,function(e,t){const n=new RegExp(`[${s.join("")}\\]]$|^ *$`,"m"),r=[...t.querySelectorAll("p:not(#back-to-top)")].filter(e=>!n.test(e.textContent.trim()));return r.length?o({name:a,offendingElements:r,occurrences:r.length},l[c]):[]})}),define("core/linter-rules/local-refs-exist",["exports","core/l10n","core/LinterRule"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rule=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};var o=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};const a="local-refs-exist",s={en:{description:"Broken local reference found in document.",howToFix:"Please fix the links mentioned.",help:"See developer console."}},l=t.lang in s?t.lang:"en";e.rule=new i.default(a,function(e,t){const n=[...t.querySelectorAll("a[href^='#']")].filter(c);return n.length?o({name:a,offendingElements:n,occurrences:n.length},s[l]):[]});function c(e){const{href:t,ownerDocument:n}=e,{hash:r}=new URL(t);return!n.getElementById(r.substring(1))}}),define("oai/defaults",["exports","core/linter","core/linter-rules/no-headingless-sections","core/linter-rules/no-http-props","w3c/linter-rules/privsec-section","core/linter-rules/check-punctuation","core/linter-rules/local-refs-exist"],function(e,t,n,r,i,o,a){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){Object.assign(e,c({},p,e)),Object.assign(e,(t=e,{isCCBY:"cc-by"===t.license,licenseInfo:d.get(t.license),isCGBG:u.has(t.specStatus),isCGFinal:t.isCGBG&&/G-FINAL$/.test(t.specStatus),isBasic:"base"===t.specStatus,isRegular:!t.isCGBG&&"base"===t.specStatus}));var t};var s,l=(s=t)&&s.__esModule?s:{default:s};var c=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="oai/defaults";l.default.register(r.rule,i.rule,n.rule,o.rule,a.rule);const u=new Set(["BG-DRAFT","BG-FINAL","CG-DRAFT","CG-FINAL"]),d=new Map([["cc0",{name:"Creative Commons 0 Public Domain Dedication",short:"CC0",url:"https://creativecommons.org/publicdomain/zero/1.0/"}],["w3c-software",{name:"W3C Software Notice and License",short:"W3C Software",url:"https://www.w3.org/Consortium/Legal/2002/copyright-software-20021231"}],["w3c-software-doc",{name:"W3C Software and Document Notice and License",short:"W3C Software and Document",url:"https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document"}],["apache2",{name:"Apache 2.0 License",short:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}],["cc-by",{name:"Creative Commons Attribution 4.0 International Public License",short:"CC-BY",url:"https://creativecommons.org/licenses/by/4.0/legalcode"}]]),p={lint:{"no-headingless-sections":!1,"privsec-section":!0,"no-http-props":!1,"check-punctuation":!1,"local-refs-exist":!1},pluralize:!0,doJsonLd:!0,license:"apache2",specStatus:"base",prependW3C:!1,logos:[{src:"https://raw.githubusercontent.com/OAI/OpenAPI-Style-Guide/master/graphics/bitmap/OpenAPI_Logo_Pantone.png",alt:"OpenAPI Initiative",height:48,url:"https://openapis.org/"}]}}),define("deps/text!core/css/respec2.css",[],function(){return'/*****************************************************************\n * ReSpec 3 CSS\n * Robin Berjon - http://berjon.com/\n *****************************************************************/\n\n/* Override code highlighter background */\n.hljs {\n background: transparent !important;\n}\n\n/* --- INLINES --- */\nh1 abbr,\nh2 abbr,\nh3 abbr,\nh4 abbr,\nh5 abbr,\nh6 abbr,\na abbr {\n border: none;\n}\n\ndfn {\n font-weight: bold;\n}\n\na.internalDFN {\n color: inherit;\n border-bottom: 1px solid #99c;\n text-decoration: none;\n}\n\na.externalDFN {\n color: inherit;\n border-bottom: 1px dotted #ccc;\n text-decoration: none;\n}\n\na.bibref {\n text-decoration: none;\n}\n\ncite .bibref {\n font-style: normal;\n}\n\ncode {\n color: #c83500;\n}\n\nth code {\n color: inherit;\n}\n\n/* --- TOC --- */\n\n.toc a,\n.tof a {\n text-decoration: none;\n}\n\na .secno,\na .figno {\n color: #000;\n}\n\nul.tof,\nol.tof {\n list-style: none outside none;\n}\n\n.caption {\n margin-top: 0.5em;\n font-style: italic;\n}\n\n/* --- TABLE --- */\n\ntable.simple {\n border-spacing: 0;\n border-collapse: collapse;\n border-bottom: 3px solid #005a9c;\n}\n\n.simple th {\n background: #005a9c;\n color: #fff;\n padding: 3px 5px;\n text-align: left;\n}\n\n.simple th[scope="row"] {\n background: inherit;\n color: inherit;\n border-top: 1px solid #ddd;\n}\n\n.simple td {\n padding: 3px 10px;\n border-top: 1px solid #ddd;\n}\n\n.simple tr:nth-child(even) {\n background: #f0f6ff;\n}\n\n/* --- DL --- */\n\n.section dd > p:first-child {\n margin-top: 0;\n}\n\n.section dd > p:last-child {\n margin-bottom: 0;\n}\n\n.section dd {\n margin-bottom: 1em;\n}\n\n.section dl.attrs dd,\n.section dl.eldef dd {\n margin-bottom: 0;\n}\n\n#issue-summary > ul,\n.respec-dfn-list {\n column-count: 2;\n}\n\n#issue-summary li,\n.respec-dfn-list li {\n list-style: none;\n}\n\ndetails.respec-tests-details {\n margin-left: 1em;\n display: inline-block;\n vertical-align: top;\n}\n\ndetails.respec-tests-details > * {\n padding-right: 2em;\n}\n\ndetails.respec-tests-details[open] {\n z-index: 999999;\n position: absolute;\n border: thin solid #cad3e2;\n border-radius: .3em;\n background-color: white;\n padding-bottom: .5em;\n}\n\ndetails.respec-tests-details[open] > summary {\n border-bottom: thin solid #cad3e2;\n padding-left: 1em;\n margin-bottom: 1em;\n line-height: 2em;\n}\n\ndetails.respec-tests-details > ul {\n width: 100%;\n margin-top: -0.3em;\n}\n\ndetails.respec-tests-details > li {\n padding-left: 1em;\n}\n\n@media print {\n .removeOnSave {\n display: none;\n }\n}\n'}),define("core/style",["exports","deps/text!core/css/respec2.css"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){e.noReSpecCSS&&i.remove();n()};var n,r=(n=t)&&n.__esModule?n:{default:n};e.name="core/style";const i=document.createElement("style");i.id="respec-mainstyle",i.textContent=r.default,document.head.appendChild(i)}),define("w3c/style",["exports","core/utils","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,i){if(!e.specStatus){const t="`respecConfig.specStatus` missing. Defaulting to 'base'.";e.specStatus="base",(0,n.pub)("warn",t)}let o="W3C-";switch(e.specStatus.toUpperCase()){case"CG-DRAFT":case"CG-FINAL":case"BG-DRAFT":case"BG-FINAL":o=e.specStatus.toLowerCase();break;case"FPWD":case"LC":case"WD-NOTE":case"LC-NOTE":o+="WD";break;case"WG-NOTE":case"FPWD-NOTE":o+="WG-NOTE.css";break;case"UNOFFICIAL":o+="UD";break;case"FINDING":case"FINDING-DRAFT":case"BASE":o="base.css";break;default:o+=e.specStatus}const a=function(e){let t="";switch(e){case null:case!0:t="2016";break;default:e&&!isNaN(e)&&(t=e.toString().trim())}return t}(e.useExperimentalStyles||"2016");a&&!e.noToc&&(0,n.sub)("end-all",function(){!function(e,t){const n=e.createElement("script");n.addEventListener("load",function(){window.location.hash&&(window.location=window.location)},{once:!0}),n.src=`https://www.w3.org/scripts/TR/${t}/fixup.js`,e.body.appendChild(n)}(r,a)},{once:!0});const s=`https://www.w3.org/StyleSheets/TR/${a?a+"/":""}${o}`;(0,t.linkCSS)(r,s),i()};e.name="w3c/style";const r=[{hint:"preconnect",href:"https://www.w3.org"},{hint:"preload",href:"https://www.w3.org/scripts/TR/2016/fixup.js",as:"script"},{hint:"preload",href:"https://www.w3.org/StyleSheets/TR/2016/base.css",as:"style"},{hint:"preload",href:"https://www.w3.org/StyleSheets/TR/2016/logos/W3C",as:"image"}].map(t.createResourceHint).reduce(function(e,t){return e.appendChild(t),e},document.createDocumentFragment());r.appendChild(function(){const e=document.createElement("link");return e.rel="stylesheet",e.href="https://www.w3.org/StyleSheets/TR/2016/base.css",e.classList.add("removeOnSave"),e}()),document.head.querySelector("meta[name=viewport]")||r.insertBefore(function(){const e=document.createElement("meta");return e.name="viewport",e.content=(0,t.toKeyValuePairs)({width:"device-width","initial-scale":"1","shrink-to-fit":"no"}).replace(/\"/g,""),e}(),r.firstChild),document.head.insertBefore(r,document.head.firstChild)}),define("core/github",["exports","core/l10n","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.fetchAll=o,e.fetchIndex=function(e,t){return o(e.replace(/\{[^}]+\}/,""),t)},e.run=async function(e){if(!e.hasOwnProperty("github")||!e.github)return;if("object"==typeof e.github&&!e.github.hasOwnProperty("repoURL")){const e="Config option `[github](https://github.com/w3c/respec/wiki/github)` is missing property `repoURL`.";return void(0,n.pub)("error",e)}let t;try{t=new URL(e.github.repoURL||e.github,"https://github.com")}catch(e){return void(0,n.pub)("error",`\`respecConf.github\` is not a valid URL? (${t})`)}if("https://github.com"!==t.origin){const e=`\`respecConf.github\` must be HTTPS and pointing to GitHub. (${t})`;return void(0,n.pub)("error",e)}const[r,o]=t.pathname.split("/").filter(e=>e);if(!r||!o){const e="`respecConf.github` URL needs a path with, for example, w3c/my-spec";return void(0,n.pub)("error",e)}const a=e.github.branch||"gh-pages",s={edDraftURI:`https://${r.toLowerCase()}.github.io/${o}/`,githubToken:void 0,githubUser:void 0,githubAPI:`https://api.github.com/repos/${r}/${o}`,issueBase:new URL("./issues/",t).href,otherLinks:[],pullBase:new URL("./pulls/",t).href,shortName:o},l={key:e.l10n.participate,data:[{value:`GitHub ${r}/${o}`,href:t},{value:e.l10n.file_a_bug,href:s.issueBase},{value:e.l10n.commit_history,href:new URL(`./commits/${a}`,t.href).href},{value:e.l10n.pull_requests,href:s.pullBase}]},c={branch:a,repoURL:t.href},u=i({},s,e,{github:c});Object.assign(e,u),e.otherLinks.unshift(l)};var r;(r=t)&&r.__esModule;var i=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="core/github";async function o(e,t={},n=[]){const r=new URL(e);r.searchParams&&!r.searchParams.has("per_page")&&r.searchParams.append("per_page","100");const i=new Request(r,{headers:t});i.headers.set("Accept","application/vnd.github.v3+json");const a=await window.fetch(i),s=await a.json();Array.isArray(s)&&n.push(...s);const l=(c=a.headers.get("Link"),(u=(c||"").match(/<([^>]+)>\s*;\s*rel="next"/))&&u[1]||null);var c,u;return l?o(l,t,n):n}}),define("core/data-include",["exports","core/pubsubhub","core/utils"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,i){const o=Array.from(r.querySelectorAll("[data-include]")).map(async e=>{const r=e.dataset.include;if(!r)return;const i="include-"+String(Math.random()).substr(2);e.dataset.includeId=i;try{const o=await fetch(r),a=await o.text();!function(e,t,r){const i=document.querySelector(`[data-include-id=${t}]`),o=i.ownerDocument,a=(0,n.runTransforms)(e,i.dataset.oninclude,r),s="string"==typeof i.dataset.includeReplace;let l;switch(i.dataset.includeFormat){case"text":s?(l=o.createTextNode(a),i.parentNode.replaceChild(l,i)):i.textContent=a;break;default:if(i.innerHTML=a,s){for(l=o.createDocumentFragment();i.hasChildNodes();)l.append(i.removeChild(i.firstChild));i.parentNode.replaceChild(l,i)}}o.contains(i)&&(c=i,["data-include","data-include-format","data-include-replace","data-include-id","oninclude"].forEach(e=>c.removeAttribute(e)));var c}(a,i,r)}catch(n){const i=`\`data-include\` failed: \`${r}\` (${n.message}). See console for details.`;console.error("data-include failed for element: ",e,n),(0,t.pub)("error",i)}});Promise.all(o).then(i)};e.name="core/data-include"}),define("core/markdown",["exports","core/utils"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){const r=!!t.querySelector("[data-format=markdown]:not(body)"),s="markdown"===e.format;if(!s&&!r)return n();if(!s)return o(t.body).map(e=>{const t=i(e,e.ownerDocument);return{structuredInternals:t,elem:e}}).forEach(({elem:e,structuredInternals:t})=>{if(e.setAttribute("aria-busy","true"),"section"===t.firstElementChild.localName&&"section"===e.localName){const n=t.firstElementChild;for(n.remove();n.hasChildNodes();)e.appendChild(n.firstChild)}else e.innerHTML="";e.appendChild(t),e.setAttribute("aria-busy","false")}),n();const l=t.getElementById("respec-ui");l.remove();const c=t.createElement("html"),u=t.createElement("body");u.innerHTML=t.body.innerHTML,c.appendChild(u),a(c);const d=u.innerHTML.replace(/<p>\s*<\/p>/gm,"");u.innerHTML=d,p=u.querySelectorAll(".nolinks a[href]"),Array.from(p).forEach(e=>{const t=e.ownerDocument.createTextNode(e.textContent);e.parentElement.replaceChild(t,e)});var p;var f=i(u,t);u.appendChild(f),u.insertAdjacentElement("afterbegin",l),t.body.parentNode.replaceChild(u,t.body),n()};e.name="core/markdown";function n(e){return n=>{const r=Array.from(n.querySelectorAll(e));return r.reverse().forEach(e=>{e.innerHTML=(0,t.markdownToHtml)(e.innerHTML)}),r}}class r{constructor(e){this.doc=e,this.root=e.createDocumentFragment(),this.stack=[this.root],this.current=this.root}findPosition(e){return parseInt(e.tagName.charAt(1),10)}findParent(e){let t;for(;e>0;)if(e--,t=this.stack[e])return t}findHeader({firstChild:e}){for(;e;){if(/H[1-6]/.test(e.tagName))return e;e=e.nextSibling}return null}addHeader(e){const t=this.doc.createElement("section"),n=this.findPosition(e);t.appendChild(e),this.findParent(n).appendChild(t),this.stack[n]=t,this.stack.length=n+1,this.current=t}addSection(e,t){const n=this.findHeader(e),r=n?this.findPosition(n):1,i=this.findParent(r);n&&e.removeChild(n),e.appendChild(t(e)),n&&e.insertBefore(n,e.firstChild),i.appendChild(e),this.current=i}addElement(e){this.current.appendChild(e)}}function i(e,t){return function e(n){const i=new r(t);for(;n.firstChild;){const t=n.firstChild;if(t.nodeType===Node.ELEMENT_NODE)switch(t.localName){case"h1":case"h2":case"h3":case"h4":case"h5":case"h6":i.addHeader(t);break;case"section":i.addSection(t,e);break;default:i.addElement(t)}else n.removeChild(t)}return i.root}(e)}const o=n("[data-format='markdown']:not(body)"),a=n("[data-format=markdown]:not(body), section, div, address, article, aside, figure, header, main, body")}),Dha=this,Eha=function(){return function(e){var t={};function n(r){if(t[r])return t[r].exports;var i=t[r]={exports:{},id:r,loaded:!1};return e[r].call(i.exports,i,i.exports,n),i.loaded=!0,i.exports}return n.m=e,n.c=t,n.p="",n(0)}([function(e,t,n){var r=n(1).default,i=n(2).default;t.__esModule=!0;var o=r(n(3)),a=i(n(20)),s=i(n(5)),l=r(n(4)),c=r(n(21)),u=i(n(33));function d(){var e=new o.HandlebarsEnvironment;return l.extend(e,o),e.SafeString=a.default,e.Exception=s.default,e.Utils=l,e.escapeExpression=l.escapeExpression,e.VM=c,e.template=function(t){return c.template(t,e)},e}var p=d();p.create=d,u.default(p),p.default=p,t.default=p,e.exports=t.default},function(e,t){t.default=function(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&(t[n]=e[n]);return t.default=e,t},t.__esModule=!0},function(e,t){t.default=function(e){return e&&e.__esModule?e:{default:e}},t.__esModule=!0},function(e,t,n){var r=n(2).default;t.__esModule=!0,t.HandlebarsEnvironment=u;var i=n(4),o=r(n(5)),a=n(9),s=n(17),l=r(n(19));t.VERSION="4.0.11";t.COMPILER_REVISION=7;t.REVISION_CHANGES={1:"<= 1.0.rc.2",2:"== 1.0.0-rc.3",3:"== 1.0.0-rc.4",4:"== 1.x.x",5:"== 2.0.0-alpha.x",6:">= 2.0.0-beta.1",7:">= 4.0.0"};var c="[object Object]";function u(e,t,n){this.helpers=e||{},this.partials=t||{},this.decorators=n||{},a.registerDefaultHelpers(this),s.registerDefaultDecorators(this)}u.prototype={constructor:u,logger:l.default,log:l.default.log,registerHelper:function(e,t){if(i.toString.call(e)===c){if(t)throw new o.default("Arg not supported with multiple helpers");i.extend(this.helpers,e)}else this.helpers[e]=t},unregisterHelper:function(e){delete this.helpers[e]},registerPartial:function(e,t){if(i.toString.call(e)===c)i.extend(this.partials,e);else{if(void 0===t)throw new o.default('Attempting to register a partial called "'+e+'" as undefined');this.partials[e]=t}},unregisterPartial:function(e){delete this.partials[e]},registerDecorator:function(e,t){if(i.toString.call(e)===c){if(t)throw new o.default("Arg not supported with multiple decorators");i.extend(this.decorators,e)}else this.decorators[e]=t},unregisterDecorator:function(e){delete this.decorators[e]}};var d=l.default.log;t.log=d,t.createFrame=i.createFrame,t.logger=l.default},function(e,t){t.__esModule=!0,t.extend=a,t.indexOf=function(e,t){for(var n=0,r=e.length;n<r;n++)if(e[n]===t)return n;return-1},t.escapeExpression=function(e){if("string"!=typeof e){if(e&&e.toHTML)return e.toHTML();if(null==e)return"";if(!e)return e+"";e=""+e}if(!i.test(e))return e;return e.replace(r,o)},t.isEmpty=function(e){return!e&&0!==e||!(!c(e)||0!==e.length)},t.createFrame=function(e){var t=a({},e);return t._parent=e,t},t.blockParams=function(e,t){return e.path=t,e},t.appendContextPath=function(e,t){return(e?e+".":"")+t};var n={"&":"&","<":"<",">":">",'"':""","'":"'","`":"`","=":"="},r=/[&<>"'`=]/g,i=/[&<>"'`=]/;function o(e){return n[e]}function a(e){for(var t=1;t<arguments.length;t++)for(var n in arguments[t])Object.prototype.hasOwnProperty.call(arguments[t],n)&&(e[n]=arguments[t][n]);return e}var s=Object.prototype.toString;t.toString=s;var l=function(e){return"function"==typeof e};l(/x/)&&(t.isFunction=l=function(e){return"function"==typeof e&&"[object Function]"===s.call(e)}),t.isFunction=l;var c=Array.isArray||function(e){return!(!e||"object"!=typeof e)&&"[object Array]"===s.call(e)};t.isArray=c},function(e,t,n){var r=n(6).default;t.__esModule=!0;var i=["description","fileName","lineNumber","message","name","number","stack"];function o(e,t){var n=t&&t.loc,a=void 0,s=void 0;n&&(e+=" - "+(a=n.start.line)+":"+(s=n.start.column));for(var l=Error.prototype.constructor.call(this,e),c=0;c<i.length;c++)this[i[c]]=l[i[c]];Error.captureStackTrace&&Error.captureStackTrace(this,o);try{n&&(this.lineNumber=a,r?Object.defineProperty(this,"column",{value:s,enumerable:!0}):this.column=s)}catch(e){}}o.prototype=new Error,t.default=o,e.exports=t.default},function(e,t,n){e.exports={default:n(7),__esModule:!0}},function(e,t,n){var r=n(8);e.exports=function(e,t,n){return r.setDesc(e,t,n)}},function(e,t){var n=Object;e.exports={create:n.create,getProto:n.getPrototypeOf,isEnum:{}.propertyIsEnumerable,getDesc:n.getOwnPropertyDescriptor,setDesc:n.defineProperty,setDescs:n.defineProperties,getKeys:n.keys,getNames:n.getOwnPropertyNames,getSymbols:n.getOwnPropertySymbols,each:[].forEach}},function(e,t,n){var r=n(2).default;t.__esModule=!0,t.registerDefaultHelpers=function(e){i.default(e),o.default(e),a.default(e),s.default(e),l.default(e),c.default(e),u.default(e)};var i=r(n(10)),o=r(n(11)),a=r(n(12)),s=r(n(13)),l=r(n(14)),c=r(n(15)),u=r(n(16))},function(e,t,n){t.__esModule=!0;var r=n(4);t.default=function(e){e.registerHelper("blockHelperMissing",function(t,n){var i=n.inverse,o=n.fn;if(!0===t)return o(this);if(!1===t||null==t)return i(this);if(r.isArray(t))return t.length>0?(n.ids&&(n.ids=[n.name]),e.helpers.each(t,n)):i(this);if(n.data&&n.ids){var a=r.createFrame(n.data);a.contextPath=r.appendContextPath(n.data.contextPath,n.name),n={data:a}}return o(t,n)})},e.exports=t.default},function(e,t,n){var r=n(2).default;t.__esModule=!0;var i=n(4),o=r(n(5));t.default=function(e){e.registerHelper("each",function(e,t){if(!t)throw new o.default("Must pass iterator to #each");var n=t.fn,r=t.inverse,a=0,s="",l=void 0,c=void 0;function u(t,r,o){l&&(l.key=t,l.index=r,l.first=0===r,l.last=!!o,c&&(l.contextPath=c+t)),s+=n(e[t],{data:l,blockParams:i.blockParams([e[t],t],[c+t,null])})}if(t.data&&t.ids&&(c=i.appendContextPath(t.data.contextPath,t.ids[0])+"."),i.isFunction(e)&&(e=e.call(this)),t.data&&(l=i.createFrame(t.data)),e&&"object"==typeof e)if(i.isArray(e))for(var d=e.length;a<d;a++)a in e&&u(a,a,a===e.length-1);else{var p=void 0;for(var f in e)e.hasOwnProperty(f)&&(void 0!==p&&u(p,a-1),p=f,a++);void 0!==p&&u(p,a-1,!0)}return 0===a&&(s=r(this)),s})},e.exports=t.default},function(e,t,n){var r=n(2).default;t.__esModule=!0;var i=r(n(5));t.default=function(e){e.registerHelper("helperMissing",function(){if(1!==arguments.length)throw new i.default('Missing helper: "'+arguments[arguments.length-1].name+'"')})},e.exports=t.default},function(e,t,n){t.__esModule=!0;var r=n(4);t.default=function(e){e.registerHelper("if",function(e,t){return r.isFunction(e)&&(e=e.call(this)),!t.hash.includeZero&&!e||r.isEmpty(e)?t.inverse(this):t.fn(this)}),e.registerHelper("unless",function(t,n){return e.helpers.if.call(this,t,{fn:n.inverse,inverse:n.fn,hash:n.hash})})},e.exports=t.default},function(e,t){t.__esModule=!0,t.default=function(e){e.registerHelper("log",function(){for(var t=[void 0],n=arguments[arguments.length-1],r=0;r<arguments.length-1;r++)t.push(arguments[r]);var i=1;null!=n.hash.level?i=n.hash.level:n.data&&null!=n.data.level&&(i=n.data.level),t[0]=i,e.log.apply(e,t)})},e.exports=t.default},function(e,t){t.__esModule=!0,t.default=function(e){e.registerHelper("lookup",function(e,t){return e&&e[t]})},e.exports=t.default},function(e,t,n){t.__esModule=!0;var r=n(4);t.default=function(e){e.registerHelper("with",function(e,t){r.isFunction(e)&&(e=e.call(this));var n=t.fn;if(r.isEmpty(e))return t.inverse(this);var i=t.data;return t.data&&t.ids&&((i=r.createFrame(t.data)).contextPath=r.appendContextPath(t.data.contextPath,t.ids[0])),n(e,{data:i,blockParams:r.blockParams([e],[i&&i.contextPath])})})},e.exports=t.default},function(e,t,n){var r=n(2).default;t.__esModule=!0,t.registerDefaultDecorators=function(e){i.default(e)};var i=r(n(18))},function(e,t,n){t.__esModule=!0;var r=n(4);t.default=function(e){e.registerDecorator("inline",function(e,t,n,i){var o=e;return t.partials||(t.partials={},o=function(i,o){var a=n.partials;n.partials=r.extend({},a,t.partials);var s=e(i,o);return n.partials=a,s}),t.partials[i.args[0]]=i.fn,o})},e.exports=t.default},function(e,t,n){t.__esModule=!0;var r=n(4),i={methodMap:["debug","info","warn","error"],level:"info",lookupLevel:function(e){if("string"==typeof e){var t=r.indexOf(i.methodMap,e.toLowerCase());e=t>=0?t:parseInt(e,10)}return e},log:function(e){if(e=i.lookupLevel(e),"undefined"!=typeof console&&i.lookupLevel(i.level)<=e){var t=i.methodMap[e];console[t]||(t="log");for(var n=arguments.length,r=Array(n>1?n-1:0),o=1;o<n;o++)r[o-1]=arguments[o];console[t].apply(console,r)}}};t.default=i,e.exports=t.default},function(e,t){function n(e){this.string=e}t.__esModule=!0,n.prototype.toString=n.prototype.toHTML=function(){return""+this.string},t.default=n,e.exports=t.default},function(e,t,n){var r=n(22).default,i=n(1).default,o=n(2).default;t.__esModule=!0,t.checkRevision=function(e){var t=e&&e[0]||1,n=l.COMPILER_REVISION;if(t!==n){if(t<n){var r=l.REVISION_CHANGES[n],i=l.REVISION_CHANGES[t];throw new s.default("Template was precompiled with an older version of Handlebars than the current runtime. Please update your precompiler to a newer version ("+r+") or downgrade your runtime to an older version ("+i+").")}throw new s.default("Template was precompiled with a newer version of Handlebars than the current runtime. Please update your runtime to a newer version ("+e[1]+").")}},t.template=function(e,t){if(!t)throw new s.default("No environment passed to template");if(!e||!e.main)throw new s.default("Unknown template object: "+typeof e);e.main.decorator=e.main_d,t.VM.checkRevision(e.compiler);var n={strict:function(e,t){if(!(t in e))throw new s.default('"'+t+'" not defined in '+e);return e[t]},lookup:function(e,t){for(var n=e.length,r=0;r<n;r++)if(e[r]&&null!=e[r][t])return e[r][t]},lambda:function(e,t){return"function"==typeof e?e.call(t):e},escapeExpression:a.escapeExpression,invokePartial:function(n,r,i){i.hash&&(r=a.extend({},r,i.hash),i.ids&&(i.ids[0]=!0));n=t.VM.resolvePartial.call(this,n,r,i);var o=t.VM.invokePartial.call(this,n,r,i);null==o&&t.compile&&(i.partials[i.name]=t.compile(n,e.compilerOptions,t),o=i.partials[i.name](r,i));if(null!=o){if(i.indent){for(var l=o.split("\n"),c=0,u=l.length;c<u&&(l[c]||c+1!==u);c++)l[c]=i.indent+l[c];o=l.join("\n")}return o}throw new s.default("The partial "+i.name+" could not be compiled when running in runtime-only mode")},fn:function(t){var n=e[t];return n.decorator=e[t+"_d"],n},programs:[],program:function(e,t,n,r,i){var o=this.programs[e],a=this.fn(e);return t||i||r||n?o=c(this,e,a,t,n,r,i):o||(o=this.programs[e]=c(this,e,a)),o},data:function(e,t){for(;e&&t--;)e=e._parent;return e},merge:function(e,t){var n=e||t;return e&&t&&e!==t&&(n=a.extend({},t,e)),n},nullContext:r({}),noop:t.VM.noop,compilerInfo:e.compiler};function i(t){var r=arguments.length<=1||void 0===arguments[1]?{}:arguments[1],o=r.data;i._setup(r),!r.partial&&e.useData&&(o=function(e,t){t&&"root"in t||((t=t?l.createFrame(t):{}).root=e);return t}(t,o));var a=void 0,s=e.useBlockParams?[]:void 0;function c(t){return""+e.main(n,t,n.helpers,n.partials,o,s,a)}return e.useDepths&&(a=r.depths?t!=r.depths[0]?[t].concat(r.depths):r.depths:[t]),(c=d(e.main,c,n,r.depths||[],o,s))(t,r)}return i.isTop=!0,i._setup=function(r){r.partial?(n.helpers=r.helpers,n.partials=r.partials,n.decorators=r.decorators):(n.helpers=n.merge(r.helpers,t.helpers),e.usePartial&&(n.partials=n.merge(r.partials,t.partials)),(e.usePartial||e.useDecorators)&&(n.decorators=n.merge(r.decorators,t.decorators)))},i._child=function(t,r,i,o){if(e.useBlockParams&&!i)throw new s.default("must pass block params");if(e.useDepths&&!o)throw new s.default("must pass parent depths");return c(n,t,e[t],r,0,i,o)},i},t.wrapProgram=c,t.resolvePartial=function(e,t,n){e?e.call||n.name||(n.name=e,e=n.partials[e]):e="@partial-block"===n.name?n.data["partial-block"]:n.partials[n.name];return e},t.invokePartial=function(e,t,n){var r=n.data&&n.data["partial-block"];n.partial=!0,n.ids&&(n.data.contextPath=n.ids[0]||n.data.contextPath);var i=void 0;n.fn&&n.fn!==u&&function(){n.data=l.createFrame(n.data);var e=n.fn;i=n.data["partial-block"]=function(t){var n=arguments.length<=1||void 0===arguments[1]?{}:arguments[1];return n.data=l.createFrame(n.data),n.data["partial-block"]=r,e(t,n)},e.partials&&(n.partials=a.extend({},n.partials,e.partials))}();void 0===e&&i&&(e=i);if(void 0===e)throw new s.default("The partial "+n.name+" could not be found");if(e instanceof Function)return e(t,n)},t.noop=u;var a=i(n(4)),s=o(n(5)),l=n(3);function c(e,t,n,r,i,o,a){function s(t){var i=arguments.length<=1||void 0===arguments[1]?{}:arguments[1],s=a;return!a||t==a[0]||t===e.nullContext&&null===a[0]||(s=[t].concat(a)),n(e,t,e.helpers,e.partials,i.data||r,o&&[i.blockParams].concat(o),s)}return(s=d(n,s,e,a,r,o)).program=t,s.depth=a?a.length:0,s.blockParams=i||0,s}function u(){return""}function d(e,t,n,r,i,o){if(e.decorator){var s={};t=e.decorator(t,s,n,r&&r[0],i,o,r),a.extend(t,s)}return t}},function(e,t,n){e.exports={default:n(23),__esModule:!0}},function(e,t,n){n(24),e.exports=n(29).Object.seal},function(e,t,n){var r=n(25);n(26)("seal",function(e){return function(t){return e&&r(t)?e(t):t}})},function(e,t){e.exports=function(e){return"object"==typeof e?null!==e:"function"==typeof e}},function(e,t,n){var r=n(27),i=n(29),o=n(32);e.exports=function(e,t){var n=(i.Object||{})[e]||Object[e],a={};a[e]=t(n),r(r.S+r.F*o(function(){n(1)}),"Object",a)}},function(e,t,n){var r=n(28),i=n(29),o=n(30),a="prototype",s=function(e,t,n){var l,c,u,d=e&s.F,p=e&s.G,f=e&s.S,h=e&s.P,m=e&s.B,g=e&s.W,b=p?i:i[t]||(i[t]={}),y=p?r:f?r[t]:(r[t]||{})[a];p&&(n=t);for(l in n)(c=!d&&y&&l in y)&&l in b||(u=c?y[l]:n[l],b[l]=p&&"function"!=typeof y[l]?n[l]:m&&c?o(u,r):g&&y[l]==u?function(e){var t=function(t){return this instanceof e?new e(t):e(t)};return t[a]=e[a],t}(u):h&&"function"==typeof u?o(Function.call,u):u,h&&((b[a]||(b[a]={}))[l]=u))};s.F=1,s.G=2,s.S=4,s.P=8,s.B=16,s.W=32,e.exports=s},function(e,t){var n=e.exports="undefined"!=typeof window&&window.Math==Math?window:"undefined"!=typeof self&&self.Math==Math?self:Function("return this")();"number"==typeof __g&&(__g=n)},function(e,t){var n=e.exports={version:"1.2.6"};"number"==typeof __e&&(__e=n)},function(e,t,n){var r=n(31);e.exports=function(e,t,n){if(r(e),void 0===t)return e;switch(n){case 1:return function(n){return e.call(t,n)};case 2:return function(n,r){return e.call(t,n,r)};case 3:return function(n,r,i){return e.call(t,n,r,i)}}return function(){return e.apply(t,arguments)}}},function(e,t){e.exports=function(e){if("function"!=typeof e)throw TypeError(e+" is not a function!");return e}},function(e,t){e.exports=function(e){try{return!!e()}catch(e){return!0}}},function(e,t){(function(n){t.__esModule=!0,t.default=function(e){var t=void 0!==n?n:window,r=t.Handlebars;e.noConflict=function(){return t.Handlebars===e&&(t.Handlebars=r),e}},e.exports=t.default}).call(t,function(){return this}())}])},"object"==typeof exports&&"object"==typeof module?module.exports=Eha():"function"==typeof define&&define.amd?define("handlebars.runtime",[],Eha):"object"==typeof exports?exports.Handlebars=Eha():Dha.Handlebars=Eha(),define("templates",["handlebars.runtime"],function(e){var t=(e=e.default).template,n=e.templates=e.templates||{};return n["permalinks.css"]=t({1:function(e,t,n,r,i){return" section > *:hover > span.permalink { visibility: visible; }\n"},3:function(e,t,n,r,i){return" float: right;\n"},5:function(e,t,n,r,i){return" visibility: hidden;\n"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{};return"/* --- PERMALINKS --- */\n"+(null!=(o=n.if.call(a,null!=t?t.permalinkHide:t,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"\n.permalink {\n width: 1px;\n height: 1px;\n overflow: visible;\n font-size: 10pt;\n font-style: normal;\n vertical-align: middle;\n margin-left: 4px;\n"+(null!=(o=n.if.call(a,null!=t?t.permalinkEdge:t,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+(null!=(o=n.if.call(a,null!=t?t.permalinkHide:t,{name:"if",hash:{},fn:e.program(5,i,0),inverse:e.noop,data:i}))?o:"")+"}\n\n.permalink a, .permalink a:link, .permalink a:visited, .permalink a:hover, .permalink a:focus, .permalink a:active {\n background:transparent !important;\n text-decoration:none;\n font-weight: bold;\n color:#666 !important;\n}\n\n.permalink abbr {\n border:0;\n}\n"},useData:!0}),n["attribute.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression((n.escapeAttributeName||t&&t.escapeAttributeName||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.name:o,{name:"escapeAttributeName",hash:{},data:i}))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return"<span class='idlAttribute' id=\""+l(s(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"\" data-idl data-title='"+l(s(null!=(o=null!=t?t.obj:t)?o.name:o,t))+"'>"+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:u)?a.call(c,{name:"qualifiers",hash:{},data:i}):a)+"attribute <span class='idlAttrType'>"+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+"</span> "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+"<span class='idlAttrName'>"+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"</span>;</span>\n"},useData:!0}),n["callback.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return"<span class='idlCallback' id='"+l(s(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"' data-idl data-title='"+l(s(null!=(o=null!=t?t.obj:t)?o.name:o,t))+"'>"+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"callback <span class='idlCallbackID'>"+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"</span> = <span class='idlCallbackType'>"+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+"</span> ("+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+");</span>"},useData:!0}),n["const.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return"<span class='idlConst' id=\""+l(s(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"\" data-idl data-title='"+l(s(null!=(o=null!=t?t.obj:t)?o.name:o,t))+"'>"+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"const <span class='idlConstType'>"+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+"</span>"+l("function"==typeof(a=null!=(a=n.nullable||(null!=t?t.nullable:t))?a:u)?a.call(c,{name:"nullable",hash:{},data:i}):a)+" "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+"<span class='idlConstName'>"+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"</span> = <span class='idlConstValue'>"+l((n.stringifyIdlConst||t&&t.stringifyIdlConst||u).call(c,null!=(o=null!=t?t.obj:t)?o.value:o,{name:"stringifyIdlConst",hash:{},data:i}))+"</span>;</span>\n"},useData:!0}),n["dict-member.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" = <span class='idlMemberValue'>"+e.escapeExpression((n.stringifyIdlConst||t&&t.stringifyIdlConst||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.default:o,{name:"stringifyIdlConst",hash:{},data:i}))+"</span>"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return"<span class='idlMember' id=\""+l(s(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"\" data-idl data-title='"+l(s(null!=(o=null!=t?t.obj:t)?o.name:o,t))+"'>"+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:u)?a.call(c,{name:"qualifiers",hash:{},data:i}):a)+"<span class='idlMemberType'>"+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+"</span> "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.typePad:t,{name:"pads",hash:{},data:i}))+"<span class='idlMemberName'>"+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"</span>"+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.default:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+";</span>\n"},useData:!0}),n["dictionary.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" : <span class='idlSuperclass'><a>"+e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.inheritance:o,t))+"</a></span>"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return"<span class='idlDictionary' id='"+l(s(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"' data-idl data-title='"+l(s(null!=(o=null!=t?t.obj:t)?o.name:o,t))+"'>"+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.partial||(null!=t?t.partial:t))?a:u)?a.call(c,{name:"partial",hash:{},data:i}):a)+"dictionary <span class='idlDictionaryID'>"+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"</span>"+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.inheritance:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+"};</span>"},useData:!0}),n["enum-item.html"]=t({1:function(e,t,n,r,i){return","},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression,u="function";return c((n.idn||t&&t.idn||l).call(s,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+'<a href="#dom-'+c(typeof(a=null!=(a=n.parentID||(null!=t?t.parentID:t))?a:l)===u?a.call(s,{name:"parentID",hash:{},data:i}):a)+"-"+c(typeof(a=null!=(a=n.lname||(null!=t?t.lname:t))?a:l)===u?a.call(s,{name:"lname",hash:{},data:i}):a)+'" class="idlEnumItem">"'+c(typeof(a=null!=(a=n.name||(null!=t?t.name:t))?a:l)===u?a.call(s,{name:"name",hash:{},data:i}):a)+'"</a>'+(null!=(o=n.if.call(s,null!=t?t.needsComma:t,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"\n"},useData:!0}),n["enum.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return"<span class='idlEnum' id='"+l(s(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"' data-idl data-title='"+l(s(null!=(o=null!=t?t.obj:t)?o.name:o,t))+"'>"+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"enum <span class='idlEnumID'>"+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"</span> {\n"+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"};</span>"},useData:!0}),n["extended-attribute.html"]=t({1:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return"<span class='"+c("function"==typeof(a=null!=(a=n.extAttrClassName||(null!=t?t.extAttrClassName:t))?a:l)?a.call(s,{name:"extAttrClassName",hash:{},data:i}):a)+'\'><span class="extAttrName">'+c("function"==typeof(a=null!=(a=n.name||(null!=t?t.name:t))?a:l)?a.call(s,{name:"name",hash:{},data:i}):a)+"</span>"+(null!=(o=n.if.call(s,null!=t?t.rhs:t,{name:"if",hash:{},fn:e.program(2,i,0),inverse:e.noop,data:i}))?o:"")+(null!=(o=(n.jsIf||t&&t.jsIf||l).call(s,null!=t?t.arguments:t,{name:"jsIf",hash:{},fn:e.program(5,i,0),inverse:e.noop,data:i}))?o:"")+"</span>"},2:function(e,t,n,r,i){var o;return'=<span class="extAttrRhs">'+(null!=(o=(n.extAttrRhs||t&&t.extAttrRhs||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=t?t.rhs:t,{name:"extAttrRhs",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+"</span>"},3:function(e,t,n,r,i){return e.escapeExpression(e.lambda(t,t))},5:function(e,t,n,r,i){var o;return"("+(null!=(o=(n.joinNonWhitespace||t&&t.joinNonWhitespace||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=t?t.arguments:t,", ",{name:"joinNonWhitespace",hash:{},fn:e.program(6,i,0),inverse:e.noop,data:i}))?o:"")+")"},6:function(e,t,n,r,i){return e.escapeExpression((n.param||t&&t.param||n.helperMissing).call(null!=t?t:e.nullContext||{},t,{name:"param",hash:{},data:i}))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return c((n.idn||t&&t.idn||l).call(s,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"["+(null!=(o=(n.join||t&&t.join||l).call(s,null!=t?t.extAttrs:t,null!=t?t.sep:t,{name:"join",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"]"+c("function"==typeof(a=null!=(a=n.end||(null!=t?t.end:t))?a:l)?a.call(s,{name:"end",hash:{},data:i}):a)},useData:!0}),n["field.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=e.lambda,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return"<span class='idlField' id=\""+s(a(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"\" data-idl data-title='"+s(a(null!=(o=null!=t?t.obj:t)?o.name:o,t))+"'>"+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"<span class='idlFieldType'>"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+"</span> "+s((n.pads||t&&t.pads||c).call(l,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+"<span class='idlFieldName'>"+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"</span>;</span>\n"},useData:!0}),n["implements.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression,c=e.lambda;return"<span class='idlImplements'>"+l((n.extAttr||t&&t.extAttr||s).call(a,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"<a>"+l(c(null!=(o=null!=t?t.obj:t)?o.target:o,t))+"</a> implements <a>"+l(c(null!=(o=null!=t?t.obj:t)?o.implements:o,t))+"</a>;</span>"},useData:!0}),n["includes.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression,c=e.lambda;return"<span class='idlIncludes'>"+l((n.extAttr||t&&t.extAttr||s).call(a,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"<a>"+l(c(null!=(o=null!=t?t.obj:t)?o.target:o,t))+"</a> includes <a>"+l(c(null!=(o=null!=t?t.obj:t)?o.includes:o,t))+"</a>;</span>"},useData:!0}),n["interface.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},3:function(e,t,n,r,i){var o;return" : <span class='idlSuperclass'><a>"+e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.inheritance:o,t))+"</a></span>"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing,d="function";return"<span class='idlInterface' id='"+l(s(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"' data-idl data-title='"+l(s(null!=(o=null!=t?t.obj:t)?o.name:o,t))+"'>"+l((n.extAttr||t&&t.extAttr||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l(typeof(a=null!=(a=n.partial||(null!=t?t.partial:t))?a:u)===d?a.call(c,{name:"partial",hash:{},data:i}):a)+l(typeof(a=null!=(a=n.callback||(null!=t?t.callback:t))?a:u)===d?a.call(c,{name:"callback",hash:{},data:i}):a)+"interface "+l(typeof(a=null!=(a=n.mixin||(null!=t?t.mixin:t))?a:u)===d?a.call(c,{name:"mixin",hash:{},data:i}):a)+"<span class='idlInterfaceID'>"+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"</span>"+(null!=(o=n.if.call(c,null!=(o=null!=t?t.obj:t)?o.inheritance:o,{name:"if",hash:{},fn:e.program(3,i,0),inverse:e.noop,data:i}))?o:"")+" {\n"+(null!=(o=typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)===d?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"};</span>"},useData:!0}),n["iterable.html"]=t({1:function(e,t,n,r,i){return"iterable"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return"<span class='idlIterable' id=\""+s(e.lambda(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"\" data-idl data-title='iterable'>"+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+s("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:c)?a.call(l,{name:"qualifiers",hash:{},data:i}):a)+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"<"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+">;</span>\n"},useData:!0}),n["line-comment.html"]=t({compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=null!=t?t:e.nullContext||{},s=n.helperMissing,l=e.escapeExpression;return"<span class='idlSectionComment'>"+l((n.idn||t&&t.idn||s).call(a,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"//"+l("function"==typeof(o=null!=(o=n.comment||(null!=t?t.comment:t))?o:s)?o.call(a,{name:"comment",hash:{},data:i}):o)+"</span>\n"},useData:!0}),n["maplike.html"]=t({1:function(e,t,n,r,i){return"maplike"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return"<span class='idlMaplike' id=\""+s(e.lambda(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"\" data-idl data-title='maplike'>"+s((n.extAttr||t&&t.extAttr||c).call(l,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttr",hash:{},data:i}))+s((n.idn||t&&t.idn||c).call(l,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+s("function"==typeof(a=null!=(a=n.qualifiers||(null!=t?t.qualifiers:t))?a:c)?a.call(l,{name:"qualifiers",hash:{},data:i}):a)+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"<"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+">;</span>\n"},useData:!0}),n["method.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=e.lambda,l=e.escapeExpression,c=null!=t?t:e.nullContext||{},u=n.helperMissing;return"<span class='idlMethod' id=\""+l(s(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"\" data-idl data-title='"+l(s(null!=(o=null!=t?t.obj:t)?o.name:o,t))+"'>"+l((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+l((n.extAttrInline||t&&t.extAttrInline||u).call(c,null!=t?t.obj:t,null!=t?t.indent:t,{name:"extAttrInline",hash:{},data:i}))+l("function"==typeof(a=null!=(a=n.special||(null!=t?t.special:t))?a:u)?a.call(c,{name:"special",hash:{},data:i}):a)+"<span class='idlMethType'>"+l((n.idlType||t&&t.idlType||u).call(c,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+"</span> "+l((n.pads||t&&t.pads||u).call(c,null!=t?t.pad:t,{name:"pads",hash:{},data:i}))+"<span class='idlMethName'>"+(null!=(o=(n.tryLink||t&&t.tryLink||u).call(c,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"</span>("+(null!=(o="function"==typeof(a=null!=(a=n.children||(null!=t?t.children:t))?a:u)?a.call(c,{name:"children",hash:{},data:i}):a)?o:"")+");</span>\n"},useData:!0}),n["multiline-comment.html"]=t({1:function(e,t,n,r,i,o,a){var s=e.escapeExpression;return s((n.idn||t&&t.idn||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=a[1]?a[1].indent:a[1],{name:"idn",hash:{},data:i}))+s(e.lambda(t,t))+"\n"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i,o,a){var s,l,c=null!=t?t:e.nullContext||{},u=n.helperMissing,d=e.escapeExpression;return"<span class='idlSectionComment'>"+d((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+"/*"+d("function"==typeof(l=null!=(l=n.firstLine||(null!=t?t.firstLine:t))?l:u)?l.call(c,{name:"firstLine",hash:{},data:i}):l)+"\n"+(null!=(s=n.each.call(c,null!=t?t.innerLine:t,{name:"each",hash:{},fn:e.program(1,i,0,o,a),inverse:e.noop,data:i}))?s:"")+d((n.idn||t&&t.idn||u).call(c,null!=t?t.indent:t,{name:"idn",hash:{},data:i}))+d("function"==typeof(l=null!=(l=n.lastLine||(null!=t?t.lastLine:t))?l:u)?l.call(c,{name:"lastLine",hash:{},data:i}):l)+"*/</span>\n"},useData:!0,useDepths:!0}),n["param.html"]=t({1:function(e,t,n,r,i){var o;return" = <span class='idlDefaultValue'>"+e.escapeExpression((n.stringifyIdlConst||t&&t.stringifyIdlConst||n.helperMissing).call(null!=t?t:e.nullContext||{},null!=(o=null!=t?t.obj:t)?o.default:o,{name:"stringifyIdlConst",hash:{},data:i}))+"</span>"},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a,s=null!=t?t:e.nullContext||{},l=n.helperMissing,c=e.escapeExpression;return"<span class='idlParam'>"+c((n.extAttrInline||t&&t.extAttrInline||l).call(s,null!=t?t.obj:t,{name:"extAttrInline",hash:{},data:i}))+c("function"==typeof(a=null!=(a=n.optional||(null!=t?t.optional:t))?a:l)?a.call(s,{name:"optional",hash:{},data:i}):a)+"<span class='idlParamType'>"+c((n.idlType||t&&t.idlType||l).call(s,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+c("function"==typeof(a=null!=(a=n.variadic||(null!=t?t.variadic:t))?a:l)?a.call(s,{name:"variadic",hash:{},data:i}):a)+"</span> <span class='idlParamName'>"+c(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))+"</span>"+(null!=(o=n.if.call(s,null!=(o=null!=t?t.obj:t)?o.default:o,{name:"if",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"</span>"},useData:!0}),n["typedef.html"]=t({1:function(e,t,n,r,i){var o;return e.escapeExpression(e.lambda(null!=(o=null!=t?t.obj:t)?o.name:o,t))},compiler:[7,">= 4.0.0"],main:function(e,t,n,r,i){var o,a=e.lambda,s=e.escapeExpression,l=null!=t?t:e.nullContext||{},c=n.helperMissing;return"<span class='idlTypedef' id='"+s(a(null!=(o=null!=t?t.obj:t)?o.idlId:o,t))+"' data-idl data-title='"+s(a(null!=(o=null!=t?t.obj:t)?o.name:o,t))+"'>typedef <span class='idlTypedefType'>"+s((n.idlType||t&&t.idlType||c).call(l,null!=t?t.obj:t,{name:"idlType",hash:{},data:i}))+"</span> <span class='idlTypedefID'>"+(null!=(o=(n.tryLink||t&&t.tryLink||c).call(l,null!=t?t.obj:t,{name:"tryLink",hash:{},fn:e.program(1,i,0),inverse:e.noop,data:i}))?o:"")+"</span>;</span>"},useData:!0}),n}),define("w3c/templates/cgbg-sotd",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const t=hyperHTML;return t`<h2>${e.l10n.sotd}</h2> -${e.isPreview?t` - <details class="annoying-warning" open=""> - <summary>This is a preview</summary> - <p> - Do not attempt to implement this version of the specification. Do not reference this - version as authoritative in any way. - ${e.edDraftURI?t` - Instead, see <a href="${e.edDraftURI}">${e.edDraftURI}</a> for the Editor's draft. - `:""} - </p> - </details> -`:""} -<p> - This specification was published by the <a href='${e.wgURI}'>${e.wg}</a>. - It is not a W3C Standard nor is it on the W3C Standards Track. - ${e.isCGFinal?t` - Please note that under the - <a href="https://www.w3.org/community/about/agreements/final/">W3C Community Final Specification Agreement (FSA)</a> - other conditions apply. - `:t` - Please note that under the - <a href="https://www.w3.org/community/about/agreements/cla/">W3C Community Contributor License Agreement (CLA)</a> - there is a limited opt-out and other conditions apply. - `} - Learn more about - <a href="https://www.w3.org/community/">W3C Community and Business Groups</a>. -</p> -${e.sotdAfterWGinfo?"":[e.additionalContent]} - ${e.wgPublicList?t` - <p>If you wish to make comments regarding this document, please send them to - <a href='${`mailto:${e.wgPublicList}@w3.org${e.subjectPrefix?`?subject=${e.subjectPrefixEnc}`:""}`}'>${e.wgPublicList}@w3.org</a> - (<a href='${`mailto:${e.wgPublicList}-request@w3.org?subject=subscribe`}'>subscribe</a>, - <a - href='${`https://lists.w3.org/Archives/Public/${e.wgPublicList}/`}'>archives</a>)${e.subjectPrefix?t` - with <code>${e.subjectPrefix}</code> at the start of your - email's subject`:""}.</p> - `:""} -${e.sotdAfterWGinfo?[e.additionalContent]:""} -${[e.additionalSections]}`})}),define("w3c/templates/sotd",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const t=hyperHTML;return t`<h2>${e.l10n.sotd}</h2> -${e.isPreview?t` - <details class="annoying-warning" open=""> - <summary>This is a preview</summary> - <p> - Do not attempt to implement this version of the specification. Do not reference this - version as authoritative in any way. - ${e.edDraftURI?t` - Instead, see <a href="${e.edDraftURI}">${e.edDraftURI}</a> for the Editor's draft. - `:""} - </p> - </details> -`:""} -${e.isUnofficial?t` - <p> - This document is draft of a potential specification. It has no official standing of - any kind and does not represent the support or consensus of any standards organisation. - </p> - ${[e.additionalContent]} -`:t` - ${e.isTagFinding?[e.additionalContent]:t` - ${e.isNoTrack?t` - <p> - This document is merely a W3C-internal ${e.isMO?"member-confidential":""} document. It - has no official standing of any kind and does not represent consensus of the W3C - Membership. - </p> - ${[e.additionalContent]} - `:t` - <p> - <em>${[e.l10n.status_at_publication]}</em> - </p> - ${e.isSubmission?t` - ${[e.additionalContent]} - ${e.isMemberSubmission?t` - <p> - By publishing this document, W3C acknowledges that the <a href="${e.thisVersion}">Submitting Members</a> - have made a formal Submission request to W3C for discussion. Publication of this document - by W3C indicates no endorsement of its content by W3C, nor that W3C has, is, or will be - allocating any resources to the issues addressed by it. This document is not the product - of a chartered W3C group, but is published as potential input to - the <a href="https://www.w3.org/Consortium/Process">W3C Process</a>. - A <a href="${`https://www.w3.org/Submission/${e.publishDate.getUTCFullYear()}/${e.submissionCommentNumber}/Comment/`}">W3C Team Comment</a> has been - published in conjunction with this Member Submission. Publication of acknowledged Member Submissions - at the W3C site is one of the benefits of <a href="https://www.w3.org/Consortium/Prospectus/Joining"> - W3C Membership</a>. Please consult the requirements associated with Member Submissions of - <a href="https://www.w3.org/Consortium/Patent-Policy/#sec-submissions">section 3.3 of the - W3C Patent Policy</a>. Please consult the complete <a href="https://www.w3.org/Submission">list - of acknowledged W3C Member Submissions</a>. - </p> - `:t` - ${e.isTeamSubmission?t` - <p>If you wish to make comments regarding this document, please send them to - <a href='${`mailto:${e.wgPublicList}@w3.org${e.subjectPrefix?`?subject=${e.subjectPrefixEnc}`:[""]}`}'>${e.wgPublicList}@w3.org</a> - (<a href='${`mailto:${e.wgPublicList}-request@w3.org?subject=subscribe`}'>subscribe</a>, - <a - href='${`https://lists.w3.org/Archives/Public/${e.wgPublicList}/`}'>archives</a>)${e.subjectPrefix?t` - with <code>${e.subjectPrefix}</code> at the start of your email's subject`:""}.</p> - <p>Please consult the complete <a href="https://www.w3.org/TeamSubmission/">list of Team Submissions</a>.</p> - `:""} - `} - `:t` - ${e.sotdAfterWGinfo?"":[e.additionalContent]} - ${e.overrideStatus?"":t` - <p> - This document was published by ${[e.wgHTML]} as ${e.anOrA} ${e.longStatus}. - ${e.notYetRec?"This document is intended to become a W3C Recommendation.":""} - ${e.wgPublicList?t` - Comments regarding this document are welcome. Please send them to - <a href='${`mailto:${e.wgPublicList}@w3.org${e.subjectPrefix?`?subject=${e.subjectPrefixEnc}`:[""]}`}'>${e.wgPublicList}@w3.org</a> - (<a href='${`mailto:${e.wgPublicList}-request@w3.org?subject=subscribe`}'>subscribe</a>, - <a - href='${`https://lists.w3.org/Archives/Public/${e.wgPublicList}/`}'>archives</a>)${e.subjectPrefix?t` - with <code>${e.subjectPrefix}</code> at the start of your email's subject`:""}. - `:""} - ${e.isCR?`\n W3C publishes a Candidate Recommendation to indicate that the document is believed to be\n stable and to encourage implementation by the developer community. This Candidate\n Recommendation is expected to advance to Proposed Recommendation no earlier than\n ${e.humanCREnd}.\n `:""} - ${e.isPER?t` - W3C Advisory Committee Members are invited to - send formal review comments on this Proposed - Edited Recommendation to the W3C Team until - ${e.humanPEREnd}. - Members of the Advisory Committee will find the - appropriate review form for this document by - consulting their list of current - <a href='https://www.w3.org/2002/09/wbs/myQuestionnaires'>WBS questionnaires</a>. - `:""} - ${e.isPR?t` - The W3C Membership and other interested parties are invited to review the document and - send comments to - <a rel='discussion' href='${`mailto:${e.wgPublicList}@w3.org`}'>${e.wgPublicList}@w3.org</a> - (<a href='${`mailto:${e.wgPublicList}-request@w3.org?subject=subscribe`}'>subscribe</a>, - <a href='${`https://lists.w3.org/Archives/Public/${e.wgPublicList}/`}'>archives</a>) - through ${e.humanPREnd}. Advisory Committee Representatives should consult their - <a href='https://www.w3.org/2002/09/wbs/myQuestionnaires'>WBS questionnaires</a>. - Note that substantive technical comments were expected during the Candidate Recommendation - review period that ended ${e.humanCREnd}. - `:""} - </p> - `} - ${e.implementationReportURI?t` - <p> - Please see the Working Group's <a href='${e.implementationReportURI}'>implementation - report</a>. - </p> - `:""} - ${e.sotdAfterWGinfo?[e.additionalContent]:""} - ${e.notRec?t` - <p> - Publication as ${e.anOrA} ${e.textStatus} does not imply endorsement by the W3C - Membership. This is a draft document and may be updated, replaced or obsoleted by other - documents at any time. It is inappropriate to cite this document as other than work in - progress. - </p> - `:""} - ${e.isRec?t` - <p> - This document has been reviewed by W3C Members, by software developers, and by other W3C - groups and interested parties, and is endorsed by the Director as a W3C Recommendation. - It is a stable document and may be used as reference material or cited from another - document. W3C's role in making the Recommendation is to draw attention to the - specification and to promote its widespread deployment. This enhances the functionality - and interoperability of the Web. - </p> - `:""} - <p data-deliverer="${e.isNote?e.wgId:null}"> - ${e.isIGNote?"":t` - This document was produced by - ${e.multipleWGs?"groups":"a group"} - operating under the - <a href='https://www.w3.org/Consortium/Patent-Policy/'>W3C Patent Policy</a>. - `} - ${e.recNotExpected?"The group does not expect this document to become a W3C Recommendation.":""} - ${e.isIGNote?"":t` - ${e.multipleWGs?t`W3C maintains ${[e.wgPatentHTML]}`:t` - W3C maintains a <a href='${[e.wgPatentURI]}' rel='disclosure'>public list of any patent - disclosures</a> - `} - made in connection with the deliverables of - ${e.multipleWGs?"each group; these pages also include":"the group; that page also includes"} - instructions for disclosing a patent. An individual who has actual knowledge of a patent - which the individual believes contains - <a href='https://www.w3.org/Consortium/Patent-Policy/#def-essential'>Essential - Claim(s)</a> must disclose the information in accordance with - <a href='https://www.w3.org/Consortium/Patent-Policy/#sec-Disclosure'>section - 6 of the W3C Patent Policy</a>. - `} - ${e.isIGNote?t` - The disclosure obligations of the Participants of this group are described in the - <a href='${e.charterDisclosureURI}'>charter</a>. - `:""} - </p> - <p>This document is governed by the <a id="w3c_process_revision" - href="https://www.w3.org/2018/Process-20180201/">1 February 2018 W3C Process Document</a>. - </p> - ${e.addPatentNote?t`<p>${[e.addPatentNote]}</p>`:""} - `} - `} - `} -`} -${[e.additionalSections]}`})}),define("w3c/templates/show-logo",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const n=document.createElement("a");if(!e.alt){const e="Found spec logo without an `alt` attribute. See dev console.";n.classList.add("respec-offending-element"),(0,t.pub)("warn",e),console.warn("warn",e,n)}return n.href=e.url||"",n.classList.add("logo"),hyperHTML.bind(n)` - <img - id="${e.id}" - alt="${e.alt}" - width="${e.width}" - height="${e.height}"> - `,n.querySelector("img").src=e.src,n})}),define("w3c/templates/show-people",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=((e,t,n=[])=>{const r=hyperHTML,i=[];for(let e=0;e<n.length;e++)i.push(o(n[e],e));return i;function o(e,t){const n=[e.name],i=r`<dd class='p-author h-card vcard' - data-editor-id='${e.w3cid?parseInt(e.w3cid,10):null}'></dd>`,o=document.createDocumentFragment(),s=[];if(e.mailto?s.push(r`<a class='ed_mailto u-email email p-name' - href='${`mailto:${e.mailto}`}'>${n}</a>`):e.url?s.push(r`<a class='u-url url p-name fn' - href='${e.url}'>${n}</a>`):s.push(r`<span class='p-name fn'>${n}</span>`),e.company&&(e.companyURL?s.push(r` (<a class='p-org org h-org h-card' href='${e.companyURL}'>${e.company}</a>)`):s.push(r` (${e.company})`)),e.note&&s.push(document.createTextNode(` (${e.note})`)),e.extras){const t=e.extras.filter(e=>e.name&&e.name.trim()).map(a);for(const e of t)s.push(document.createTextNode(", "),e)}return hyperHTML.bind(o)`${s}`,i.appendChild(o),i}function a(e){const t=r`<span class='${e.class||null}'></span>`;let n=t;return e.href&&(n=r`<a href='${e.href}'></a>`,t.appendChild(n)),n.textContent=e.name,t}})}),define("w3c/templates/show-link",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0});const n=hyperHTML;function r(e){return n` - <dd class="${e.class?e.class:null}"> - ${e.href?n` - <a href="${e.href}">${e.value||e.href}</a> - `:""} - </dd> - `}e.default=(e=>{if(!e.key){const n="Found a link without `key` attribute in the configuration. See dev console.";return(0,t.pub)("warn",n),void console.warn("warn",n,e)}return n` - <dt class="${e.class?e.class:null}">${e.key}:</dt> - ${e.data?e.data.map(r):r(e)} - `})}),define("w3c/templates/cgbg-headers",["exports","./show-logo","./show-people","./show-link","deps/hyperhtml"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0});var i=s(t),o=s(n),a=s(r);function s(e){return e&&e.__esModule?e:{default:e}}e.default=(e=>{const t=hyperHTML;return t`<div class='head'> - ${e.logos.map(i.default)} - <h1 class='title p-name' id='title'>${e.title}</h1> - ${e.subtitle?t` - <h2 id='subtitle'>${e.subtitle}</h2> - `:""} - <h2>${e.longStatus} <time class='dt-published' datetime='${e.dashDate}'>${e.publishHumanDate}</time></h2> - <dl> - ${e.thisVersion?t` - <dt>${e.l10n.this_version}</dt> - <dd><a class='u-url' href='${e.thisVersion}'>${e.thisVersion}</a></dd> - `:""} - ${e.latestVersion?t` - <dt>${e.l10n.latest_published_version}</dt> - <dd><a href='${e.latestVersion}'>${e.latestVersion}</a></dd> - `:""} - ${e.edDraftURI?t` - <dt>${e.l10n.latest_editors_draft}</dt> - <dd><a href='${e.edDraftURI}'>${e.edDraftURI}</a></dd> - `:""} - ${e.testSuiteURI?t` - <dt>Test suite:</dt> - <dd><a href='${e.testSuiteURI}'>${e.testSuiteURI}</a></dd> - `:""} - ${e.implementationReportURI?t` - <dt>Implementation report:</dt> - <dd><a href='${e.implementationReportURI}'>${e.implementationReportURI}</a></dd> - `:""} - ${e.bugTrackerHTML?t` - <dt>${e.l10n.bug_tracker}</dt> - <dd>${[e.bugTrackerHTML]}</dd> - `:""} - ${e.prevVersion?t` - <dt>Previous version:</dt> - <dd><a href='${e.prevVersion}'>${e.prevVersion}</a></dd> - `:""} - ${e.isCGFinal?"":t` - ${e.prevED?t` - <dt>Previous editor's draft:</dt> - <dd><a href='${e.prevED}'>${e.prevED}</a></dd> - `:""} - `} - <dt>${e.multipleEditors?e.l10n.editors:e.l10n.editor}</dt> - ${(0,o.default)(e,"Editor",e.editors)} - ${Array.isArray(e.formerEditors)&&e.formerEditors.length>0?t` - <dt>${e.multipleFormerEditors?e.l10n.former_editors:e.l10n.former_editor}</dt> - ${(0,o.default)(e,"Editor",e.formerEditors)} - `:""} - ${e.authors?t` - <dt>${e.multipleAuthors?e.l10n.authors:e.l10n.author}</dt> - ${(0,o.default)(e,"Author",e.authors)} - `:""} - ${e.otherLinks?e.otherLinks.map(a.default):""} - </dl> - ${e.alternateFormats?t` - <p> - ${e.multipleAlternates?"This document is also available in these non-normative formats:":"This document is also available in this non-normative format:"} - ${[e.alternatesHTML]} - </p> - `:""} - <p class='copyright'> - <a href='https://www.w3.org/Consortium/Legal/ipr-notice#Copyright'>Copyright</a> © - ${e.copyrightStart?`${e.copyrightStart}-`:""}${e.publishYear} - the Contributors to the ${e.title} Specification, published by the - <a href='${e.wgURI}'>${e.wg}</a> under the - ${e.isCGFinal?t` - <a href="https://www.w3.org/community/about/agreements/fsa/">W3C Community Final Specification Agreement (FSA)</a>. - A human-readable <a href="https://www.w3.org/community/about/agreements/fsa-deed/">summary</a> is available. - `:t` - <a href="https://www.w3.org/community/about/agreements/cla/">W3C Community Contributor License Agreement (CLA)</a>. - A human-readable <a href="https://www.w3.org/community/about/agreements/cla-deed/">summary</a> is available. - `} - </p> - <hr title="Separator for header"> -</div>`})}),define("oai/templates/show-logo",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(e=>{const n=document.createElement("a");if(!e.alt){const e="Found spec logo without an `alt` attribute. See dev console.";n.classList.add("respec-offending-element"),(0,t.pub)("warn",e),console.warn("warn",e,n)}return n.href=e.url||"",n.classList.add("logo"),hyperHTML.bind(n)` - <img - id="${e.id}" - alt="${e.alt}" - width="${e.width}" - height="${e.height}"> - `,n.querySelector("img").src=e.src,n})}),define("oai/templates/show-people",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=((e,t,n=[])=>{const r=hyperHTML,i=[];for(let e=0;e<n.length;e++)i.push(o(n[e],e));return i;function o(e,t){const n=[e.name],i=r`<dd class='p-author h-card vcard' - data-editor-id='${e.w3cid?parseInt(e.w3cid,10):null}'></dd>`,o=document.createDocumentFragment(),s=[];if(e.mailto?s.push(r`<a class='ed_mailto u-email email p-name' - href='${`mailto:${e.mailto}`}'>${n}</a>`):e.url?s.push(r`<a class='u-url url p-name fn' - href='${e.url}'>${n}</a>`):s.push(r`<span class='p-name fn'>${n}</span>`),e.company&&(e.companyURL?s.push(r` (<a class='p-org org h-org h-card' href='${e.companyURL}'>${e.company}</a>)`):s.push(r` (${e.company})`)),e.note&&s.push(document.createTextNode(` (${e.note})`)),e.extras){const t=e.extras.filter(e=>e.name&&e.name.trim()).map(a);for(const e of t)s.push(document.createTextNode(", "),e)}return hyperHTML.bind(o)`${s}`,i.appendChild(o),i}function a(e){const t=r`<span class='${e.class||null}'></span>`;let n=t;return e.href&&(n=r`<a href='${e.href}'></a>`,t.appendChild(n)),n.textContent=e.name,t}})}),define("oai/templates/show-link",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0});const n=hyperHTML;function r(e){return n` - <dd class="${e.class?e.class:null}"> - ${e.href?n` - <a href="${e.href}">${e.value||e.href}</a> - `:""} - </dd> - `}e.default=(e=>{if(!e.key){const n="Found a link without `key` attribute in the configuration. See dev console.";return(0,t.pub)("warn",n),void console.warn("warn",n,e)}return n` - <dt class="${e.class?e.class:null}">${e.key}:</dt> - ${e.data?e.data.map(r):r(e)} - `})}),define("oai/templates/headers",["exports","./show-logo","./show-people","./show-link","core/pubsubhub","deps/hyperhtml"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0});var o=l(t),a=l(n),s=l(r);function l(e){return e&&e.__esModule?e:{default:e}}e.default=(e=>{const t=hyperHTML;return t`<div class='head'> - ${e.logos.map(o.default)} - ${function(e){const t=document.querySelector("h1#title")||document.createElement("h1");return t.parentElement?(t.remove(),e.title=t.textContent.trim()):(t.textContent=e.title,t.id="title"),t.classList.add("title","p-name"),null===document.querySelector("title")?document.title=e.title:document.title!==e.title&&(0,i.pub)("warn","The document's title and the `<title>` element differ."),t}(e)} - ${function(e){let t=document.querySelector("h2#subtitle");return t&&t.parentElement?(t.remove(),e.subtitle=t.textContent.trim()):e.subtitle&&((t=document.createElement("h2")).textContent=e.subtitle,t.id="subtitle"),t&&t.classList.add("subtitle"),t}(e)} - <h2>${e.prependW3C?"W3C":""}${e.textStatus} <time class='dt-published' datetime='${e.dashDate}'>${e.publishHumanDate}</time></h2> - <dl> - ${e.isNoTrack?"":t` - <dt>${e.l10n.this_version}</dt> - <dd><a class='u-url' href='${e.thisVersion}'>${e.thisVersion}</a></dd> - <dt>${e.l10n.latest_published_version}</dt> - <dd>${e.latestVersion?t`<a href='${e.latestVersion}'>${e.latestVersion}</a>`:"none"}</dd> - `} - ${e.edDraftURI?t` - <dt>${e.l10n.latest_editors_draft}</dt> - <dd><a href='${e.edDraftURI}'>${e.edDraftURI}</a></dd> - `:""} - ${e.testSuiteURI?t` - <dt>Test suite:</dt> - <dd><a href='${e.testSuiteURI}'>${e.testSuiteURI}</a></dd> - `:""} - ${e.implementationReportURI?t` - <dt>Implementation report:</dt> - <dd><a href='${e.implementationReportURI}'>${e.implementationReportURI}</a></dd> - `:""} - ${e.bugTrackerHTML?t` - <dt>${e.l10n.bug_tracker}</dt> - <dd>${[e.bugTrackerHTML]}</dd> - `:""} - ${e.isED?t` - ${e.prevED?t` - <dt>Previous editor's draft:</dt> - <dd><a href='${e.prevED}'>${e.prevED}</a></dd> - `:""} - `:""} - ${e.showPreviousVersion?t` - <dt>Previous version:</dt> - <dd><a href='${e.prevVersion}'>${e.prevVersion}</a></dd> - `:""} - ${e.prevRecURI?t` - ${e.isRec?t` - <dt>Previous Recommendation:</dt> - <dd><a href='${e.prevRecURI}'>${e.prevRecURI}</a></dd> - `:t` - <dt>Latest Recommendation:</dt> - <dd><a href='${e.prevRecURI}'>${e.prevRecURI}</a></dd> - `} - `:""} - <dt>${e.multipleEditors?e.l10n.editors:e.l10n.editor}</dt> - ${(0,a.default)(e,"Editor",e.editors)} - ${Array.isArray(e.formerEditors)&&e.formerEditors.length>0?t` - <dt>${e.multipleFormerEditors?e.l10n.former_editors:e.l10n.former_editor}</dt> - ${(0,a.default)(e,"Editor",e.formerEditors)} - `:""} - ${e.authors?t` - <dt>${e.multipleAuthors?e.l10n.authors:e.l10n.author}</dt> - ${(0,a.default)(e,"Author",e.authors)} - `:""} - ${e.otherLinks?e.otherLinks.map(s.default):""} - </dl> - ${e.errata?t` - <p> - Please check the <a href="${e.errata}"><strong>errata</strong></a> for any errors or issues - reported since publication. - </p> - `:""} - ${e.isRec?t` - <p> - See also <a href="${`http://www.w3.org/2003/03/Translations/byTechnology?technology=${e.shortName}`}"> - <strong>translations</strong></a>. - </p> - `:""} - ${e.alternateFormats?t` - <p> - ${e.multipleAlternates?"This document is also available in these non-normative formats:":"This document is also available in this non-normative format:"} - ${[e.alternatesHTML]} - </p> - `:""} - ${e.isUnofficial?t` - ${e.additionalCopyrightHolders?t` - <p class='copyright'>${[e.additionalCopyrightHolders]}</p> - `:t` - ${e.overrideCopyright?[e.overrideCopyright]:t` - <p class='copyright'> - This document is licensed under a - <a class='subfoot' href='https://creativecommons.org/licenses/by/3.0/' rel='license'>Creative Commons - Attribution 3.0 License</a>. - </p> - `} - `} - `:t` - ${e.overrideCopyright?[e.overrideCopyright]:t` - <p class='copyright'> - Copyright © - ${e.copyrightStart?`${e.copyrightStart}-`:""}${e.publishYear} - ${e.additionalCopyrightHolders?t` ${[e.additionalCopyrightHolders]} `:""} - ${e.isCCBY?t` - Some Rights Reserved: this document is dual-licensed, - <a rel="license" href="https://creativecommons.org/licenses/by/3.0/">CC-BY</a> and - <a rel="license" href="https://www.w3.org/Consortium/Legal/copyright-documents">W3C Document License</a>. - `:""} - </p> - `} - `} - <hr title="Separator for header"> -</div>`})}),define("oai/headers",["exports","core/utils","handlebars.runtime","core/pubsubhub","templates","w3c/templates/cgbg-sotd","w3c/templates/sotd","w3c/templates/cgbg-headers","oai/templates/headers"],function(e,t,n,r,i,o,a,s,l){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){e.isUnofficial="unofficial"===e.specStatus,e.isUnofficial&&(e.logos=[]);if(e.license="apache2",e.isCCBY="cc-by"===e.license,e.isW3CSoftAndDocLicense="w3c-software-doc"===e.license,["cc-by"].includes(e.license)){let t=`You cannot use license "\`${e.license}\`" with W3C Specs. `;t+='Please set `respecConfig.license: "w3c-software-doc"` instead.',(0,r.pub)("error",t)}e.licenseInfo=k[e.license],e.isCGBG=w.includes(e.specStatus),e.isCGFinal=e.isCGBG&&/G-FINAL$/.test(e.specStatus),e.isBasic="base"===e.specStatus,e.isRegular=!e.isCGBG&&!e.isBasic,e.specStatus||(0,r.pub)("error","Missing required configuration: `specStatus`");e.isRegular&&!e.shortName&&(0,r.pub)("error","Missing required configuration: `shortName`");if(e.testSuiteURI){const t=new URL(e.testSuiteURI,document.location),{host:n,pathname:i}=t;if("github.com"===n&&i.startsWith("/w3c/web-platform-tests/")){const t="Web Platform Tests have moved to a new Github Organization at https://github.com/web-platform-tests. Please update your [`testSuiteURI`](https://github.com/w3c/respec/wiki/testSuiteURI) to point to the "+`new tests repository (e.g., https://github.com/web-platform-tests/${e.shortName} ).`;(0,r.pub)("warn",t)}}e.title=document.title||"No Title",e.subtitle||(e.subtitle="");if(e.publishDate=E(e,"publishDate",document.lastModified),e.publishYear=e.publishDate.getUTCFullYear(),e.publishHumanDate=f.format(e.publishDate),e.isNoTrack=v.includes(e.specStatus),e.isRecTrack=!e.noRecTrack&&y.includes(e.specStatus),e.isMemberSubmission="Member-SUBM"===e.specStatus,e.isMemberSubmission){const t={alt:"W3C Member Submission",href:"https://www.w3.org/Submission/",src:"https://www.w3.org/Icons/member_subm-v.svg",width:"211"};e.logos.push(p({},C,t))}if(e.isTeamSubmission="Team-SUBM"===e.specStatus,e.isTeamSubmission){const t={alt:"W3C Team Submission",href:"https://www.w3.org/TeamSubmission/",src:"https://www.w3.org/Icons/team_subm-v.svg",width:"211"};e.logos.push(p({},C,t))}e.isSubmission=e.isMemberSubmission||e.isTeamSubmission,e.anOrA=x.includes(e.specStatus)?"an":"a",e.isTagFinding="finding"===e.specStatus||"draft-finding"===e.specStatus,e.edDraftURI||(e.edDraftURI="","ED"===e.specStatus&&(0,r.pub)("warn","Editor's Drafts should set edDraftURI."));e.maturity=h[e.specStatus]?h[e.specStatus]:e.specStatus;var n="TR";"Member-SUBM"===e.specStatus?n="Submission":"Team-SUBM"===e.specStatus&&(n="TeamSubmission");e.isRegular&&(e.thisVersion="https://www.w3.org/"+n+"/"+e.publishDate.getUTCFullYear()+"/"+e.maturity+"-"+e.shortName+"-"+(0,t.concatDate)(e.publishDate)+"/");"ED"===e.specStatus&&(e.thisVersion=e.edDraftURI);e.isRegular&&(e.latestVersion="https://www.w3.org/"+n+"/"+e.shortName+"/");e.isTagFinding&&(e.latestVersion="https://www.w3.org/2001/tag/doc/"+e.shortName,e.thisVersion=e.latestVersion+"-"+t.ISODate.format(e.publishDate));if(e.previousPublishDate){e.previousMaturity||e.isTagFinding||(0,r.pub)("error","`previousPublishDate` is set, but not `previousMaturity`."),e.previousPublishDate=E(e,"previousPublishDate");var i=h[e.previousMaturity]?h[e.previousMaturity]:e.previousMaturity;e.isTagFinding?e.prevVersion=e.latestVersion+"-"+t.ISODate.format(e.previousPublishDate):e.isCGBG?e.prevVersion=e.prevVersion||"":e.isBasic?e.prevVersion="":e.prevVersion="https://www.w3.org/TR/"+e.previousPublishDate.getUTCFullYear()+"/"+i+"-"+e.shortName+"-"+(0,t.concatDate)(e.previousPublishDate)+"/"}else/NOTE$/.test(e.specStatus)||"FPWD"===e.specStatus||"FPLC"===e.specStatus||"ED"===e.specStatus||e.noRecTrack||e.isNoTrack||e.isSubmission||(0,r.pub)("error","Document on track but no previous version: Add `previousMaturity`, and `previousPublishDate` to ReSpec's config."),e.prevVersion||(e.prevVersion="");e.prevRecShortname&&!e.prevRecURI&&(e.prevRecURI="https://www.w3.org/TR/"+e.prevRecShortname);e.editors&&0!==e.editors.length||(0,r.pub)("error","At least one editor is required");var o=function(e){e.name||(0,r.pub)("error","All authors and editors must have a name.")};e.editors&&e.editors.forEach(o);e.formerEditors&&e.formerEditors.forEach(o);e.authors&&e.authors.forEach(o);e.multipleEditors=e.editors&&e.editors.length>1,e.multipleFormerEditors=Array.isArray(e.formerEditors)&&e.formerEditors.length>1,e.multipleAuthors=e.authors&&e.authors.length>1,$.each(e.alternateFormats||[],function(e,t){t.uri&&t.label||(0,r.pub)("error","All alternate formats must have a uri and a label.")}),e.multipleAlternates=e.alternateFormats&&e.alternateFormats.length>1,e.alternatesHTML=e.alternateFormats&&(0,t.joinAnd)(e.alternateFormats,function(e){var t=e.hasOwnProperty("lang")&&e.lang?" hreflang='"+e.lang+"'":"";return t+=e.hasOwnProperty("type")&&e.type?" type='"+e.type+"'":"","<a rel='alternate' href='"+e.uri+"'"+t+">"+e.label+"</a>"}),e.bugTracker&&(e.bugTracker.new&&e.bugTracker.open?e.bugTrackerHTML="<a href='"+e.bugTracker.new+"'>"+e.l10n.file_a_bug+"</a> "+e.l10n.open_parens+"<a href='"+e.bugTracker.open+"'>"+e.l10n.open_bugs+"</a>"+e.l10n.close_parens:e.bugTracker.open?e.bugTrackerHTML="<a href='"+e.bugTracker.open+"'>open bugs</a>":e.bugTracker.new&&(e.bugTrackerHTML="<a href='"+e.bugTracker.new+"'>file a bug</a>"));e.copyrightStart&&e.copyrightStart==e.publishYear&&(e.copyrightStart="");for(var a in g)b[a]||(b[a]=g[a]);e.longStatus=b[e.specStatus],e.textStatus=g[e.specStatus],m[e.specStatus]&&(e.rdfStatus=m[e.specStatus]);e.showThisVersion=!e.isNoTrack||e.isTagFinding,e.showPreviousVersion="FPWD"!==e.specStatus&&"FPLC"!==e.specStatus&&"ED"!==e.specStatus&&!e.isNoTrack&&!e.isSubmission,/NOTE$/.test(e.specStatus)&&!e.prevVersion&&(e.showPreviousVersion=!1);e.isTagFinding&&(e.showPreviousVersion=!!e.previousPublishDate);e.notYetRec=e.isRecTrack&&"REC"!==e.specStatus,e.isRec=e.isRecTrack&&"REC"===e.specStatus,e.isRec&&!e.errata&&(0,r.pub)("error","Recommendations must have an errata link.");e.notRec="REC"!==e.specStatus,e.prependW3C=!1,e.isED="ED"===e.specStatus,e.isCR="CR"===e.specStatus,e.isPR="PR"===e.specStatus,e.isPER="PER"===e.specStatus,e.isMO="MO"===e.specStatus,e.isNote=["FPWD-NOTE","WG-NOTE"].includes(e.specStatus),e.isIGNote="IG-NOTE"===e.specStatus,e.dashDate=t.ISODate.format(e.publishDate),e.publishISODate=e.publishDate.toISOString(),e.shortISODate=t.ISODate.format(e.publishDate),Object.defineProperty(e,"wgId",{get(){if(!this.hasOwnProperty("wgPatentURI"))return"";const e=this.wgPatentURI.split("/"),t=e.findIndex(e=>"pp-impl"===e)+1;return e[t]||""}});const s=(e.isCGBG?c.default:u.default)(e);document.body.insertBefore(s,document.body.firstChild),document.body.classList.add("h-entry");var l=document.getElementById("sotd")||document.createElement("section");!e.isCGBG&&e.isNoTrack&&!e.isTagFinding||l.id||(0,r.pub)("error","A custom SotD paragraph is required for your type of document.");l.id=l.id||"sotd",l.classList.add("introductory");var d=[e.wg,e.wgURI,e.wgPatentURI];d.some(e=>Array.isArray(e))&&!d.every(e=>Array.isArray(e))&&(0,r.pub)("error","If one of '`wg`', '`wgURI`', or '`wgPatentURI`' is an array, they all have to be.");e.isCGBG&&!e.wg&&(0,r.pub)("error","[`wg`](https://github.com/w3c/respec/wiki/wg) configuration option is required for this kind of document.");if(Array.isArray(e.wg)){e.multipleWGs=e.wg.length>1,e.wgHTML=(0,t.joinAnd)(e.wg,function(t,n){return"the <a href='"+e.wgURI[n]+"'>"+t+"</a>"});for(var T=[],S=0,A=e.wg.length;S<A;S++)T.push("a <a href='"+e.wgPatentURI[S]+"' rel='disclosure'>public list of any patent disclosures ("+e.wg[S]+")</a>");e.wgPatentHTML=(0,t.joinAnd)(T)}else e.multipleWGs=!1,e.wgHTML="the <a href='"+e.wgURI+"'>"+e.wg+"</a>";"PR"!==e.specStatus||e.crEnd||(0,r.pub)("error",'`specStatus` is "PR" but no `crEnd` is specified (needed to indicate end of previous CR).');"CR"!==e.specStatus||e.crEnd||(0,r.pub)("error",'`specStatus` is "CR", but no `crEnd` is specified in Respec config.');e.crEnd=E(e,"crEnd"),e.humanCREnd=f.format(e.crEnd),"PR"!==e.specStatus||e.prEnd||(0,r.pub)("error",'`specStatus` is "PR" but no `prEnd` is specified.');e.prEnd=E(e,"prEnd"),e.humanPREnd=f.format(e.prEnd),"PER"!==e.specStatus||e.perEnd||(0,r.pub)("error","Status is PER but no perEnd is specified");e.perEnd=E(e,"perEnd"),e.humanPEREnd=f.format(e.perEnd),e.recNotExpected=!!e.recNotExpected||!e.isRecTrack&&"WD"==e.maturity&&"FPWD-NOTE"!==e.specStatus,e.isIGNote&&!e.charterDisclosureURI&&(0,r.pub)("error","IG-NOTEs must link to charter's disclosure section using `charterDisclosureURI`.");""!==e.subjectPrefix&&(e.subjectPrefixEnc=encodeURIComponent(e.subjectPrefix));!e.implementationReportURI&&e.isCR&&(0,r.pub)("error","CR documents must have an [`implementationReportURI`](https://github.com/w3c/respec/wiki/implementationReportURI) that describes [implementation experience](https://www.w3.org/2018/Process-20180201/#implementation-experience).");!e.implementationReportURI&&e.isPR&&(0,r.pub)("warn","PR documents should include an [`implementationReportURI`](https://github.com/w3c/respec/wiki/implementationReportURI) that describes [implementation experience](https://www.w3.org/2018/Process-20180201/#implementation-experience).");e.isTagFinding&&!e.additionalContent&&(0,r.pub)("warn","ReSpec does not support automated SotD generation for TAG findings, please add the prerequisite content in the 'sotd' section");(0,r.pub)("amend-user-config",{publishISODate:e.publishISODate,generatedSubtitle:`${e.longStatus} ${e.publishHumanDate}`})};d(n),d(i),d(o),d(a);var c=d(s),u=d(l);function d(e){return e&&e.__esModule?e:{default:e}}var p=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="oai/headers";const f=new Intl.DateTimeFormat(["en-GB"],{timeZone:"UTC",year:"numeric",month:"long",day:"2-digit"}),h={FPWD:"WD",LC:"WD",FPLC:"WD","FPWD-NOTE":"NOTE","WD-NOTE":"WD","LC-NOTE":"LC","IG-NOTE":"NOTE","WG-NOTE":"NOTE"},m={NOTE:"w3p:NOTE",WD:"w3p:WD",LC:"w3p:LastCall",CR:"w3p:CR",PR:"w3p:PR",REC:"w3p:REC",PER:"w3p:PER",RSCND:"w3p:RSCND"},g={NOTE:"Working Group Note","WG-NOTE":"Working Group Note","CG-NOTE":"Co-ordination Group Note","IG-NOTE":"Interest Group Note","Member-SUBM":"Member Submission","Team-SUBM":"Team Submission",MO:"Member-Only Document",ED:"Editor's Draft",FPWD:"First Public Working Draft",WD:"Working Draft","FPWD-NOTE":"Working Group Note","WD-NOTE":"Working Draft","LC-NOTE":"Working Draft",FPLC:"First Public and Last Call Working Draft",LC:"Last Call Working Draft",CR:"Candidate Recommendation",PR:"Proposed Recommendation",PER:"Proposed Edited Recommendation",REC:"Recommendation",RSCND:"Rescinded Recommendation",unofficial:"Unofficial Draft",base:"Published",finding:"TAG Finding","draft-finding":"Draft TAG Finding","CG-DRAFT":"Draft Community Group Report","CG-FINAL":"Final Community Group Report","BG-DRAFT":"Draft Business Group Report","BG-FINAL":"Final Business Group Report"},b={"FPWD-NOTE":"First Public Working Group Note","LC-NOTE":"Last Call Working Draft"},y=["FPWD","WD","FPLC","LC","CR","PR","PER","REC"],v=["MO","unofficial","base","finding","draft-finding","CG-DRAFT","CG-FINAL","BG-DRAFT","BG-FINAL"],w=["CG-DRAFT","CG-FINAL","BG-DRAFT","BG-FINAL"],x=["ED","IG-NOTE"],k={cc0:{name:"Creative Commons 0 Public Domain Dedication",short:"CC0",url:"https://creativecommons.org/publicdomain/zero/1.0/"},"w3c-software":{name:"W3C Software Notice and License",short:"W3C Software",url:"https://www.w3.org/Consortium/Legal/2002/copyright-software-20021231"},"w3c-software-doc":{name:"W3C Software and Document Notice and License",short:"W3C Software and Document",url:"https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document"},apache2:{name:"Apache 2.0 License",short:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"},"cc-by":{name:"Creative Commons Attribution 4.0 International Public License",short:"CC-BY",url:"https://creativecommons.org/licenses/by/4.0/legalcode"}},C=Object.freeze({id:"",alt:"",href:"",src:"",height:"48",width:"72"});function E(e,n,i=new Date){const o=e[n]?new Date(e[n]):new Date(i);if(Number.isFinite(o.valueOf())){const e=t.ISODate.format(o);return new Date(e)}const a=`[\`${n}\`](https://github.com/w3c/respec/wiki/${n}) `+`is not a valid date: "${e[n]}". Expected format 'YYYY-MM-DD'.`;return(0,r.pub)("error",a),new Date(t.ISODate.format(new Date))}}),define("w3c/abstract",["exports","core/pubsubhub","core/l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(){const e=document.getElementById("abstract");if(!e)return void(0,t.pub)("error",'Document must have one element with `id="abstract"');e.classList.add("introductory");let r=document.querySelector("#abstract>h2");if(r)return;(r=document.createElement("h2")).innerText=n.l10n[n.lang].abstract,e.insertAdjacentElement("afterbegin",r)};e.name="w3c/abstract"}),define("w3c/templates/conformance",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.default=(()=>{const e=hyperHTML;return e`<h2>Conformance</h2> -<p> - As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, - and notes in this specification are non-normative. Everything else in this specification is - normative. -</p> -<p id='respecRFC2119'> - to be interpreted as described in [[!RFC2119]]. -</p>`})}),define("w3c/conformance",["exports","w3c/templates/conformance","core/pubsubhub"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,r){var o=$("#conformance");o.length&&o.prepend((0,i.default)(e).childNodes);(0,n.pub)("end","w3c/conformance"),r()};var r,i=(r=t)&&r.__esModule?r:{default:r};e.name="w3c/conformance"}),define("core/data-transform",["exports","core/utils"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){Array.from(n.querySelectorAll("[data-transform]")).forEach(e=>{e.innerHTML=(0,t.runTransforms)(e.innerHTML,e.dataset.transform),e.removeAttribute("data-transform")}),r()};e.name="core/data-transform"}),define("core/inlines",["exports","core/pubsubhub","deps/hyperhtml"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){document.normalize(),e.normativeReferences||(e.normativeReferences=new Set);e.informativeReferences||(e.informativeReferences=new Set);e.respecRFC2119||(e.respecRFC2119={});const n=new Map;for(const e of Array.from(document.querySelectorAll("abbr[title]")))n.set(e.textContent,e.title);const r=[...n.keys()];r.sort((e,t)=>t.length-e.length);const i=r.length?`(?:\\b${r.join("\\b)|(?:\\b")}\\b)`:null,o=window.$.fn.allTextNodes.call([document.body],["pre"]),a=new RegExp("(\\bMUST(?:\\s+NOT)?\\b|\\bSHOULD(?:\\s+NOT)?\\b|\\bSHALL(?:\\s+NOT)?\\b|\\bMAY\\b|\\b(?:NOT\\s+)?REQUIRED\\b|\\b(?:NOT\\s+)?RECOMMENDED\\b|\\bOPTIONAL\\b|(?:\\[\\[(?:!|\\\\)?[A-Za-z0-9\\.-]+\\]\\])"+(i?`|${i}`:"")+")");for(const r of o){const i=r.data.split(a);if(1===i.length)continue;const o=document.createDocumentFragment();for(;i.length;){const a=i.shift();let s=null;if(i.length&&(s=i.shift()),o.appendChild(document.createTextNode(a)),s)if(/MUST(?:\s+NOT)?|SHOULD(?:\s+NOT)?|SHALL(?:\s+NOT)?|MAY|(?:NOT\s+)?REQUIRED|(?:NOT\s+)?RECOMMENDED|OPTIONAL/.test(s))s=s.split(/\s+/).join(" "),o.appendChild(hyperHTML`<em class="rfc2119" title="${s}">${s}</em>`),e.respecRFC2119[s]=!0;else if(/^\[\[/.test(s)){let t=s;if(0===(t=(t=t.replace(/^\[\[/,"")).replace(/\]\]$/,"")).indexOf("\\"))o.appendChild(document.createTextNode(`[[${t.replace(/^\\/,"")}]]`));else{let n=!1;0===t.indexOf("!")&&(n=!0,t=t.replace(/^!/,"")),n?e.normativeReferences.add(t):e.informativeReferences.add(t),o.appendChild(document.createTextNode("[")),o.appendChild(hyperHTML`<cite><a class="bibref" href="${`#bib-${t}`}">${t}</a></cite>`),o.appendChild(document.createTextNode("]"))}}else n.has(s)?"ABBR"===r.parentNode.tagName?o.appendChild(document.createTextNode(s)):o.appendChild(hyperHTML`<abbr title="${n.get(s)}">${s}</abbr>`):(0,t.pub)("error",`Found token '${s}' but it does not correspond to anything`)}r.parentNode.replaceChild(o,r)}};e.name="core/inlines"}),mta=this,nta=function(){var e=[],t=[],n={},r={},i={};function o(e){return"string"==typeof e?new RegExp("^"+e+"$","i"):e}function a(e,t){return e===t?t:e===e.toUpperCase()?t.toUpperCase():e[0]===e[0].toUpperCase()?t.charAt(0).toUpperCase()+t.substr(1).toLowerCase():t.toLowerCase()}function s(e,t){return e.replace(t[0],function(n,r){var i,o,s=(i=t[1],o=arguments,i.replace(/\$(\d{1,2})/g,function(e,t){return o[t]||""}));return a(""===n?e[r-1]:n,s)})}function l(e,t,r){if(!e.length||n.hasOwnProperty(e))return t;for(var i=r.length;i--;){var o=r[i];if(o[0].test(t))return s(t,o)}return t}function c(e,t,n){return function(r){var i=r.toLowerCase();return t.hasOwnProperty(i)?a(r,i):e.hasOwnProperty(i)?a(r,e[i]):l(i,r,n)}}function u(e,t,n,r){return function(r){var i=r.toLowerCase();return!!t.hasOwnProperty(i)||!e.hasOwnProperty(i)&&l(i,i,n)===i}}function d(e,t,n){var r=1===t?d.singular(e):d.plural(e);return(n?t+" ":"")+r}return d.plural=c(i,r,e),d.isPlural=u(i,r,e),d.singular=c(r,i,t),d.isSingular=u(r,i,t),d.addPluralRule=function(t,n){e.push([o(t),n])},d.addSingularRule=function(e,n){t.push([o(e),n])},d.addUncountableRule=function(e){"string"!=typeof e?(d.addPluralRule(e,"$0"),d.addSingularRule(e,"$0")):n[e.toLowerCase()]=!0},d.addIrregularRule=function(e,t){t=t.toLowerCase(),e=e.toLowerCase(),i[e]=t,r[t]=e},[["I","we"],["me","us"],["he","they"],["she","they"],["them","them"],["myself","ourselves"],["yourself","yourselves"],["itself","themselves"],["herself","themselves"],["himself","themselves"],["themself","themselves"],["is","are"],["was","were"],["has","have"],["this","these"],["that","those"],["echo","echoes"],["dingo","dingoes"],["volcano","volcanoes"],["tornado","tornadoes"],["torpedo","torpedoes"],["genus","genera"],["viscus","viscera"],["stigma","stigmata"],["stoma","stomata"],["dogma","dogmata"],["lemma","lemmata"],["schema","schemata"],["anathema","anathemata"],["ox","oxen"],["axe","axes"],["die","dice"],["yes","yeses"],["foot","feet"],["eave","eaves"],["goose","geese"],["tooth","teeth"],["quiz","quizzes"],["human","humans"],["proof","proofs"],["carve","carves"],["valve","valves"],["looey","looies"],["thief","thieves"],["groove","grooves"],["pickaxe","pickaxes"],["whiskey","whiskies"]].forEach(function(e){return d.addIrregularRule(e[0],e[1])}),[[/s?$/i,"s"],[/[^\u0000-\u007F]$/i,"$0"],[/([^aeiou]ese)$/i,"$1"],[/(ax|test)is$/i,"$1es"],[/(alias|[^aou]us|tlas|gas|ris)$/i,"$1es"],[/(e[mn]u)s?$/i,"$1s"],[/([^l]ias|[aeiou]las|[emjzr]as|[iu]am)$/i,"$1"],[/(alumn|syllab|octop|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i,"$1i"],[/(alumn|alg|vertebr)(?:a|ae)$/i,"$1ae"],[/(seraph|cherub)(?:im)?$/i,"$1im"],[/(her|at|gr)o$/i,"$1oes"],[/(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|automat|quor)(?:a|um)$/i,"$1a"],[/(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)(?:a|on)$/i,"$1a"],[/sis$/i,"ses"],[/(?:(kni|wi|li)fe|(ar|l|ea|eo|oa|hoo)f)$/i,"$1$2ves"],[/([^aeiouy]|qu)y$/i,"$1ies"],[/([^ch][ieo][ln])ey$/i,"$1ies"],[/(x|ch|ss|sh|zz)$/i,"$1es"],[/(matr|cod|mur|sil|vert|ind|append)(?:ix|ex)$/i,"$1ices"],[/(m|l)(?:ice|ouse)$/i,"$1ice"],[/(pe)(?:rson|ople)$/i,"$1ople"],[/(child)(?:ren)?$/i,"$1ren"],[/eaux$/i,"$0"],[/m[ae]n$/i,"men"],["thou","you"]].forEach(function(e){return d.addPluralRule(e[0],e[1])}),[[/s$/i,""],[/(ss)$/i,"$1"],[/(wi|kni|(?:after|half|high|low|mid|non|night|[^\w]|^)li)ves$/i,"$1fe"],[/(ar|(?:wo|[ae])l|[eo][ao])ves$/i,"$1f"],[/ies$/i,"y"],[/\b([pl]|zomb|(?:neck|cross)?t|coll|faer|food|gen|goon|group|lass|talk|goal|cut)ies$/i,"$1ie"],[/\b(mon|smil)ies$/i,"$1ey"],[/(m|l)ice$/i,"$1ouse"],[/(seraph|cherub)im$/i,"$1"],[/(x|ch|ss|sh|zz|tto|go|cho|alias|[^aou]us|tlas|gas|(?:her|at|gr)o|ris)(?:es)?$/i,"$1"],[/(analy|ba|diagno|parenthe|progno|synop|the|empha|cri)(?:sis|ses)$/i,"$1sis"],[/(movie|twelve|abuse|e[mn]u)s$/i,"$1"],[/(test)(?:is|es)$/i,"$1is"],[/(alumn|syllab|octop|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i,"$1us"],[/(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|quor)a$/i,"$1um"],[/(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)a$/i,"$1on"],[/(alumn|alg|vertebr)ae$/i,"$1a"],[/(cod|mur|sil|vert|ind)ices$/i,"$1ex"],[/(matr|append)ices$/i,"$1ix"],[/(pe)(rson|ople)$/i,"$1rson"],[/(child)ren$/i,"$1"],[/(eau)x?$/i,"$1"],[/men$/i,"man"]].forEach(function(e){return d.addSingularRule(e[0],e[1])}),["adulthood","advice","agenda","aid","alcohol","ammo","anime","athletics","audio","bison","blood","bream","buffalo","butter","carp","cash","chassis","chess","clothing","cod","commerce","cooperation","corps","debris","diabetes","digestion","elk","energy","equipment","excretion","expertise","flounder","fun","gallows","garbage","graffiti","headquarters","health","herpes","highjinks","homework","housework","information","jeans","justice","kudos","labour","literature","machinery","mackerel","mail","media","mews","moose","music","manga","news","pike","plankton","pliers","pollution","premises","rain","research","rice","salmon","scissors","series","sewage","shambles","shrimp","species","staff","swine","tennis","traffic","transporation","trout","tuna","wealth","welfare","whiting","wildebeest","wildlife","you",/[^aeiou]ese$/i,/deer$/i,/fish$/i,/measles$/i,/o[iu]s$/i,/pox$/i,/sheep$/i].forEach(d.addUncountableRule),d},"function"==typeof require&&"object"==typeof exports&&"object"==typeof module?module.exports=nta():"function"==typeof define&&define.amd?define("deps/pluralize",[],function(){return nta()}):mta.pluralize=nta(),define("core/dfn",["exports","deps/pluralize","core/utils"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){e.hasOwnProperty("definitionMap")||(e.definitionMap=Object.create(null));let r;!0===e.pluralize&&(r=function(){const e=new Set;document.querySelectorAll("a:not([href])").forEach(t=>{const r=(0,n.norm)(t.textContent).toLowerCase();e.add(r),t.dataset.lt&&e.add(t.dataset.lt)});const r=new Set;return document.querySelectorAll("dfn:not([data-lt-noDefault])").forEach(e=>{const t=(0,n.norm)(e.textContent).toLowerCase();r.add(t),e.dataset.lt&&e.dataset.lt.split("|").reduce((e,t)=>e.add(t),r)}),function(n){const i=(0,t.plural)(n);return e.has(i)&&!r.has(i)?i:""}}());document.querySelectorAll("dfn").forEach(t=>{const i=t.closest("[data-dfn-for]");i&&i!==t&&!t.dataset.dfnFor&&(t.dataset.dfnFor=i.dataset.dfnFor),t.dataset.dfnFor&&(t.dataset.dfnFor=t.dataset.dfnFor.toLowerCase());const o=$(t),a=o.getDfnTitles({isDefinition:!0});if(r&&!t.hasAttribute("data-lt-no-plural")&&!t.hasAttribute("data-lt-noDefault")){const e=(0,n.norm)(t.textContent).toLowerCase(),i=r(e);i&&(a[0]===e?a.unshift(i):a.push(i),t.dataset.lt=a.filter(t=>t!==e).join("|"))}a.map(t=>(e.definitionMap[t]||(e.definitionMap[t]=[]),e.definitionMap[t])).reduce((e,t)=>(t.push(e),e),o)})};e.name="core/dfn"}),define("w3c/rfc2119",["exports","core/utils"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){const i=n.getElementById("respecRFC2119");if(!i)return r();const o=Object.getOwnPropertyNames(e.respecRFC2119);if(0===o.length)return i.remove(),r();const a=(0,t.joinAnd)(o.sort(),e=>`<em class="rfc2119">${e}</em>`),s=o.length>1,l=`The key word${s?"s ":" "} ${a} ${s?"are":"is"} ${i.innerHTML}`;i.innerHTML=l,r()};e.name="w3c/rfc2119"}),define("deps/text!core/css/examples.css",[],function(){return"/* --- EXAMPLES --- */\ndiv.example-title {\n min-width: 7.5em;\n color: #b9ab2d;\n}\ndiv.example-title span {\n text-transform: uppercase;\n}\naside.example, div.example, div.illegal-example {\n padding: 0.5em;\n margin: 1em 0;\n position: relative;\n clear: both;\n}\ndiv.illegal-example { color: red }\ndiv.illegal-example p { color: black }\naside.example, div.example {\n padding: .5em;\n border-left-width: .5em;\n border-left-style: solid;\n border-color: #e0cb52;\n background: #fcfaee;\n}\n\naside.example div.example {\n border-left-width: .1em;\n border-color: #999;\n background: #fff;\n}\naside.example div.example div.example-title {\n color: #999;\n}\n"}),define("core/examples",["exports","core/pubsubhub","deps/text!core/css/examples.css"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){var a=$("pre.example, pre.illegal-example, aside.example"),s=0;a.length&&($(n).find("head link").first().before($("<style/>").text(i.default)),a.each(function(n,r){var i=$(r),a={number:s,illegal:i.hasClass("illegal-example")};if(i.is("aside")){var l=o(e,i,++s,a);i.prepend(l),(0,t.pub)("example",a)}else{var c=!!i.parents("aside").length;c||s++;for(var u=i.html().split("\n");u.length&&/^\s*$/.test(u[0]);)u.shift();for(;u.length&&/^\s*$/.test(u[u.length-1]);)u.pop();var d=/^(\s+)/.exec(u[0]);if(d)for(var p=new RegExp("^"+d[1]),f=0;f<u.length;f++)u[f]=u[f].replace(p,"");a.content=u.join("\n"),i.html(u.join("\n")),i.removeClass("example illegal-example");var h=$("<div class='example'></div>"),l=o(e,i,c?0:s,a);h.append(l),h.append(i.clone()),i.replaceWith(h),c||(0,t.pub)("example",a)}}));r()};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/examples";var o=function(e,t,n,r){var i=n>0?" "+n:"",o=$(`<div class='example-title'><span>${e.l10n.example}${i}</span></div>`);return r.title=t.attr("title"),r.title&&(o.append($("<span style='text-transform: none'>: "+r.title+"</span>")),t.removeAttr("title")),o.addClass("marker"),o}}),define("deps/text!core/css/issues-notes.css",[],function(){return'/* --- ISSUES/NOTES --- */\ndiv.issue-title, div.note-title , div.ednote-title, div.warning-title {\n padding-right: 1em;\n min-width: 7.5em;\n color: #b9ab2d;\n}\ndiv.issue-title { color: #e05252; }\ndiv.note-title, div.ednote-title { color: #2b2; }\ndiv.warning-title { color: #f22; }\ndiv.issue-title span, div.note-title span, div.ednote-title span, div.warning-title span {\n text-transform: uppercase;\n}\ndiv.note, div.issue, div.ednote, div.warning {\n margin-top: 1em;\n margin-bottom: 1em;\n}\n.note > p:first-child, .ednote > p:first-child, .issue > p:first-child, .warning > p:first-child { margin-top: 0 }\n.issue, .note, .ednote, .warning {\n padding: .5em;\n border-left-width: .5em;\n border-left-style: solid;\n}\ndiv.issue, div.note , div.ednote, div.warning {\n padding: 1em 1.2em 0.5em;\n margin: 1em 0;\n position: relative;\n clear: both;\n}\nspan.note, span.ednote, span.issue, span.warning { padding: .1em .5em .15em; }\n\n.issue {\n border-color: #e05252;\n background: #fbe9e9;\n}\n.note, .ednote {\n border-color: #52e052;\n background: #e9fbe9;\n}\n\n.warning {\n border-color: #f11;\n border-width: .2em;\n border-style: solid;\n background: #fbe9e9;\n}\n\n.warning-title:before{\n content: "⚠"; /*U+26A0 WARNING SIGN*/\n font-size: 3em;\n float: left;\n height: 100%;\n padding-right: .3em;\n vertical-align: top;\n margin-top: -0.5em;\n}\n\nli.task-list-item {\n list-style: none;\n}\n\ninput.task-list-item-checkbox {\n margin: 0 0.35em 0.25em -1.6em;\n vertical-align: middle;\n}\n\n.issue a.respec-gh-label {\n padding: 5px;\n margin: 0 2px 0 2px;\n font-size: 10px;\n text-transform: none;\n text-decoration: none;\n font-weight: bold;\n border-radius: 4px;\n position: relative;\n bottom: 2px;\n}\n\n.issue a.respec-label-dark {\n color: #fff;\n background-color: #000;\n}\n\n.issue a.respec-label-light {\n color: #000;\n background-color: #fff;\n}\n'}),define("core/issues-notes",["exports","core/pubsubhub","deps/text!core/css/issues-notes.css","core/utils","deps/hyperhtml"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){const n=document.querySelectorAll(".issue, .note, .warning, .ednote");if(!n.length)return;const i=e.githubAPI?await async function(e){const{githubAPI:n,githubUser:i,githubToken:o}=e,a=document.querySelectorAll(".issue[data-number]");if(a.length>s){const e=`Your spec contains ${a.length} Github issues, `+`but GitHub only allows ${s} requests. Some issues might not show up.`;(0,t.pub)("warning",e)}const l=[...a].map(e=>Number.parseInt(e.dataset.number,10)).filter(e=>e).map(async e=>{const a=`${n}/issues/${e}`,s={Accept:"application/vnd.github.v3.html+json"};if(i&&o){const e=btoa(`${i}:${o}`),t=`Basic ${e}`;Object.assign(s,{Authorization:t})}const l=new Request(a,{headers:s}),c=await(0,r.fetchAndCache)(l);return async function(e,n){const r={title:"",number:n,state:"",message:""};try{const t=await e.json();Object.assign(r,t)}catch(e){r.message=`Error JSON parsing issue #${n} from GitHub.`}if(!e.ok||r.message){const i=`Error fetching issue #${n} from GitHub. ${r.message} (HTTP Status ${e.status}).`;(0,t.pub)("error",i)}return[n,r]}(c,e)}),c=await Promise.all(l);return new Map(c)}(e):new Map,{head:c}=document;c.insertBefore(hyperHTML`<style>${[o.default]}</style>`,c.querySelector("link")),function(e,n,r){const i=$(e),{issueBase:o,githubAPI:s}=r;var c=!!document.querySelector(".issue[data-number]"),u=0,d=$("<div><h2>"+r.l10n.issue_summary+"</h2><ul></ul></div>"),p=d.find("ul");s&&Array.from(i).filter(({dataset:{number:e}})=>void 0!==e&&"closed"===n.get(Number(e)).state).forEach(e=>{const{dataset:{number:n}}=e,r=`Github issue ${n} was closed on GitHub, so removing from spec`;(0,t.pub)("warn",r),e.remove()});i.filter((e,t)=>t.parentNode).each(function(e,i){var d=$(i),f=d.hasClass("issue"),h=d.hasClass("warning"),m=d.hasClass("ednote"),g=d.hasClass("atrisk"),b="span"===d[0].localName,y=d.attr("data-number"),v={inline:b};if(v.type=f?"issue":h?"warning":m?"ednote":"note",!f||b||c?y&&(v.number=y):(u++,v.number=u),!b){var w,x=$("<div class='"+v.type+(g?" atrisk":"")+"'></div>"),k=$("<div role='heading' class='"+v.type+"-title'><span></span></div>"),C=f?g?r.l10n.feature_at_risk:r.l10n.issue:h?r.l10n.warning:m?r.l10n.editors_note:r.l10n.note;if(i.id?(x[0].id=i.id,i.removeAttribute("id")):x.makeID("issue-container",v.number?`number-${v.number}`:""),k.makeID("h",v.type),v.title=d.attr("title"),f&&(c?y&&(C+=" "+y,!g&&o?k.find("span").wrap($("<a href='"+o+y+"'/>")):g&&r.atRiskBase&&k.find("span").wrap($("<a href='"+r.atRiskBase+y+"'/>")),(w=n.get(Number(y)))&&!v.title&&(v.title=w.title)):C+=" "+u,void 0!==v.number)){var E=$("<li><a></a></li>");E.find("a").attr("href","#"+x[0].id).text(r.l10n.issue+" "+v.number),v.title&&E.append($("<span style='text-transform: none'>: "+v.title+"</span>")),p.append(E)}if(k.find("span").text(C),w&&v.title&&s){const e=Array.from(w.labels).map(e=>{const t=new URL("issues/",r.github.repoURL+"/");return t.searchParams.set("q",`is:issue is:open label:"${e.name}"`),a({},e,{href:t.href})}).map(l).reduce((e,t)=>(e.appendChild(t),e),document.createDocumentFragment());k.append($("<span style='text-transform: none'>: "+v.title+"</span>").append(e)),d.removeAttr("title")}else v.title&&(k.append($("<span style='text-transform: none'>: "+v.title+"</span>")),d.removeAttr("title"));k.addClass("marker"),x.append(k),d.replaceWith(x);var T=d.removeClass(v.type).removeAttr("data-number");w&&!T.text().trim()&&(T=w.body_html),x.append(T);const e=k.parents("section").length+2;k.attr("aria-level",e)}(0,t.pub)(v.type,v)}),$(".issue").length?$("#issue-summary")&&$("#issue-summary").append(d.contents()):$("#issue-summary").length&&((0,t.pub)("warn","Using issue summary (#issue-summary) but no issues found."),$("#issue-summary").remove())}(n,i,e)};var i,o=(i=n)&&i.__esModule?i:{default:i};var a=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="core/issues-notes";const s=60;function l(e){const{color:t,href:n,name:r}=e,i=parseInt(t,16);var o;return hyperHTML`<a - class="${`respec-gh-label respec-label-${isNaN(i)||.2126*((o=i)>>16&255)+.7152*(o>>8&255)+.0722*(o>>0&255)>140?"light":"dark"}`}" - style="${`background-color: #${t}`}" - href="${n}">${r}</a>`}}),define("core/requirements",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){$(".req").each(function(e){e++;var t=$(this),n="Req. "+e;t.prepend("<a href='#"+t.attr("id")+"'>"+n+"</a>: ")}),$("a.reqRef").each(function(){var e,n,r,i=$(this),o=i.attr("href");o&&(e=o.substring(1),(n=$("#"+e)).length?r=n.find("> a").text():(r="Req. not found '"+e+"'",(0,t.pub)("error","Requirement not found in element `a.reqRef`: "+e)),i.text(r))}),r()};e.name="core/requirements"}),define("deps/text!core/css/bp.css",[],function(){return"/* --- Best Practices --- */\ndiv.practice {\n border: solid #bebebe 1px;\n margin: 2em 1em 1em 2em;\n}\n\nspan.practicelab {\n margin: 1.5em 0.5em 1em 1em;\n font-weight: bold;\n font-style: italic;\n background: #dfffff;\n position: relative;\n padding: 0 0.5em;\n top: -1.5em;\n}\n\np.practicedesc {\n margin: 1.5em 0.5em 1em 1em;\n}\n\n@media screen {\n p.practicedesc {\n position: relative;\n top: -2em;\n padding: 0;\n margin: 1.5em 0.5em -1em 1em;\n }\n}\n"}),define("core/best-practices",["exports","deps/text!core/css/bp.css","core/pubsubhub","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(){let e=0;const t=document.querySelectorAll("span.practicelab"),r=document.createElement("ul");for(const n of Array.from(t)){e++;const t=window.$.fn.makeID.call([n],"bp"),i=hyperHTML`<li><a href="${`#${t}`}">Best Practice ${e}</a>: ${n.textContent}</li>`;r.appendChild(i),n.insertBefore(document.createTextNode(`Best Practice ${e}: `),n.firstChild)}const o=document.getElementById("bp-summary");t.length?(document.head.insertBefore(hyperHTML`<style>${[i.default]}</style>`,document.head.querySelector("link")),o&&(o.appendChild(hyperHTML`<h2>Best Practices Summary</h2>`),o.appendChild(r))):o&&((0,n.pub)("warn","Using best practices summary (#bp-summary) but no best practices found."),o.remove())};var r,i=(r=t)&&r.__esModule?r:{default:r};e.name="core/best-practices"}),define("core/figures",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){i=n,[...i.querySelectorAll(":not(picture)>img:not([width]):not([height]):not([srcset])")].forEach(e=>{e.height=e.naturalHeight,e.width=e.naturalWidth});var i;var o={},a=[],s=0;$("figure").each(function(){var r=$(this),i=r.find("figcaption"),l=i.text(),c=r.makeID("fig",l);i.length||(0,t.pub)("warn","A `<figure>` should contain a `<figcaption>`."),s++,i.wrapInner($("<span class='fig-title'/>")).prepend(n.createTextNode(" ")).prepend($("<span class='figno'>"+s+"</span>")).prepend(n.createTextNode(e.l10n.fig)),o[c]=i.contents();var u=i.clone();u.find("a").renameElement("span").removeAttr("href"),a.push($("<li class='tofline'><a class='tocxref' href='#"+c+"'></a></li>").find(".tocxref").append(u.contents()).end())}),$("a[href]",n).each(function(){var e=$(this),t=e.attr("href");if(t&&(t=t.substring(1),o[t]&&(e.addClass("fig-ref"),""===e.html()))){const n=o[t].slice(0,2).clone();if(!e[0].hasAttribute("title")){const n=o[t].slice(2).clone().text();e.attr("title",n.trim())}e.append(n)}});var l=$("#tof",n);if(a.length&&l.length){l.hasClass("appendix")||l.hasClass("introductory")||l.parents("section").length||(l.prevAll("section.introductory").length===l.prevAll("section").length?l.addClass("introductory"):l.prevAll("appendix").length&&l.addClass("appendix")),l.append($("<h2>"+e.l10n.table_of_fig+"</h2>")),l.append($("<ul class='tof'/>"));for(var c=l.find("ul");a.length;)c.append(a.shift())}r()};e.name="core/figures"}),(()=>{const e={float:/-?(?=[0-9]*\.|[0-9]+[eE])(([0-9]+\.[0-9]*|[0-9]*\.[0-9]+)([Ee][-+]?[0-9]+)?|[0-9]+[Ee][-+]?[0-9]+)/y,integer:/-?(0([Xx][0-9A-Fa-f]+|[0-7]*)|[1-9][0-9]*)/y,identifier:/[A-Z_a-z][0-9A-Z_a-z-]*/y,string:/"[^"]*"/y,whitespace:/[\t\n\r ]+/y,comment:/((\/(\/.*|\*([^*]|\*[^\/])*\*\/)[\t\n\r ]*)+)/y,other:/[^\t\n\r 0-9A-Z_a-z]/y};function t(t,n,r,i){const o=e[n];o.lastIndex=r;const a=o.exec(t);return a?(i.push({type:n,value:a[0]}),o.lastIndex):-1}class n{constructor(e,t,n,r){this.message=e,this.line=t,this.input=n,this.tokens=r}toString(){return`${this.message}, line ${this.line} (tokens: '${this.input}')\n${JSON.stringify(this.tokens,null,4)}`}}function r(e,t){let r=1;e=e.slice();const i=new Map;let o=null;const a="float",s="integer",l="identifier",c="string",u="other",d=Object.freeze({type:"operation",getter:!1,setter:!1,deleter:!1,static:!1,stringifier:!1}),p=Object.freeze({sequence:!1,generic:null,nullable:!1,union:!1,idlType:null,extAttrs:[]});function f(t){let i="",a=0;for(;a<5&&e.length>a;)i+=e[a].value,a++;let s;throw s=o?`Got an error during or right after parsing \`${o.partial?"partial ":""}${o.type} ${o.name}\`: ${t}`:`Got an error before parsing any named definition: ${t}`,new n(s,r,i,e.slice(0,5))}function h(e,t){return i.has(e)&&f(`The name "${e}" of type "${i.get(e)}" is already seen`),i.set(e,t),e}let m=null;function g(t,n){if(e.length&&e[0].type===t)return void 0===n||e[0].value===n?(m=e.shift(),t===l&&m.value.startsWith("_")&&(m.value=m.value.substring(1)),m):void 0}function b(){if(e.length&&("whitespace"===e[0].type||"comment"===e[0].type)){const t=e.shift();return r+=function(e,t){let n=0;for(let r=e.indexOf(t);-1!==r;r=e.indexOf(t,r+1))++n;return n}(t.value,"\n"),t}}const y={ws:/([\t\n\r ]+)/y,"line-comment":/\/\/(.*)\r?\n?/y,"multiline-comment":/\/\*((?:[^*]|\*[^/])*)\*\//y};function v(e,t){const n={type:"whitespace",value:""};for(;;){const e=b();if(!e)break;n.value+=e.value}if(n.value.length>0){if(e){let r=n.value,i=0;for(;i<r.length;){let n=!1;for(let o in y){const a=y[o];a.lastIndex=i;const s=a.exec(r);if(s){e.push({type:o+(t?"-"+t:""),value:s[1]}),n=!0,i=a.lastIndex;break}}if(!n)throw new Error("Surprising white space construct.")}}return n}}function w(){const e=function(){let e="";return v(),g(l,"unsigned")&&(e="unsigned "),v(),g(l,"short")?e+"short":g(l,"long")?(e+="long",v(),g(l,"long")?e+" long":e):void(e&&f("Failed to parse integer type"))}()||function(){let e="";return v(),g(l,"unrestricted")&&(e="unrestricted "),v(),g(l,"float")?e+"float":g(l,"double")?e+"double":void(e&&f("Failed to parse float type"))}();return e||(v(),g(l,"boolean")?"boolean":g(l,"byte")?"byte":g(l,"octet")?"octet":void 0)}function x(){if(g(l,"true"))return{type:"boolean",value:!0};if(g(l,"false"))return{type:"boolean",value:!1};if(g(l,"null"))return{type:"null"};if(g(l,"Infinity"))return{type:"Infinity",negative:!1};if(g(l,"NaN"))return{type:"NaN"};const t=g(a)||g(s);if(t)return{type:"number",value:t.value};const n=g(u,"-");if(n){if(g(l,"Infinity"))return{type:"Infinity",negative:!0};e.unshift(n)}}function k(e){for(;;){if(v(),!g(u,"?"))return;e.nullable&&f("Can't nullable more than once"),e.nullable=!0}}function C(e){const t=w(),n=Object.assign({type:e||null},p);let r,i;if(t)n.idlType=t;else{if(!(r=g(l)))return;if(i=r.value,v(),g(u,"<")){"sequence"===i&&(n.sequence=!0),n.generic=i;const t=[];do{v(),t.push($(e)||f("Error parsing generic type "+i)),v()}while(g(u,","));return"sequence"===i?1!==t.length&&f("A sequence must have exactly one subtype"):"record"===i?(2!==t.length&&f("A record must have exactly two subtypes"),/^(DOMString|USVString|ByteString)$/.test(t[0].idlType)||f("Record key must be DOMString, USVString, or ByteString"),t[0].extAttrs.length&&f("Record key cannot have extended attribute")):"Promise"===i&&t[0].extAttrs.length&&f("Promise type cannot have extended attribute"),n.idlType=1===t.length?t[0]:t,v(),g(u,">")||f("Unterminated generic type "+i),k(n),n}n.idlType=i}return k(n),n.nullable&&"any"===n.idlType&&f("Type any cannot be made nullable"),n}function E(e){if(v(),!g(u,"("))return;const t=Object.assign({type:e||null},p,{union:!0,idlType:[]}),n=$()||f("Union type with no content");for(t.idlType.push(n);v(),g(l,"or");){const e=$()||f("No type after 'or' in union type");t.idlType.push(e)}return g(u,")")||f("Unterminated union type"),k(t),t}function $(e){const t=L(),n=C(e)||E(e);return t.length&&n&&(n.extAttrs=t),n}function T(t){const n={optional:!1,variadic:!1};n.extAttrs=L(t),v(t,"pea");const r=g(l,"optional");if(r&&(n.optional=!0,v()),n.idlType=$("argument-type"),!n.idlType)return void(r&&e.unshift(r));const i=m;n.optional||(v(),e.length>=3&&"other"===e[0].type&&"."===e[0].value&&"other"===e[1].type&&"."===e[1].value&&"other"===e[2].type&&"."===e[2].value&&(e.shift(),e.shift(),e.shift(),n.variadic=!0)),v();const o=g(l);if(!o)return r&&e.unshift(r),void e.unshift(i);if(n.name=o.value,n.optional){v();const e=j();void 0!==e&&(n.default=e)}return n}function S(e){const t=[],n=T(e?t:null);if(!n)return t;for(t.push(n);;){if(v(e?t:null),!g(u,","))return t;const n=T(e?t:null)||f("Trailing comma in arguments list");t.push(n)}}function A(e){v();const t=g(l);if(!t)return;const n={name:t.value,arguments:null,type:"extended-attribute",rhs:null};v();const r=g(u,"=");return r&&(v(),n.rhs=g(l)||g(a)||g(s)||g(c)),v(),g(u,"(")&&(r&&!n.rhs?n.rhs={type:"identifier-list",value:function(){const e=[],t=g(l);t?e.push(t.value):f("Expected identifiers but not found");for(;v(),g(u,",");){v();const t=g(l)||f("Trailing comma in identifiers list");e.push(t.value)}return e}()}:n.arguments=S(e),v(),g(u,")")||f("Unexpected token in extended attribute argument list")),r&&!n.rhs&&f("No right hand side to extended attribute assignment"),n}function L(e){const t=[];if(v(e),!g(u,"["))return t;for(t[0]=A(e)||f("Extended attribute with not content"),v();g(u,",");)t.push(A(e)||f("Trailing comma in extended attribute"));return v(),g(u,"]")||f("No end of extended attribute"),t}function j(){if(v(),g(u,"=")){v();const e=x();if(e)return e;if(g(u,"["))return g(u,"]")||f("Default sequence value must be empty"),{type:"sequence",value:[]};{const e=g(c)||f("No value for default");return e.value=e.value.slice(1,-1),e}}}function D(e){if(v(e,"pea"),!g(l,"const"))return;const t={type:"const",nullable:!1};v();let n=w();n||(n=(n=g(l)||f("No type for const")).value),t.idlType=Object.assign({type:"const-type"},p,{idlType:n}),v(),g(u,"?")&&(t.nullable=!0,v());const r=g(l)||f("No name for const");t.name=r.value,v(),g(u,"=")||f("No value assignment for const"),v();const i=x();return i?t.value=i:f("No value for const"),v(),g(u,";")||f("Unterminated const"),t}function _(){if(v(),g(u,":"))return v(),(g(l)||f("No type in inheritance")).value}function N(e,t){v(),e||(e={});const n=g(l);return e.name=n?n.value:null,v(),g(u,"(")||f("Invalid operation"),e.arguments=S(t),v(),g(u,")")||f("Unterminated operation"),v(),g(u,";")||f("Unterminated operation"),e}function R(t){v(t,"pea");const n=[],r={type:"attribute",static:!1,stringifier:!1,inherit:!1,readonly:!1},i=v();if(i&&n.push(i),g(l,"inherit")){(r.static||r.stringifier)&&f("Cannot have a static or stringifier inherit"),r.inherit=!0,n.push(m);const e=v();e&&n.push(e)}if(g(l,"readonly")){r.readonly=!0,n.push(m);const e=v();e&&n.push(e)}const o=P(r);return o||(e=n.concat(e)),o}function P(e){if(!g(l,"attribute"))return;v(),e.idlType=$("attribute-type")||f("No type in attribute"),e.idlType.sequence&&f("Attributes cannot accept sequence types"),"record"===e.idlType.generic&&f("Attributes cannot accept record types"),v();const t=g(l)||f("No name in attribute");return e.name=t.value,v(),g(u,";")||f("Unterminated attribute"),e}function M(){const e=C(t="return-type")||E(t);var t;if(!e){if(g(l,"void"))return"void";f("No return type")}return e}function O(e){v(e,"pea");const t=Object.assign({},d);for(;;)if(v(),g(l,"getter"))t.getter=!0;else if(g(l,"setter"))t.setter=!0;else{if(!g(l,"deleter"))break;t.deleter=!0}return t.getter||t.setter||t.deleter?(v(),t.idlType=M(),N(t,e),t):(t.idlType=M(),v(),N(t,e),t)}function I(e){if(v(e,"pea"),g(l,"static"))return v(),G(e,"static")||V(e,"static")||f("No body in static member")}function q(e){if(v(e,"pea"),g(l,"stringifier"))return v(),g(u,";")?Object.assign({},d,{stringifier:!0}):G(e,"stringifier")||V(e,"stringifier")||f("Unterminated stringifier")}function U(){return g(l,"iterable")?"iterable":g(l,"legacyiterable")?"legacyiterable":g(l,"maplike")?"maplike":g(l,"setlike")?"setlike":void 0}function W(){return g(l,"maplike")?"maplike":g(l,"setlike")?"setlike":void 0}function H(t){v(t,"pea");const n=[],r={type:null,idlType:null,readonly:!1};if(g(l,"readonly")){r.readonly=!0,n.push(m);var i=v();i&&n.push(i)}const o=(r.readonly?W:U)();if(!o)return void(e=n.concat(e));const a="maplike"===o,s=a||"iterable"===o;return r.type=o,"maplike"!==r.type&&"setlike"!==r.type&&delete r.readonly,v(),g(u,"<")?(r.idlType=[$()]||f(`Error parsing ${o} declaration`),v(),s&&(g(u,",")?(v(),r.idlType.push($()),v()):a&&f(`Missing second type argument in ${o} declaration`)),g(u,">")||f(`Unterminated ${o} declaration`),v(),g(u,";")||f(`Missing semicolon after ${o} declaration`)):f(`Error parsing ${o} declaration`),r}function B(e,n,r="interface"){v();const i=g(l)||f("No name for interface"),a=[],s=o={type:r,name:e?i.value:h(i.value,"interface"),partial:e,members:a};for(e||(s.inheritance=_()||null),v(),g(u,"{")||f("Bodyless interface");;){if(v(n?a:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after interface"),s;const e=L(n?a:null);v();const r=D(n?a:null);if(r){r.extAttrs=e,s.members.push(r);continue}const i=t.allowNestedTypedefs&&Z(n?a:null)||I(n?a:null)||q(n?a:null)||H(n?a:null)||R(n?a:null)||O(n?a:null)||f("Unknown member");i.extAttrs=e,s.members.push(i)}}function F(e,t){if(v(e?null:t,"pea"),g(l,"interface"))return function(e,t){if(v(),!g(l,"mixin"))return;v();const n=g(l)||f("No name for interface mixin"),r=[],i=o={type:"interface mixin",name:e?n.value:h(n.value,"interface mixin"),partial:e,members:r};for(v(),g(u,"{")||f("Bodyless interface mixin");;){if(v(t?r:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after interface mixin"),i;const e=L(t?r:null);v();const n=D(t?r:null);if(n){n.extAttrs=e,i.members.push(n);continue}const o=q(t?r:null)||G(t?r:null)||V(t?r:null)||f("Unknown member");o.extAttrs=e,i.members.push(o)}}(e,t)||B(e,t)||f("Interface has no proper body")}function z(e,t){if(v(e?null:t,"pea"),!g(l,"namespace"))return;v();const n=g(l)||f("No name for namespace"),r=[],i=o={type:"namespace",name:e?n.value:h(n.value,"namespace"),partial:e,members:r};for(v(),g(u,"{")||f("Bodyless namespace");;){if(v(t?r:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after namespace"),i;const e=L(t?r:null);v();const n=G(t?r:null)||V(t?r:null)||f("Unknown member");n.extAttrs=e,i.members.push(n)}}function G(t,n){const r=v(t,"pea"),i=[],o={type:"attribute",static:!1,stringifier:!1,inherit:!1,readonly:!1};if(n&&(o[n]=!0),r&&i.push(r),g(l,"readonly")){o.readonly=!0,i.push(m);const e=v();e&&i.push(e)}const a=P(o);return a||(e=i.concat(e)),a}function V(e,t){v(e,"pea");const n=Object.assign({},d);return t&&(n[t]=!0),n.idlType=M(),N(n,e)}function X(e,t){if(v(e?null:t,"pea"),!g(l,"dictionary"))return;v();const n=g(l)||f("No name for dictionary"),r=[],i=o={type:"dictionary",name:e?n.value:h(n.value,"dictionary"),partial:e,members:r};for(e||(i.inheritance=_()||null),v(),g(u,"{")||f("Bodyless dictionary");;){if(v(t?r:null),g(u,"}"))return v(),g(u,";")||f("Missing semicolon after dictionary"),i;const e=L(t?r:null);v(t?r:null,"pea");const n=g(l,"required"),o=$("dictionary-type")||f("No type for dictionary member");v();const a=g(l)||f("No name for dictionary member"),s=j();n&&s&&f("Required member must not have a default");const c={type:"field",name:a.value,required:!!n,idlType:o,extAttrs:e};void 0!==s&&(c.default=s),i.members.push(c),v(),g(u,";")||f("Unterminated dictionary member")}}function Z(e){if(v(e,"pea"),!g(l,"typedef"))return;const t={type:"typedef"};v(),t.idlType=$("typedef-type")||f("No type in typedef"),v();const n=g(l)||f("No name in typedef");return t.name=h(n.value,"typedef"),o=t,v(),g(u,";")||f("Unterminated typedef"),t}function Y(t){return function(e){let t;if(v(e,"pea"),!g(l,"callback"))return;if(v(),g(l,"interface"))return t=B(!1,e,"callback interface");const n=g(l)||f("No name for callback");return t=o={type:"callback",name:h(n.value,"callback")},v(),g(u,"=")||f("No assignment in callback"),v(),t.idlType=M(),v(),g(u,"(")||f("No arguments in callback"),t.arguments=S(e),v(),g(u,")")||f("Unterminated callback"),v(),g(u,";")||f("Unterminated callback"),t}(t)||F(!1,t)||function(e){if(v(e,"pea"),!g(l,"partial"))return;return X(!0,e)||F(!0,e)||z(!0,e)||f("Partial doesn't apply to anything")}(t)||X(!1,t)||function(e){if(v(e,"pea"),!g(l,"enum"))return;v();const t=g(l)||f("No name for enum"),n=[],r=o={type:"enum",name:h(t.value,"enum"),values:n};v(),g(u,"{")||f("No curly for enum");let i=!1;for(;;){if(v(e?n:null),g(u,"}"))return v(),g(u,";")||f("No semicolon after enum"),r;const t=g(c)||f("Unexpected value in enum");t.value=t.value.slice(1,-1),r.values.push(t),v(e?n:null),g(u,",")?(e&&n.push({type:","}),v(e?n:null),i=!0):i=!1}}(t)||Z(t)||function(t){v(t,"pea");const n=g(l);if(!n)return;const r=v();if(g(l,"implements")){const e={type:"implements",target:n.value};v();const t=g(l)||f("Incomplete implements statement");return e.implements=t.value,v(),g(u,";")||f("No terminating ; for implements statement"),e}r&&e.unshift(r),e.unshift(n)}(t)||function(t){v(t,"pea");const n=g(l);if(!n)return;const r=v();if(g(l,"includes")){const e={type:"includes",target:n.value};v();const t=g(l)||f("Incomplete includes statement");return e.includes=t.value,v(),g(u,";")||f("No terminating ; for includes statement"),e}r&&e.unshift(r),e.unshift(n)}(t)||z(!1,t)}const Q=function(t){if(!e.length)return[];const n=[];for(;;){const e=L(t?n:null),r=Y(t?n:null);if(!r){e.length&&f("Stray extended attributes");break}r.extAttrs=e,n.push(r)}return n}(t.ws);return e.length&&f("Unrecognised tokens"),Q}const i={parse:(e,n)=>(n||(n={}),r(function(e){const n=[];let r=0;for(;r<e.length;){const i=e.charAt(r);let o=-1;if(/[-0-9.]/.test(i)?(-1===(o=t(e,"float",r,n))&&(o=t(e,"integer",r,n)),-1===o&&(o=t(e,"other",r,n))):/[A-Z_a-z]/.test(i)?o=t(e,"identifier",r,n):'"'===i?-1===(o=t(e,"string",r,n))&&(o=t(e,"other",r,n)):/[\t\n\r ]/.test(i)?o=t(e,"whitespace",r,n):"/"===i?-1===(o=t(e,"comment",r,n))&&(o=t(e,"other",r,n)):o=t(e,"other",r,n),-1===o)throw new Error("Token stream not progressing");r=o}return n}(e),n))};"undefined"!=typeof module&&void 0!==module.exports?module.exports=i:"function"==typeof define&&define.amd?define("deps/webidl2",[],()=>i):(self||window).WebIDL2=i})(),define("deps/text!core/css/webidl.css",[],function(){return'/* --- WEB IDL --- */\n\npre.idl {\n padding: 1em;\n}\n\n.respec-idl-separator {\n padding: 0 0 0.4cm 0;\n}\n\n.respec-idl-separator:last-child {\n padding: 0;\n}\n\n@media print {\n pre.idl {\n white-space: pre-wrap;\n }\n}\n\npre.idl::before {\n content: "WebIDL";\n display: block;\n width: 150px;\n background: #90b8de;\n color: #fff;\n font-family: sans-serif;\n font-weight: bold;\n margin: -1em 0 1em -1em;\n height: 28px;\n line-height: 28px; \n}\n\n.idlType {\n color: #ff4500;\n font-weight: bold;\n text-decoration: none;\n}\n\n\n/*.idlModule*/\n\n\n/*.idlModuleID*/\n\n\n/*.idlInterface*/\n\n.idlInterfaceID,\n.idlDictionaryID,\n.idlCallbackID,\n.idlEnumID {\n font-weight: bold;\n color: #005a9c;\n}\n\na.idlEnumItem {\n color: #000;\n border-bottom: 1px dotted #ccc;\n text-decoration: none;\n}\n\n.idlSuperclass {\n font-style: italic;\n color: #005a9c;\n}\n\n\n/*.idlAttribute*/\n\n.idlAttrType,\n.idlFieldType,\n.idlMemberType {\n color: #005a9c;\n}\n\n.idlAttrName,\n.idlFieldName,\n.idlMemberName {\n color: #ff4500;\n}\n\n.idlAttrName a,\n.idlFieldName a,\n.idlMemberName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlMethod*/\n\n.idlMethType,\n.idlCallbackType {\n color: #005a9c;\n}\n\n.idlMethName {\n color: #ff4500;\n}\n\n.idlMethName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlCtor*/\n\n.idlCtorName {\n color: #ff4500;\n}\n\n.idlCtorName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlParam*/\n\n.idlParamType {\n color: #005a9c;\n}\n\n.idlParamName,\n.idlDefaultValue {\n font-style: italic;\n}\n\n.extAttr {\n color: #666;\n}\n\n\n/*.idlSectionComment*/\n\n.idlSectionComment {\n color: gray;\n}\n\n\n/*.idlIterable*/\n\n.idlIterableKeyType,\n.idlIterableValueType {\n color: #005a9c;\n}\n\n\n/*.idlMaplike*/\n\n.idlMaplikeKeyType,\n.idlMaplikeValueType {\n color: #005a9c;\n}\n\n\n/*.idlConst*/\n\n.idlConstType {\n color: #005a9c;\n}\n\n.idlConstName {\n color: #ff4500;\n}\n\n.idlConstName a {\n color: #ff4500;\n border-bottom: 1px dotted #ff4500;\n text-decoration: none;\n}\n\n\n/*.idlException*/\n\n.idlExceptionID {\n font-weight: bold;\n color: #c00;\n}\n\n.idlTypedefID,\n.idlTypedefType {\n color: #005a9c;\n}\n\n.idlRaises,\n.idlRaises a.idlType,\n.idlRaises a.idlType code,\n.excName a,\n.excName a code {\n color: #c00;\n font-weight: normal;\n}\n\n.excName a {\n font-family: monospace;\n}\n\n.idlRaises a.idlType,\n.excName a.idlType {\n border-bottom: 1px dotted #c00;\n}\n\n.excGetSetTrue,\n.excGetSetFalse,\n.prmNullTrue,\n.prmNullFalse,\n.prmOptTrue,\n.prmOptFalse {\n width: 45px;\n text-align: center;\n}\n\n.excGetSetTrue,\n.prmNullTrue,\n.prmOptTrue {\n color: #0c0;\n}\n\n.excGetSetFalse,\n.prmNullFalse,\n.prmOptFalse {\n color: #c00;\n}\n\n.idlImplements a, .idlIncludes a {\n font-weight: bold;\n}\n\ndl.attributes,\ndl.methods,\ndl.constants,\ndl.constructors,\ndl.fields,\ndl.dictionary-members {\n margin-left: 2em;\n}\n\n.attributes dt,\n.methods dt,\n.constants dt,\n.constructors dt,\n.fields dt,\n.dictionary-members dt {\n font-weight: normal;\n}\n\n.attributes dt code,\n.methods dt code,\n.constants dt code,\n.constructors dt code,\n.fields dt code,\n.dictionary-members dt code {\n font-weight: bold;\n color: #000;\n font-family: monospace;\n}\n\n.attributes dt code,\n.fields dt code,\n.dictionary-members dt code {\n background: #ffffd2;\n}\n\n.attributes dt .idlAttrType code,\n.fields dt .idlFieldType code,\n.dictionary-members dt .idlMemberType code {\n color: #005a9c;\n background: transparent;\n font-family: inherit;\n font-weight: normal;\n font-style: italic;\n}\n\n.methods dt code {\n background: #d9e6f8;\n}\n\n.constants dt code {\n background: #ddffd2;\n}\n\n.constructors dt code {\n background: #cfc;\n}\n\n.attributes dd,\n.methods dd,\n.constants dd,\n.constructors dd,\n.fields dd,\n.dictionary-members dd {\n margin-bottom: 1em;\n}\n\ntable.parameters,\ntable.exceptions {\n border-spacing: 0;\n border-collapse: collapse;\n margin: 0.5em 0;\n width: 100%;\n}\n\ntable.parameters {\n border-bottom: 1px solid #90b8de;\n}\n\ntable.exceptions {\n border-bottom: 1px solid #deb890;\n}\n\n.parameters th,\n.exceptions th {\n color: inherit;\n padding: 3px 5px;\n text-align: left;\n font-weight: normal;\n}\n\n.parameters th {\n color: #fff;\n background: #005a9c;\n}\n\n.exceptions th {\n background: #deb890;\n}\n\n.parameters td,\n.exceptions td {\n padding: 3px 10px;\n border-top: 1px solid #ddd;\n vertical-align: top;\n}\n\n.parameters tr:first-child td,\n.exceptions tr:first-child td {\n border-top: none;\n}\n\n.parameters td.prmName,\n.exceptions td.excName,\n.exceptions td.excCodeName {\n width: 100px;\n}\n\n.parameters td.prmType {\n width: 120px;\n}\n\ntable.exceptions table {\n border-spacing: 0;\n border-collapse: collapse;\n width: 100%;\n}\n\n.respec-button-copy-paste:focus {\n text-decoration: none;\n border-color: #51a7e8;\n outline: none;\n box-shadow: 0 0 5px rgba(81, 167, 232, 0.5);\n}\n\n.respec-button-copy-paste:focus:hover,\n.respec-button-copy-paste.selected:focus {\n border-color: #51a7e8;\n}\n\n.respec-button-copy-paste:hover,\n.respec-button-copy-paste:active,\n.respec-button-copy-paste.zeroclipboard-is-hover,\n.respec-button-copy-paste.zeroclipboard-is-active {\n text-decoration: none;\n background-color: #ddd;\n background-image: linear-gradient(#eee, #ddd);\n border-color: #ccc;\n}\n\n.respec-button-copy-paste:active,\n.respec-button-copy-paste.selected,\n.respec-button-copy-paste.zeroclipboard-is-active {\n background-color: #dcdcdc;\n background-image: none;\n border-color: #b5b5b5;\n box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15)\n}\n\n.respec-button-copy-paste.selected:hover {\n background-color: #cfcfcf;\n}\n\n.respec-button-copy-paste:disabled,\n.respec-button-copy-paste:disabled:hover,\n.respec-button-copy-paste.disabled,\n.respec-button-copy-paste.disabled:hover {\n color: rgba(102, 102, 102, 0.5);\n cursor: default;\n background-color: rgba(229, 229, 229, 0.5);\n background-image: none;\n border-color: rgba(197, 197, 197, 0.5);\n box-shadow: none;\n}\n'}),define("core/webidl",["exports","core/pubsubhub","deps/webidl2","handlebars.runtime","deps/text!core/css/webidl.css","templates","core/utils"],function(e,t,n,r,i,o,a){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0,e.run=function(e,n,r){var i=function(){z(),(0,t.pub)("end","core/webidl"),r()},o=$("pre.idl",n);if(!o.length)return i();l.default.registerHelper("extAttr",function(e,t){return U(e.extAttrs,t,!1)}),l.default.registerHelper("extAttrInline",function(e){return U(e.extAttrs,0,!0)}),l.default.registerHelper("extAttrClassName",function(){return"Constructor"===this.name||"NamedConstructor"===this.name?"idlCtor":"extAttr"}),l.default.registerHelper("extAttrRhs",function(e,t){return"identifier"===e.type?t.fn(e.value):`(${e.value.map(t.fn)})`}),l.default.registerHelper("param",function(e){return new l.default.SafeString(L({obj:e,optional:e.optional?"optional ":"",variadic:e.variadic?"...":""}))}),l.default.registerHelper("jsIf",function(e,t){return e?t.fn(this):t.inverse(this)}),l.default.registerHelper("idn",function(e){return new l.default.SafeString(_(e))}),l.default.registerHelper("idlType",function(e){return new l.default.SafeString(N(e.idlType))}),l.default.registerHelper("stringifyIdlConst",function(e){switch(e.type){case"null":return"null";case"Infinity":return e.negative?"-Infinity":"Infinity";case"NaN":return"NaN";case"number":return e.value;case"string":case"boolean":case"sequence":return JSON.stringify(e.value);default:return(0,t.pub)("error","Unexpected constant value type: `"+e.type+"`."),"<Unknown>"}}),l.default.registerHelper("escapeArgumentName",X),l.default.registerHelper("escapeAttributeName",Z),l.default.registerHelper("escapeIdentifier",Y),l.default.registerHelper("pads",function(e){return new l.default.SafeString(M(e))}),l.default.registerHelper("join",function(e,t,n){return e.map(n.fn).join(t)}),l.default.registerHelper("joinNonWhitespace",function(e,t,n){return e.filter(e=>"ws"!==e.type).map(n.fn).join(t)}),l.default.registerHelper("tryLink",function(e,t){const n=t.fn(this),r="toJSON"===e.name&&e.extAttrs.some(({name:e})=>"Default"===e);if(!e.dfn&&!r)return n;const i=document.createElement("a");return i.innerText=n,!e.dfn&&r?i.dataset.cite="WEBIDL#default-tojson-operation":(i.dataset.noDefault="",i.dataset.linkFor=e.linkFor?l.default.Utils.escapeExpression(e.linkFor).toLowerCase():"",i.dataset.lt=e.dfn[0].dataset.lt||""),i.outerHTML}),$(".idl",n).not("pre").length||$(n).find("head link").first().before($("<style/>").text(c.default));o.each(function(){var n;try{n=s.default.parse($(this).text(),{ws:!0})}catch(e){return void(0,t.pub)("error",`Failed to parse WebIDL: \`${e.message}\`.\n <details>\n <pre>${(0,a.normalizePadding)(this.textContent)}\n ${e}</pre>\n </details>`)}!function e(n,r,i,o){n.filter(({type:e})=>!1===["includes","implements","ws","ws-pea","ws-tpea","line-comment","multiline-comment"].includes(e)).forEach(function(n){var a;switch(n.type){case"callback interface":case"dictionary":case"interface":case"interface mixin":var s="";n.partial&&(V[n.name]||(V[n.name]=[]),V[n.name].push(n),s="-partial-"+V[n.name].length),e(n.members,r,n.name,o),a=n.name,n.idlId="idl-def-"+a.toLowerCase()+s;break;case"enum":a=n.name;for(const e of n.values)"string"===e.type&&(e.dfn=ne(a,e.value,r,n.type,o));n.idlId="idl-def-"+a.toLowerCase();break;case"callback":case"typedef":a=n.name,n.idlId="idl-def-"+a.toLowerCase();break;case"attribute":case"const":case"field":a=n.name,n.idlId="idl-def-"+i.toLowerCase()+"-"+a.toLowerCase();break;case"operation":if(n.name){a=n.name;var l=i+"."+a,c=i+"."+a+"()";G[c]||(G[c]=[]),G[l]?(n.overload=G[l].length,a=n.name+"!overload-"+n.overload):G[l]=[],G[c].push(n),G[l].push(n)}else(n.getter||n.setter||n.deleter||n.stringifier)&&(a="");const u=`idl-def-${i.toLowerCase()}-${a.toLowerCase()}`,d=n.overload||!n.arguments.length?"":"-"+n.arguments.filter(e=>!I(e.type)).map(e=>e.name.toLowerCase()).join("-").replace(/\s/g,"_");n.idlId=u+d;break;case"maplike":a="maplike",n.idlId=("idl-def-"+i+"-"+a).toLowerCase();break;case"iterable":a="iterable",n.idlId="idl-def-"+i.toLowerCase()+"-"+a.toLowerCase();break;default:return void(0,t.pub)("error",new Error("ReSpec doesn't know about IDL type: `"+n.type+"`."))}i&&(n.linkFor=i),n.dfn=ne(i,a,r,n.type,o)})}(n,e.definitionMap,"",this);var r,i,o=(r=n,(i=$("<pre></pre>").attr({class:"def idl"})).html(r.filter(function(e){return!I(e.type)}).map(function(e){return function(e,n){var r={indent:++n,obj:e};switch(e.type){case"typedef":return j(r);case"includes":return w(r);case"implements":return x(r);case"interface":return Q(r);case"interface mixin":return Q(r,{mixin:!0});case"callback interface":return Q(r,{callback:!0});case"dictionary":var i=0,o=0;e.members.filter(function(e){return!I(e.type)});for(const t of e.members){if(I(t.type))continue;const e=t.required?"required ":"";i<e.length&&(i=e.length);var a=P(t.idlType).length;o<a&&(o=a)}var s=e.members.map(function(e){switch(e.type){case"field":return r=i,(a={obj:t=e,indent:n+1}).typePad=o-P(t.idlType).length,t.required?a.qualifiers="required ":a.qualifiers=" ",a.qualifiers=a.qualifiers.slice(0,r),g(a);case"line-comment":return ee(e,n+1);case"multiline-comment":return te(e,n+1);case"ws":return K(e);case"ws-pea":break;default:throw new Error("Unexpected type in dictionary: `"+e.type+"`.")}var t,r,a}).join("");return m({obj:e,indent:n,children:s,partial:e.partial?"partial ":""});case"callback":var l=e.arguments.filter(function(e){return!I(e.type)}).map(function(e){return L({obj:e,optional:e.optional?"optional ":"",variadic:e.variadic?"...":""})}),c={obj:e,indent:n,children:l.join(", ")},u=f(c),d=$(u).text();if(d.length>80){var p=d.indexOf("(")+1;c.children=l.join(",\n"+M(p)),u=f(c)}return u;case"enum":for(var s="",h=0;h<e.values.length;h++){var v=e.values[h];switch(v.type){case"string":for(var k=!1,C=h+1;C<e.values.length;C++){var E=e.values[C];if(void 0===E.type)break;if(","===E.type){k=!0;break}}s+=b({lname:v.value?v.value.toLowerCase():"the-empty-string",name:v.value,parentID:e.name.toLowerCase(),indent:n+1,needsComma:k});break;case"line-comment":s+=ee(v,n+1);break;case"multiline-comment":s+=te(v,n+1);break;case"ws":s+=K(v);break;case",":case"ws-pea":break;default:throw new Error("Unexpected type in exception: `"+v.type+"`.")}}return y({obj:e,indent:n,children:s});default:return(0,t.pub)("error","Unexpected object type `"+e.type+"` in "+JSON.stringify(e)),""}}(e,-1)}).join("\n\n")),i);o.attr({id:this.id}),o.find(".idlAttribute,.idlCallback,.idlConst,.idlDictionary,.idlEnum,.idlException,.idlField,.idlInterface,.idlMember,.idlMethod,.idlMaplike,.idlIterable,.idlTypedef").each(function(){var t=$(this),n=t.attr("data-title").toLowerCase(),r=t.parent().closest(".idlDictionary,.idlEnum,.idlException,.idlInterface");r.length&&t.attr("data-dfn-for",r.attr("data-title").toLowerCase()),e.definitionMap[n]||(e.definitionMap[n]=[]),e.definitionMap[n].push(t)}),$(this).replaceWith(o),o[0].classList.add(...this.classList)}),n.normalize(),i()};var s=d(n),l=d(r),c=d(i),u=d(o);function d(e){return e&&e.__esModule?e:{default:e}}e.name="core/webidl";var p=u.default["attribute.html"],f=u.default["callback.html"],h=u.default["const.html"],m=u.default["dictionary.html"],g=u.default["dict-member.html"],b=u.default["enum-item.html"],y=u.default["enum.html"],v=u.default["extended-attribute.html"],w=(u.default["field.html"],u.default["includes.html"]),x=u.default["implements.html"],k=u.default["interface.html"],C=u.default["iterable.html"],E=u.default["line-comment.html"],T=u.default["maplike.html"],S=u.default["method.html"],A=u.default["multiline-comment.html"],L=u.default["param.html"],j=u.default["typedef.html"],D=new Set(["maplike","setlike","stringifier"]);function _(e){return" ".repeat(e)}function N(e){if("string"==typeof e)return`<a>${l.default.Utils.escapeExpression(e)}</a>`;if(Array.isArray(e))return e.map(N).join(", ");const t=U(e.extAttrs,0,!0),n=e.nullable?"?":"";if(e.union)return`${t}(${e.idlType.map(N).join(" or ")})${n}`;let r="";return t+(r=e.generic?`${r=W.has(e.generic)?R(e.generic):N(e.generic)}<${N(e.idlType)}>`:W.has(e.idlType)?R(e.idlType):N(e.idlType))+n}function R(e){if(!W.has(e))return e;const t=l.default.Utils.escapeExpression(e);return`<a data-cite='${W.get(t)}'>${t}</a>`}function P(e){if("string"==typeof e)return e;const t=e.nullable?"?":"";if(e.union)return`(${e.idlType.map(P).join(" or ")})${t}`;if(e.generic){const n=[].concat(e.idlType).map(P).join(", ");return`${e.generic}<${n}>${t}`}return P(e.idlType)+t}function M(e){return" ".repeat(e)}var O={ws:!0,"ws-pea":!0,"ws-tpea":!0,"line-comment":!0,"multiline-comment":!0};function I(e){return O[e]}const q=new Map([["CEReactions","HTML#cereactions"],["Clamp","WEBIDL#Clamp"],["Constructor","WEBIDL#Constructor"],["Default","WEBIDL#Default"],["EnforceRange","WEBIDL#EnforceRange"],["Exposed","WEBIDL#Exposed"],["Global","WEBIDL#Global"],["HTMLConstructor","HTML#htmlconstructor"],["LegacyUnenumerableNamedProperties","WEBIDL#LegacyUnenumerableNamedProperties"],["LenientSetter","WEBIDL#LenientSetter"],["LenientThis","WEBIDL#LenientThis"],["NamedConstructor","WEBIDL#NamedConstructor"],["NewObject","WEBIDL#NewObject"],["NoInterfaceObject","WEBIDL#NoInterfaceObject"],["OverrideBuiltins","WEBIDL#OverrideBuiltins"],["PrimaryGlobal","WEBIDL#PrimaryGlobal"],["PutForwards","WEBIDL#PutForwards"],["Replaceable","WEBIDL#Replaceable"],["SameObject","WEBIDL#SameObject"],["SecureContext","WEBIDL#SecureContext"],["TreatNonObjectAsNull","WEBIDL#TreatNonObjectAsNull"],["TreatNullAs","WEBIDL#TreatNullAs"],["Unforgeable","WEBIDL#Unforgeable"],["Unscopable","WEBIDL#Unscopable"]]);function U(e,t,n){if(0===e.length)return"";var r={extAttrs:e,indent:t,sep:n?", ":",\n "+_(t),end:n?" ":"\n"};const i=new l.default.SafeString(v(r)),o=document.createElement("div");return o.innerHTML=i,Array.from(o.querySelectorAll(".extAttrName")).filter(function(e){return q.has(e.textContent)}).forEach(function(e){const t=e.ownerDocument.createElement("a");t.dataset.cite=q.get(e.textContent),t.textContent=e.textContent,e.replaceChild(t,e.firstChild)}),new l.default.SafeString(o.innerHTML)}const W=new Map([["any","WEBIDL#idl-any"],["ArrayBuffer","WEBIDL#idl-ArrayBuffer"],["boolean","WEBIDL#idl-boolean"],["Buffer","WEBIDL#idl-Buffer"],["byte","WEBIDL#idl-byte"],["ByteString","WEBIDL#idl-ByteString"],["Callback","WEBIDL#idl-Callback"],["DataView","WEBIDL#idl-DataView"],["DOMException","WEBIDL#idl-DOMException"],["DOMString","WEBIDL#idl-DOMString"],["double","WEBIDL#idl-double"],["Error","WEBIDL#idl-Error"],["EventHandler","HTML#eventhandler"],["float","WEBIDL#idl-float"],["Float32Array","WEBIDL#idl-Float32Array"],["Float64Array","WEBIDL#idl-Float64Array"],["FrozenArray","WEBIDL#idl-frozen-array"],["Int16Array","WEBIDL#idl-Int16Array"],["Int32Array","WEBIDL#idl-Int32Array"],["Int8Array","WEBIDL#idl-Int8Array"],["long long","WEBIDL#idl-long-long"],["long","WEBIDL#idl-long"],["object","WEBIDL#idl-object"],["octet","WEBIDL#idl-octet"],["Promise","WEBIDL#idl-promise"],["record","WEBIDL#idl-record"],["sequence","WEBIDL#idl-sequence"],["short","WEBIDL#idl-short"],["Uint16Array","WEBIDL#idl-Uint16Array"],["Uint32Array","WEBIDL#idl-Uint32Array"],["Uint8Array","WEBIDL#idl-Uint8Array"],["Uint8ClampedArray","WEBIDL#dl-Uint8ClampedArray"],["unrestricted double","WEBIDL#idl-unrestricted-double"],["unrestricted float","WEBIDL#idl-unrestricted-float"],["unsigned long long","WEBIDL#idl-unsigned-long-long"],["unsigned long","WEBIDL#idl-unsigned-long"],["unsigned short","WEBIDL#idl-unsigned-short"],["USVString","WEBIDL#idl-USVString"]]),H=new Set(["any","attribute","boolean","byte","ByteString","callback","const","creator","Date","deleter","dictionary","DOMString","double","enum","false","float","getter","implements","Infinity","inherit","interface","iterable","long","maplike","NaN","null","object","octet","optional","or","partial","readonly","RegExp","required","sequence","setlike","setter","short","static","stringifier","true","typedef","unrestricted","unsigned","USVString","void"]),B=new Set(["attribute","callback","const","creator","deleter","dictionary","enum","getter","implements","inherit","interface","iterable","maplike","partial","required","setlike","setter","static","stringifier","typedef","unrestricted"]),F=new Set(["required"]);var z,G={},V={};function X(e){return H.has(e)&&!B.has(e)?"_"+e:e}function Z(e){return H.has(e)&&!F.has(e)?"_"+e:e}function Y(e){return H.has(e)?"_"+e:e}function Q(e,t={}){var n=e.obj,r=e.indent,i=0,o=0,a=0,s=0;for(const e of n.members)if(!I(e.type)&&"maplike"!==e.type&&"iterable"!==e.type){var l=P(e.idlType).length;if("attribute"===e.type){var c=J(e).length;i=Math.max(l,i),o=Math.max(c,o)}else"operation"===e.type?(e.static?l+="static ".length:e.stringifier?l+="stringifier ".length:e.getter?l+="getter ".length:e.setter&&(l+="setter ".length),a=Math.max(l,a)):"const"===e.type&&(s=Math.max(l,s))}var u=n.members.map(function(e){switch(e.type){case"attribute":return d=i,f=r+1,m=o,g=P((u=e).idlType).length,b=d-g,y=J(u),y=(y+=M(m)).slice(0,m),p({obj:u,indent:f,qualifiers:y,pad:b});case"operation":return function(e,t,n){var r=e.arguments.filter(function(e){return!I(e.type)}).map(function(e){return L({obj:e,optional:e.optional?"optional ":"",variadic:e.variadic?"...":""})}),i=r.join(", "),o=P(e.idlType).length,a=["getter","setter","deleter","stringifier","static"],s="";for(var l in a)if(e[a[l]]){o+=(s=a[l]+" ").length;break}var c={obj:e,indent:n,special:s,pad:t-o,children:i},u=S(c),d=$(u).text();if(d.length>80){var p=d.indexOf("(")+1;c.children=r.join(",\n"+M(p)),u=S(c)}return u}(e,a,r+1);case"const":return function(e,t,n){var r=t-P(e.idlType).length;e.nullable&&r--;return h({obj:e,indent:n,pad:r,nullable:e.nullable?"?":""})}(e,s,r+1);case"maplike":return c=r+1,T({obj:l=e,qualifiers:l.readonly?"readonly ":"",indent:c});case"iterable":return n=r+1,C({obj:t=e,qualifiers:t.readonly?"readonly ":"",indent:n});case"ws":return K(e);case"line-comment":return ee(e,r+1);case"multiline-comment":return te(e,r+1);default:throw new Error("Unexpected member type: `"+e.type+"`.")}var t,n,l,c,u,d,f,m,g,b,y}).join("");return k({obj:n,indent:r,partial:n.partial?"partial ":"",callback:t.callback?"callback ":"",mixin:t.mixin?"mixin ":"",children:u})}function J(e){var t="";return e.static&&(t+="static "),e.stringifier&&(t+="stringifier "),e.inherit&&(t+="inherit "),e.readonly&&(t+="readonly "),t}function K(e){return/\n.*\n/.test(e.value)?"\n":""}function ee(e,t){return E({indent:t,comment:e.value})}function te(e,t){var n=e.value.split(/\r\n|\r|\n/);if(0===n.length)return"";if(1===n.length)return E({indent:t,comment:n[0]});var r=Math.max(0,/^ */.exec(n[1])[0].length-3);function i(e){return e.slice(r)}return A({indent:t,firstLine:n[0],lastLine:i(n[n.length-1]),innerLine:n.slice(1,-1).map(i)})}function ne(e,n,r,i,o){const a=e,s=n;switch(e=e.toLowerCase(),i){case"operation":if(-1!==n.search("!overload")){n=n.toLowerCase();break}const t=n.toLowerCase()+"()",a=e+"."+n.toLowerCase()+"()";if(r[t]||r[a]){const i=r[t]?t:a,s=ne(e,i,r,null,o);if(!s)break;const l=s[0].dataset.lt?s[0].dataset.lt.split("|"):[];return l.push(i,n),s[0].dataset.lt=l.join("|"),r[n]||(r[n]=[]),r[n].push(s),s}const s=ne(e,n,r,null,o);if(!s)break;const l=s[0].dataset.lt?s[0].dataset.lt.split("|"):[];return l.push(t,n),s[0].dataset.lt=l.reverse().join("|"),r[t]=[s],s;case"enum":if(""===n){n="the-empty-string";break}default:n=n.toLowerCase()}if(D.has(n))return;var l=r[n],c=[];if(l&&0===(c=l.filter(t=>t[0].dataset.dfnFor===e)).length&&""===e&&1===l.length&&(c=l),0===c.length&&""!==e){var u=e+"."+n;void 0!==(l=r[u])&&1===l.length&&(c=l,delete r[u],c[0].attr("data-dfn-for",e),c[0].attr("data-lt",n),void 0===r[n]&&(r[n]=[]),r[n].push(c[0]))}if(c.length>1){const e=`Multiple \`<dfn>\`s for \`${s}\` ${a?`in \`${a}\``:""}`;(0,t.pub)("error",new Error(e))}if(0===c.length){if(i&&o&&n&&!1===o.classList.contains("no-link-warnings")){var d=`No \`<dfn>\` for ${i} \`${s}\`${a?" in `"+a+"`":""}`;d+=". [More info](https://github.com/w3c/respec/wiki/WebIDL-thing-is-not-defined).",(0,t.pub)("warn",d)}return}const p=c[0][0],f="dom-"+(e?e+"-":"")+n.replace(/[()]/g,"");if(p.id=f,p.dataset.idl="",p.dataset.title=p.textContent,p.dataset.dfnFor=e,!p.querySelector("code")&&!p.closest("code")&&p.children){const e=p.ownerDocument.createElement("code");for(;p.hasChildNodes();)e.appendChild(p.firstChild);p.appendChild(e)}return c[0]}e.done=new Promise(function(e){z=e})}),define("core/biblio-db",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.biblioDB=e.name=void 0;e.name="core/biblio-db";const n=new Set(["alias","reference"]),r=new Promise((e,t)=>{let n;try{n=window.indexedDB.open("respec-biblio2",12)}catch(e){return t(e)}n.onerror=(()=>{t(new DOMException(n.error.message,n.error.name))}),n.onsuccess=(()=>{e(n.result)}),n.onupgradeneeded=(async()=>{const r=n.result;Array.from(r.objectStoreNames).map(e=>r.deleteObjectStore(e));const i=[new Promise((e,t)=>{try{const n=r.createObjectStore("alias",{keyPath:"id"});n.createIndex("aliasOf","aliasOf",{unique:!1}),n.transaction.oncomplete=e,n.transaction.onerror=t}catch(e){t(e)}}),new Promise((e,t)=>{try{const n=r.createObjectStore("reference",{keyPath:"id"}).transaction;n.oncomplete=e,n.onerror=t}catch(e){t(e)}})];try{await Promise.all(i),e()}catch(e){t(e)}})});e.biblioDB={get ready(){return r},async find(e){return await this.isAlias(e)&&(e=await this.resolveAlias(e)),this.get("reference",e)},async has(e,t){if(!n.has(e))throw new TypeError("Invalid type: "+e);if(!t)throw new TypeError("id is required");const r=await this.ready;return new Promise((n,i)=>{var o=r.transaction([e],"readonly").objectStore(e),a=IDBKeyRange.only(t),s=o.openCursor(a);s.onsuccess=(()=>{n(!!s.result)}),s.onerror=(()=>{i(new DOMException(s.error.message,s.error.name))})})},async isAlias(e){if(!e)throw new TypeError("id is required");const t=await this.ready;return new Promise((n,r)=>{var i=t.transaction(["alias"],"readonly").objectStore("alias"),o=IDBKeyRange.only(e),a=i.openCursor(o);a.onsuccess=(()=>{n(!!a.result)}),a.onerror=(()=>{r(new DOMException(a.error.message,a.error.name))})})},async resolveAlias(e){if(!e)throw new TypeError("id is required");const t=await this.ready;return new Promise((n,r)=>{var i=t.transaction("alias","readonly").objectStore("alias"),o=IDBKeyRange.only(e),a=i.openCursor(o);a.onsuccess=(()=>{if(null===a.result)return n(null);n(a.result.value.aliasOf)}),a.onerror=(()=>{r(new DOMException(a.error.message,a.error.name))})})},async get(e,t){if(!n.has(e))throw new TypeError("Invalid type: "+e);if(!t)throw new TypeError("id is required");const r=await this.ready;return new Promise((n,i)=>{var o=r.transaction([e],"readonly").objectStore(e),a=IDBKeyRange.only(t),s=o.openCursor(a);s.onsuccess=(()=>{if(null===s.result)return n(null);n(s.result.value)}),s.onerror=(()=>{i(new DOMException(s.error.message,s.error.name))})})},async addAll(e){if(!e)return;const n={alias:new Set,reference:new Set};Object.keys(e).filter(n=>{if("string"==typeof e[n]){let e=`Legacy SpecRef entries are not supported: \`[[${n}]]\`. `;return e+="Please update it to the new format at [specref repo](https://github.com/tobie/specref/)",(0,t.pub)("error",e),!1}return!0}).map(t=>Object.assign({id:t},e[t])).reduce((e,t)=>(t.aliasOf?e.alias.add(t):e.reference.add(t),e),n);const r=Object.keys(n).map(e=>Array.from(n[e]).map(t=>this.add(e,t))).reduce((e,t)=>e.concat(t),[]);await Promise.all(r)},async add(e,t){if(!n.has(e))throw new TypeError("Invalid type: "+e);if("object"!=typeof t)throw new TypeError("details should be an object");if("alias"===e&&!t.hasOwnProperty("aliasOf"))throw new TypeError("Invalid alias object.");const r=await this.ready,i=await this.has(e,t.id);return new Promise((n,o)=>{const a=r.transaction([e],"readwrite").objectStore(e);var s=i?a.put(t):a.add(t);s.onsuccess=n,s.onerror=(()=>{o(new DOMException(s.error.message,s.error.name))})})},async close(){(await this.ready).close()}}}),define("core/biblio",["exports","core/biblio-db","core/utils","core/pubsubhub"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.done=e.name=void 0,e.wireReference=function(e,t="_blank"){if("object"!=typeof e)throw new TypeError("Only modern object references are allowed");const n=Object.assign({},s,e),r=n.authors.join("; ")+(n.etAl?" et al":""),i=a.get(n.status)||n.status;return hyperHTML.wire(n)` - <cite> - <a - href="${n.href}" - target="${t}" - rel="noopener noreferrer"> - ${n.title.trim()}</a>. - </cite> - <span class="authors"> - ${l(r)} - </span> - <span class="publisher"> - ${l(n.publisher)} - </span> - <span class="pubDate"> - ${l(n.date)} - </span> - <span class="pubStatus"> - ${l(i)} - </span> - `},e.stringifyReference=u,e.resolveRef=async function e(t){const n=await f;if(!n.hasOwnProperty(t))return null;const r=n[t];if(r.aliasOf)return await e(r.aliasOf);return r},e.run=async function(e,n,i){e.localBiblio||(e.localBiblio={});if(e.biblio){let e="Overriding `.biblio` in config. Please use ";e+="`.localBiblio` for custom biblio entries.",(0,r.pub)("warn",e)}e.biblio={};const a=Array.from(Object.keys(e.localBiblio)).filter(t=>e.localBiblio[t].hasOwnProperty("aliasOf")).map(t=>e.localBiblio[t].aliasOf);s=e,Array.from(s.informativeReferences).filter(e=>s.normativeReferences.has(e)).forEach(e=>s.informativeReferences.delete(e));var s;const l=o(e),c=l.normativeReferences.concat(l.informativeReferences).filter(t=>!e.localBiblio.hasOwnProperty(t)).concat(a).reduce((e,t)=>(-1===e.indexOf(t)&&e.push(t),e),[]).sort(),d=[];try{await t.biblioDB.ready;const e=c.map(async e=>({id:e,data:await t.biblioDB.find(e)}));d.push(...await Promise.all(e))}catch(e){d.push(...c.map(e=>({id:e,data:null}))),console.warn(e)}const f={hasData:[],noData:[]};d.reduce((e,t)=>(t.data?e.hasData.push(t):e.noData.push(t),e),f),f.hasData.reduce((e,t)=>(e[t.id]=t.data,e),e.biblio);const m=f.noData.map(e=>e.id);if(m.length){const t=await h(m,{forceUpdate:!0});Object.assign(e.biblio,t)}Object.assign(e.biblio,e.localBiblio),function(e){var t={},n=o(e),i=n.informativeReferences,a=n.normativeReferences,s={};if(!i.length&&!a.length&&!e.refNote)return;var l=$("<section id='references' class='appendix'><h2>"+e.l10n.references+"</h2></section>").appendTo($("body"));e.refNote&&$("<p></p>").html(e.refNote).appendTo(l);for(var c=["Normative","Informative"],d=0;d<c.length;d++){var p=c[d],f="Normative"===p?a:i,h="Normative"===p?e.l10n.norm_references:e.l10n.info_references;if(f.length){var m=$("<section><h3></h3></section>").appendTo(l).find("h3").text(h).end();m.makeID(null,p+" references"),f.sort((e,t)=>e.toLowerCase().localeCompare(t.toLowerCase()));for(var g=$("<dl class='bibliography'></dl>").appendTo(m),b=0;b<f.length;b++){var y=f[b];$("<dt></dt>").attr({id:"bib-"+y}).text("["+y+"]").appendTo(g);var v=$("<dd></dd>").appendTo(g),w=e.biblio[y],x={},k=y;for(x[y]=!0;w&&w.aliasOf;)if(x[w.aliasOf]){w=null;const e=`Circular reference in biblio DB between [\`${y}\`] and [\`${k}\`].`;(0,r.pub)("error",e)}else k=w.aliasOf,w=e.biblio[k],x[k]=!0;s[k]=s[k]||[],s[k].indexOf(y)<0&&s[k].push(y),w?v.html(u(w)+"\n"):(t[y]||(t[y]=0),t[y]++,v.html("<em style='color: #f00'>Reference not found.</em>\n"))}}}for(var C in s)if(s[C].length>1){let e=`[${C}] is referenced in ${s[C].length} ways: `;e+=`(${s[C].map(e=>`'${e}'`).join(", ")}). This causes`,e+=" duplicate entries in the References section.",(0,r.pub)("warn",e)}for(var E in t){const e=`Bad reference: [\`${E}\`] (appears ${t[E]} times)`;t.hasOwnProperty(E)&&(0,r.pub)("error",e)}}(e),p(e.biblio),i(),await h(c)};e.name="core/biblio";const i=new URL("https://specref.herokuapp.com/bibrefs?refs=");function o(e){return{informativeReferences:Array.from(e.informativeReferences),normativeReferences:Array.from(e.normativeReferences)}}const a=new Map([["CR","W3C Candidate Recommendation"],["ED","W3C Editor's Draft"],["FPWD","W3C First Public Working Draft"],["LCWD","W3C Last Call Working Draft"],["NOTE","W3C Note"],["PER","W3C Proposed Edited Recommendation"],["PR","W3C Proposed Recommendation"],["REC","W3C Recommendation"],["WD","W3C Working Draft"],["WG-NOTE","W3C Working Group Note"]]),s=Object.freeze({authors:[],date:"",href:"",publisher:"",status:"",title:"",etAl:!1}),l=(c=".",e=>{const t=e.trim();return!t||t.endsWith(c)?t:t+c});var c;function u(e){if("string"==typeof e)return e;let t=`<cite>${e.title}</cite>`;(t=e.href?`<a href="${e.href}">${t}</a>. `:`${t}. `,e.authors&&e.authors.length&&(t+=e.authors.join("; "),e.etAl&&(t+=" et al"),t+="."),e.publisher)&&(t=`${t} ${e.publisher+(/\.$/.test(e.publisher)?"":".")} `);return e.date&&(t+=e.date+". "),e.status&&(t+=(a.get(e.status)||e.status)+". "),e.href&&(t+=`URL: <a href="${e.href}">${e.href}</a>`),t}var d=(0,n.createResourceHint)({hint:"dns-prefetch",href:i.origin});let p;document.head.appendChild(d);const f=e.done=new Promise(e=>{p=e});async function h(e,n={forceUpdate:!1}){if(!e.length||!1===navigator.onLine)return;let r;try{r=await fetch(i.href+e.join(","))}catch(e){return console.error(e),null}if(!n.forceUpdate&&!r.ok||200!==r.status)return null;const o=await r.json();try{await t.biblioDB.addAll(o)}catch(e){console.error(e)}return o}}),define("core/data-cite",["exports","core/pubsubhub","core/biblio"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){const t=r(e);Array.from(document.querySelectorAll(["dfn[data-cite], a[data-cite]"])).filter(e=>e.dataset.cite).map(t).forEach(({isNormative:t,key:n})=>{const r=t?e.normativeReferences:e.informativeReferences;r.add(n)})},e.linkInlineCitations=async function(e,i=respecConfig){const o=function(e){const i=r(e);return async function(r){const o=r.dataset.cite;let{key:a,frag:s,path:l}=i(r),c="";if(a===e.shortName)c=document.location.href;else{const e=await(0,n.resolveRef)(a);if(d=r,["data-cite","data-cite-frag"].filter(e=>d.hasAttribute(e)).forEach(e=>d.removeAttribute(e)),!e){var u=`Couldn't find a match for 'data-cite=${o}'.`;return console.warn(u,r),u+=" Please check developer console for offending element.",void(0,t.pub)("warn",u)}c=e.href}var d;switch(l&&(c=new URL(l,c).href),s&&(c=new URL(s,c).href),r.localName){case"a":r.href=c;break;case"dfn":{const e=r.ownerDocument.createElement("a");for(e.href=c;r.firstChild;)e.appendChild(r.firstChild);r.appendChild(e,r);break}}}}(i),a=e.querySelectorAll("dfn[data-cite], a[data-cite]"),s=Array.from(a).map(o);return await Promise.all(s)};e.name="core/data-cite";function r(e){return function t(n){const{dataset:r}=n;let{cite:i,citeFrag:o,citePath:a}=r;const s=i.startsWith("!"),l=i.search("/"),c=i.search("#");if(i.startsWith("#")&&!o){const r=n.parentElement.closest('[data-cite]:not([data-cite^="#"])'),{key:o,isNormative:a}=r?t(r):{key:e.shortName||"",isNormative:!1};return n.dataset.cite=a?`!${o}`:o,n.dataset.citeFrag=i,t(n)}return-1!==c&&(o=o||i.substr(c),i=i.substring(0,c)),-1!==l&&(a=a||i.substr(l),i=i.substring(0,l)),s&&(i=i.substr(1)),o&&!o.startsWith("#")&&(o="#"+o),a&&a.startsWith("/")&&(a=a.substr(1)),{key:i,isNormative:s,frag:o,path:a}}}}),define("core/webidl-index",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,t,n){const r=t.querySelector("section#idl-index");if(!r)return n();const i=[2,3,4,5,6].map(e=>`h${e}:first-child`).join(",");if(!r.querySelector(i)){const e=document.createElement("h2");r.title?(e.innerHTML=r.title,r.removeAttribute("title")):e.innerHTML="IDL Index",r.insertAdjacentElement("afterbegin",e)}if(!document.querySelector("pre.idl")){const e="This specification doesn't declare any Web IDL.",t=document.createTextNode(e);return r.appendChild(t),n()}const o=document.createDocumentFragment(),a=document.createElement("pre");a.classList.add("idl","def"),a.id="actual-idl-index",Array.from(document.querySelectorAll("pre.def.idl")).map(e=>{const t=document.createElement("span"),{children:n}=e.cloneNode(!0);for(const e of Array.from(n))t.appendChild(e),t.appendChild(document.createTextNode("\n"));return t.classList.add("respec-idl-separator"),t}).reduce((e,t)=>(e.appendChild(t),e),a),Array.from(a.querySelectorAll("*[id]")).forEach(e=>e.removeAttribute("id")),o.appendChild(a),r.appendChild(o),n()};e.name="core/webidl-index"}),define("core/link-to-dfn",["exports","core/data-cite","core/pubsubhub","./l10n"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,r,a){r.normalize();var s={};Object.keys(e.definitionMap).forEach(function(t){s[t]={};var r=[];if(e.definitionMap[t].forEach(function(e){void 0===e.attr("data-idl")&&e.removeAttr("data-dfn-for");var n=e.attr("data-dfn-for")||"";if(n in s[t]){var a=0!==s[t][n].filter("dfn").length,l=0!==e.filter("dfn").length;if(a&&l&&(e.addClass("respec-offending-element"),void 0===e.attr("title")&&e.attr("title",i[o].duplicate),void 0===e.attr("id")&&e.makeID(null,t),r.push(e[0])),a)return}s[t][n]=e,void 0===e.attr("id")&&(e.attr("data-idl")?e.makeID("dom",(n?n+"-":"")+t):e.makeID("dfn",t))}),r.length>0){const e=r.map((e,t)=>`[${t+1}](#${e.id})`).join(", ");(0,n.pub)("error",`Duplicate definitions of '${t}' at: ${e}.`)}}),$("a:not([href]):not([data-cite]):not(.logo)").each(function(){const e=$(this);if(e.hasClass("externalDFN"))return;const t=e.linkTargets(),r=t.some(function(t){if(s[t.title]&&s[t.title][t.for]){const n=s[t.title][t.for];if(n[0].dataset.cite)e[0].dataset.cite=n[0].dataset.cite;else{const t="#"+encodeURIComponent(n.prop("id"));e.attr("href",t).addClass("internalDFN")}if(e.attr("data-link-type")||e.attr("data-link-type","dfn"),n.closest("code,pre").length||1===n.contents().length&&1===n.children("code").length){const t=e[0].textContent.trim(),r=n[0].dataset.hasOwnProperty("idl"),i=r?n[0].dataset.title===t:n[0].textContent.trim()===t;if(r&&!i)return!0;e.wrapInner("<code></code>")}return!0}return!1});if(!r&&0!==t.length){if(!e.parents(".idl:not(.extAttr), dl.methods, dl.attributes, dl.constants, dl.constructors, dl.fields, dl.dictionary-members, span.idlMemberType, span.idlTypedefType, div.idlImplementsDesc").length){const r=t[0].for,i=t[0].title;return this.classList.add("respec-offending-element"),this.title="Linking error: not matching <dfn>",(0,n.pub)("warn","Found linkless <a> element "+(r?"for '"+r+"' ":"")+"with text '"+i+"' but no matching `<dfn>`."),void console.warn("Linkless element:",e[0])}e.replaceWith(e.contents())}}),(0,t.linkInlineCitations)(r,e).then(()=>{(0,n.pub)("end","core/link-to-dfn"),a()})};e.name="core/link-to-dfn";const i={en:{duplicate:"This is defined more than once in the document."}},o=r.lang in i?r.lang:"en"}),define("core/contrib",["exports","core/github","core/pubsubhub","core/utils"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){const i=document.getElementById("gh-commenters"),l=document.getElementById("gh-contributors");if(!i&&!l)return;const c={},{githubAPI:u,githubUser:d,githubToken:p}=e;if(d&&p){const e=btoa(`${d}:${p}`),t=`Basic ${e}`;Object.assign(c,{Authorization:t})}if(!u){const e="Requested list of contributors and/or commenters from GitHub, but [`githubAPI`](https://github.com/w3c/respec/wiki/githubAPI) is not set.";return void(0,n.pub)("error",e)}const f=await fetch(u,{headers:c});if(!f.ok){const e="Error fetching repository information from GitHub. "+`(HTTP Status ${f.status}).`;return void(0,n.pub)("error",e)}const h=await f.json(),{issues_url:m,issue_comment_url:g,contributors_url:b}=h,[y,v,w]=await Promise.all([(0,t.fetchIndex)(m,c),(0,t.fetchIndex)(g,c),(0,t.fetchIndex)(b,c)]),x=e.editors.map(o),k=i?function(...e){const t=e.reduce(r.flatten,[]).filter(e=>e&&e.user).map(({user:e})=>e.url);return[...new Set(t)]}(y,v):[],C=l?w.map(a):[];try{await Promise.all(s(k,x,i,c),s(C,x,l,c))}catch(e){(0,n.pub)("error","Error loading contributors and/or commenters from GitHub.")}};e.name="core/contrib";function i(e){return t=>t[e]}const o=i("name"),a=i("url");async function s(e,t,n,i){const o=(await Promise.all(e.map(e=>fetch(e,{headers:i})))).map(([e])=>e.name||e.login).filter(e=>!t.includes(e)).sort((e,t)=>e.toLowerCase().localeCompare(t.toLowerCase()));n.textContent=(0,r.joinAnd)(o),n.id=null}}),define("core/fix-headers",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,t,n){$("section:not(.introductory)",t).find("h1:first, h2:first, h3:first, h4:first, h5:first, h6:first").each(function(){var e=$(this).parents("section").length+1;e>6&&(e=6);var t="h"+e;this.localName.toLowerCase()!==t&&$(this).renameElement(t)}),n()};e.name="core/fix-headers"}),define("core/structure",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,o,a){"tocIntroductory"in e==!1&&(e.tocIntroductory=!1);"maxTocLevel"in e==!1&&(e.maxTocLevel=0);var s=$("section:not(.introductory)",o).find("h1:first, h2:first, h3:first, h4:first, h5:first, h6:first").toArray().filter(e=>null===e.closest("section.introductory"));if(!(s=$(s)).length)return a();if(s.each(function(){var e=$(this).parents("section").length+1;e>6&&(e=6);var t="h"+e;this.localName.toLowerCase()!==t&&$(this).renameElement(t)}),!e.noTOC){var l=function e(o,a,s,l,c){var u=o.children(c.tocIntroductory?"section":"section:not(.introductory)");if(0===u.length)return null;var d=$("<ol class='toc'></ol>");for(var p=0;p<u.length;p++){var f=$(u[p],a),h=f.hasClass("introductory"),m=f.hasClass("notoc");if(f.children().length&&!m){var g=f.children()[0],b=g.localName.toLowerCase();if("h2"===b||"h3"===b||"h4"===b||"h5"===b||"h6"===b){var y=g.textContent,v=$("<div></div>").append($(g).contents().clone());v.find("a").renameElement("span").attr("class","formerLink").removeAttr("href"),v.find("dfn").renameElement("span").removeAttr("id");var w=g.id?g.id:f.makeID(null,y);h||s[s.length-1]++;var x=s.slice();f.hasClass("appendix")&&1===s.length&&!n&&(r=s[0],n=!0),n&&(x[0]=i.charAt(s[0]-r));var k=x.join("."),C=1==x.length;C&&(k+=".",$(g).before(document.createComment("OddPage")));var E=$("<span class='secno'></span>").text(k+" ");h||$(g).prepend(E),t[w]=(h?"":"<span class='secno'>"+k+"</span> ")+"<span class='sec-title'>"+y+"</span>";var T=$("<a/>").attr({href:"#"+w,class:"tocxref"}).append(h?"":E.clone()).append(v.contents()),S=$("<li class='tocline'/>").append(T);(0===c.maxTocLevel||l<=c.maxTocLevel)&&d.append(S),s.push(0);var A=e(f,a,s,l+1,c);A&&S.append(A),s.pop()}}}return d}($("body",o),o,[0],1,e);if(!l)return;var c=o.createElement("nav");c.id="toc",c.innerHTML="<h2 class='introductory'>"+e.l10n.toc+"</h2>",c.appendChild(l[0]);var u=$("#toc",o),d=!1;u.length&&(d=!0),u.length||(u=$("#sotd",o)),u.length||(u=$("#abstract",o)),d?u.replaceWith(c):u.after(c);var p=$("<p role='navigation' id='back-to-top'><a href='#title'><abbr title='Back to Top'>↑</abbr></a></p>");$("body").append(p)}$("a[href^='#']:not(.tocxref)",o).each(function(){var e=$(this);if(""===e.html()){var n=e.attr("href").slice(1);t[n]&&(e.addClass("sec-ref"),e.html((e.hasClass("sectionRef")?"section ":"")+t[n]))}}),a()};var t={},n=!1,r=0,i="ABCDEFGHIJKLMNOPQRSTUVWXYZ";e.name="core/structure"}),define("w3c/informative",["exports","deps/hyperhtml"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(){Array.from(document.querySelectorAll("section.informative")).map(e=>e.querySelector("h2, h3, h4, h5, h6")).filter(e=>e).forEach(e=>{e.parentNode.insertBefore(hyperHTML`<p><em>This section is non-normative.</em></p>`,e.nextSibling)})};e.name="w3c/informative"}),define("w3c/permalinks",["exports","templates"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,t,n){if(!e.includePermalinks)return n();const i=r.default["permalinks.css"];var o=e.permalinkSymbol||"§",a="<style>"+i(e)+"</style>";$(t).find("head link").first().before(a),$(t).find("h2, h3, h4, h5, h6").each(function(t,n){var r=$(n);if(!r.hasClass("nolink")){var i=r.attr("id"),a=r.parent();if((a.is("section")||a.is("div"))&&(i=a.hasClass("introductory")||a.hasClass("nolink")?null:a.attr("id")),i){var s=$("<span></span>");s.attr("class","permalink");var l=r.text(),c=$("<a></a>");c.attr({href:"#"+i,"aria-label":"Permalink for "+l,title:"Permalink for "+l});var u=$("<span></span>");u.append(o),c.append(u),s.append(c),e.permalinkEdge||r.append(" "),r.append(s)}}}),n()};var n,r=(n=t)&&n.__esModule?n:{default:n};e.name="w3c/permalinks"}),define("core/id-headers",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=function(e,t,n){Array.from(document.querySelectorAll("h2:not([id]), h3:not([id]), h4:not([id]), h5:not([id]), h6:not([id])")).forEach(e=>{$(e).makeID()}),n()};e.name="core/id-headers"}),define("core/location-hash",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,n,r){(0,t.pub)("start","core/location-hash");let i="";try{i=decodeURIComponent(window.location.hash).substr(1)}catch(e){i=""}if(!i&&!document.documentElement.scrollTop)return r();const o=!!n.getElementById(i),a=/\W/.test(i);if(!o&&a){const e=i.replace(/[\W]+/gim,"-").replace(/^-+/,"").replace(/-+$/,"");document.getElementById(e)&&(i=e)}window.location.hash=`#${i}`,r()};e.name="core/location-hash"}),define("deps/text!core/css/caniuse.css",[],function(){return"/* container for stats */\n.caniuse-stats {\n display: flex;\n flex-wrap: wrap;\n justify-content: flex-start;\n align-items: baseline;\n cursor: pointer;\n}\n\nbutton.caniuse-cell {\n margin: 1px 1px 0 0;\n border: none;\n}\n\n.caniuse-browser {\n position: relative;\n}\n\n/* reset styles, hide old versions by default */\n.caniuse-browser ul {\n display: none;\n margin: 0;\n padding: 0;\n list-style: none;\n position: absolute;\n left: 0;\n z-index: 2;\n background: #fff;\n margin-top: 1px;\n}\n\n.caniuse-stats a {\n white-space: nowrap;\n align-self: center;\n margin-left: .5em;\n}\n\n/* a browser version */\n.caniuse-cell {\n display: flex;\n color: rgba(0, 0, 0, 0.8);\n font-size: 90%;\n height: 0.8cm;\n margin-right: 1px;\n margin-top: 0;\n min-width: 3cm;\n overflow: visible;\n justify-content: center;\n align-items: center;\n}\n\nli.caniuse-cell {\n margin-bottom: 1px;\n}\n\n.caniuse-cell:focus {\n outline: none;\n}\n\n.caniuse-cell:hover {\n color: rgba(0, 0, 0, 1);\n}\n\n/* supports */\n.caniuse-cell.y {\n background: #8bc34a;\n}\n\n/* no support */\n.caniuse-cell.n {\n background: #e53935;\n}\n\n/* not supported by default / partial support etc\nsee https://github.com/Fyrd/caniuse/blob/master/CONTRIBUTING.md for stats */\n.caniuse-cell.d,\n.caniuse-cell.a,\n.caniuse-cell.x,\n.caniuse-cell.p {\n background: #ffc107;\n}\n\n/* show rest of the browser versions */\n.caniuse-stats button:focus + ul,\n.caniuse-stats .caniuse-browser:hover > ul {\n display: block;\n}\n"}),define("core/caniuse",["exports","core/utils","core/pubsubhub","deps/text!core/css/caniuse.css","deps/hyperhtml"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){if(!e.caniuse)return;!function(e){const t={maxAge:864e5,browsers:["chrome","firefox","safari","edge"],versions:4};if("string"==typeof e.caniuse)return void(e.caniuse=a({feature:e.caniuse},t));Array.isArray(e.caniuse.browsers)?e.caniuse.browsers=e.caniuse.browsers.map(e=>e.toLowerCase()).filter(function(e){if(l.has(e))return!0;return(0,n.pub)("warn",`Ignoring invalid browser "\`${e}\`" in `+"[`respecConfig.caniuse.browsers`](https://github.com/w3c/respec/wiki/caniuse)"),!1}):e.caniuse.browsers=t.browsers;Object.assign(e.caniuse,t,a({},e.caniuse))}(e);const{caniuse:r}=e;if(!r.feature)return;const{feature:i}=r,u="https://caniuse.com/#feat="+i,d=(0,t.createResourceHint)({hint:"preconnect",href:"https://raw.githubusercontent.com"});document.head.appendChild(d),document.head.appendChild(hyperHTML` - <style class="removeOnSave">${o.default}</style>`);const p=document.querySelector(".head dl"),f=new Promise(async e=>{let o;try{const e=await async function(e){const{apiURL:n,feature:r,maxAge:i}=e,o=n?n.replace("{FEATURE}",r):`${s}${r}.json`,a=new Request(o),l=await(0,t.fetchAndCache)(a,i),{stats:c}=await l.json();return c}(r);o=function(e,n){return hyperHTML` - ${e.browsers.map(r=>(function(e,n,r){if(!r)return;const i=e=>{const t=r[e].split("#",1)[0].split(" ").filter(e=>e),n=t.filter(e=>c.has(e)).map(e=>c.get(e));return{support:t.join(" "),title:n.join(" ")}},[o,...a]=Object.keys(r).sort(t.semverCompare).slice(-n).reverse(),{support:s,title:u}=i(o);return hyperHTML` - <div class="caniuse-browser"> - <button class="${`caniuse-cell ${s}`}" title="${u}"> - ${l.get(e)||e} ${o} - </button> - <ul> - ${a.map(e=>{const{support:t,title:n}=i(e);return`<li class="${"caniuse-cell "+t}" title="${n}">${e}</li>`})} - </ul> - </div>`})(r,e.versions,n[r])).filter(e=>e)} - <a href="${`https://caniuse.com/#feat=${e.feature}`}" - title="Get details at caniuse.com">More info - </a>`}(r,e)}catch(e){console.error(e);const t=`Couldn't find feature "${i}" on caniuse.com? `+"Please check the feature key on [caniuse.com](https://caniuse.com)";(0,n.pub)("error",t),o=hyperHTML`<a href="${u}">caniuse.com</a>`}e(o)}),h=hyperHTML.bind(document.createDocumentFragment())` - <dt class="caniuse-title">Can I Use this API?</dt> - <dd class="caniuse-stats">${{any:f,placeholder:"Fetching data from caniuse.com..."}}</dd>`;p.appendChild(h),await f,(0,n.pub)("amend-user-config",{caniuse:i}),(0,n.sub)("beforesave",e=>{hyperHTML.bind(e.querySelector(".caniuse-stats"))` - <a href="${u}">caniuse.com</a>`})};var i,o=(i=r)&&i.__esModule?i:{default:i};var a=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e};e.name="core/caniuse";const s="https://raw.githubusercontent.com/Fyrd/caniuse/master/features-json/",l=new Map([["chrome","Chrome"],["firefox","Firefox"],["ie","IE"],["edge","Edge"],["android","Android"],["safari","Safari"],["opera","Opera"],["bb","Blackberry"],["and_uc","UC (Android)"],["and_ff","Firefox (Android)"]]),c=new Map([["y","Supported."],["a","Almost supported (aka Partial support)."],["n","No support, or disabled by default."],["p","No support, but has Polyfill."],["u","Support unknown."],["x","Requires prefix to work."],["d","Disabled by default (needs to enabled)."]])}),define("core/exporter",["exports","core/utils","core/pubsubhub","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.rsDocToDataURL=function(e,i=document){const o=r.get(e);if(!o){const t=[...r.values()].join(", "),n=`Invalid format: ${e}. Expected one of: ${t}.`;throw new TypeError(n)}const a=function(e,r){const i=r.cloneNode(!0);!function(e){const{head:r,body:i,documentElement:o}=e;(function({documentElement:e}){const t=document.createTreeWalker(e,NodeFilter.SHOW_COMMENT,e=>e.textContent.startsWith("_hyper"));for(const e of[...function*(e){for(;e.nextNode();)yield e.currentNode}(t)])e.remove()})(e),e.querySelectorAll(".removeOnSave, #toc-nav").forEach(e=>e.remove()),i.classList.remove("toc-sidebar"),(0,t.removeReSpec)(o);const a=e.createDocumentFragment(),s=e.querySelector("meta[name='viewport']");s&&r.firstChild!==s&&a.appendChild(s);let l=e.querySelector("meta[charset], meta[content*='charset=']");l||(l=hyperHTML`<meta charset="utf-8">`);a.appendChild(l);const c=hyperHTML` - <meta name="generator" content="${`ReSpec ${window.respecVersion||"Developer Channel"}`}"> - `;a.appendChild(c),r.insertBefore(a,r.firstChild),(0,n.pub)("beforesave",o)}(i);let o="";switch(e){case"xml":o=(new XMLSerializer).serializeToString(i);break;default:i.doctype&&(o+=(new XMLSerializer).serializeToString(i.doctype)),o+=i.documentElement.outerHTML}return o}(o,i),s=encodeURIComponent(a);return`data:${e};charset=utf-8,${s}`};const r=new Map([["text/html","html"],["application/xml","xml"]])}),define("ui/save-html",["exports","core/ui","core/l10n","core/pubsubhub","core/exporter","deps/hyperhtml"],function(e,t,n,r,i){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.show=function(){if(!c)return;l.show(u)},e.exportDocument=function(e,t){const n="Exporting via ui/save-html module's `exportDocument()` is deprecated and will be removed. Use core/exporter `rsDocToDataURL()` instead.";return(0,r.pub)("warn",n),console.warn(n),(0,i.rsDocToDataURL)(t)};e.name="ui/save-html";const o=new URL("https://labs.w3.org/epub-generator/cgi-bin/epub-generator.py");o.searchParams.append("type","respec"),o.searchParams.append("url",document.location.href);const a=[{id:"respec-save-as-html",fileName:"index.html",title:"HTML",type:"text/html",get href(){return(0,i.rsDocToDataURL)(this.type)}},{id:"respec-save-as-xml",fileName:"index.xhtml",title:"XML",type:"application/xml",get href(){return(0,i.rsDocToDataURL)(this.type)}},{id:"respec-save-as-epub",fileName:"spec.epub",title:"EPUB 3",type:"application/epub+zip",href:o.href}];function s(e){const{id:n,href:r,fileName:i,title:o,type:a}=e;return hyperHTML` - <a - href="${r}" - id="${n}" - download="${i}" - type="${a}" - class="respec-save-button" - onclick=${()=>t.ui.closeModal()} - >${o}</a>`}const l={async show(e){await document.respecIsReady;const r=hyperHTML` - <div class="respec-save-buttons"> - ${a.map(s)} - </div>`;t.ui.freshModal(n.l10n[n.lang].save_snapshot,r,e)}},c="download"in HTMLAnchorElement.prototype;let u;c&&(u=t.ui.addCommand(n.l10n[n.lang].save_snapshot,"ui/save-html","Ctrl+Shift+Alt+S","💾"))}),define("ui/search-specref",["exports","core/ui","core/biblio","core/l10n"],function(e,t,n,r){Object.defineProperty(e,"__esModule",{value:!0}),e.show=void 0;const i=t.ui.addCommand(r.l10n[r.lang].search_specref,"ui/search-specref","Ctrl+Shift+Alt+space","🔎"),o="https://specref.herokuapp.com/",a=`${o}search-refs`,s=`${o}reverse-lookup`,l=document.createElement("form"),c=window.hyperHTML.bind(l),u=hyperHTML.bind(document.createElement("div"));function d([e,t]){return hyperHTML.wire(t)` - <dt> - [${e}] - </dt> - <dd>${(0,n.wireReference)(t)}</dd> - `}l.id="specref-ui",l.addEventListener("submit",async e=>{e.preventDefault();const{searchBox:t}=l,n=t.value;if(!n)return void t.focus();f({state:"Searching Specref…"});const r=new URL(a);r.searchParams.set("q",n);const i=new URL(s);i.searchParams.set("urls",n);try{const e=performance.now(),o=await Promise.all([fetch(r).then(e=>e.json()),fetch(i).then(e=>e.json())]),{checked:a}=l.includeVersions;f({query:n,results:function({includeVersions:e}={includeVersions:!1}){return(...t)=>{const n=t.reduce((e,t)=>Object.assign(e,t),{}),r=new Map(Object.entries(n));return Array.from(r.entries()).filter(([,e])=>e.aliasOf).map(([e])=>e).reduce((e,t)=>e.delete(t)&&e,r),e||Array.from(r.values()).filter(e=>"object"==typeof e&&"versions"in e).reduce((e,t)=>e.concat(t.versions),[]).forEach(e=>{r.delete(e)}),Array.from(r.entries()).filter(([,e])=>"object"!=typeof e).reduce((e,[t])=>r.delete(t)&&r,r),r}}({includeVersions:a})(...o),state:"",timeTaken:Math.round(performance.now()-e)/1e3})}catch(e){console.error(e),f({state:"Error! Couldn't do search."})}finally{t.focus()}});const p=hyperHTML.wire()` - <header> - <p> - An Open-Source, Community-Maintained Database of - Web Standards & Related References. - </p> - </header> - <div class="searchcomponent"> - <input - name="searchBox" - type="search" - autocomplete="off" - placeholder="Keywords, titles, authors, urls…"> - <button - type="submit"> - Search - </button> - <label> - <input type="checkbox" name="includeVersions"> Include all versions. - </label> - </div> -`;function f({state:e,results:t,timeTaken:n,query:r}={state:""}){t?c` - <div>${p}</div> - <p class="state" hidden="${!e}"> - ${e} - </p> - <section hidden="${!t}">${t?function(e,t,n){if(!e.size)return u` - <p class="state"> - Your search - <strong> ${t} </strong> - - did not match any references. - </p> - `;const r=Array.from(e.entries()).slice(0,99).map(d).reduce((e,t)=>e.concat(t),[]);return u` - <p class="result-stats"> - ${e.size} results (${n} seconds). - ${e.size>99?"First 100 results.":""} - </p> - <dl class="specref-results">${r}</dl> - `}(t,r,n):[]}</section> - `:c`<div>${p}</div>`}e.show=function(){f(),t.ui.freshModal(r.l10n[r.lang].search_specref,l,i),l.querySelector("input[type=search]").focus()}}),define("ui/dfn-list",["exports","core/ui","core/l10n","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.show=void 0;const r=t.ui.addCommand(n.l10n[n.lang].definition_list,"ui/dfn-list","Ctrl+Shift+Alt+D","📔"),i=document.createElement("ul");i.classList.add("respec-dfn-list");const o=window.hyperHTML.bind(i);i.addEventListener("click",e=>{t.ui.closeModal(),e.stopPropagation()}),e.show=function(){o`${Object.entries(respecConfig.definitionMap).sort(([e],[t])=>e.localeCompare(t)).map(([e,t])=>{const[n]=t[0];return window.hyperHTML.wire(n,":li>a")` - <li> - <a href="${"#"+n.id}"> - ${n.textContent} - </a> - </li> - `})}`,t.ui.freshModal(n.l10n[n.lang].list_of_definitions,i,r)}}),define("ui/about-respec",["exports","core/ui","core/l10n","deps/hyperhtml"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.show=void 0,window.respecVersion=window.respecVersion||"Developer Edition";const r=document.createElement("div"),i=hyperHTML.bind(r),o=t.ui.addCommand(`About ${window.respecVersion}`,"ui/about-respec","Ctrl+Shift+Alt+A","ℹ️");function a({name:e,duration:t}){const n=hyperHTML.bind(document.createElement("tr"));return n` - <td> - <a href="${`https://github.com/w3c/respec/tree/develop/src/${e}.js`}"> - ${e} - </a> - </td> - <td> - ${t} - </td> - `}e.show=function(){t.ui.freshModal(`${n.l10n[n.lang].about_respec} - ${window.respecVersion}`,r,o);let e=[];"getEntriesByType"in performance&&performance.getEntriesByType("measure").sort((e,t)=>t.duration-e.duration).map(({name:e,duration:t})=>{const n=t.toFixed(2);return{name:e,duration:n>1e3?`${Math.round(n/1e3)} second(s)`:`${n} milliseconds`}}).map(a).reduce((e,t)=>(e.push(t),e),e),i` - <p> - ReSpec is a document production toolchain, with a notable focus on W3C specifications. - </p> - <p> - <a href='https://github.com/w3c/respec/wiki'>Documentation</a>, - <a href='https://github.com/w3c/respec/issues'>Bugs</a>. - </p> - <table border="1" width="100%" hidden="${!e.length}"> - <caption> - Loaded plugins - </caption> - <thead> - <tr> - <th> - Plugin Name - </th> - <th> - Processing time - </th> - </tr> - </thead> - <tbody>${e}</tbody> - </table> -`}}),define("core/seo",["exports"],function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.run=async function(e,t,n){n(),await t.respecIsReady;const r=t.querySelector("#abstract p:first-of-type");if(!r)return;!function(e){const t=e.ownerDocument,n=e.textContent.replace(/\s+/," ").trim(),r=t.createElement("meta");r.name="description",r.content=n,t.head.appendChild(r)}(r)};e.name="core/seo"}),define("w3c/seo",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e,i,o){var a=e.shortName?"https://www.w3.org/TR/"+e.shortName+"/":null;switch(e.canonicalURI){case"edDraft":e.edDraftURI?e.canonicalURI=new URL(e.edDraftURI,i.location).href:((0,t.pub)("warn","Canonical URI set to edDraft, but no edDraftURI is set in configuration"),e.canonicalURI=null);break;case"TR":a?e.canonicalURI=a:((0,t.pub)("warn","Canonical URI set to TR, but no shortName is set in configuration"),e.canonicalURI=null);break;default:if(e.canonicalURI)try{e.canonicalURI=new URL(e.canonicalURI,i.location).href}catch(n){(0,t.pub)("warn","CanonicalURI is an invalid URL: "+n.message),e.canonicalURI=null}else a&&(e.canonicalURI=a)}if(e.canonicalURI){var s=i.createElement("link");s.setAttribute("rel","canonical"),s.setAttribute("href",e.canonicalURI),i.head.appendChild(s)}o(),e.doJsonLd&&async function(e,t){await t.respecIsReady;const i=["TechArticle"];e.rdfStatus&&i.push(e.rdfStatus);const o={"@context":["http://schema.org",{"@vocab":"http://schema.org/","@language":t.documentElement.lang||"en",w3p:"http://www.w3.org/2001/02pd/rec54#",foaf:"http://xmlns.com/foaf/0.1/",datePublished:{"@type":"http://www.w3.org/2001/XMLSchema#date"},inLanguage:{"@language":null},isBasedOn:{"@type":"@id"},license:{"@type":"@id"}}],id:e.canonicalURI||e.thisVersion,type:i,name:e.title,inLanguage:t.documentElement.lang||"en",license:e.licenseInfo.url,datePublished:e.dashDate,copyrightHolder:{name:"World Wide Web Consortium",url:"https://www.w3.org/"},discussionUrl:e.issueBase,alternativeHeadline:e.subtitle,isBasedOn:e.prevVersion};if(e.additionalCopyrightHolders){const t=Array.isArray(e.additionalCopyrightHolders)?e.additionalCopyrightHolders:[e.additionalCopyrightHolders];o.copyrightHolder=[o.copyrightHolder,...t.map(e=>({name:e}))]}const a=t.head.querySelector("meta[name=description]");a&&(o.description=a.content);e.editors&&(o.editor=e.editors.map(n));e.authors&&(o.contributor=e.authors.map(n));o.citation=[...e.normativeReferences,...e.informativeReferences].map(t=>e.biblio[t]).filter(e=>"object"==typeof e).map(r);const s=t.createElement("script");s.type="application/ld+json",s.textContent=JSON.stringify(o,null,2),t.head.appendChild(s)}(e,i)};e.name="w3c/seo";function n({name:e,url:t,mailto:n,company:r,companyURL:i}){const o={type:"Person",name:e,url:t,"foaf:mbox":n};return(r||i)&&(o.worksFor={name:r,url:i}),o}function r(e){const{href:t,title:n,href:r}=e;return{id:t,type:"TechArticle",name:n,url:r}}}),define("deps/text!core/css/github.css",[],function(){return"/*\n\ngithub.com style (c) Vasily Polovnyov <vast@whiteants.net>\n\n*/\n\n.hljs {\n display: block;\n overflow-x: auto;\n padding: 0.5em;\n color: #333;\n background: #f8f8f8;\n}\n\n.hljs-comment,\n.hljs-quote {\n color: #998;\n font-style: italic;\n}\n\n.hljs-keyword,\n.hljs-selector-tag,\n.hljs-subst {\n color: #333;\n font-weight: bold;\n}\n\n.hljs-number,\n.hljs-literal,\n.hljs-variable,\n.hljs-template-variable,\n.hljs-tag .hljs-attr {\n color: #008080;\n}\n\n.hljs-string,\n.hljs-doctag {\n color: #d14;\n}\n\n.hljs-title,\n.hljs-section,\n.hljs-selector-id {\n color: #900;\n font-weight: bold;\n}\n\n.hljs-subst {\n font-weight: normal;\n}\n\n.hljs-type,\n.hljs-class .hljs-title {\n color: #458;\n font-weight: bold;\n}\n\n.hljs-tag,\n.hljs-name,\n.hljs-attribute {\n color: #000080;\n font-weight: normal;\n}\n\n.hljs-regexp,\n.hljs-link {\n color: #009926;\n}\n\n.hljs-symbol,\n.hljs-bullet {\n color: #990073;\n}\n\n.hljs-built_in,\n.hljs-builtin-name {\n color: #0086b3;\n}\n\n.hljs-meta {\n color: #999;\n font-weight: bold;\n}\n\n.hljs-deletion {\n background: #fdd;\n}\n\n.hljs-addition {\n background: #dfd;\n}\n\n.hljs-emphasis {\n font-style: italic;\n}\n\n.hljs-strong {\n font-weight: bold;\n}\n"}),define("deps/text!core/../../worker/respec-worker.js",[],function(){return'// ReSpec Worker v0.1.1\n"use strict";\ntry {\n importScripts("https://www.w3.org/Tools/respec/respec-highlight.js");\n hljs.configure({\n tabReplace: " ", // 2 spaces\n languages: ["abnf", "css", "http", "javascript", "json", "markdown", "xml"],\n });\n} catch (err) {\n console.error("Network error loading/configuring highlighter", err);\n}\n\nself.addEventListener("message", ({ data: originalData }) => {\n const data = Object.assign({}, originalData);\n switch (data.action) {\n case "highlight":\n const { code } = data;\n const langs = data.languages.length ? data.languages : undefined;\n try {\n const { value, language } = self.hljs.highlightAuto(code, langs);\n Object.assign(data, { value, language });\n } catch (err) {\n console.error("Could not transform some code?", err);\n // Post back the original code\n Object.assign(data, { value: code, language: "" });\n }\n }\n self.postMessage(data);\n});\n'}),define("core/worker",["exports","core/utils","deps/text!../../worker/respec-worker.js"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.worker=e.name=void 0;var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/worker";const o=(0,t.createResourceHint)({hint:"preload",href:"https://www.w3.org/Tools/respec/respec-highlight.js",as:"script"});document.head.appendChild(o);const a=URL.createObjectURL(new Blob([i.default],{type:"application/javascript"}));e.worker=new Worker(a)}),define("core/highlight",["exports","deps/text!core/css/github.css","core/worker"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e){if(e.noHighlightCSS)return void o.remove();const t=Array.from(document.querySelectorAll("pre:not(.idl):not(.nohighlight), code.highlight"));if(0===t.length)return void o.remove();const r=t.map((e,t)=>new Promise(r=>{if(""===e.textContent.trim())return r();const o=()=>{e.setAttribute("aria-busy","false"),r()},a=setTimeout(()=>{console.error("Timed-out waiting for highlight:",e),o()},4e3),s={action:"highlight",code:e.textContent,id:`highlight:${t}`,languages:(i=e.classList,Array.from(i).filter(e=>"highlight"!==e&&"nolinks"!==e).map(e=>e.toLowerCase()))};n.worker.addEventListener("message",function t(r){const{data:{id:i,code:l,language:c,value:u}}=r;i===s.id&&(e.innerHTML=u,"pre"===e.localName&&e.classList.add("hljs"),c&&e.classList.add(c),clearTimeout(a),n.worker.removeEventListener("message",t),o())}),e.setAttribute("aria-busy","true"),n.worker.postMessage(s)}));var i;await Promise.all(r)};var r,i=(r=t)&&r.__esModule?r:{default:r};e.name="core/highlight";const o=document.createElement("style");o.textContent=i.default,document.head.appendChild(o)}),define("deps/text!core/images/clipboard.svg",[],function(){return'<svg height="16" viewBox="0 0 14 16" width="14"><path fill-rule="evenodd" d="M2 13h4v1H2v-1zm5-6H2v1h5V7zm2 3V8l-3 3 3 3v-2h5v-2H9zM4.5 9H2v1h2.5V9zM2 12h2.5v-1H2v1zm9 1h1v2c-.02.28-.11.52-.3.7-.19.18-.42.28-.7.3H1c-.55 0-1-.45-1-1V4c0-.55.45-1 1-1h3c0-1.11.89-2 2-2 1.11 0 2 .89 2 2h3c.55 0 1 .45 1 1v5h-1V6H1v9h10v-2zM2 5h8c0-.55-.45-1-1-1H8c-.55 0-1-.45-1-1s-.45-1-1-1-1 .45-1 1-.45 1-1 1H3c-.55 0-1 .45-1 1z"/></svg>'}),eXa=this,fXa=function(){return function(e){var t={};function n(r){if(t[r])return t[r].exports;var i=t[r]={i:r,l:!1,exports:{}};return e[r].call(i.exports,i,i.exports,n),i.l=!0,i.exports}return n.m=e,n.c=t,n.i=function(e){return e},n.d=function(e,t,r){n.o(e,t)||Object.defineProperty(e,t,{configurable:!1,enumerable:!0,get:r})},n.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return n.d(t,"a",t),t},n.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},n.p="",n(n.s=3)}([function(e,t,n){var r,i,o,a;a=function(e,t){var n,r=(n=t)&&n.__esModule?n:{default:n};var i="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e};var o=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),a=function(){function e(t){!function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}(this,e),this.resolveOptions(t),this.initSelection()}return o(e,[{key:"resolveOptions",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this.action=e.action,this.container=e.container,this.emitter=e.emitter,this.target=e.target,this.text=e.text,this.trigger=e.trigger,this.selectedText=""}},{key:"initSelection",value:function(){this.text?this.selectFake():this.target&&this.selectTarget()}},{key:"selectFake",value:function(){var e=this,t="rtl"==document.documentElement.getAttribute("dir");this.removeFake(),this.fakeHandlerCallback=function(){return e.removeFake()},this.fakeHandler=this.container.addEventListener("click",this.fakeHandlerCallback)||!0,this.fakeElem=document.createElement("textarea"),this.fakeElem.style.fontSize="12pt",this.fakeElem.style.border="0",this.fakeElem.style.padding="0",this.fakeElem.style.margin="0",this.fakeElem.style.position="absolute",this.fakeElem.style[t?"right":"left"]="-9999px";var n=window.pageYOffset||document.documentElement.scrollTop;this.fakeElem.style.top=n+"px",this.fakeElem.setAttribute("readonly",""),this.fakeElem.value=this.text,this.container.appendChild(this.fakeElem),this.selectedText=(0,r.default)(this.fakeElem),this.copyText()}},{key:"removeFake",value:function(){this.fakeHandler&&(this.container.removeEventListener("click",this.fakeHandlerCallback),this.fakeHandler=null,this.fakeHandlerCallback=null),this.fakeElem&&(this.container.removeChild(this.fakeElem),this.fakeElem=null)}},{key:"selectTarget",value:function(){this.selectedText=(0,r.default)(this.target),this.copyText()}},{key:"copyText",value:function(){var e=void 0;try{e=document.execCommand(this.action)}catch(t){e=!1}this.handleResult(e)}},{key:"handleResult",value:function(e){this.emitter.emit(e?"success":"error",{action:this.action,text:this.selectedText,trigger:this.trigger,clearSelection:this.clearSelection.bind(this)})}},{key:"clearSelection",value:function(){this.trigger&&this.trigger.focus(),window.getSelection().removeAllRanges()}},{key:"destroy",value:function(){this.removeFake()}},{key:"action",set:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:"copy";if(this._action=e,"copy"!==this._action&&"cut"!==this._action)throw new Error('Invalid "action" value, use either "copy" or "cut"')},get:function(){return this._action}},{key:"target",set:function(e){if(void 0!==e){if(!e||"object"!==(void 0===e?"undefined":i(e))||1!==e.nodeType)throw new Error('Invalid "target" value, use a valid Element');if("copy"===this.action&&e.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if("cut"===this.action&&(e.hasAttribute("readonly")||e.hasAttribute("disabled")))throw new Error('Invalid "target" attribute. You can\'t cut text from elements with "readonly" or "disabled" attributes');this._target=e}},get:function(){return this._target}}]),e}();e.exports=a},i=[e,n(7)],void 0===(o="function"==typeof(r=a)?r.apply(t,i):r)||(e.exports=o)},function(e,t,n){var r=n(6),i=n(5);e.exports=function(e,t,n){if(!e&&!t&&!n)throw new Error("Missing required arguments");if(!r.string(t))throw new TypeError("Second argument must be a String");if(!r.fn(n))throw new TypeError("Third argument must be a Function");if(r.node(e))return p=t,f=n,(d=e).addEventListener(p,f),{destroy:function(){d.removeEventListener(p,f)}};if(r.nodeList(e))return l=e,c=t,u=n,Array.prototype.forEach.call(l,function(e){e.addEventListener(c,u)}),{destroy:function(){Array.prototype.forEach.call(l,function(e){e.removeEventListener(c,u)})}};if(r.string(e))return o=e,a=t,s=n,i(document.body,o,a,s);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList");var o,a,s,l,c,u,d,p,f}},function(e,t){function n(){}n.prototype={on:function(e,t,n){var r=this.e||(this.e={});return(r[e]||(r[e]=[])).push({fn:t,ctx:n}),this},once:function(e,t,n){var r=this;function i(){r.off(e,i),t.apply(n,arguments)}return i._=t,this.on(e,i,n)},emit:function(e){for(var t=[].slice.call(arguments,1),n=((this.e||(this.e={}))[e]||[]).slice(),r=0,i=n.length;r<i;r++)n[r].fn.apply(n[r].ctx,t);return this},off:function(e,t){var n=this.e||(this.e={}),r=n[e],i=[];if(r&&t)for(var o=0,a=r.length;o<a;o++)r[o].fn!==t&&r[o].fn._!==t&&i.push(r[o]);return i.length?n[e]=i:delete n[e],this}},e.exports=n},function(e,t,n){var r,i,o,a;a=function(e,t,n,r){var i=s(t),o=s(n),a=s(r);function s(e){return e&&e.__esModule?e:{default:e}}var l="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e};var c=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}();var u=function(e){function t(e,n){!function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}(this,t);var r=function(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}(this,(t.__proto__||Object.getPrototypeOf(t)).call(this));return r.resolveOptions(n),r.listenClick(e),r}return function(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}(t,o.default),c(t,[{key:"resolveOptions",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this.action="function"==typeof e.action?e.action:this.defaultAction,this.target="function"==typeof e.target?e.target:this.defaultTarget,this.text="function"==typeof e.text?e.text:this.defaultText,this.container="object"===l(e.container)?e.container:document.body}},{key:"listenClick",value:function(e){var t=this;this.listener=(0,a.default)(e,"click",function(e){return t.onClick(e)})}},{key:"onClick",value:function(e){var t=e.delegateTarget||e.currentTarget;this.clipboardAction&&(this.clipboardAction=null),this.clipboardAction=new i.default({action:this.action(t),target:this.target(t),text:this.text(t),container:this.container,trigger:t,emitter:this})}},{key:"defaultAction",value:function(e){return d("action",e)}},{key:"defaultTarget",value:function(e){var t=d("target",e);if(t)return document.querySelector(t)}},{key:"defaultText",value:function(e){return d("text",e)}},{key:"destroy",value:function(){this.listener.destroy(),this.clipboardAction&&(this.clipboardAction.destroy(),this.clipboardAction=null)}}],[{key:"isSupported",value:function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:["copy","cut"],t="string"==typeof e?[e]:e,n=!!document.queryCommandSupported;return t.forEach(function(e){n=n&&!!document.queryCommandSupported(e)}),n}}]),t}();function d(e,t){var n="data-clipboard-"+e;if(t.hasAttribute(n))return t.getAttribute(n)}e.exports=u},i=[e,n(0),n(2),n(1)],void 0===(o="function"==typeof(r=a)?r.apply(t,i):r)||(e.exports=o)},function(e,t){var n=9;if("undefined"!=typeof Element&&!Element.prototype.matches){var r=Element.prototype;r.matches=r.matchesSelector||r.mozMatchesSelector||r.msMatchesSelector||r.oMatchesSelector||r.webkitMatchesSelector}e.exports=function(e,t){for(;e&&e.nodeType!==n;){if("function"==typeof e.matches&&e.matches(t))return e;e=e.parentNode}}},function(e,t,n){var r=n(4);function i(e,t,n,i,o){var a=function(e,t,n,i){return function(n){n.delegateTarget=r(n.target,t),n.delegateTarget&&i.call(e,n)}}.apply(this,arguments);return e.addEventListener(n,a,o),{destroy:function(){e.removeEventListener(n,a,o)}}}e.exports=function(e,t,n,r,o){return"function"==typeof e.addEventListener?i.apply(null,arguments):"function"==typeof n?i.bind(null,document).apply(null,arguments):("string"==typeof e&&(e=document.querySelectorAll(e)),Array.prototype.map.call(e,function(e){return i(e,t,n,r,o)}))}},function(e,t){t.node=function(e){return void 0!==e&&e instanceof HTMLElement&&1===e.nodeType},t.nodeList=function(e){var n=Object.prototype.toString.call(e);return void 0!==e&&("[object NodeList]"===n||"[object HTMLCollection]"===n)&&"length"in e&&(0===e.length||t.node(e[0]))},t.string=function(e){return"string"==typeof e||e instanceof String},t.fn=function(e){return"[object Function]"===Object.prototype.toString.call(e)}},function(e,t){e.exports=function(e){var t;if("SELECT"===e.nodeName)e.focus(),t=e.value;else if("INPUT"===e.nodeName||"TEXTAREA"===e.nodeName){var n=e.hasAttribute("readonly");n||e.setAttribute("readonly",""),e.select(),e.setSelectionRange(0,e.value.length),n||e.removeAttribute("readonly"),t=e.value}else{e.hasAttribute("contenteditable")&&e.focus();var r=window.getSelection(),i=document.createRange();i.selectNodeContents(e),r.removeAllRanges(),r.addRange(i),t=r.toString()}return t}}])},"object"==typeof exports&&"object"==typeof module?module.exports=fXa():"function"==typeof define&&define.amd?define("deps/clipboard",[],fXa):"object"==typeof exports?exports.ClipboardJS=fXa():eXa.ClipboardJS=fXa(),define("core/webidl-clipboard",["exports","deps/text!core/images/clipboard.svg","deps/clipboard"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=async function(e,t,n){Array.from(t.querySelectorAll("pre.idl")).map(e=>{const t=a.cloneNode(!0),n=e.querySelector('span[id^="idl-def-"], span[id^="dom-"]');let r="#";return null===n&&""===e.id?"idl-index"===e.parentElement.id?r+="actual-idl-index":(e.id=`idl-${String(Math.random()).substr(2)}`,r+=e.id):r+=e.id||n.id,{button:t,elem:e,target:r}}).forEach(({elem:e,button:n,target:r})=>{const i=t.createElement("div");n.dataset.clipboardTarget=r,e.parentElement.replaceChild(i,e),i.appendChild(n),i.appendChild(e)}),new i.default(".respec-button-copy-paste",s).on("success",e=>e.clearSelection()),n()};var r=o(t),i=o(n);function o(e){return e&&e.__esModule?e:{default:e}}e.name="core/webidl-clipboard";const a=document.createElement("button");a.innerHTML=r.default,a.title="Copy IDL to clipboard",a.classList.add("respec-button-copy-paste","removeOnSave");const s={text:e=>document.querySelector(e.dataset.clipboardTarget).textContent.replace(/\ +/gm," ").replace(/^\ /gm," ").replace(/^};\n/gm,"};\n").trim()}}),define("core/data-tests",["exports","core/pubsubhub","core/l10n"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){const n=document.querySelectorAll("[data-tests]");if(!n.length)return;if(!e.testSuiteURI)return void(0,t.pub)("error",r[i].missing_test_suite_uri);Array.from(n).filter(e=>e.dataset.tests).map(n=>{const a=document.createElement("details"),s=hyperHTML.bind(a),l=n.dataset.tests.split(/,/gm).map(e=>e.trim()).map(n=>{let o="";try{o=new URL(n,e.testSuiteURI).href}catch(e){(0,t.pub)("warn",`${r[i].bad_uri}: ${n}`)}return o});return a.classList.add("respec-tests-details","removeOnSave"),s` - <summary> - tests: ${l.length} - </summary> - <ul>${l.map(o)}</ul> - `,{elem:n,details:a}}).forEach(({elem:e,details:t})=>{delete e.dataset.tests,e.insertAdjacentElement("beforeend",t)})};const r={en:{missing_test_suite_uri:"Found tests in your spec, but missing '[`testSuiteURI`](https://github.com/w3c/respec/wiki/testSuiteURI)' in your ReSpec config.",tests:"tests",test:"test"}},i=(e.name="core/data-tests",n.lang in r?n.lang:"en");function o(e){const t=[],[n]=new URL(e).pathname.split("/").reverse(),r=n.split(".");let[i]=r;if(r.find(e=>"https"===e)){const e=document.createElement("span");e.innerHTML="🔒",e.setAttribute("aria-label","requires a secure connection"),e.setAttribute("title","Test requires HTTPS"),i=i.replace(".https",""),t.push(e)}if(i.split(".").join("-").split("-").find(e=>"manual"===e)){const e=document.createElement("span");e.innerHTML="💪",e.setAttribute("aria-label","the test must be run manually"),e.setAttribute("title","Manual test"),i=i.replace("-manual",""),t.push(e)}return hyperHTML.bind(document.createElement("li"))` - <a href="${e}"> - ${i} - </a> ${t} - `}}),define("core/list-sorter",["exports","core/pubsubhub"],function(e,t){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.sortListItems=r,e.sortDefinitionTerms=o,e.run=function(e,n,i){for(const e of document.querySelectorAll("[data-sort]")){let n;const i=e.dataset.sort||"ascending";switch(e.localName){case"dl":n=o(e,i);break;case"ol":case"ul":n=r(e,i);break;default:(0,t.pub)("warning",`ReSpec can't sort ${e.localName} elements.`)}if(n){const t=document.createRange();t.selectNodeContents(e),t.deleteContents(),e.appendChild(n)}}i()};e.name="core/list-sorter";function n(e){return({textContent:t},{textContent:n})=>"ascending"===e?t.localeCompare(n):n.localeCompare(t)}function r(e,t){return i(e,"li").sort(n(t)).reduce((e,t)=>(e.appendChild(t),e),document.createDocumentFragment())}function i(e,t){let n;try{n=e.querySelectorAll(`:scope > ${t}`)}catch(r){let i="";e.id||(i=`temp-${String(Math.random()).substr(2)}`,e.id=i);const o=`#${e.id} > ${t}`;n=e.parentElement.querySelectorAll(o),i&&(e.id="")}return[...n]}function o(e,t){return i(e,"dt").sort(n(t)).reduce((e,t)=>{const{nodeType:n,nodeName:r}=t,i=document.createDocumentFragment();let{nextSibling:o}=t;for(;o&&o.nextSibling;){i.appendChild(o.cloneNode(!0));const{nodeType:e,nodeName:t}=o.nextSibling;if(e===n&&t===r)break;o=o.nextSibling}return i.prepend(t.cloneNode(!0)),e.appendChild(i),e},document.createDocumentFragment())}}),define("deps/text!core/css/var.css",[],function(){return"var:hover {\n border-bottom: 1px dotted;\n cursor: pointer;\n}\n\nvar.respec-hl {\n color: var(--color, #000);\n background-color: var(--bg-color);\n box-shadow: 0 0 0px 2px var(--bg-color);\n}\n\n/* highlight colors\n https://github.com/w3c/tr-design/issues/152\n*/\nvar.respec-hl-c1 {\n --bg-color: #f4d200;\n}\n\nvar.respec-hl-c2 {\n --bg-color: #ff87a2;\n}\n\nvar.respec-hl-c3 {\n --bg-color: #96e885;\n}\n\nvar.respec-hl-c4 {\n --bg-color: #3eeed2;\n}\n\nvar.respec-hl-c5 {\n --bg-color: #eacfb6;\n}\n\nvar.respec-hl-c6 {\n --bg-color: #82ddff;\n}\n\nvar.respec-hl-c7 {\n --bg-color: #ffbcf2;\n}\n\n@media print {\n var.respec-hl {\n background: none;\n color: #000;\n box-shadow: unset;\n }\n}\n"}),define("core/highlight-vars",["exports","core/pubsubhub","deps/text!core/css/var.css"],function(e,t,n){Object.defineProperty(e,"__esModule",{value:!0}),e.name=void 0,e.run=function(e){if(!e.highlightVars)return;const n=document.createElement("style");n.textContent=i.default,n.classList.add("removeOnSave"),document.head.appendChild(n),[...document.querySelectorAll("var")].forEach(e=>e.addEventListener("click",o)),(0,t.sub)("beforesave",e=>{[...e.querySelectorAll("var.respec-hl")].forEach(l)})};var r,i=(r=n)&&r.__esModule?r:{default:r};e.name="core/highlight-vars";function o(e){e.stopPropagation();const{target:t}=e,n=function(e){const t=e.textContent.trim(),n=e.closest("section"),r=s(e),i=[...n.querySelectorAll("var")].filter(e=>e.textContent.trim()===t),o=i[0].classList.contains("respec-hl");if(a.set(r,o),o)return i.forEach(e=>l(e,r)),[];i.forEach(e=>(c=e,u=r,void c.classList.add("respec-hl",u)));var c,u;return i}(t),r=()=>{const e=s(t);n.forEach(t=>l(t,e)),[...a.keys()].forEach(e=>a.set(e,!0))};n.length&&document.body.addEventListener("click",r,{once:!0})}const a=new Map([["respec-hl-c1",!0],["respec-hl-c2",!0],["respec-hl-c3",!0],["respec-hl-c4",!0],["respec-hl-c5",!0],["respec-hl-c6",!0],["respec-hl-c7",!0]]);function s(e){const{value:t}=e.classList,n=/respec-hl-\w+/,r=n.test(t)&&t.match(n);return r?r[0]:!0===a.get("respec-hl-c1")?"respec-hl-c1":[...a.keys()].find(e=>a.get(e))||"respec-hl-c1"}function l(e,t){e.classList.remove("respec-hl",t),e.classList.length||e.removeAttribute("class")}}),window.addEventListener("error",e=>{console.error(e.error,e.message,e)}),require.config({shim:{shortcut:{exports:"shortcut"},highlight:{exports:"hljs"}},paths:{"handlebars.runtime":"deps/handlebars","deps/highlight":"https://www.w3.org/Tools/respec/respec-highlight"},deps:["deps/hyperhtml","deps/url-search-params"]}),define("profile-oai",["deps/domReady","core/base-runner","core/ui","core/l10n","oai/defaults","core/style","w3c/style","w3c/l10n","core/github","core/data-include","core/markdown","oai/headers","w3c/abstract","w3c/conformance","core/data-transform","core/inlines","core/dfn","w3c/rfc2119","core/examples","core/issues-notes","core/requirements","core/best-practices","core/figures","core/webidl","core/data-cite","core/biblio","core/webidl-index","core/link-to-dfn","core/contrib","core/fix-headers","core/structure","w3c/informative","w3c/permalinks","core/id-headers","core/location-hash","core/caniuse","ui/save-html","ui/search-specref","ui/dfn-list","ui/about-respec","core/seo","w3c/seo","core/highlight","core/webidl-clipboard","core/data-tests","core/list-sorter","core/highlight-vars","core/linter"],(e,t,{ui:n},...r)=>{n.show(),e(async()=>{try{await t.runAll(r),await document.respecIsReady}catch(e){console.error(e)}finally{n.enable()}})}),require(["profile-oai"]); -//# sourceMappingURL=respec-oai.build.js.map diff --git a/docs/js/respec-worker.js b/docs/js/respec-worker.js deleted file mode 100644 index 71da79cb6c..0000000000 --- a/docs/js/respec-worker.js +++ /dev/null @@ -1,29 +0,0 @@ -// ReSpec Worker v0.1.1 -"use strict"; -try { - importScripts("https://www.w3.org/Tools/respec/respec-highlight.js"); - hljs.configure({ - tabReplace: " ", // 2 spaces - languages: ["abnf", "css", "http", "javascript", "json", "markdown", "xml"], - }); -} catch (err) { - console.error("Network error loading/configuring highlighter", err); -} - -self.addEventListener("message", ({ data: originalData }) => { - const data = Object.assign({}, originalData); - switch (data.action) { - case "highlight": - const { code } = data; - const langs = data.languages.length ? data.languages : undefined; - try { - const { value, language } = self.hljs.highlightAuto(code, langs); - Object.assign(data, { value, language }); - } catch (err) { - console.error("Could not transform some code?", err); - // Post back the original code - Object.assign(data, { value: code, language: "" }); - } - } - self.postMessage(data); -}); diff --git a/docs/oas/3.0/schema/2021-09-28 b/docs/oas/3.0/schema/2021-09-28 deleted file mode 100644 index 4360553fe5..0000000000 --- a/docs/oas/3.0/schema/2021-09-28 +++ /dev/null @@ -1,1662 +0,0 @@ -{ - "id": "https://spec.openapis.org/oas/3.0/schema/2021-09-28", - "$schema": "http://json-schema.org/draft-04/schema#", - "description": "The description of OpenAPI v3.0.x documents, as defined by https://spec.openapis.org/oas/v3.0.3", - "type": "object", - "required": [ - "openapi", - "info", - "paths" - ], - "properties": { - "openapi": { - "type": "string", - "pattern": "^3\\.0\\.\\d(-.+)?$" - }, - "info": { - "$ref": "#/definitions/Info" - }, - "externalDocs": { - "$ref": "#/definitions/ExternalDocumentation" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/definitions/Server" - } - }, - "security": { - "type": "array", - "items": { - "$ref": "#/definitions/SecurityRequirement" - } - }, - "tags": { - "type": "array", - "items": { - "$ref": "#/definitions/Tag" - }, - "uniqueItems": true - }, - "paths": { - "$ref": "#/definitions/Paths" - }, - "components": { - "$ref": "#/definitions/Components" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false, - "definitions": { - "Reference": { - "type": "object", - "required": [ - "$ref" - ], - "patternProperties": { - "^\\$ref$": { - "type": "string", - "format": "uri-reference" - } - } - }, - "Info": { - "type": "object", - "required": [ - "title", - "version" - ], - "properties": { - "title": { - "type": "string" - }, - "description": { - "type": "string" - }, - "termsOfService": { - "type": "string", - "format": "uri-reference" - }, - "contact": { - "$ref": "#/definitions/Contact" - }, - "license": { - "$ref": "#/definitions/License" - }, - "version": { - "type": "string" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "Contact": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri-reference" - }, - "email": { - "type": "string", - "format": "email" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "License": { - "type": "object", - "required": [ - "name" - ], - "properties": { - "name": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri-reference" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "Server": { - "type": "object", - "required": [ - "url" - ], - "properties": { - "url": { - "type": "string" - }, - "description": { - "type": "string" - }, - "variables": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/ServerVariable" - } - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "ServerVariable": { - "type": "object", - "required": [ - "default" - ], - "properties": { - "enum": { - "type": "array", - "items": { - "type": "string" - } - }, - "default": { - "type": "string" - }, - "description": { - "type": "string" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "Components": { - "type": "object", - "properties": { - "schemas": { - "type": "object", - "patternProperties": { - "^[a-zA-Z0-9\\.\\-_]+$": { - "oneOf": [ - { - "$ref": "#/definitions/Schema" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - } - }, - "responses": { - "type": "object", - "patternProperties": { - "^[a-zA-Z0-9\\.\\-_]+$": { - "oneOf": [ - { - "$ref": "#/definitions/Reference" - }, - { - "$ref": "#/definitions/Response" - } - ] - } - } - }, - "parameters": { - "type": "object", - "patternProperties": { - "^[a-zA-Z0-9\\.\\-_]+$": { - "oneOf": [ - { - "$ref": "#/definitions/Reference" - }, - { - "$ref": "#/definitions/Parameter" - } - ] - } - } - }, - "examples": { - "type": "object", - "patternProperties": { - "^[a-zA-Z0-9\\.\\-_]+$": { - "oneOf": [ - { - "$ref": "#/definitions/Reference" - }, - { - "$ref": "#/definitions/Example" - } - ] - } - } - }, - "requestBodies": { - "type": "object", - "patternProperties": { - "^[a-zA-Z0-9\\.\\-_]+$": { - "oneOf": [ - { - "$ref": "#/definitions/Reference" - }, - { - "$ref": "#/definitions/RequestBody" - } - ] - } - } - }, - "headers": { - "type": "object", - "patternProperties": { - "^[a-zA-Z0-9\\.\\-_]+$": { - "oneOf": [ - { - "$ref": "#/definitions/Reference" - }, - { - "$ref": "#/definitions/Header" - } - ] - } - } - }, - "securitySchemes": { - "type": "object", - "patternProperties": { - "^[a-zA-Z0-9\\.\\-_]+$": { - "oneOf": [ - { - "$ref": "#/definitions/Reference" - }, - { - "$ref": "#/definitions/SecurityScheme" - } - ] - } - } - }, - "links": { - "type": "object", - "patternProperties": { - "^[a-zA-Z0-9\\.\\-_]+$": { - "oneOf": [ - { - "$ref": "#/definitions/Reference" - }, - { - "$ref": "#/definitions/Link" - } - ] - } - } - }, - "callbacks": { - "type": "object", - "patternProperties": { - "^[a-zA-Z0-9\\.\\-_]+$": { - "oneOf": [ - { - "$ref": "#/definitions/Reference" - }, - { - "$ref": "#/definitions/Callback" - } - ] - } - } - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "Schema": { - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "multipleOf": { - "type": "number", - "minimum": 0, - "exclusiveMinimum": true - }, - "maximum": { - "type": "number" - }, - "exclusiveMaximum": { - "type": "boolean", - "default": false - }, - "minimum": { - "type": "number" - }, - "exclusiveMinimum": { - "type": "boolean", - "default": false - }, - "maxLength": { - "type": "integer", - "minimum": 0 - }, - "minLength": { - "type": "integer", - "minimum": 0, - "default": 0 - }, - "pattern": { - "type": "string", - "format": "regex" - }, - "maxItems": { - "type": "integer", - "minimum": 0 - }, - "minItems": { - "type": "integer", - "minimum": 0, - "default": 0 - }, - "uniqueItems": { - "type": "boolean", - "default": false - }, - "maxProperties": { - "type": "integer", - "minimum": 0 - }, - "minProperties": { - "type": "integer", - "minimum": 0, - "default": 0 - }, - "required": { - "type": "array", - "items": { - "type": "string" - }, - "minItems": 1, - "uniqueItems": true - }, - "enum": { - "type": "array", - "items": { - }, - "minItems": 1, - "uniqueItems": false - }, - "type": { - "type": "string", - "enum": [ - "array", - "boolean", - "integer", - "number", - "object", - "string" - ] - }, - "not": { - "oneOf": [ - { - "$ref": "#/definitions/Schema" - }, - { - "$ref": "#/definitions/Reference" - } - ] - }, - "allOf": { - "type": "array", - "items": { - "oneOf": [ - { - "$ref": "#/definitions/Schema" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - }, - "oneOf": { - "type": "array", - "items": { - "oneOf": [ - { - "$ref": "#/definitions/Schema" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - }, - "anyOf": { - "type": "array", - "items": { - "oneOf": [ - { - "$ref": "#/definitions/Schema" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - }, - "items": { - "oneOf": [ - { - "$ref": "#/definitions/Schema" - }, - { - "$ref": "#/definitions/Reference" - } - ] - }, - "properties": { - "type": "object", - "additionalProperties": { - "oneOf": [ - { - "$ref": "#/definitions/Schema" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - }, - "additionalProperties": { - "oneOf": [ - { - "$ref": "#/definitions/Schema" - }, - { - "$ref": "#/definitions/Reference" - }, - { - "type": "boolean" - } - ], - "default": true - }, - "description": { - "type": "string" - }, - "format": { - "type": "string" - }, - "default": { - }, - "nullable": { - "type": "boolean", - "default": false - }, - "discriminator": { - "$ref": "#/definitions/Discriminator" - }, - "readOnly": { - "type": "boolean", - "default": false - }, - "writeOnly": { - "type": "boolean", - "default": false - }, - "example": { - }, - "externalDocs": { - "$ref": "#/definitions/ExternalDocumentation" - }, - "deprecated": { - "type": "boolean", - "default": false - }, - "xml": { - "$ref": "#/definitions/XML" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "Discriminator": { - "type": "object", - "required": [ - "propertyName" - ], - "properties": { - "propertyName": { - "type": "string" - }, - "mapping": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } - }, - "XML": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "namespace": { - "type": "string", - "format": "uri" - }, - "prefix": { - "type": "string" - }, - "attribute": { - "type": "boolean", - "default": false - }, - "wrapped": { - "type": "boolean", - "default": false - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "Response": { - "type": "object", - "required": [ - "description" - ], - "properties": { - "description": { - "type": "string" - }, - "headers": { - "type": "object", - "additionalProperties": { - "oneOf": [ - { - "$ref": "#/definitions/Header" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - }, - "content": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/MediaType" - } - }, - "links": { - "type": "object", - "additionalProperties": { - "oneOf": [ - { - "$ref": "#/definitions/Link" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "MediaType": { - "type": "object", - "properties": { - "schema": { - "oneOf": [ - { - "$ref": "#/definitions/Schema" - }, - { - "$ref": "#/definitions/Reference" - } - ] - }, - "example": { - }, - "examples": { - "type": "object", - "additionalProperties": { - "oneOf": [ - { - "$ref": "#/definitions/Example" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - }, - "encoding": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/Encoding" - } - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false, - "allOf": [ - { - "$ref": "#/definitions/ExampleXORExamples" - } - ] - }, - "Example": { - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "value": { - }, - "externalValue": { - "type": "string", - "format": "uri-reference" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "Header": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "required": { - "type": "boolean", - "default": false - }, - "deprecated": { - "type": "boolean", - "default": false - }, - "allowEmptyValue": { - "type": "boolean", - "default": false - }, - "style": { - "type": "string", - "enum": [ - "simple" - ], - "default": "simple" - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "type": "boolean", - "default": false - }, - "schema": { - "oneOf": [ - { - "$ref": "#/definitions/Schema" - }, - { - "$ref": "#/definitions/Reference" - } - ] - }, - "content": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/MediaType" - }, - "minProperties": 1, - "maxProperties": 1 - }, - "example": { - }, - "examples": { - "type": "object", - "additionalProperties": { - "oneOf": [ - { - "$ref": "#/definitions/Example" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false, - "allOf": [ - { - "$ref": "#/definitions/ExampleXORExamples" - }, - { - "$ref": "#/definitions/SchemaXORContent" - } - ] - }, - "Paths": { - "type": "object", - "patternProperties": { - "^\\/": { - "$ref": "#/definitions/PathItem" - }, - "^x-": { - } - }, - "additionalProperties": false - }, - "PathItem": { - "type": "object", - "properties": { - "$ref": { - "type": "string" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/definitions/Server" - } - }, - "parameters": { - "type": "array", - "items": { - "oneOf": [ - { - "$ref": "#/definitions/Parameter" - }, - { - "$ref": "#/definitions/Reference" - } - ] - }, - "uniqueItems": true - } - }, - "patternProperties": { - "^(get|put|post|delete|options|head|patch|trace)$": { - "$ref": "#/definitions/Operation" - }, - "^x-": { - } - }, - "additionalProperties": false - }, - "Operation": { - "type": "object", - "required": [ - "responses" - ], - "properties": { - "tags": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/definitions/ExternalDocumentation" - }, - "operationId": { - "type": "string" - }, - "parameters": { - "type": "array", - "items": { - "oneOf": [ - { - "$ref": "#/definitions/Parameter" - }, - { - "$ref": "#/definitions/Reference" - } - ] - }, - "uniqueItems": true - }, - "requestBody": { - "oneOf": [ - { - "$ref": "#/definitions/RequestBody" - }, - { - "$ref": "#/definitions/Reference" - } - ] - }, - "responses": { - "$ref": "#/definitions/Responses" - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "oneOf": [ - { - "$ref": "#/definitions/Callback" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - }, - "deprecated": { - "type": "boolean", - "default": false - }, - "security": { - "type": "array", - "items": { - "$ref": "#/definitions/SecurityRequirement" - } - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/definitions/Server" - } - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "Responses": { - "type": "object", - "properties": { - "default": { - "oneOf": [ - { - "$ref": "#/definitions/Response" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - }, - "patternProperties": { - "^[1-5](?:\\d{2}|XX)$": { - "oneOf": [ - { - "$ref": "#/definitions/Response" - }, - { - "$ref": "#/definitions/Reference" - } - ] - }, - "^x-": { - } - }, - "minProperties": 1, - "additionalProperties": false - }, - "SecurityRequirement": { - "type": "object", - "additionalProperties": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "Tag": { - "type": "object", - "required": [ - "name" - ], - "properties": { - "name": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/definitions/ExternalDocumentation" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "ExternalDocumentation": { - "type": "object", - "required": [ - "url" - ], - "properties": { - "description": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri-reference" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "ExampleXORExamples": { - "description": "Example and examples are mutually exclusive", - "not": { - "required": [ - "example", - "examples" - ] - } - }, - "SchemaXORContent": { - "description": "Schema and content are mutually exclusive, at least one is required", - "not": { - "required": [ - "schema", - "content" - ] - }, - "oneOf": [ - { - "required": [ - "schema" - ] - }, - { - "required": [ - "content" - ], - "description": "Some properties are not allowed if content is present", - "allOf": [ - { - "not": { - "required": [ - "style" - ] - } - }, - { - "not": { - "required": [ - "explode" - ] - } - }, - { - "not": { - "required": [ - "allowReserved" - ] - } - }, - { - "not": { - "required": [ - "example" - ] - } - }, - { - "not": { - "required": [ - "examples" - ] - } - } - ] - } - ] - }, - "Parameter": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "in": { - "type": "string" - }, - "description": { - "type": "string" - }, - "required": { - "type": "boolean", - "default": false - }, - "deprecated": { - "type": "boolean", - "default": false - }, - "allowEmptyValue": { - "type": "boolean", - "default": false - }, - "style": { - "type": "string" - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "type": "boolean", - "default": false - }, - "schema": { - "oneOf": [ - { - "$ref": "#/definitions/Schema" - }, - { - "$ref": "#/definitions/Reference" - } - ] - }, - "content": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/MediaType" - }, - "minProperties": 1, - "maxProperties": 1 - }, - "example": { - }, - "examples": { - "type": "object", - "additionalProperties": { - "oneOf": [ - { - "$ref": "#/definitions/Example" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false, - "required": [ - "name", - "in" - ], - "allOf": [ - { - "$ref": "#/definitions/ExampleXORExamples" - }, - { - "$ref": "#/definitions/SchemaXORContent" - }, - { - "$ref": "#/definitions/ParameterLocation" - } - ] - }, - "ParameterLocation": { - "description": "Parameter location", - "oneOf": [ - { - "description": "Parameter in path", - "required": [ - "required" - ], - "properties": { - "in": { - "enum": [ - "path" - ] - }, - "style": { - "enum": [ - "matrix", - "label", - "simple" - ], - "default": "simple" - }, - "required": { - "enum": [ - true - ] - } - } - }, - { - "description": "Parameter in query", - "properties": { - "in": { - "enum": [ - "query" - ] - }, - "style": { - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ], - "default": "form" - } - } - }, - { - "description": "Parameter in header", - "properties": { - "in": { - "enum": [ - "header" - ] - }, - "style": { - "enum": [ - "simple" - ], - "default": "simple" - } - } - }, - { - "description": "Parameter in cookie", - "properties": { - "in": { - "enum": [ - "cookie" - ] - }, - "style": { - "enum": [ - "form" - ], - "default": "form" - } - } - } - ] - }, - "RequestBody": { - "type": "object", - "required": [ - "content" - ], - "properties": { - "description": { - "type": "string" - }, - "content": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/MediaType" - } - }, - "required": { - "type": "boolean", - "default": false - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "SecurityScheme": { - "oneOf": [ - { - "$ref": "#/definitions/APIKeySecurityScheme" - }, - { - "$ref": "#/definitions/HTTPSecurityScheme" - }, - { - "$ref": "#/definitions/OAuth2SecurityScheme" - }, - { - "$ref": "#/definitions/OpenIdConnectSecurityScheme" - } - ] - }, - "APIKeySecurityScheme": { - "type": "object", - "required": [ - "type", - "name", - "in" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "apiKey" - ] - }, - "name": { - "type": "string" - }, - "in": { - "type": "string", - "enum": [ - "header", - "query", - "cookie" - ] - }, - "description": { - "type": "string" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "HTTPSecurityScheme": { - "type": "object", - "required": [ - "scheme", - "type" - ], - "properties": { - "scheme": { - "type": "string" - }, - "bearerFormat": { - "type": "string" - }, - "description": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "http" - ] - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false, - "oneOf": [ - { - "description": "Bearer", - "properties": { - "scheme": { - "type": "string", - "pattern": "^[Bb][Ee][Aa][Rr][Ee][Rr]$" - } - } - }, - { - "description": "Non Bearer", - "not": { - "required": [ - "bearerFormat" - ] - }, - "properties": { - "scheme": { - "not": { - "type": "string", - "pattern": "^[Bb][Ee][Aa][Rr][Ee][Rr]$" - } - } - } - } - ] - }, - "OAuth2SecurityScheme": { - "type": "object", - "required": [ - "type", - "flows" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "oauth2" - ] - }, - "flows": { - "$ref": "#/definitions/OAuthFlows" - }, - "description": { - "type": "string" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "OpenIdConnectSecurityScheme": { - "type": "object", - "required": [ - "type", - "openIdConnectUrl" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "openIdConnect" - ] - }, - "openIdConnectUrl": { - "type": "string", - "format": "uri-reference" - }, - "description": { - "type": "string" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "OAuthFlows": { - "type": "object", - "properties": { - "implicit": { - "$ref": "#/definitions/ImplicitOAuthFlow" - }, - "password": { - "$ref": "#/definitions/PasswordOAuthFlow" - }, - "clientCredentials": { - "$ref": "#/definitions/ClientCredentialsFlow" - }, - "authorizationCode": { - "$ref": "#/definitions/AuthorizationCodeOAuthFlow" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "ImplicitOAuthFlow": { - "type": "object", - "required": [ - "authorizationUrl", - "scopes" - ], - "properties": { - "authorizationUrl": { - "type": "string", - "format": "uri-reference" - }, - "refreshUrl": { - "type": "string", - "format": "uri-reference" - }, - "scopes": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "PasswordOAuthFlow": { - "type": "object", - "required": [ - "tokenUrl", - "scopes" - ], - "properties": { - "tokenUrl": { - "type": "string", - "format": "uri-reference" - }, - "refreshUrl": { - "type": "string", - "format": "uri-reference" - }, - "scopes": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "ClientCredentialsFlow": { - "type": "object", - "required": [ - "tokenUrl", - "scopes" - ], - "properties": { - "tokenUrl": { - "type": "string", - "format": "uri-reference" - }, - "refreshUrl": { - "type": "string", - "format": "uri-reference" - }, - "scopes": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "AuthorizationCodeOAuthFlow": { - "type": "object", - "required": [ - "authorizationUrl", - "tokenUrl", - "scopes" - ], - "properties": { - "authorizationUrl": { - "type": "string", - "format": "uri-reference" - }, - "tokenUrl": { - "type": "string", - "format": "uri-reference" - }, - "refreshUrl": { - "type": "string", - "format": "uri-reference" - }, - "scopes": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false - }, - "Link": { - "type": "object", - "properties": { - "operationId": { - "type": "string" - }, - "operationRef": { - "type": "string", - "format": "uri-reference" - }, - "parameters": { - "type": "object", - "additionalProperties": { - } - }, - "requestBody": { - }, - "description": { - "type": "string" - }, - "server": { - "$ref": "#/definitions/Server" - } - }, - "patternProperties": { - "^x-": { - } - }, - "additionalProperties": false, - "not": { - "description": "Operation Id and Operation Ref are mutually exclusive", - "required": [ - "operationId", - "operationRef" - ] - } - }, - "Callback": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/PathItem" - }, - "patternProperties": { - "^x-": { - } - } - }, - "Encoding": { - "type": "object", - "properties": { - "contentType": { - "type": "string" - }, - "headers": { - "type": "object", - "additionalProperties": { - "oneOf": [ - { - "$ref": "#/definitions/Header" - }, - { - "$ref": "#/definitions/Reference" - } - ] - } - }, - "style": { - "type": "string", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "type": "boolean", - "default": false - } - }, - "additionalProperties": false - } - } -} diff --git a/docs/oas/3.0/schema/latest b/docs/oas/3.0/schema/latest deleted file mode 120000 index 50eb6cd6bc..0000000000 --- a/docs/oas/3.0/schema/latest +++ /dev/null @@ -1 +0,0 @@ -2021-09-28 \ No newline at end of file diff --git a/docs/oas/3.1/dialect/base b/docs/oas/3.1/dialect/base deleted file mode 100644 index eae8386e8a..0000000000 --- a/docs/oas/3.1/dialect/base +++ /dev/null @@ -1,25 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/dialect/base", - "$schema": "https://json-schema.org/draft/2020-12/schema", - - "title": "OpenAPI 3.1 Schema Object Dialect", - "description": "A JSON Schema dialect describing schemas found in OpenAPI documents", - - "$vocabulary": { - "https://json-schema.org/draft/2020-12/vocab/core": true, - "https://json-schema.org/draft/2020-12/vocab/applicator": true, - "https://json-schema.org/draft/2020-12/vocab/unevaluated": true, - "https://json-schema.org/draft/2020-12/vocab/validation": true, - "https://json-schema.org/draft/2020-12/vocab/meta-data": true, - "https://json-schema.org/draft/2020-12/vocab/format-annotation": true, - "https://json-schema.org/draft/2020-12/vocab/content": true, - "https://spec.openapis.org/oas/3.1/vocab/base": false - }, - - "$dynamicAnchor": "meta", - - "allOf": [ - { "$ref": "https://json-schema.org/draft/2020-12/schema" }, - { "$ref": "https://spec.openapis.org/oas/3.1/meta/base" } - ] -} diff --git a/docs/oas/3.1/meta/base b/docs/oas/3.1/meta/base deleted file mode 100644 index a7a59f1c7d..0000000000 --- a/docs/oas/3.1/meta/base +++ /dev/null @@ -1,87 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/meta/base", - "$schema": "https://json-schema.org/draft/2020-12/schema", - - "title": "OAS Base vocabulary", - "description": "A JSON Schema Vocabulary used in the OpenAPI Schema Dialect", - - "$vocabulary": { - "https://spec.openapis.org/oas/3.1/vocab/base": true - }, - - "$dynamicAnchor": "meta", - - "type": ["object", "boolean"], - "properties": { - "example": true, - "discriminator": { "$ref": "#/$defs/discriminator" }, - "externalDocs": { "$ref": "#/$defs/external-docs" }, - "xml": { "$ref": "#/$defs/xml" } - }, - - "$defs": { - "extensible": { - "patternProperties": { - "^x-": true - } - }, - - "discriminator": { - "$ref": "#/$defs/extensible", - "type": "object", - "properties": { - "propertyName": { - "type": "string" - }, - "mapping": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - }, - "required": ["propertyName"], - "unevaluatedProperties": false - }, - - "external-docs": { - "$ref": "#/$defs/extensible", - "type": "object", - "properties": { - "url": { - "type": "string", - "format": "uri-reference" - }, - "description": { - "type": "string" - } - }, - "required": ["url"], - "unevaluatedProperties": false - }, - - "xml": { - "$ref": "#/$defs/extensible", - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "namespace": { - "type": "string", - "format": "uri" - }, - "prefix": { - "type": "string" - }, - "attribute": { - "type": "boolean" - }, - "wrapped": { - "type": "boolean" - } - }, - "unevaluatedProperties": false - } - } -} diff --git a/docs/oas/3.1/schema-base/2021-03-02 b/docs/oas/3.1/schema-base/2021-03-02 deleted file mode 100644 index 03a580818f..0000000000 --- a/docs/oas/3.1/schema-base/2021-03-02 +++ /dev/null @@ -1,24 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema-base/2021-03-02", - "$schema": "https://json-schema.org/draft/2020-12/schema", - "$ref": "https://spec.openapis.org/oas/3.1/schema/2021-03-02", - "properties": { - "jsonSchemaDialect": { - "$ref": "#/$defs/dialect" - } - }, - "$defs": { - "dialect": { - "const": "https://spec.openapis.org/oas/3.1/dialect/base" - }, - "schema": { - "$dynamicAnchor": "meta", - "$ref": "https://spec.openapis.org/oas/3.1/dialect/base", - "properties": { - "$schema": { - "$ref": "#/$defs/dialect" - } - } - } - } -} diff --git a/docs/oas/3.1/schema-base/2021-04-15 b/docs/oas/3.1/schema-base/2021-04-15 deleted file mode 100644 index cb973912a7..0000000000 --- a/docs/oas/3.1/schema-base/2021-04-15 +++ /dev/null @@ -1,24 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema-base/2021-04-15", - "$schema": "https://json-schema.org/draft/2020-12/schema", - "$ref": "https://spec.openapis.org/oas/3.1/schema/2021-04-15", - "properties": { - "jsonSchemaDialect": { - "$ref": "#/$defs/dialect" - } - }, - "$defs": { - "dialect": { - "const": "https://spec.openapis.org/oas/3.1/dialect/base" - }, - "schema": { - "$dynamicAnchor": "meta", - "$ref": "https://spec.openapis.org/oas/3.1/dialect/base", - "properties": { - "$schema": { - "$ref": "#/$defs/dialect" - } - } - } - } -} diff --git a/docs/oas/3.1/schema-base/2021-05-20 b/docs/oas/3.1/schema-base/2021-05-20 deleted file mode 100644 index 9796fa3851..0000000000 --- a/docs/oas/3.1/schema-base/2021-05-20 +++ /dev/null @@ -1,24 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema-base/2021-05-20", - "$schema": "https://json-schema.org/draft/2020-12/schema", - "$ref": "https://spec.openapis.org/oas/3.1/schema/2021-05-20", - "properties": { - "jsonSchemaDialect": { - "$ref": "#/$defs/dialect" - } - }, - "$defs": { - "dialect": { - "const": "https://spec.openapis.org/oas/3.1/dialect/base" - }, - "schema": { - "$dynamicAnchor": "meta", - "$ref": "https://spec.openapis.org/oas/3.1/dialect/base", - "properties": { - "$schema": { - "$ref": "#/$defs/dialect" - } - } - } - } -} diff --git a/docs/oas/3.1/schema-base/2021-09-28 b/docs/oas/3.1/schema-base/2021-09-28 deleted file mode 100644 index f75bf16c50..0000000000 --- a/docs/oas/3.1/schema-base/2021-09-28 +++ /dev/null @@ -1,24 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema-base/2021-09-28", - "$schema": "https://json-schema.org/draft/2020-12/schema", - "$ref": "https://spec.openapis.org/oas/3.1/schema/2021-09-28", - "properties": { - "jsonSchemaDialect": { - "$ref": "#/$defs/dialect" - } - }, - "$defs": { - "dialect": { - "const": "https://spec.openapis.org/oas/3.1/dialect/base" - }, - "schema": { - "$dynamicAnchor": "meta", - "$ref": "https://spec.openapis.org/oas/3.1/dialect/base", - "properties": { - "$schema": { - "$ref": "#/$defs/dialect" - } - } - } - } -} diff --git a/docs/oas/3.1/schema-base/2022-02-27 b/docs/oas/3.1/schema-base/2022-02-27 deleted file mode 100644 index 04c9f60206..0000000000 --- a/docs/oas/3.1/schema-base/2022-02-27 +++ /dev/null @@ -1,23 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema-base/2022-02-27", - "$schema": "https://json-schema.org/draft/2020-12/schema", - - "description": "The description of OpenAPI v3.1.x documents using the OpenAPI JSON Schema dialect, as defined by https://spec.openapis.org/oas/v3.1.0", - - "$ref": "https://spec.openapis.org/oas/3.1/schema/2022-02-27", - "properties": { - "jsonSchemaDialect": { "$ref": "#/$defs/dialect" } - }, - - "$defs": { - "dialect": { "const": "https://spec.openapis.org/oas/3.1/dialect/base" }, - - "schema": { - "$dynamicAnchor": "meta", - "$ref": "https://spec.openapis.org/oas/3.1/dialect/base", - "properties": { - "$schema": { "$ref": "#/$defs/dialect" } - } - } - } -} diff --git a/docs/oas/3.1/schema-base/2022-10-07 b/docs/oas/3.1/schema-base/2022-10-07 deleted file mode 100644 index 752e98be4e..0000000000 --- a/docs/oas/3.1/schema-base/2022-10-07 +++ /dev/null @@ -1,23 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema-base/2022-10-07", - "$schema": "https://json-schema.org/draft/2020-12/schema", - - "description": "The description of OpenAPI v3.1.x documents using the OpenAPI JSON Schema dialect, as defined by https://spec.openapis.org/oas/v3.1.0", - - "$ref": "https://spec.openapis.org/oas/3.1/schema/2022-10-07", - "properties": { - "jsonSchemaDialect": { "$ref": "#/$defs/dialect" } - }, - - "$defs": { - "dialect": { "const": "https://spec.openapis.org/oas/3.1/dialect/base" }, - - "schema": { - "$dynamicAnchor": "meta", - "$ref": "https://spec.openapis.org/oas/3.1/dialect/base", - "properties": { - "$schema": { "$ref": "#/$defs/dialect" } - } - } - } -} diff --git a/docs/oas/3.1/schema-base/latest b/docs/oas/3.1/schema-base/latest deleted file mode 120000 index 0855e8794b..0000000000 --- a/docs/oas/3.1/schema-base/latest +++ /dev/null @@ -1 +0,0 @@ -2022-10-07 \ No newline at end of file diff --git a/docs/oas/3.1/schema/2021-03-02 b/docs/oas/3.1/schema/2021-03-02 deleted file mode 100644 index fa987c12d6..0000000000 --- a/docs/oas/3.1/schema/2021-03-02 +++ /dev/null @@ -1,1340 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema/2021-03-02", - "$schema": "https://json-schema.org/draft/2020-12/schema", - "type": "object", - "properties": { - "openapi": { - "type": "string", - "pattern": "^3\\.1\\.\\d+(-.+)?$" - }, - "info": { - "$ref": "#/$defs/info" - }, - "jsonSchemaDialect": { - "$ref": "#/$defs/uri", - "default": "https://spec.openapis.org/oas/3.1/dialect/base" - }, - "servers": { - "$ref": "#/$defs/server" - }, - "paths": { - "$ref": "#/$defs/paths" - }, - "webhooks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "components": { - "$ref": "#/$defs/components" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "tags": { - "type": "array", - "items": { - "$ref": "#/$defs/tag" - } - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "openapi", - "info" - ], - "anyOf": [ - { - "required": [ - "paths" - ] - }, - { - "required": [ - "components" - ] - }, - { - "required": [ - "webhooks" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "info": { - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "termsOfService": { - "type": "string" - }, - "contact": { - "$ref": "#/$defs/contact" - }, - "license": { - "$ref": "#/$defs/license" - }, - "version": { - "type": "string" - } - }, - "required": [ - "title", - "version" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "contact": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "url": { - "type": "string" - }, - "email": { - "type": "string" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "license": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "identifier": { - "type": "string" - }, - "url": { - "$ref": "#/$defs/uri" - } - }, - "required": [ - "name" - ], - "oneOf": [ - { - "required": [ - "identifier" - ] - }, - { - "required": [ - "url" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server": { - "type": "object", - "properties": { - "url": { - "$ref": "#/$defs/uri" - }, - "description": { - "type": "string" - }, - "variables": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/server-variable" - } - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server-variable": { - "type": "object", - "properties": { - "enum": { - "type": "array", - "items": { - "type": "string" - }, - "minItems": 1 - }, - "default": { - "type": "string" - }, - "descriptions": { - "type": "string" - } - }, - "required": [ - "default" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "components": { - "type": "object", - "properties": { - "schemas": { - "type": "object", - "additionalProperties": { - "$dynamicRef": "#meta" - } - }, - "responses": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/response-or-reference" - } - }, - "parameters": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - }, - "requestBodies": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/request-body-or-reference" - } - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "securitySchemes": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/security-scheme-or-reference" - } - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "pathItems": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - } - }, - "patternProperties": { - "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": { - "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected", - "propertyNames": { - "pattern": "^[a-zA-Z0-9._-]+$" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "paths": { - "type": "object", - "patternProperties": { - "^/": { - "$ref": "#/$defs/path-item" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item": { - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - } - }, - "patternProperties": { - "^(get|post|delete|options|head|patch|trace)$": { - "$ref": "#/$defs/operation" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/path-item" - } - }, - "operation": { - "type": "object", - "properties": { - "tags": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - }, - "operationId": { - "type": "string" - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "requestBody": { - "$ref": "#/$defs/request-body-or-reference" - }, - "responses": { - "$ref": "#/$defs/responses" - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "external-documentation": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "url": { - "$ref": "#/$defs/uri" - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "path", - "cookie" - ] - }, - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "allowEmptyValue": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - }, - "content": { - "$ref": "#/$defs/content" - } - }, - "required": [ - "in" - ], - "oneOf": [ - { - "required": [ - "schema" - ] - }, - { - "required": [ - "content" - ] - } - ], - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "type": "string" - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/examples" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form" - } - ], - "$defs": { - "styles-for-path": { - "if": { - "properties": { - "in": { - "const": "path" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "simple", - "enum": [ - "matrix", - "label", - "simple" - ] - }, - "required": { - "const": true - } - }, - "required": [ - "required" - ] - } - }, - "styles-for-header": { - "if": { - "properties": { - "in": { - "const": "header" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "simple", - "enum": [ - "simple" - ] - } - } - } - }, - "styles-for-query": { - "if": { - "properties": { - "in": { - "const": "query" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - } - } - } - }, - "styles-for-cookie": { - "if": { - "properties": { - "in": { - "const": "cookie" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "enum": [ - "form" - ] - } - } - } - }, - "styles-for-form": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/parameter" - } - }, - "request-body": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "content": { - "$ref": "#/$defs/content" - }, - "required": { - "default": false, - "type": "boolean" - } - }, - "required": [ - "content" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "request-body-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/request-body" - } - }, - "content": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/media-type" - }, - "propertyNames": { - "format": "media-range" - } - }, - "media-type": { - "type": "object", - "properties": { - "schema": { - "$dynamicRef": "#meta" - }, - "encoding": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/encoding" - } - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/examples" - } - ], - "unevaluatedProperties": false - }, - "encoding": { - "type": "object", - "properties": { - "contentType": { - "type": "string", - "format": "media-range" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/encoding/$defs/explode-default" - } - ], - "unevaluatedProperties": false, - "$defs": { - "explode-default": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - }, - "responses": { - "type": "object", - "properties": { - "default": { - "$ref": "#/$defs/response-or-reference" - } - }, - "patternProperties": { - "^[1-5][0-9X]{2}$": { - "$ref": "#/$defs/response-or-reference" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "content": { - "$ref": "#/$defs/content" - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - } - }, - "required": [ - "description" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/response" - } - }, - "callbacks": { - "type": "object", - "$ref": "#/$defs/specification-extensions", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "callbacks-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/callbacks" - } - }, - "example": { - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "value": true, - "externalValue": { - "$ref": "#/$defs/uri" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "example-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/example" - } - }, - "link": { - "type": "object", - "properties": { - "operationRef": { - "$ref": "#/$defs/uri" - }, - "operationId": true, - "parameters": { - "$ref": "#/$defs/map-of-strings" - }, - "requestBody": true, - "description": { - "type": "string" - }, - "body": { - "$ref": "#/$defs/server" - } - }, - "oneOf": [ - { - "required": [ - "operationRef" - ] - }, - { - "required": [ - "operationId" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "link-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/link" - } - }, - "header": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "allowEmptyValue": { - "default": false, - "type": "boolean" - } - }, - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "default": "simple", - "enum": [ - "simple" - ] - }, - "explode": { - "default": false, - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - } - }, - "$ref": "#/$defs/examples" - }, - "content": { - "properties": { - "content": { - "$ref": "#/$defs/content" - } - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "header-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/header" - } - }, - "tag": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "name" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "reference": { - "type": "object", - "properties": { - "$ref": { - "$ref": "#/$defs/uri" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - } - }, - "unevaluatedProperties": false - }, - "schema": { - "$dynamicAnchor": "meta", - "type": [ - "object", - "boolean" - ] - }, - "security-scheme": { - "type": "object", - "properties": { - "type": { - "enum": [ - "apiKey", - "http", - "mutualTLS", - "oauth2", - "openIdConnect" - ] - }, - "description": { - "type": "string" - } - }, - "required": [ - "type" - ], - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-apikey" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http-bearer" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oauth2" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oidc" - } - ], - "unevaluatedProperties": false, - "$defs": { - "type-apikey": { - "if": { - "properties": { - "type": { - "const": "apiKey" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "cookie" - ] - } - }, - "required": [ - "name", - "in" - ] - } - }, - "type-http": { - "if": { - "properties": { - "type": { - "const": "http" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "scheme": { - "type": "string" - } - }, - "required": [ - "scheme" - ] - } - }, - "type-http-bearer": { - "if": { - "properties": { - "type": { - "const": "http" - }, - "scheme": { - "const": "bearer" - } - }, - "required": [ - "type", - "scheme" - ] - }, - "then": { - "properties": { - "bearerFormat": { - "type": "string" - } - }, - "required": [ - "scheme" - ] - } - }, - "type-oauth2": { - "if": { - "properties": { - "type": { - "const": "oauth2" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "flows": { - "$ref": "#/$defs/oauth-flows" - } - }, - "required": [ - "flows" - ] - } - }, - "type-oidc": { - "if": { - "properties": { - "type": { - "const": "openIdConnect" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "openIdConnectUrl": { - "$ref": "#/$defs/uri" - } - }, - "required": [ - "openIdConnectUrl" - ] - } - } - } - }, - "security-scheme-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/security-scheme" - } - }, - "oauth-flows": { - "type": "object", - "properties": { - "implicit": { - "$ref": "#/$defs/oauth-flows/$defs/implicit" - }, - "password": { - "$ref": "#/$defs/oauth-flows/$defs/password" - }, - "clientCredentials": { - "$ref": "#/$defs/oauth-flows/$defs/client-credentials" - }, - "authorizationCode": { - "$ref": "#/$defs/oauth-flows/$defs/authorization-code" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "implicit": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "password": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "client-credentials": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "authorization-code": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string" - }, - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - } - } - }, - "security-requirement": { - "type": "object", - "additionalProperties": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "specification-extensions": { - "patternProperties": { - "^x-": true - } - }, - "examples": { - "properties": { - "example": true, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - } - } - }, - "uri": { - "type": "string", - "format": "uri" - }, - "map-of-strings": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } -} diff --git a/docs/oas/3.1/schema/2021-04-15 b/docs/oas/3.1/schema/2021-04-15 deleted file mode 100644 index a798834247..0000000000 --- a/docs/oas/3.1/schema/2021-04-15 +++ /dev/null @@ -1,1343 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema/2021-04-15", - "$schema": "https://json-schema.org/draft/2020-12/schema", - "type": "object", - "properties": { - "openapi": { - "type": "string", - "pattern": "^3\\.1\\.\\d+(-.+)?$" - }, - "info": { - "$ref": "#/$defs/info" - }, - "jsonSchemaDialect": { - "$ref": "#/$defs/uri", - "default": "https://spec.openapis.org/oas/3.1/dialect/base" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - }, - "paths": { - "$ref": "#/$defs/paths" - }, - "webhooks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "components": { - "$ref": "#/$defs/components" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "tags": { - "type": "array", - "items": { - "$ref": "#/$defs/tag" - } - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "openapi", - "info" - ], - "anyOf": [ - { - "required": [ - "paths" - ] - }, - { - "required": [ - "components" - ] - }, - { - "required": [ - "webhooks" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "info": { - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "termsOfService": { - "type": "string" - }, - "contact": { - "$ref": "#/$defs/contact" - }, - "license": { - "$ref": "#/$defs/license" - }, - "version": { - "type": "string" - } - }, - "required": [ - "title", - "version" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "contact": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "url": { - "type": "string" - }, - "email": { - "type": "string" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "license": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "identifier": { - "type": "string" - }, - "url": { - "$ref": "#/$defs/uri" - } - }, - "required": [ - "name" - ], - "oneOf": [ - { - "required": [ - "identifier" - ] - }, - { - "required": [ - "url" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server": { - "type": "object", - "properties": { - "url": { - "$ref": "#/$defs/uri" - }, - "description": { - "type": "string" - }, - "variables": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/server-variable" - } - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server-variable": { - "type": "object", - "properties": { - "enum": { - "type": "array", - "items": { - "type": "string" - }, - "minItems": 1 - }, - "default": { - "type": "string" - }, - "descriptions": { - "type": "string" - } - }, - "required": [ - "default" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "components": { - "type": "object", - "properties": { - "schemas": { - "type": "object", - "additionalProperties": { - "$dynamicRef": "#meta" - } - }, - "responses": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/response-or-reference" - } - }, - "parameters": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - }, - "requestBodies": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/request-body-or-reference" - } - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "securitySchemes": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/security-scheme-or-reference" - } - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "pathItems": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - } - }, - "patternProperties": { - "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": { - "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected", - "propertyNames": { - "pattern": "^[a-zA-Z0-9._-]+$" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "paths": { - "type": "object", - "patternProperties": { - "^/": { - "$ref": "#/$defs/path-item" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item": { - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - } - }, - "patternProperties": { - "^(get|put|post|delete|options|head|patch|trace)$": { - "$ref": "#/$defs/operation" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/path-item" - } - }, - "operation": { - "type": "object", - "properties": { - "tags": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - }, - "operationId": { - "type": "string" - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "requestBody": { - "$ref": "#/$defs/request-body-or-reference" - }, - "responses": { - "$ref": "#/$defs/responses" - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "external-documentation": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "url": { - "$ref": "#/$defs/uri" - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "path", - "cookie" - ] - }, - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "allowEmptyValue": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - }, - "content": { - "$ref": "#/$defs/content" - } - }, - "required": [ - "in" - ], - "oneOf": [ - { - "required": [ - "schema" - ] - }, - { - "required": [ - "content" - ] - } - ], - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "type": "string" - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/examples" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form" - } - ], - "$defs": { - "styles-for-path": { - "if": { - "properties": { - "in": { - "const": "path" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "simple", - "enum": [ - "matrix", - "label", - "simple" - ] - }, - "required": { - "const": true - } - }, - "required": [ - "required" - ] - } - }, - "styles-for-header": { - "if": { - "properties": { - "in": { - "const": "header" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "simple", - "enum": [ - "simple" - ] - } - } - } - }, - "styles-for-query": { - "if": { - "properties": { - "in": { - "const": "query" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - } - } - } - }, - "styles-for-cookie": { - "if": { - "properties": { - "in": { - "const": "cookie" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "enum": [ - "form" - ] - } - } - } - }, - "styles-for-form": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/parameter" - } - }, - "request-body": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "content": { - "$ref": "#/$defs/content" - }, - "required": { - "default": false, - "type": "boolean" - } - }, - "required": [ - "content" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "request-body-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/request-body" - } - }, - "content": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/media-type" - }, - "propertyNames": { - "format": "media-range" - } - }, - "media-type": { - "type": "object", - "properties": { - "schema": { - "$dynamicRef": "#meta" - }, - "encoding": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/encoding" - } - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/examples" - } - ], - "unevaluatedProperties": false - }, - "encoding": { - "type": "object", - "properties": { - "contentType": { - "type": "string", - "format": "media-range" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/encoding/$defs/explode-default" - } - ], - "unevaluatedProperties": false, - "$defs": { - "explode-default": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - }, - "responses": { - "type": "object", - "properties": { - "default": { - "$ref": "#/$defs/response-or-reference" - } - }, - "patternProperties": { - "^[1-5][0-9X]{2}$": { - "$ref": "#/$defs/response-or-reference" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "content": { - "$ref": "#/$defs/content" - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - } - }, - "required": [ - "description" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/response" - } - }, - "callbacks": { - "type": "object", - "$ref": "#/$defs/specification-extensions", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "callbacks-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/callbacks" - } - }, - "example": { - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "value": true, - "externalValue": { - "$ref": "#/$defs/uri" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "example-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/example" - } - }, - "link": { - "type": "object", - "properties": { - "operationRef": { - "$ref": "#/$defs/uri" - }, - "operationId": true, - "parameters": { - "$ref": "#/$defs/map-of-strings" - }, - "requestBody": true, - "description": { - "type": "string" - }, - "body": { - "$ref": "#/$defs/server" - } - }, - "oneOf": [ - { - "required": [ - "operationRef" - ] - }, - { - "required": [ - "operationId" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "link-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/link" - } - }, - "header": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "allowEmptyValue": { - "default": false, - "type": "boolean" - } - }, - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "default": "simple", - "enum": [ - "simple" - ] - }, - "explode": { - "default": false, - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - } - }, - "$ref": "#/$defs/examples" - }, - "content": { - "properties": { - "content": { - "$ref": "#/$defs/content" - } - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "header-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/header" - } - }, - "tag": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "name" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "reference": { - "type": "object", - "properties": { - "$ref": { - "$ref": "#/$defs/uri" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - } - }, - "unevaluatedProperties": false - }, - "schema": { - "$dynamicAnchor": "meta", - "type": [ - "object", - "boolean" - ] - }, - "security-scheme": { - "type": "object", - "properties": { - "type": { - "enum": [ - "apiKey", - "http", - "mutualTLS", - "oauth2", - "openIdConnect" - ] - }, - "description": { - "type": "string" - } - }, - "required": [ - "type" - ], - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-apikey" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http-bearer" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oauth2" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oidc" - } - ], - "unevaluatedProperties": false, - "$defs": { - "type-apikey": { - "if": { - "properties": { - "type": { - "const": "apiKey" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "cookie" - ] - } - }, - "required": [ - "name", - "in" - ] - } - }, - "type-http": { - "if": { - "properties": { - "type": { - "const": "http" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "scheme": { - "type": "string" - } - }, - "required": [ - "scheme" - ] - } - }, - "type-http-bearer": { - "if": { - "properties": { - "type": { - "const": "http" - }, - "scheme": { - "const": "bearer" - } - }, - "required": [ - "type", - "scheme" - ] - }, - "then": { - "properties": { - "bearerFormat": { - "type": "string" - } - }, - "required": [ - "scheme" - ] - } - }, - "type-oauth2": { - "if": { - "properties": { - "type": { - "const": "oauth2" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "flows": { - "$ref": "#/$defs/oauth-flows" - } - }, - "required": [ - "flows" - ] - } - }, - "type-oidc": { - "if": { - "properties": { - "type": { - "const": "openIdConnect" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "openIdConnectUrl": { - "$ref": "#/$defs/uri" - } - }, - "required": [ - "openIdConnectUrl" - ] - } - } - } - }, - "security-scheme-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/security-scheme" - } - }, - "oauth-flows": { - "type": "object", - "properties": { - "implicit": { - "$ref": "#/$defs/oauth-flows/$defs/implicit" - }, - "password": { - "$ref": "#/$defs/oauth-flows/$defs/password" - }, - "clientCredentials": { - "$ref": "#/$defs/oauth-flows/$defs/client-credentials" - }, - "authorizationCode": { - "$ref": "#/$defs/oauth-flows/$defs/authorization-code" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "implicit": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "password": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "client-credentials": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "authorization-code": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string" - }, - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - } - } - }, - "security-requirement": { - "type": "object", - "additionalProperties": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "specification-extensions": { - "patternProperties": { - "^x-": true - } - }, - "examples": { - "properties": { - "example": true, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - } - } - }, - "uri": { - "type": "string", - "format": "uri" - }, - "map-of-strings": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } -} diff --git a/docs/oas/3.1/schema/2021-05-20 b/docs/oas/3.1/schema/2021-05-20 deleted file mode 100644 index 44fdbb92b8..0000000000 --- a/docs/oas/3.1/schema/2021-05-20 +++ /dev/null @@ -1,1347 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema/2021-05-20", - "$schema": "https://json-schema.org/draft/2020-12/schema", - "type": "object", - "properties": { - "openapi": { - "type": "string", - "pattern": "^3\\.1\\.\\d+(-.+)?$" - }, - "info": { - "$ref": "#/$defs/info" - }, - "jsonSchemaDialect": { - "type": "string", - "format": "uri", - "default": "https://spec.openapis.org/oas/3.1/dialect/base" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - }, - "paths": { - "$ref": "#/$defs/paths" - }, - "webhooks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "components": { - "$ref": "#/$defs/components" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "tags": { - "type": "array", - "items": { - "$ref": "#/$defs/tag" - } - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "openapi", - "info" - ], - "anyOf": [ - { - "required": [ - "paths" - ] - }, - { - "required": [ - "components" - ] - }, - { - "required": [ - "webhooks" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "info": { - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "termsOfService": { - "type": "string" - }, - "contact": { - "$ref": "#/$defs/contact" - }, - "license": { - "$ref": "#/$defs/license" - }, - "version": { - "type": "string" - } - }, - "required": [ - "title", - "version" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "contact": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "url": { - "type": "string" - }, - "email": { - "type": "string" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "license": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "identifier": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "name" - ], - "oneOf": [ - { - "required": [ - "identifier" - ] - }, - { - "required": [ - "url" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server": { - "type": "object", - "properties": { - "url": { - "type": "string", - "format": "uri-reference" - }, - "description": { - "type": "string" - }, - "variables": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/server-variable" - } - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server-variable": { - "type": "object", - "properties": { - "enum": { - "type": "array", - "items": { - "type": "string" - }, - "minItems": 1 - }, - "default": { - "type": "string" - }, - "descriptions": { - "type": "string" - } - }, - "required": [ - "default" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "components": { - "type": "object", - "properties": { - "schemas": { - "type": "object", - "additionalProperties": { - "$dynamicRef": "#meta" - } - }, - "responses": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/response-or-reference" - } - }, - "parameters": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - }, - "requestBodies": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/request-body-or-reference" - } - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "securitySchemes": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/security-scheme-or-reference" - } - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "pathItems": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - } - }, - "patternProperties": { - "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": { - "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected", - "propertyNames": { - "pattern": "^[a-zA-Z0-9._-]+$" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "paths": { - "type": "object", - "patternProperties": { - "^/": { - "$ref": "#/$defs/path-item" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item": { - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - } - }, - "patternProperties": { - "^(get|put|post|delete|options|head|patch|trace)$": { - "$ref": "#/$defs/operation" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/path-item" - } - }, - "operation": { - "type": "object", - "properties": { - "tags": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - }, - "operationId": { - "type": "string" - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "requestBody": { - "$ref": "#/$defs/request-body-or-reference" - }, - "responses": { - "$ref": "#/$defs/responses" - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "external-documentation": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "path", - "cookie" - ] - }, - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "allowEmptyValue": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - }, - "content": { - "$ref": "#/$defs/content" - } - }, - "required": [ - "in" - ], - "oneOf": [ - { - "required": [ - "schema" - ] - }, - { - "required": [ - "content" - ] - } - ], - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "type": "string" - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/examples" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form" - } - ], - "$defs": { - "styles-for-path": { - "if": { - "properties": { - "in": { - "const": "path" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "simple", - "enum": [ - "matrix", - "label", - "simple" - ] - }, - "required": { - "const": true - } - }, - "required": [ - "required" - ] - } - }, - "styles-for-header": { - "if": { - "properties": { - "in": { - "const": "header" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "simple", - "enum": [ - "simple" - ] - } - } - } - }, - "styles-for-query": { - "if": { - "properties": { - "in": { - "const": "query" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - } - } - } - }, - "styles-for-cookie": { - "if": { - "properties": { - "in": { - "const": "cookie" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "enum": [ - "form" - ] - } - } - } - }, - "styles-for-form": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/parameter" - } - }, - "request-body": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "content": { - "$ref": "#/$defs/content" - }, - "required": { - "default": false, - "type": "boolean" - } - }, - "required": [ - "content" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "request-body-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/request-body" - } - }, - "content": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/media-type" - }, - "propertyNames": { - "format": "media-range" - } - }, - "media-type": { - "type": "object", - "properties": { - "schema": { - "$dynamicRef": "#meta" - }, - "encoding": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/encoding" - } - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/examples" - } - ], - "unevaluatedProperties": false - }, - "encoding": { - "type": "object", - "properties": { - "contentType": { - "type": "string", - "format": "media-range" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/encoding/$defs/explode-default" - } - ], - "unevaluatedProperties": false, - "$defs": { - "explode-default": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - }, - "responses": { - "type": "object", - "properties": { - "default": { - "$ref": "#/$defs/response-or-reference" - } - }, - "patternProperties": { - "^[1-5][0-9X]{2}$": { - "$ref": "#/$defs/response-or-reference" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "content": { - "$ref": "#/$defs/content" - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - } - }, - "required": [ - "description" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/response" - } - }, - "callbacks": { - "type": "object", - "$ref": "#/$defs/specification-extensions", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "callbacks-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/callbacks" - } - }, - "example": { - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "value": true, - "externalValue": { - "type": "string", - "format": "uri" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "example-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/example" - } - }, - "link": { - "type": "object", - "properties": { - "operationRef": { - "type": "string", - "format": "uri-reference" - }, - "operationId": true, - "parameters": { - "$ref": "#/$defs/map-of-strings" - }, - "requestBody": true, - "description": { - "type": "string" - }, - "body": { - "$ref": "#/$defs/server" - } - }, - "oneOf": [ - { - "required": [ - "operationRef" - ] - }, - { - "required": [ - "operationId" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "link-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/link" - } - }, - "header": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "allowEmptyValue": { - "default": false, - "type": "boolean" - } - }, - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "default": "simple", - "enum": [ - "simple" - ] - }, - "explode": { - "default": false, - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - } - }, - "$ref": "#/$defs/examples" - }, - "content": { - "properties": { - "content": { - "$ref": "#/$defs/content" - } - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "header-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/header" - } - }, - "tag": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "name" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "reference": { - "type": "object", - "properties": { - "$ref": { - "type": "string", - "format": "uri-reference" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - } - }, - "unevaluatedProperties": false - }, - "schema": { - "$dynamicAnchor": "meta", - "type": [ - "object", - "boolean" - ] - }, - "security-scheme": { - "type": "object", - "properties": { - "type": { - "enum": [ - "apiKey", - "http", - "mutualTLS", - "oauth2", - "openIdConnect" - ] - }, - "description": { - "type": "string" - } - }, - "required": [ - "type" - ], - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-apikey" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http-bearer" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oauth2" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oidc" - } - ], - "unevaluatedProperties": false, - "$defs": { - "type-apikey": { - "if": { - "properties": { - "type": { - "const": "apiKey" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "cookie" - ] - } - }, - "required": [ - "name", - "in" - ] - } - }, - "type-http": { - "if": { - "properties": { - "type": { - "const": "http" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "scheme": { - "type": "string" - } - }, - "required": [ - "scheme" - ] - } - }, - "type-http-bearer": { - "if": { - "properties": { - "type": { - "const": "http" - }, - "scheme": { - "const": "bearer" - } - }, - "required": [ - "type", - "scheme" - ] - }, - "then": { - "properties": { - "bearerFormat": { - "type": "string" - } - }, - "required": [ - "scheme" - ] - } - }, - "type-oauth2": { - "if": { - "properties": { - "type": { - "const": "oauth2" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "flows": { - "$ref": "#/$defs/oauth-flows" - } - }, - "required": [ - "flows" - ] - } - }, - "type-oidc": { - "if": { - "properties": { - "type": { - "const": "openIdConnect" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "openIdConnectUrl": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "openIdConnectUrl" - ] - } - } - } - }, - "security-scheme-or-reference": { - "if": { - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/security-scheme" - } - }, - "oauth-flows": { - "type": "object", - "properties": { - "implicit": { - "$ref": "#/$defs/oauth-flows/$defs/implicit" - }, - "password": { - "$ref": "#/$defs/oauth-flows/$defs/password" - }, - "clientCredentials": { - "$ref": "#/$defs/oauth-flows/$defs/client-credentials" - }, - "authorizationCode": { - "$ref": "#/$defs/oauth-flows/$defs/authorization-code" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "implicit": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "password": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "client-credentials": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "authorization-code": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string" - }, - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - } - } - }, - "security-requirement": { - "type": "object", - "additionalProperties": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "specification-extensions": { - "patternProperties": { - "^x-": true - } - }, - "examples": { - "properties": { - "example": true, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - } - } - }, - "map-of-strings": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } -} diff --git a/docs/oas/3.1/schema/2021-09-28 b/docs/oas/3.1/schema/2021-09-28 deleted file mode 100644 index 4ea4da67b5..0000000000 --- a/docs/oas/3.1/schema/2021-09-28 +++ /dev/null @@ -1,1351 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema/2021-09-28", - "$schema": "https://json-schema.org/draft/2020-12/schema", - "type": "object", - "properties": { - "openapi": { - "type": "string", - "pattern": "^3\\.1\\.\\d+(-.+)?$" - }, - "info": { - "$ref": "#/$defs/info" - }, - "jsonSchemaDialect": { - "type": "string", - "format": "uri", - "default": "https://spec.openapis.org/oas/3.1/dialect/base" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - }, - "paths": { - "$ref": "#/$defs/paths" - }, - "webhooks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "components": { - "$ref": "#/$defs/components" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "tags": { - "type": "array", - "items": { - "$ref": "#/$defs/tag" - } - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "openapi", - "info" - ], - "anyOf": [ - { - "required": [ - "paths" - ] - }, - { - "required": [ - "components" - ] - }, - { - "required": [ - "webhooks" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "info": { - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "termsOfService": { - "type": "string" - }, - "contact": { - "$ref": "#/$defs/contact" - }, - "license": { - "$ref": "#/$defs/license" - }, - "version": { - "type": "string" - } - }, - "required": [ - "title", - "version" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "contact": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "url": { - "type": "string" - }, - "email": { - "type": "string" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "license": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "identifier": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "name" - ], - "oneOf": [ - { - "required": [ - "identifier" - ] - }, - { - "required": [ - "url" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server": { - "type": "object", - "properties": { - "url": { - "type": "string", - "format": "uri-reference" - }, - "description": { - "type": "string" - }, - "variables": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/server-variable" - } - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server-variable": { - "type": "object", - "properties": { - "enum": { - "type": "array", - "items": { - "type": "string" - }, - "minItems": 1 - }, - "default": { - "type": "string" - }, - "descriptions": { - "type": "string" - } - }, - "required": [ - "default" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "components": { - "type": "object", - "properties": { - "schemas": { - "type": "object", - "additionalProperties": { - "$dynamicRef": "#meta" - } - }, - "responses": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/response-or-reference" - } - }, - "parameters": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - }, - "requestBodies": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/request-body-or-reference" - } - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "securitySchemes": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/security-scheme-or-reference" - } - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "pathItems": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - } - }, - "patternProperties": { - "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": { - "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected", - "propertyNames": { - "pattern": "^[a-zA-Z0-9._-]+$" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "paths": { - "type": "object", - "patternProperties": { - "^/": { - "$ref": "#/$defs/path-item" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item": { - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - } - }, - "patternProperties": { - "^(get|put|post|delete|options|head|patch|trace)$": { - "$ref": "#/$defs/operation" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/path-item" - } - }, - "operation": { - "type": "object", - "properties": { - "tags": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - }, - "operationId": { - "type": "string" - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "requestBody": { - "$ref": "#/$defs/request-body-or-reference" - }, - "responses": { - "$ref": "#/$defs/responses" - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "external-documentation": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "path", - "cookie" - ] - }, - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "allowEmptyValue": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - }, - "content": { - "$ref": "#/$defs/content" - } - }, - "required": [ - "in" - ], - "oneOf": [ - { - "required": [ - "schema" - ] - }, - { - "required": [ - "content" - ] - } - ], - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "type": "string" - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/examples" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form" - } - ], - "$defs": { - "styles-for-path": { - "if": { - "properties": { - "in": { - "const": "path" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "name": { - "pattern": "[^/#?]+$" - }, - "style": { - "default": "simple", - "enum": [ - "matrix", - "label", - "simple" - ] - }, - "required": { - "const": true - } - }, - "required": [ - "required" - ] - } - }, - "styles-for-header": { - "if": { - "properties": { - "in": { - "const": "header" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "simple", - "const": "simple" - } - } - } - }, - "styles-for-query": { - "if": { - "properties": { - "in": { - "const": "query" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - } - } - } - }, - "styles-for-cookie": { - "if": { - "properties": { - "in": { - "const": "cookie" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "const": "form" - } - } - } - }, - "styles-for-form": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/parameter" - } - }, - "request-body": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "content": { - "$ref": "#/$defs/content" - }, - "required": { - "default": false, - "type": "boolean" - } - }, - "required": [ - "content" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "request-body-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/request-body" - } - }, - "content": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/media-type" - }, - "propertyNames": { - "format": "media-range" - } - }, - "media-type": { - "type": "object", - "properties": { - "schema": { - "$dynamicRef": "#meta" - }, - "encoding": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/encoding" - } - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/examples" - } - ], - "unevaluatedProperties": false - }, - "encoding": { - "type": "object", - "properties": { - "contentType": { - "type": "string", - "format": "media-range" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/encoding/$defs/explode-default" - } - ], - "unevaluatedProperties": false, - "$defs": { - "explode-default": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - }, - "responses": { - "type": "object", - "properties": { - "default": { - "$ref": "#/$defs/response-or-reference" - } - }, - "patternProperties": { - "^[1-5](?:[0-9]{2}|XX)$": { - "$ref": "#/$defs/response-or-reference" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "content": { - "$ref": "#/$defs/content" - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - } - }, - "required": [ - "description" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/response" - } - }, - "callbacks": { - "type": "object", - "$ref": "#/$defs/specification-extensions", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "callbacks-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/callbacks" - } - }, - "example": { - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "value": true, - "externalValue": { - "type": "string", - "format": "uri" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "example-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/example" - } - }, - "link": { - "type": "object", - "properties": { - "operationRef": { - "type": "string", - "format": "uri-reference" - }, - "operationId": true, - "parameters": { - "$ref": "#/$defs/map-of-strings" - }, - "requestBody": true, - "description": { - "type": "string" - }, - "body": { - "$ref": "#/$defs/server" - } - }, - "oneOf": [ - { - "required": [ - "operationRef" - ] - }, - { - "required": [ - "operationId" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "link-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/link" - } - }, - "header": { - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - }, - "content": { - "$ref": "#/$defs/content" - } - }, - "oneOf": [ - { - "required": [ - "schema" - ] - }, - { - "required": [ - "content" - ] - } - ], - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "default": "simple", - "const": "simple" - }, - "explode": { - "default": false, - "type": "boolean" - } - }, - "$ref": "#/$defs/examples" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "header-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/header" - } - }, - "tag": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "name" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "reference": { - "type": "object", - "properties": { - "$ref": { - "type": "string", - "format": "uri-reference" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - } - }, - "unevaluatedProperties": false - }, - "schema": { - "$dynamicAnchor": "meta", - "type": [ - "object", - "boolean" - ] - }, - "security-scheme": { - "type": "object", - "properties": { - "type": { - "enum": [ - "apiKey", - "http", - "mutualTLS", - "oauth2", - "openIdConnect" - ] - }, - "description": { - "type": "string" - } - }, - "required": [ - "type" - ], - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-apikey" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http-bearer" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oauth2" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oidc" - } - ], - "unevaluatedProperties": false, - "$defs": { - "type-apikey": { - "if": { - "properties": { - "type": { - "const": "apiKey" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "cookie" - ] - } - }, - "required": [ - "name", - "in" - ] - } - }, - "type-http": { - "if": { - "properties": { - "type": { - "const": "http" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "scheme": { - "type": "string" - } - }, - "required": [ - "scheme" - ] - } - }, - "type-http-bearer": { - "if": { - "properties": { - "type": { - "const": "http" - }, - "scheme": { - "type": "string", - "pattern": "^[Bb][Ee][Aa][Rr][Ee][Rr]$" - } - }, - "required": [ - "type", - "scheme" - ] - }, - "then": { - "properties": { - "bearerFormat": { - "type": "string" - } - } - } - }, - "type-oauth2": { - "if": { - "properties": { - "type": { - "const": "oauth2" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "flows": { - "$ref": "#/$defs/oauth-flows" - } - }, - "required": [ - "flows" - ] - } - }, - "type-oidc": { - "if": { - "properties": { - "type": { - "const": "openIdConnect" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "openIdConnectUrl": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "openIdConnectUrl" - ] - } - } - } - }, - "security-scheme-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/security-scheme" - } - }, - "oauth-flows": { - "type": "object", - "properties": { - "implicit": { - "$ref": "#/$defs/oauth-flows/$defs/implicit" - }, - "password": { - "$ref": "#/$defs/oauth-flows/$defs/password" - }, - "clientCredentials": { - "$ref": "#/$defs/oauth-flows/$defs/client-credentials" - }, - "authorizationCode": { - "$ref": "#/$defs/oauth-flows/$defs/authorization-code" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "implicit": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "password": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "client-credentials": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "authorization-code": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string" - }, - "tokenUrl": { - "type": "string" - }, - "refreshUrl": { - "type": "string" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - } - } - }, - "security-requirement": { - "type": "object", - "additionalProperties": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "specification-extensions": { - "patternProperties": { - "^x-": true - } - }, - "examples": { - "properties": { - "example": true, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - } - } - }, - "map-of-strings": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } -} diff --git a/docs/oas/3.1/schema/2022-02-27 b/docs/oas/3.1/schema/2022-02-27 deleted file mode 100644 index ed0fd49a65..0000000000 --- a/docs/oas/3.1/schema/2022-02-27 +++ /dev/null @@ -1,1420 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema/2022-02-27", - "$schema": "https://json-schema.org/draft/2020-12/schema", - "description": "The description of OpenAPI v3.1.x documents without schema validation, as defined by https://spec.openapis.org/oas/v3.1.0", - "type": "object", - "properties": { - "openapi": { - "type": "string", - "pattern": "^3\\.1\\.\\d+(-.+)?$" - }, - "info": { - "$ref": "#/$defs/info" - }, - "jsonSchemaDialect": { - "type": "string", - "format": "uri", - "default": "https://spec.openapis.org/oas/3.1/dialect/base" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - }, - "default": [ - { "url": "/" } - ] - }, - "paths": { - "$ref": "#/$defs/paths" - }, - "webhooks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "components": { - "$ref": "#/$defs/components" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "tags": { - "type": "array", - "items": { - "$ref": "#/$defs/tag" - } - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "openapi", - "info" - ], - "anyOf": [ - { - "required": [ - "paths" - ] - }, - { - "required": [ - "components" - ] - }, - { - "required": [ - "webhooks" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "info": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#info-object", - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "termsOfService": { - "type": "string", - "format": "uri" - }, - "contact": { - "$ref": "#/$defs/contact" - }, - "license": { - "$ref": "#/$defs/license" - }, - "version": { - "type": "string" - } - }, - "required": [ - "title", - "version" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "contact": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#contact-object", - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri" - }, - "email": { - "type": "string", - "format": "email" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "license": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#license-object", - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "identifier": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "name" - ], - "oneOf": [ - { - "required": [ - "identifier" - ] - }, - { - "required": [ - "url" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#server-object", - "type": "object", - "properties": { - "url": { - "type": "string", - "format": "uri-reference" - }, - "description": { - "type": "string" - }, - "variables": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/server-variable" - } - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server-variable": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#server-variable-object", - "type": "object", - "properties": { - "enum": { - "type": "array", - "items": { - "type": "string" - }, - "minItems": 1 - }, - "default": { - "type": "string" - }, - "description": { - "type": "string" - } - }, - "required": [ - "default" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "components": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#components-object", - "type": "object", - "properties": { - "schemas": { - "type": "object", - "additionalProperties": { - "$dynamicRef": "#meta" - } - }, - "responses": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/response-or-reference" - } - }, - "parameters": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - }, - "requestBodies": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/request-body-or-reference" - } - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "securitySchemes": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/security-scheme-or-reference" - } - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "pathItems": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - } - }, - "patternProperties": { - "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": { - "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected", - "propertyNames": { - "pattern": "^[a-zA-Z0-9._-]+$" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "paths": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#paths-object", - "type": "object", - "patternProperties": { - "^/": { - "$ref": "#/$defs/path-item" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#path-item-object", - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - } - }, - "patternProperties": { - "^(get|put|post|delete|options|head|patch|trace)$": { - "$ref": "#/$defs/operation" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/path-item" - } - }, - "operation": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#operation-object", - "type": "object", - "properties": { - "tags": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - }, - "operationId": { - "type": "string" - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "requestBody": { - "$ref": "#/$defs/request-body-or-reference" - }, - "responses": { - "$ref": "#/$defs/responses" - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "external-documentation": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#external-documentation-object", - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#parameter-object", - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "path", - "cookie" - ] - }, - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - }, - "content": { - "$ref": "#/$defs/content", - "minProperties": 1, - "maxProperties": 1 - } - }, - "required": [ - "name", - "in" - ], - "oneOf": [ - { - "required": [ - "schema" - ] - }, - { - "required": [ - "content" - ] - } - ], - "if": { - "properties": { - "in": { - "const": "query" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "allowEmptyValue": { - "default": false, - "type": "boolean" - } - } - }, - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "type": "string" - }, - "explode": { - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/examples" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form" - } - ], - "$defs": { - "styles-for-path": { - "if": { - "properties": { - "in": { - "const": "path" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "name": { - "pattern": "[^/#?]+$" - }, - "style": { - "default": "simple", - "enum": [ - "matrix", - "label", - "simple" - ] - }, - "required": { - "const": true - } - }, - "required": [ - "required" - ] - } - }, - "styles-for-header": { - "if": { - "properties": { - "in": { - "const": "header" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "simple", - "const": "simple" - } - } - } - }, - "styles-for-query": { - "if": { - "properties": { - "in": { - "const": "query" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - } - } - }, - "styles-for-cookie": { - "if": { - "properties": { - "in": { - "const": "cookie" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "const": "form" - } - } - } - }, - "styles-for-form": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/parameter" - } - }, - "request-body": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#request-body-object", - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "content": { - "$ref": "#/$defs/content" - }, - "required": { - "default": false, - "type": "boolean" - } - }, - "required": [ - "content" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "request-body-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/request-body" - } - }, - "content": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#fixed-fields-10", - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/media-type" - }, - "propertyNames": { - "format": "media-range" - } - }, - "media-type": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#media-type-object", - "type": "object", - "properties": { - "schema": { - "$dynamicRef": "#meta" - }, - "encoding": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/encoding" - } - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/examples" - } - ], - "unevaluatedProperties": false - }, - "encoding": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#encoding-object", - "type": "object", - "properties": { - "contentType": { - "type": "string", - "format": "media-range" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/encoding/$defs/explode-default" - } - ], - "unevaluatedProperties": false, - "$defs": { - "explode-default": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - }, - "responses": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#responses-object", - "type": "object", - "properties": { - "default": { - "$ref": "#/$defs/response-or-reference" - } - }, - "patternProperties": { - "^[1-5](?:[0-9]{2}|XX)$": { - "$ref": "#/$defs/response-or-reference" - } - }, - "minProperties": 1, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#response-object", - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "content": { - "$ref": "#/$defs/content" - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - } - }, - "required": [ - "description" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/response" - } - }, - "callbacks": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#callback-object", - "type": "object", - "$ref": "#/$defs/specification-extensions", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "callbacks-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/callbacks" - } - }, - "example": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#example-object", - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "value": true, - "externalValue": { - "type": "string", - "format": "uri" - } - }, - "not": { - "required": [ - "value", - "externalValue" - ] - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "example-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/example" - } - }, - "link": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#link-object", - "type": "object", - "properties": { - "operationRef": { - "type": "string", - "format": "uri-reference" - }, - "operationId": true, - "parameters": { - "$ref": "#/$defs/map-of-strings" - }, - "requestBody": true, - "description": { - "type": "string" - }, - "body": { - "$ref": "#/$defs/server" - } - }, - "oneOf": [ - { - "required": [ - "operationRef" - ] - }, - { - "required": [ - "operationId" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "link-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/link" - } - }, - "header": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#header-object", - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - }, - "content": { - "$ref": "#/$defs/content", - "minProperties": 1, - "maxProperties": 1 - } - }, - "oneOf": [ - { - "required": [ - "schema" - ] - }, - { - "required": [ - "content" - ] - } - ], - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "default": "simple", - "const": "simple" - }, - "explode": { - "default": false, - "type": "boolean" - } - }, - "$ref": "#/$defs/examples" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "header-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/header" - } - }, - "tag": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#tag-object", - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "name" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "reference": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#reference-object", - "type": "object", - "properties": { - "$ref": { - "type": "string", - "format": "uri-reference" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - } - }, - "unevaluatedProperties": false - }, - "schema": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#schema-object", - "$dynamicAnchor": "meta", - "type": [ - "object", - "boolean" - ] - }, - "security-scheme": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#security-scheme-object", - "type": "object", - "properties": { - "type": { - "enum": [ - "apiKey", - "http", - "mutualTLS", - "oauth2", - "openIdConnect" - ] - }, - "description": { - "type": "string" - } - }, - "required": [ - "type" - ], - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-apikey" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http-bearer" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oauth2" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oidc" - } - ], - "unevaluatedProperties": false, - "$defs": { - "type-apikey": { - "if": { - "properties": { - "type": { - "const": "apiKey" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "cookie" - ] - } - }, - "required": [ - "name", - "in" - ] - } - }, - "type-http": { - "if": { - "properties": { - "type": { - "const": "http" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "scheme": { - "type": "string" - } - }, - "required": [ - "scheme" - ] - } - }, - "type-http-bearer": { - "if": { - "properties": { - "type": { - "const": "http" - }, - "scheme": { - "type": "string", - "pattern": "^[Bb][Ee][Aa][Rr][Ee][Rr]$" - } - }, - "required": [ - "type", - "scheme" - ] - }, - "then": { - "properties": { - "bearerFormat": { - "type": "string" - } - } - } - }, - "type-oauth2": { - "if": { - "properties": { - "type": { - "const": "oauth2" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "flows": { - "$ref": "#/$defs/oauth-flows" - } - }, - "required": [ - "flows" - ] - } - }, - "type-oidc": { - "if": { - "properties": { - "type": { - "const": "openIdConnect" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "openIdConnectUrl": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "openIdConnectUrl" - ] - } - } - } - }, - "security-scheme-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/security-scheme" - } - }, - "oauth-flows": { - "type": "object", - "properties": { - "implicit": { - "$ref": "#/$defs/oauth-flows/$defs/implicit" - }, - "password": { - "$ref": "#/$defs/oauth-flows/$defs/password" - }, - "clientCredentials": { - "$ref": "#/$defs/oauth-flows/$defs/client-credentials" - }, - "authorizationCode": { - "$ref": "#/$defs/oauth-flows/$defs/authorization-code" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "implicit": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string", - "format": "uri" - }, - "refreshUrl": { - "type": "string", - "format": "uri" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "password": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string", - "format": "uri" - }, - "refreshUrl": { - "type": "string", - "format": "uri" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "client-credentials": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string", - "format": "uri" - }, - "refreshUrl": { - "type": "string", - "format": "uri" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "authorization-code": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string", - "format": "uri" - }, - "tokenUrl": { - "type": "string", - "format": "uri" - }, - "refreshUrl": { - "type": "string", - "format": "uri" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - } - } - }, - "security-requirement": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#security-requirement-object", - "type": "object", - "additionalProperties": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "specification-extensions": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#specification-extensions", - "patternProperties": { - "^x-": true - } - }, - "examples": { - "properties": { - "example": true, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - } - } - }, - "map-of-strings": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } -} diff --git a/docs/oas/3.1/schema/2022-10-07 b/docs/oas/3.1/schema/2022-10-07 deleted file mode 100644 index 468bc7e5f5..0000000000 --- a/docs/oas/3.1/schema/2022-10-07 +++ /dev/null @@ -1,1440 +0,0 @@ -{ - "$id": "https://spec.openapis.org/oas/3.1/schema/2022-10-07", - "$schema": "https://json-schema.org/draft/2020-12/schema", - "description": "The description of OpenAPI v3.1.x documents without schema validation, as defined by https://spec.openapis.org/oas/v3.1.0", - "type": "object", - "properties": { - "openapi": { - "type": "string", - "pattern": "^3\\.1\\.\\d+(-.+)?$" - }, - "info": { - "$ref": "#/$defs/info" - }, - "jsonSchemaDialect": { - "type": "string", - "format": "uri", - "default": "https://spec.openapis.org/oas/3.1/dialect/base" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - }, - "default": [ - { - "url": "/" - } - ] - }, - "paths": { - "$ref": "#/$defs/paths" - }, - "webhooks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "components": { - "$ref": "#/$defs/components" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "tags": { - "type": "array", - "items": { - "$ref": "#/$defs/tag" - } - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "openapi", - "info" - ], - "anyOf": [ - { - "required": [ - "paths" - ] - }, - { - "required": [ - "components" - ] - }, - { - "required": [ - "webhooks" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "info": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#info-object", - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "termsOfService": { - "type": "string", - "format": "uri" - }, - "contact": { - "$ref": "#/$defs/contact" - }, - "license": { - "$ref": "#/$defs/license" - }, - "version": { - "type": "string" - } - }, - "required": [ - "title", - "version" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "contact": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#contact-object", - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri" - }, - "email": { - "type": "string", - "format": "email" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "license": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#license-object", - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "identifier": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "name" - ], - "dependentSchemas": { - "identifier": { - "not": { - "required": [ - "url" - ] - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#server-object", - "type": "object", - "properties": { - "url": { - "type": "string", - "format": "uri-reference" - }, - "description": { - "type": "string" - }, - "variables": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/server-variable" - } - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "server-variable": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#server-variable-object", - "type": "object", - "properties": { - "enum": { - "type": "array", - "items": { - "type": "string" - }, - "minItems": 1 - }, - "default": { - "type": "string" - }, - "description": { - "type": "string" - } - }, - "required": [ - "default" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "components": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#components-object", - "type": "object", - "properties": { - "schemas": { - "type": "object", - "additionalProperties": { - "$dynamicRef": "#meta" - } - }, - "responses": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/response-or-reference" - } - }, - "parameters": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - }, - "requestBodies": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/request-body-or-reference" - } - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "securitySchemes": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/security-scheme-or-reference" - } - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "pathItems": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - } - }, - "patternProperties": { - "^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$": { - "$comment": "Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected", - "propertyNames": { - "pattern": "^[a-zA-Z0-9._-]+$" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "paths": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#paths-object", - "type": "object", - "patternProperties": { - "^/": { - "$ref": "#/$defs/path-item" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#path-item-object", - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "get": { - "$ref": "#/$defs/operation" - }, - "put": { - "$ref": "#/$defs/operation" - }, - "post": { - "$ref": "#/$defs/operation" - }, - "delete": { - "$ref": "#/$defs/operation" - }, - "options": { - "$ref": "#/$defs/operation" - }, - "head": { - "$ref": "#/$defs/operation" - }, - "patch": { - "$ref": "#/$defs/operation" - }, - "trace": { - "$ref": "#/$defs/operation" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "path-item-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/path-item" - } - }, - "operation": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#operation-object", - "type": "object", - "properties": { - "tags": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - }, - "operationId": { - "type": "string" - }, - "parameters": { - "type": "array", - "items": { - "$ref": "#/$defs/parameter-or-reference" - } - }, - "requestBody": { - "$ref": "#/$defs/request-body-or-reference" - }, - "responses": { - "$ref": "#/$defs/responses" - }, - "callbacks": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/callbacks-or-reference" - } - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "security": { - "type": "array", - "items": { - "$ref": "#/$defs/security-requirement" - } - }, - "servers": { - "type": "array", - "items": { - "$ref": "#/$defs/server" - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "external-documentation": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#external-documentation-object", - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "url": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "url" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#parameter-object", - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "path", - "cookie" - ] - }, - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - }, - "content": { - "$ref": "#/$defs/content", - "minProperties": 1, - "maxProperties": 1 - } - }, - "required": [ - "name", - "in" - ], - "oneOf": [ - { - "required": [ - "schema" - ] - }, - { - "required": [ - "content" - ] - } - ], - "if": { - "properties": { - "in": { - "const": "query" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "allowEmptyValue": { - "default": false, - "type": "boolean" - } - } - }, - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "type": "string" - }, - "explode": { - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/examples" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-path" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-header" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-query" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-cookie" - }, - { - "$ref": "#/$defs/parameter/dependentSchemas/schema/$defs/styles-for-form" - } - ], - "$defs": { - "styles-for-path": { - "if": { - "properties": { - "in": { - "const": "path" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "name": { - "pattern": "[^/#?]+$" - }, - "style": { - "default": "simple", - "enum": [ - "matrix", - "label", - "simple" - ] - }, - "required": { - "const": true - } - }, - "required": [ - "required" - ] - } - }, - "styles-for-header": { - "if": { - "properties": { - "in": { - "const": "header" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "simple", - "const": "simple" - } - } - } - }, - "styles-for-query": { - "if": { - "properties": { - "in": { - "const": "query" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - } - } - }, - "styles-for-cookie": { - "if": { - "properties": { - "in": { - "const": "cookie" - } - }, - "required": [ - "in" - ] - }, - "then": { - "properties": { - "style": { - "default": "form", - "const": "form" - } - } - } - }, - "styles-for-form": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "parameter-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/parameter" - } - }, - "request-body": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#request-body-object", - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "content": { - "$ref": "#/$defs/content" - }, - "required": { - "default": false, - "type": "boolean" - } - }, - "required": [ - "content" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "request-body-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/request-body" - } - }, - "content": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#fixed-fields-10", - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/media-type" - }, - "propertyNames": { - "format": "media-range" - } - }, - "media-type": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#media-type-object", - "type": "object", - "properties": { - "schema": { - "$dynamicRef": "#meta" - }, - "encoding": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/encoding" - } - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/examples" - } - ], - "unevaluatedProperties": false - }, - "encoding": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#encoding-object", - "type": "object", - "properties": { - "contentType": { - "type": "string", - "format": "media-range" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "style": { - "default": "form", - "enum": [ - "form", - "spaceDelimited", - "pipeDelimited", - "deepObject" - ] - }, - "explode": { - "type": "boolean" - }, - "allowReserved": { - "default": false, - "type": "boolean" - } - }, - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/encoding/$defs/explode-default" - } - ], - "unevaluatedProperties": false, - "$defs": { - "explode-default": { - "if": { - "properties": { - "style": { - "const": "form" - } - }, - "required": [ - "style" - ] - }, - "then": { - "properties": { - "explode": { - "default": true - } - } - }, - "else": { - "properties": { - "explode": { - "default": false - } - } - } - } - } - }, - "responses": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#responses-object", - "type": "object", - "properties": { - "default": { - "$ref": "#/$defs/response-or-reference" - } - }, - "patternProperties": { - "^[1-5](?:[0-9]{2}|XX)$": { - "$ref": "#/$defs/response-or-reference" - } - }, - "minProperties": 1, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#response-object", - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "headers": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/header-or-reference" - } - }, - "content": { - "$ref": "#/$defs/content" - }, - "links": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/link-or-reference" - } - } - }, - "required": [ - "description" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "response-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/response" - } - }, - "callbacks": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#callback-object", - "type": "object", - "$ref": "#/$defs/specification-extensions", - "additionalProperties": { - "$ref": "#/$defs/path-item-or-reference" - } - }, - "callbacks-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/callbacks" - } - }, - "example": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#example-object", - "type": "object", - "properties": { - "summary": { - "type": "string" - }, - "description": { - "type": "string" - }, - "value": true, - "externalValue": { - "type": "string", - "format": "uri" - } - }, - "not": { - "required": [ - "value", - "externalValue" - ] - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "example-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/example" - } - }, - "link": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#link-object", - "type": "object", - "properties": { - "operationRef": { - "type": "string", - "format": "uri-reference" - }, - "operationId": { - "type": "string" - }, - "parameters": { - "$ref": "#/$defs/map-of-strings" - }, - "requestBody": true, - "description": { - "type": "string" - }, - "body": { - "$ref": "#/$defs/server" - } - }, - "oneOf": [ - { - "required": [ - "operationRef" - ] - }, - { - "required": [ - "operationId" - ] - } - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "link-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/link" - } - }, - "header": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#header-object", - "type": "object", - "properties": { - "description": { - "type": "string" - }, - "required": { - "default": false, - "type": "boolean" - }, - "deprecated": { - "default": false, - "type": "boolean" - }, - "schema": { - "$dynamicRef": "#meta" - }, - "content": { - "$ref": "#/$defs/content", - "minProperties": 1, - "maxProperties": 1 - } - }, - "oneOf": [ - { - "required": [ - "schema" - ] - }, - { - "required": [ - "content" - ] - } - ], - "dependentSchemas": { - "schema": { - "properties": { - "style": { - "default": "simple", - "const": "simple" - }, - "explode": { - "default": false, - "type": "boolean" - } - }, - "$ref": "#/$defs/examples" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "header-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/header" - } - }, - "tag": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#tag-object", - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "description": { - "type": "string" - }, - "externalDocs": { - "$ref": "#/$defs/external-documentation" - } - }, - "required": [ - "name" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "reference": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#reference-object", - "type": "object", - "properties": { - "$ref": { - "type": "string", - "format": "uri-reference" - }, - "summary": { - "type": "string" - }, - "description": { - "type": "string" - } - }, - "unevaluatedProperties": false - }, - "schema": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#schema-object", - "$dynamicAnchor": "meta", - "type": [ - "object", - "boolean" - ] - }, - "security-scheme": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#security-scheme-object", - "type": "object", - "properties": { - "type": { - "enum": [ - "apiKey", - "http", - "mutualTLS", - "oauth2", - "openIdConnect" - ] - }, - "description": { - "type": "string" - } - }, - "required": [ - "type" - ], - "allOf": [ - { - "$ref": "#/$defs/specification-extensions" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-apikey" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-http-bearer" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oauth2" - }, - { - "$ref": "#/$defs/security-scheme/$defs/type-oidc" - } - ], - "unevaluatedProperties": false, - "$defs": { - "type-apikey": { - "if": { - "properties": { - "type": { - "const": "apiKey" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "name": { - "type": "string" - }, - "in": { - "enum": [ - "query", - "header", - "cookie" - ] - } - }, - "required": [ - "name", - "in" - ] - } - }, - "type-http": { - "if": { - "properties": { - "type": { - "const": "http" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "scheme": { - "type": "string" - } - }, - "required": [ - "scheme" - ] - } - }, - "type-http-bearer": { - "if": { - "properties": { - "type": { - "const": "http" - }, - "scheme": { - "type": "string", - "pattern": "^[Bb][Ee][Aa][Rr][Ee][Rr]$" - } - }, - "required": [ - "type", - "scheme" - ] - }, - "then": { - "properties": { - "bearerFormat": { - "type": "string" - } - } - } - }, - "type-oauth2": { - "if": { - "properties": { - "type": { - "const": "oauth2" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "flows": { - "$ref": "#/$defs/oauth-flows" - } - }, - "required": [ - "flows" - ] - } - }, - "type-oidc": { - "if": { - "properties": { - "type": { - "const": "openIdConnect" - } - }, - "required": [ - "type" - ] - }, - "then": { - "properties": { - "openIdConnectUrl": { - "type": "string", - "format": "uri" - } - }, - "required": [ - "openIdConnectUrl" - ] - } - } - } - }, - "security-scheme-or-reference": { - "if": { - "type": "object", - "required": [ - "$ref" - ] - }, - "then": { - "$ref": "#/$defs/reference" - }, - "else": { - "$ref": "#/$defs/security-scheme" - } - }, - "oauth-flows": { - "type": "object", - "properties": { - "implicit": { - "$ref": "#/$defs/oauth-flows/$defs/implicit" - }, - "password": { - "$ref": "#/$defs/oauth-flows/$defs/password" - }, - "clientCredentials": { - "$ref": "#/$defs/oauth-flows/$defs/client-credentials" - }, - "authorizationCode": { - "$ref": "#/$defs/oauth-flows/$defs/authorization-code" - } - }, - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false, - "$defs": { - "implicit": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string", - "format": "uri" - }, - "refreshUrl": { - "type": "string", - "format": "uri" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "password": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string", - "format": "uri" - }, - "refreshUrl": { - "type": "string", - "format": "uri" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "client-credentials": { - "type": "object", - "properties": { - "tokenUrl": { - "type": "string", - "format": "uri" - }, - "refreshUrl": { - "type": "string", - "format": "uri" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - }, - "authorization-code": { - "type": "object", - "properties": { - "authorizationUrl": { - "type": "string", - "format": "uri" - }, - "tokenUrl": { - "type": "string", - "format": "uri" - }, - "refreshUrl": { - "type": "string", - "format": "uri" - }, - "scopes": { - "$ref": "#/$defs/map-of-strings" - } - }, - "required": [ - "authorizationUrl", - "tokenUrl", - "scopes" - ], - "$ref": "#/$defs/specification-extensions", - "unevaluatedProperties": false - } - } - }, - "security-requirement": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#security-requirement-object", - "type": "object", - "additionalProperties": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "specification-extensions": { - "$comment": "https://spec.openapis.org/oas/v3.1.0#specification-extensions", - "patternProperties": { - "^x-": true - } - }, - "examples": { - "properties": { - "example": true, - "examples": { - "type": "object", - "additionalProperties": { - "$ref": "#/$defs/example-or-reference" - } - } - } - }, - "map-of-strings": { - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } -} diff --git a/docs/oas/3.1/schema/latest b/docs/oas/3.1/schema/latest deleted file mode 120000 index 0855e8794b..0000000000 --- a/docs/oas/3.1/schema/latest +++ /dev/null @@ -1 +0,0 @@ -2022-10-07 \ No newline at end of file diff --git a/docs/oas/latest.html b/docs/oas/latest.html deleted file mode 100644 index 6a8ea9e54d..0000000000 --- a/docs/oas/latest.html +++ /dev/null @@ -1,4083 +0,0 @@ -<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.1.0 | Introduction, Definitions, & More - - -

            OpenAPI Specification v3.1.0

            The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

            Status of This Document

            The source-of-truth for the specification is the GitHub markdown file referenced above.
            -

            OpenAPI Specification

            -

            Version 3.1.0

            -

            The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

            -

            This document is licensed under The Apache License, Version 2.0.

            -

            Introduction

            -

            The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to HTTP APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

            -

            An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

            - -

            Definitions

            -

            OpenAPI Document

            -

            A self-contained or composite resource which defines or describes an API or elements of an API. The OpenAPI document MUST contain at least one paths field, a components field or a webhooks field. An OpenAPI document uses and conforms to the OpenAPI Specification.

            -

            Path Templating

            -

            Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.

            -

            Each template expression in the path MUST correspond to a path parameter that is included in the Path Item itself and/or in each of the Path Item’s Operations. An exception is if the path item is empty, for example due to ACL constraints, matching path parameters are not required.

            -

            The value for these path parameters MUST NOT contain any unescaped “generic syntax” characters described by [[!RFC3986]]: forward slashes (/), question marks (?), or hashes (#).

            -

            Media Types

            -

            Media type definitions are spread across several resources. -The media type definitions SHOULD be in compliance with [[!RFC6838]].

            -

            Some examples of possible media type definitions:

            -
            
            -  text/plain; charset=utf-8
            -  application/json
            -  application/vnd.github+json
            -  application/vnd.github.v3+json
            -  application/vnd.github.v3.raw+json
            -  application/vnd.github.v3.text+json
            -  application/vnd.github.v3.html+json
            -  application/vnd.github.v3.full+json
            -  application/vnd.github.v3.diff
            -  application/vnd.github.v3.patch
            -
            -

            HTTP Status Codes

            -

            The HTTP Status Codes are used to indicate the status of the executed operation. -The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

            -

            Specification

            -

            Versions

            -

            The OpenAPI Specification is versioned using a major.minor.patch versioning scheme. The major.minor portion of the version string (for example 3.1) SHALL designate the OAS feature set. .patch versions address errors in, or provide clarifications to, this document, not the feature set. Tooling which supports OAS 3.1 SHOULD be compatible with all OAS 3.1.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.1.0 and 3.1.1 for example.

            -

            Occasionally, non-backwards compatible changes may be made in minor versions of the OAS where impact is believed to be low relative to the benefit provided.

            -

            An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the version of the OAS that it uses.

            -

            Format

            -

            An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

            -

            For example, if a field has an array value, the JSON array representation will be used:

            -
            
            -{
            -   "field": [ 1, 2, 3 ]
            -}
            -
            -

            All field names in the specification are case sensitive. -This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

            -

            The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

            -

            Patterned fields MUST have unique names within the containing object.

            -

            In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

            - -

            Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

            -

            Document Structure

            -

            An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. In the latter case, Reference Objects and Schema Object $ref keywords are used.

            -

            It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

            -

            Data Types

            -

            Data types in the OAS are based on the types supported by the JSON Schema Specification Draft 2020-12. -Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. -Models are defined using the Schema Object, which is a superset of JSON Schema Specification Draft 2020-12.

            -

            As defined by the JSON Schema Validation vocabulary, data types can have an optional modifier property: format. -OAS defines additional formats to provide fine detail for primitive data types.

            -

            The formats defined by the OAS are:

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            typeformatComments
            integerint32signed 32 bits
            integerint64signed 64 bits (a.k.a long)
            numberfloat
            numberdouble
            stringpasswordA hint to UIs to obscure input.
            -

            Rich Text Formatting

            -

            Throughout the specification description fields are noted as supporting CommonMark markdown formatting. -Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

            -

            Relative References in URIs

            -

            Unless specified otherwise, all properties that are URIs MAY be relative references as defined by [[!RFC3986]].

            -

            Relative references, including those in Reference Objects, PathItem Object $ref fields, Link Object operationRef fields and Example Object externalValue fields, are resolved using the referring document as the Base URI according to [[!RFC3986]].

            -

            If a URI contains a fragment identifier, then the fragment should be resolved per the fragment resolution mechanism of the referenced document. If the representation of the referenced document is JSON or YAML, then the fragment identifier SHOULD be interpreted as a JSON-Pointer as per [[!RFC6901]].

            -

            Relative references in Schema Objects, including any that appear as $id values, use the nearest parent $id as a Base URI, as described by JSON Schema Specification Draft 2020-12. If no parent schema contains an $id, then the Base URI MUST be determined according to [[!RFC3986]].

            -

            Relative References in URLs

            -

            Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. -Unless specified otherwise, relative references are resolved using the URLs defined in the Server Object as a Base URL. Note that these themselves MAY be relative to the referring document.

            -

            Schema

            -

            In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

            -

            OpenAPI Object

            -

            This is the root object of the OpenAPI document.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            openapistringREQUIRED. This string MUST be the version number of the OpenAPI Specification that the OpenAPI document uses. The openapi field SHOULD be used by tooling to interpret the OpenAPI document. This is not related to the API info.version string.
            infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
            jsonSchemaDialectstringThe default value for the $schema keyword within Schema Objects contained within this OAS document. This MUST be in the form of a URI.
            servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
            pathsPaths ObjectThe available paths and operations for the API.
            webhooksMap[string, Path Item Object | Reference Object] ]The incoming webhooks that MAY be received as part of this API and that the API consumer MAY choose to implement. Closely related to the callbacks feature, this section describes requests initiated other than by an API call, for example by an out of band registration. The key name is a unique string to refer to each webhook, while the (optionally referenced) Path Item Object describes a request that may be initiated by the API provider and the expected responses. An example is available.
            componentsComponents ObjectAn element to hold various schemas for the document.
            security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition. To make security optional, an empty security requirement ({}) can be included in the array.
            tags[Tag Object]A list of tags used by the document with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
            externalDocsExternal Documentation ObjectAdditional external documentation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object

            -

            The object provides metadata about the API. -The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            titlestringREQUIRED. The title of the API.
            summarystringA short summary of the API.
            descriptionstringA description of the API. CommonMark syntax MAY be used for rich text representation.
            termsOfServicestringA URL to the Terms of Service for the API. This MUST be in the form of a URL.
            contactContact ObjectThe contact information for the exposed API.
            licenseLicense ObjectThe license information for the exposed API.
            versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object Example

            -
            
            -{
            -  "title": "Sample Pet Store App",
            -  "summary": "A pet store manager.",
            -  "description": "This is a sample server for a pet store.",
            -  "termsOfService": "https://example.com/terms/",
            -  "contact": {
            -    "name": "API Support",
            -    "url": "https://www.example.com/support",
            -    "email": "support@example.com"
            -  },
            -  "license": {
            -    "name": "Apache 2.0",
            -    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
            -  },
            -  "version": "1.0.1"
            -}
            -
            -
            
            -title: Sample Pet Store App
            -summary: A pet store manager.
            -description: This is a sample server for a pet store.
            -termsOfService: https://example.com/terms/
            -contact:
            -  name: API Support
            -  url: https://www.example.com/support
            -  email: support@example.com
            -license:
            -  name: Apache 2.0
            -  url: https://www.apache.org/licenses/LICENSE-2.0.html
            -version: 1.0.1
            -
            -

            Contact Object

            -

            Contact information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringThe identifying name of the contact person/organization.
            urlstringThe URL pointing to the contact information. This MUST be in the form of a URL.
            emailstringThe email address of the contact person/organization. This MUST be in the form of an email address.
            -

            This object MAY be extended with Specification Extensions.

            -

            Contact Object Example

            -
            
            -{
            -  "name": "API Support",
            -  "url": "https://www.example.com/support",
            -  "email": "support@example.com"
            -}
            -
            -
            
            -name: API Support
            -url: https://www.example.com/support
            -email: support@example.com
            -
            -

            License Object

            -

            License information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The license name used for the API.
            identifierstringAn SPDX license expression for the API. The identifier field is mutually exclusive of the url field.
            urlstringA URL to the license used for the API. This MUST be in the form of a URL. The url field is mutually exclusive of the identifier field.
            -

            This object MAY be extended with Specification Extensions.

            -

            License Object Example

            -
            
            -{
            -  "name": "Apache 2.0",
            -  "identifier": "Apache-2.0"
            -}
            -
            -
            
            -name: Apache 2.0
            -identifier: Apache-2.0
            -
            -

            Server Object

            -

            An object representing a Server.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
            descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
            variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
            -

            This object MAY be extended with Specification Extensions.

            -

            Server Object Example

            -

            A single server would be described as:

            -
            
            -{
            -  "url": "https://development.gigantic-server.com/v1",
            -  "description": "Development server"
            -}
            -
            -
            
            -url: https://development.gigantic-server.com/v1
            -description: Development server
            -
            -

            The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://development.gigantic-server.com/v1",
            -      "description": "Development server"
            -    },
            -    {
            -      "url": "https://staging.gigantic-server.com/v1",
            -      "description": "Staging server"
            -    },
            -    {
            -      "url": "https://api.gigantic-server.com/v1",
            -      "description": "Production server"
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://development.gigantic-server.com/v1
            -  description: Development server
            -- url: https://staging.gigantic-server.com/v1
            -  description: Staging server
            -- url: https://api.gigantic-server.com/v1
            -  description: Production server
            -
            -

            The following shows how variables can be used for a server configuration:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
            -      "description": "The production API server",
            -      "variables": {
            -        "username": {
            -          "default": "demo",
            -          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
            -        },
            -        "port": {
            -          "enum": [
            -            "8443",
            -            "443"
            -          ],
            -          "default": "8443"
            -        },
            -        "basePath": {
            -          "default": "v2"
            -        }
            -      }
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://{username}.gigantic-server.com:{port}/{basePath}
            -  description: The production API server
            -  variables:
            -    username:
            -      # note! no enum here means it is an open value
            -      default: demo
            -      description: this value is assigned by the service provider, in this example `gigantic-server.com`
            -    port:
            -      enum:
            -        - '8443'
            -        - '443'
            -      default: '8443'
            -    basePath:
            -      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
            -      default: v2
            -
            -

            Server Variable Object

            -

            An object representing a Server Variable for server URL template substitution.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            enum[string]An enumeration of string values to be used if the substitution options are from a limited set. The array MUST NOT be empty.
            defaultstringREQUIRED. The default value to use for substitution, which SHALL be sent if an alternate value is not supplied. Note this behavior is different than the Schema Object’s treatment of default values, because in those cases parameter values are optional. If the enum is defined, the value MUST exist in the enum’s values.
            descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Components Object

            -

            Holds a set of reusable objects for different aspects of the OAS. -All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemasMap[string, Schema Object]An object to hold reusable Schema Objects.
            responsesMap[string, Response Object | Reference Object]An object to hold reusable Response Objects.
            parametersMap[string, Parameter Object | Reference Object]An object to hold reusable Parameter Objects.
            examplesMap[string, Example Object | Reference Object]An object to hold reusable Example Objects.
            requestBodiesMap[string, Request Body Object | Reference Object]An object to hold reusable Request Body Objects.
            headersMap[string, Header Object | Reference Object]An object to hold reusable Header Objects.
            securitySchemesMap[string, Security Scheme Object | Reference Object]An object to hold reusable Security Scheme Objects.
            linksMap[string, Link Object | Reference Object]An object to hold reusable Link Objects.
            callbacksMap[string, Callback Object | Reference Object]An object to hold reusable Callback Objects.
            pathItemsMap[string, Path Item Object | Reference Object]An object to hold reusable Path Item Object.
            -

            This object MAY be extended with Specification Extensions.

            -

            All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

            -

            Field Name Examples:

            -
            
            -User
            -User_1
            -User_Name
            -user-name
            -my.org.User
            -
            -

            Components Object Example

            -
            
            -"components": {
            -  "schemas": {
            -    "GeneralError": {
            -      "type": "object",
            -      "properties": {
            -        "code": {
            -          "type": "integer",
            -          "format": "int32"
            -        },
            -        "message": {
            -          "type": "string"
            -        }
            -      }
            -    },
            -    "Category": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    },
            -    "Tag": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  },
            -  "parameters": {
            -    "skipParam": {
            -      "name": "skip",
            -      "in": "query",
            -      "description": "number of items to skip",
            -      "required": true,
            -      "schema": {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    },
            -    "limitParam": {
            -      "name": "limit",
            -      "in": "query",
            -      "description": "max records to return",
            -      "required": true,
            -      "schema" : {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    }
            -  },
            -  "responses": {
            -    "NotFound": {
            -      "description": "Entity not found."
            -    },
            -    "IllegalInput": {
            -      "description": "Illegal input for operation."
            -    },
            -    "GeneralError": {
            -      "description": "General Error",
            -      "content": {
            -        "application/json": {
            -          "schema": {
            -            "$ref": "#/components/schemas/GeneralError"
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "securitySchemes": {
            -    "api_key": {
            -      "type": "apiKey",
            -      "name": "api_key",
            -      "in": "header"
            -    },
            -    "petstore_auth": {
            -      "type": "oauth2",
            -      "flows": {
            -        "implicit": {
            -          "authorizationUrl": "https://example.org/api/oauth/dialog",
            -          "scopes": {
            -            "write:pets": "modify pets in your account",
            -            "read:pets": "read your pets"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    GeneralError:
            -      type: object
            -      properties:
            -        code:
            -          type: integer
            -          format: int32
            -        message:
            -          type: string
            -    Category:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -    Tag:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -  parameters:
            -    skipParam:
            -      name: skip
            -      in: query
            -      description: number of items to skip
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -    limitParam:
            -      name: limit
            -      in: query
            -      description: max records to return
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -  responses:
            -    NotFound:
            -      description: Entity not found.
            -    IllegalInput:
            -      description: Illegal input for operation.
            -    GeneralError:
            -      description: General Error
            -      content:
            -        application/json:
            -          schema:
            -            $ref: '#/components/schemas/GeneralError'
            -  securitySchemes:
            -    api_key:
            -      type: apiKey
            -      name: api_key
            -      in: header
            -    petstore_auth:
            -      type: oauth2
            -      flows:
            -        implicit:
            -          authorizationUrl: https://example.org/api/oauth/dialog
            -          scopes:
            -            write:pets: modify pets in your account
            -            read:pets: read your pets
            -
            -

            Paths Object

            -

            Holds the relative paths to the individual endpoints and their operations. -The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to Access Control List (ACL) constraints.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a forward slash (/). The path is appended (no relative URL resolution) to the expanded URL from the Server Object’s url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Templating Matching

            -

            Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

            -
            
            -  /pets/{petId}
            -  /pets/mine
            -
            -

            The following paths are considered identical and invalid:

            -
            
            -  /pets/{petId}
            -  /pets/{name}
            -
            -

            The following may lead to ambiguous resolution:

            -
            
            -  /{entity}/me
            -  /books/{id}
            -
            -

            Paths Object Example

            -
            
            -{
            -  "/pets": {
            -    "get": {
            -      "description": "Returns all pets from the system that the user has access to",
            -      "responses": {
            -        "200": {         
            -          "description": "A list of pets.",
            -          "content": {
            -            "application/json": {
            -              "schema": {
            -                "type": "array",
            -                "items": {
            -                  "$ref": "#/components/schemas/pet"
            -                }
            -              }
            -            }
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -/pets:
            -  get:
            -    description: Returns all pets from the system that the user has access to
            -    responses:
            -      '200':
            -        description: A list of pets.
            -        content:
            -          application/json:
            -            schema:
            -              type: array
            -              items:
            -                $ref: '#/components/schemas/pet'
            -
            -

            Path Item Object

            -

            Describes the operations available on a single path. -A Path Item MAY be empty, due to ACL constraints. -The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringAllows for a referenced definition of this path item. The referenced structure MUST be in the form of a Path Item Object. In case a Path Item Object field appears both in the defined object and the referenced object, the behavior is undefined. See the rules for resolving Relative References.
            summarystringAn optional, string summary, intended to apply to all operations in this path.
            descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
            getOperation ObjectA definition of a GET operation on this path.
            putOperation ObjectA definition of a PUT operation on this path.
            postOperation ObjectA definition of a POST operation on this path.
            deleteOperation ObjectA definition of a DELETE operation on this path.
            optionsOperation ObjectA definition of a OPTIONS operation on this path.
            headOperation ObjectA definition of a HEAD operation on this path.
            patchOperation ObjectA definition of a PATCH operation on this path.
            traceOperation ObjectA definition of a TRACE operation on this path.
            servers[Server Object]An alternative server array to service all operations in this path.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Item Object Example

            -
            
            -{
            -  "get": {
            -    "description": "Returns pets based on ID",
            -    "summary": "Find pets by ID",
            -    "operationId": "getPetsById",
            -    "responses": {
            -      "200": {
            -        "description": "pet response",
            -        "content": {
            -          "*/*": {
            -            "schema": {
            -              "type": "array",
            -              "items": {
            -                "$ref": "#/components/schemas/Pet"
            -              }
            -            }
            -          }
            -        }
            -      },
            -      "default": {
            -        "description": "error payload",
            -        "content": {
            -          "text/html": {
            -            "schema": {
            -              "$ref": "#/components/schemas/ErrorModel"
            -            }
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "parameters": [
            -    {
            -      "name": "id",
            -      "in": "path",
            -      "description": "ID of pet to use",
            -      "required": true,
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      },
            -      "style": "simple"
            -    }
            -  ]
            -}
            -
            -
            
            -get:
            -  description: Returns pets based on ID
            -  summary: Find pets by ID
            -  operationId: getPetsById
            -  responses:
            -    '200':
            -      description: pet response
            -      content:
            -        '*/*' :
            -          schema:
            -            type: array
            -            items:
            -              $ref: '#/components/schemas/Pet'
            -    default:
            -      description: error payload
            -      content:
            -        'text/html':
            -          schema:
            -            $ref: '#/components/schemas/ErrorModel'
            -parameters:
            -- name: id
            -  in: path
            -  description: ID of pet to use
            -  required: true
            -  schema:
            -    type: array
            -    items:
            -      type: string 
            -  style: simple
            -
            -

            Operation Object

            -

            Describes a single API operation on a path.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
            summarystringA short summary of what the operation does.
            descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
            operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. The operationId value is case-sensitive. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            requestBodyRequest Body Object | Reference ObjectThe request body applicable for this operation. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as GET, HEAD and DELETE), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.
            responsesResponses ObjectThe list of possible responses as they are returned from executing this operation.
            callbacksMap[string, Callback Object | Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses.
            deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
            security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. To make security optional, an empty security requirement ({}) can be included in the array. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
            servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
            -

            This object MAY be extended with Specification Extensions.

            -

            Operation Object Example

            -
            
            -{
            -  "tags": [
            -    "pet"
            -  ],
            -  "summary": "Updates a pet in the store with form data",
            -  "operationId": "updatePetWithForm",
            -  "parameters": [
            -    {
            -      "name": "petId",
            -      "in": "path",
            -      "description": "ID of pet that needs to be updated",
            -      "required": true,
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  ],
            -  "requestBody": {
            -    "content": {
            -      "application/x-www-form-urlencoded": {
            -        "schema": {
            -          "type": "object",
            -          "properties": {
            -            "name": {
            -              "description": "Updated name of the pet",
            -              "type": "string"
            -            },
            -            "status": {
            -              "description": "Updated status of the pet",
            -              "type": "string"
            -            }
            -          },
            -          "required": ["status"]
            -        }
            -      }
            -    }
            -  },
            -  "responses": {
            -    "200": {
            -      "description": "Pet updated.",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    },
            -    "405": {
            -      "description": "Method Not Allowed",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    }
            -  },
            -  "security": [
            -    {
            -      "petstore_auth": [
            -        "write:pets",
            -        "read:pets"
            -      ]
            -    }
            -  ]
            -}
            -
            -
            
            -tags:
            -- pet
            -summary: Updates a pet in the store with form data
            -operationId: updatePetWithForm
            -parameters:
            -- name: petId
            -  in: path
            -  description: ID of pet that needs to be updated
            -  required: true
            -  schema:
            -    type: string
            -requestBody:
            -  content:
            -    'application/x-www-form-urlencoded':
            -      schema:
            -       type: object
            -       properties:
            -          name:
            -            description: Updated name of the pet
            -            type: string
            -          status:
            -            description: Updated status of the pet
            -            type: string
            -       required:
            -         - status
            -responses:
            -  '200':
            -    description: Pet updated.
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -  '405':
            -    description: Method Not Allowed
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -security:
            -- petstore_auth:
            -  - write:pets
            -  - read:pets
            -
            -

            External Documentation Object

            -

            Allows referencing an external resource for extended documentation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA description of the target documentation. CommonMark syntax MAY be used for rich text representation.
            urlstringREQUIRED. The URL for the target documentation. This MUST be in the form of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            External Documentation Object Example

            -
            
            -{
            -  "description": "Find more info here",
            -  "url": "https://example.com"
            -}
            -
            -
            
            -description: Find more info here
            -url: https://example.com
            -
            -

            Parameter Object

            -

            Describes a single operation parameter.

            -

            A unique parameter is defined by a combination of a name and location.

            -

            Parameter Locations

            -

            There are four possible parameter locations specified by the in field:

            -
              -
            • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
            • -
            • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
            • -
            • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
            • -
            • cookie - Used to pass a specific cookie value to the API.
            • -
            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
            • If in is "path", the name field MUST correspond to a template expression occurring within the path field in the Paths Object. See Path Templating for further information.
            • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
            • For all other cases, the name corresponds to the parameter name used by the in property.
            instringREQUIRED. The location of the parameter. Possible values are "query", "header", "path" or "cookie".
            descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is "path", this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
            deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage. Default value is false.
            allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored. Use of this property is NOT RECOMMENDED, as it is likely to be removed in a later revision.
            -

            The rules for serialization of the parameter are specified in one of two ways. -For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
            explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
            schemaSchema ObjectThe schema defining the type used for the parameter.
            exampleAnyExample of the parameter’s potential value. The example SHOULD match the specified schema and encoding properties if present. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema that contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
            examplesMap[ string, Example Object | Reference Object]Examples of the parameter’s potential value. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema that contains an example, the examples value SHALL override the example provided by the schema.
            -

            For more complex scenarios, the content property can define the media type and schema of the parameter. -A parameter MUST contain either a schema property, or a content property, but not both. -When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
            -

            Style Values

            -

            In order to support common ways of serializing simple parameters, a set of style values are defined.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styletypeinComments
            matrixprimitive, array, objectpathPath-style parameters defined by [[!RFC6570]]
            labelprimitive, array, objectpathLabel style parameters defined by [[!RFC6570]]
            formprimitive, array, objectquery, cookieForm style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
            simplearraypath, headerSimple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0.
            spaceDelimitedarray, objectquerySpace separated array or object values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
            pipeDelimitedarray, objectqueryPipe separated array or object values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
            deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
            -

            Style Examples

            -

            Assume a parameter named color has one of the following values:

            -
            
            -   string -> "blue"
            -   array -> ["blue","black","brown"]
            -   object -> { "R": 100, "G": 200, "B": 150 }
            -
            -

            The following table shows examples of rendering differences for each value.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styleexplodeemptystringarrayobject
            matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
            matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
            labelfalse..blue.blue.black.brown.R.100.G.200.B.150
            labeltrue..blue.blue.black.brown.R=100.G=200.B=150
            formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
            formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
            simplefalsen/ablueblue,black,brownR,100,G,200,B,150
            simpletruen/ablueblue,black,brownR=100,G=200,B=150
            spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
            pipeDelimitedfalsen/an/ablue|black|brownR|100|G|200|B|150
            deepObjecttruen/an/an/acolor[R]=100&color[G]=200&color[B]=150
            -

            This object MAY be extended with Specification Extensions.

            -

            Parameter Object Examples

            -

            A header parameter with an array of 64 bit integer numbers:

            -
            
            -{
            -  "name": "token",
            -  "in": "header",
            -  "description": "token to be passed as a header",
            -  "required": true,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "integer",
            -      "format": "int64"
            -    }
            -  },
            -  "style": "simple"
            -}
            -
            -
            
            -name: token
            -in: header
            -description: token to be passed as a header
            -required: true
            -schema:
            -  type: array
            -  items:
            -    type: integer
            -    format: int64
            -style: simple
            -
            -

            A path parameter of a string value:

            -
            
            -{
            -  "name": "username",
            -  "in": "path",
            -  "description": "username to fetch",
            -  "required": true,
            -  "schema": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -name: username
            -in: path
            -description: username to fetch
            -required: true
            -schema:
            -  type: string
            -
            -

            An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

            -
            
            -{
            -  "name": "id",
            -  "in": "query",
            -  "description": "ID of the object to fetch",
            -  "required": false,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    }
            -  },
            -  "style": "form",
            -  "explode": true
            -}
            -
            -
            
            -name: id
            -in: query
            -description: ID of the object to fetch
            -required: false
            -schema:
            -  type: array
            -  items:
            -    type: string
            -style: form
            -explode: true
            -
            -

            A free-form query parameter, allowing undefined parameters of a specific type:

            -
            
            -{
            -  "in": "query",
            -  "name": "freeForm",
            -  "schema": {
            -    "type": "object",
            -    "additionalProperties": {
            -      "type": "integer"
            -    },
            -  },
            -  "style": "form"
            -}
            -
            -
            
            -in: query
            -name: freeForm
            -schema:
            -  type: object
            -  additionalProperties:
            -    type: integer
            -style: form
            -
            -

            A complex parameter using content to define serialization:

            -
            
            -{
            -  "in": "query",
            -  "name": "coordinates",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "object",
            -        "required": [
            -          "lat",
            -          "long"
            -        ],
            -        "properties": {
            -          "lat": {
            -            "type": "number"
            -          },
            -          "long": {
            -            "type": "number"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -in: query
            -name: coordinates
            -content:
            -  application/json:
            -    schema:
            -      type: object
            -      required:
            -        - lat
            -        - long
            -      properties:
            -        lat:
            -          type: number
            -        long:
            -          type: number
            -
            -

            Request Body Object

            -

            Describes a single request body.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            requiredbooleanDetermines if the request body is required in the request. Defaults to false.
            -

            This object MAY be extended with Specification Extensions.

            -

            Request Body Examples

            -

            A request body with a referenced model definition.

            -
            
            -{
            -  "description": "user to add to the system",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User Example",
            -            "externalValue": "https://foo.bar/examples/user-example.json"
            -          }
            -        }
            -    },
            -    "application/xml": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User example in XML",
            -            "externalValue": "https://foo.bar/examples/user-example.xml"
            -          }
            -        }
            -    },
            -    "text/plain": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in Plain text",
            -            "externalValue": "https://foo.bar/examples/user-example.txt"
            -        }
            -      }
            -    },
            -    "*/*": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in other format",
            -            "externalValue": "https://foo.bar/examples/user-example.whatever"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -content:
            -  'application/json':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User Example
            -        externalValue: 'https://foo.bar/examples/user-example.json'
            -  'application/xml':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User example in XML
            -        externalValue: 'https://foo.bar/examples/user-example.xml'
            -  'text/plain':
            -    examples:
            -      user:
            -        summary: User example in Plain text
            -        externalValue: 'https://foo.bar/examples/user-example.txt'
            -  '*/*':
            -    examples:
            -      user:
            -        summary: User example in other format
            -        externalValue: 'https://foo.bar/examples/user-example.whatever'
            -
            -

            A body parameter that is an array of string values:

            -
            
            -{
            -  "description": "user to add to the system",
            -  "required": true,
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -required: true
            -content:
            -  text/plain:
            -    schema:
            -      type: array
            -      items:
            -        type: string
            -
            -

            Media Type Object

            -

            Each Media Type Object provides schema and examples for the media type identified by its key.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemaSchema ObjectThe schema defining the content of the request, response, or parameter.
            exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
            examplesMap[ string, Example Object | Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
            encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
            -

            This object MAY be extended with Specification Extensions.

            -

            Media Type Examples

            -
            
            -{
            -  "application/json": {
            -    "schema": {
            -         "$ref": "#/components/schemas/Pet"
            -    },
            -    "examples": {
            -      "cat" : {
            -        "summary": "An example of a cat",
            -        "value":
            -          {
            -            "name": "Fluffy",
            -            "petType": "Cat",
            -            "color": "White",
            -            "gender": "male",
            -            "breed": "Persian"
            -          }
            -      },
            -      "dog": {
            -        "summary": "An example of a dog with a cat's name",
            -        "value" :  {
            -          "name": "Puma",
            -          "petType": "Dog",
            -          "color": "Black",
            -          "gender": "Female",
            -          "breed": "Mixed"
            -        },
            -      "frog": {
            -          "$ref": "#/components/examples/frog-example"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -application/json:
            -  schema:
            -    $ref: "#/components/schemas/Pet"
            -  examples:
            -    cat:
            -      summary: An example of a cat
            -      value:
            -        name: Fluffy
            -        petType: Cat
            -        color: White
            -        gender: male
            -        breed: Persian
            -    dog:
            -      summary: An example of a dog with a cat's name
            -      value:
            -        name: Puma
            -        petType: Dog
            -        color: Black
            -        gender: Female
            -        breed: Mixed
            -    frog:
            -      $ref: "#/components/examples/frog-example"
            -
            -

            Considerations for File Uploads

            -

            In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type.

            -

            In contrast with the 3.0 specification, the format keyword has no effect on the content-encoding of the schema. JSON Schema offers a contentEncoding keyword, which may be used to specify the Content-Encoding for the schema. The contentEncoding keyword supports all encodings defined in [[!RFC4648]], including “base64” and “base64url”, as well as “quoted-printable” from [[!RFC2045]]. The encoding specified by the contentEncoding keyword is independent of an encoding specified by the Content-Type header in the request or response or metadata of a multipart body – when both are present, the encoding specified in the contentEncoding is applied first and then the encoding specified in the Content-Type header.

            -

            JSON Schema also offers a contentMediaType keyword. However, when the media type is already specified by the Media Type Object’s key, or by the contentType field of an Encoding Object, the contentMediaType keyword SHALL be ignored if present.

            -

            Examples:

            -

            Content transferred in binary (octet-stream) MAY omit schema:

            -
            
            -# a PNG image as a binary file:
            -content:
            -    image/png: {}
            -
            -
            
            -# an arbitrary binary file:
            -content:
            -    application/octet-stream: {}
            -
            -

            Binary content transferred with base64 encoding:

            -
            
            -content:
            -    image/png:
            -        schema:
            -            type: string
            -            contentMediaType: image/png
            -            contentEncoding: base64
            -
            -

            Note that the Content-Type remains image/png, describing the semantics of the payload. The JSON Schema type and contentEncoding fields explain that the payload is transferred as text. The JSON Schema contentMediaType is technically redundant, but can be used by JSON Schema tools that may not be aware of the OpenAPI context.

            -

            These examples apply to either input payloads of file uploads or response payloads.

            -

            A requestBody for submitting a file in a POST operation may look like the following example:

            -
            
            -requestBody:
            -  content:
            -    application/octet-stream: {}
            -
            -

            In addition, specific media types MAY be specified:

            -
            
            -# multiple, specific media types may be specified:
            -requestBody:
            -  content:
            -    # a binary file of type png or jpeg
            -    image/jpeg: {}
            -    image/png: {}
            -
            -

            To upload multiple files, a multipart media type MUST be used:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        properties:
            -          # The property name 'file' will be used for all files.
            -          file:
            -            type: array
            -            items: {}
            -
            -

            As seen in the section on multipart/form-data below, the empty schema for items indicates a media type of application/octet-stream.

            -

            Support for x-www-form-urlencoded Request Bodies

            -

            To submit content using form url encoding via [[!RFC1866]], the following -definition may be used:

            -
            
            -requestBody:
            -  content:
            -    application/x-www-form-urlencoded:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # complex types are stringified to support RFC 1866
            -            type: object
            -            properties: {}
            -
            -

            In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

            -

            When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object’s style property as form.

            -

            Special Considerations for multipart Content

            -

            It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

            -

            In a multipart/form-data request body, each schema property, or each element of a schema array property, takes a section in the payload with an internal header as defined by [[!RFC7578]]. The serialization strategy for each property of a multipart/form-data request body can be specified in an associated Encoding Object.

            -

            When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred – thus, the following default Content-Types are defined for multipart:

            -
              -
            • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
            • -
            • If the property is complex, or an array of complex values, the default Content-Type is application/json
            • -
            • If the property is a type: string with a contentEncoding, the default Content-Type is application/octet-stream
            • -
            -

            Per the JSON Schema specification, contentMediaType without contentEncoding present is treated as if contentEncoding: identity were present. While useful for embedding text documents such as text/html into JSON strings, it is not useful for a multipart/form-data part, as it just causes the document to be treated as text/plain instead of its actual media type. Use the Encoding Object without contentMediaType if no contentEncoding is required.

            -

            Examples:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # default Content-Type for objects is `application/json`
            -            type: object
            -            properties: {}
            -          profileImage:
            -            # Content-Type for application-level encoded resource is `text/plain`
            -            type: string
            -            contentMediaType: image/png
            -            contentEncoding: base64
            -          children:
            -            # default Content-Type for arrays is based on the _inner_ type (`text/plain` here)
            -            type: array
            -            items:
            -              type: string
            -          addresses:
            -            # default Content-Type for arrays is based on the _inner_ type (object shown, so `application/json` in this example)
            -            type: array
            -            items:
            -              type: object
            -              $ref: '#/components/schemas/Address'
            -
            -

            An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

            -

            Encoding Object

            -

            A single encoding definition applied to a single schema property.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for object - application/json; for array – the default is defined based on the inner type; for all other cases the default is application/octet-stream. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
            headersMap[string, Header Object | Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
            stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
            explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
            -

            This object MAY be extended with Specification Extensions.

            -

            Encoding Object Example

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            # default is text/plain
            -            type: string
            -            format: uuid
            -          address:
            -            # default is application/json
            -            type: object
            -            properties: {}
            -          historyMetadata:
            -            # need to declare XML format!
            -            description: metadata in XML format
            -            type: object
            -            properties: {}
            -          profileImage: {}
            -      encoding:
            -        historyMetadata:
            -          # require XML Content-Type in utf-8 encoding
            -          contentType: application/xml; charset=utf-8
            -        profileImage:
            -          # only accept png/jpeg
            -          contentType: image/png, image/jpeg
            -          headers:
            -            X-Rate-Limit-Limit:
            -              description: The number of allowed requests in the current period
            -              schema:
            -                type: integer
            -
            -

            Responses Object

            -

            A container for the expected responses of an operation. -The container maps a HTTP response code to the expected response.

            -

            The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. -However, documentation is expected to cover a successful operation response and any known errors.

            -

            The default MAY be used as a default response object for all HTTP codes -that are not covered individually by the Responses Object.

            -

            The Responses Object MUST contain at least one response code, and if only one -response code is provided it SHOULD be the response for a successful operation -call.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            defaultResponse Object | Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses.
            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            HTTP Status CodeResponse Object | Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. Only the following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
            -

            This object MAY be extended with Specification Extensions.

            -

            Responses Object Example

            -

            A 200 response for a successful operation and a default response for others (implying an error):

            -
            
            -{
            -  "200": {
            -    "description": "a pet to be returned",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/Pet"
            -        }
            -      }
            -    }
            -  },
            -  "default": {
            -    "description": "Unexpected error",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/ErrorModel"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -'200':
            -  description: a pet to be returned
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/Pet'
            -default:
            -  description: Unexpected error
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/ErrorModel'
            -
            -

            Response Object

            -

            Describes a single response from an API Operation, including design-time, static -links to operations based on the response.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringREQUIRED. A description of the response. CommonMark syntax MAY be used for rich text representation.
            headersMap[string, Header Object | Reference Object]Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
            contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            linksMap[string, Link Object | Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
            -

            This object MAY be extended with Specification Extensions.

            -

            Response Object Examples

            -

            Response of an array of a complex type:

            -
            
            -{
            -  "description": "A complex object array response",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "$ref": "#/components/schemas/VeryComplexType"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A complex object array response
            -content:
            -  application/json:
            -    schema:
            -      type: array
            -      items:
            -        $ref: '#/components/schemas/VeryComplexType'
            -
            -

            Response with a string type:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  }
            -
            -}
            -
            -
            
            -description: A simple string response
            -content:
            -  text/plain:
            -    schema:
            -      type: string
            -
            -

            Plain text response with headers:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string",
            -        "example": "whoa!"
            -      }
            -    }
            -  },
            -  "headers": {
            -    "X-Rate-Limit-Limit": {
            -      "description": "The number of allowed requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Remaining": {
            -      "description": "The number of remaining requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Reset": {
            -      "description": "The number of seconds left in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A simple string response
            -content:
            -  text/plain:
            -    schema:
            -      type: string
            -    example: 'whoa!'
            -headers:
            -  X-Rate-Limit-Limit:
            -    description: The number of allowed requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Remaining:
            -    description: The number of remaining requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Reset:
            -    description: The number of seconds left in the current period
            -    schema:
            -      type: integer
            -
            -

            Response with no return value:

            -
            
            -{
            -  "description": "object created"
            -}
            -
            -
            
            -description: object created
            -
            -

            Callback Object

            -

            A map of possible out-of band callbacks related to the parent operation. -Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. -The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

            -

            To describe incoming requests from the API provider independent from another API call, use the webhooks field.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {expression}Path Item Object | Reference ObjectA Path Item Object, or a reference to one, used to define a callback request and expected responses. A complete example is available.
            -

            This object MAY be extended with Specification Extensions.

            -

            Key Expression

            -

            The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. -A simple example might be $request.body#/url. -However, using a runtime expression the complete HTTP message can be accessed. -This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

            -

            For example, given the following HTTP request:

            -
            
            -POST /subscribe/myevent?queryUrl=https://clientdomain.com/stillrunning HTTP/1.1
            -Host: example.org
            -Content-Type: application/json
            -Content-Length: 187
            -
            -{
            -  "failedUrl" : "https://clientdomain.com/failed",
            -  "successUrls" : [
            -    "https://clientdomain.com/fast",
            -    "https://clientdomain.com/medium",
            -    "https://clientdomain.com/slow"
            -  ]
            -}
            -
            -201 Created
            -Location: https://example.org/subscription/1
            -
            -

            The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            ExpressionValue
            $urlhttps://example.org/subscribe/myevent?queryUrl=https://clientdomain.com/stillrunning
            $methodPOST
            $request.path.eventTypemyevent
            $request.query.queryUrlhttps://clientdomain.com/stillrunning
            $request.header.content-Typeapplication/json
            $request.body#/failedUrlhttps://clientdomain.com/failed
            $request.body#/successUrls/2https://clientdomain.com/medium
            $response.header.Locationhttps://example.org/subscription/1
            -

            Callback Object Examples

            -

            The following example uses the user provided queryUrl query string parameter to define the callback URL. This is an example of how to use a callback object to describe a WebHook callback that goes with the subscription operation to enable registering for the WebHook.

            -
            
            -myCallback:
            -  '{$request.query.queryUrl}':
            -    post:
            -      requestBody:
            -        description: Callback payload
            -        content:
            -          'application/json':
            -            schema:
            -              $ref: '#/components/schemas/SomePayload'
            -      responses:
            -        '200':
            -          description: callback successfully processed
            -
            -

            The following example shows a callback where the server is hard-coded, but the query string parameters are populated from the id and email property in the request body.

            -
            
            -transactionCallback:
            -  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
            -    post:
            -      requestBody:
            -        description: Callback payload
            -        content:
            -          'application/json':
            -            schema:
            -              $ref: '#/components/schemas/SomePayload'
            -      responses:
            -        '200':
            -          description: callback successfully processed
            -
            -

            Example Object

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            summarystringShort description for the example.
            descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
            valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
            externalValuestringA URI that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive. See the rules for resolving Relative References.
            -

            This object MAY be extended with Specification Extensions.

            -

            In all cases, the example value is expected to be compatible with the type schema -of its associated value. Tooling implementations MAY choose to -validate compatibility automatically, and reject the example value(s) if incompatible.

            -

            Example Object Examples

            -

            In a request body:

            -
            
            -requestBody:
            -  content:
            -    'application/json':
            -      schema:
            -        $ref: '#/components/schemas/Address'
            -      examples:
            -        foo:
            -          summary: A foo example
            -          value: {"foo": "bar"}
            -        bar:
            -          summary: A bar example
            -          value: {"bar": "baz"}
            -    'application/xml':
            -      examples:
            -        xmlExample:
            -          summary: This is an example in XML
            -          externalValue: 'https://example.org/examples/address-example.xml'
            -    'text/plain':
            -      examples:
            -        textExample:
            -          summary: This is a text example
            -          externalValue: 'https://foo.bar/examples/address-example.txt'
            -
            -

            In a parameter:

            -
            
            -parameters:
            -  - name: 'zipCode'
            -    in: 'query'
            -    schema:
            -      type: 'string'
            -      format: 'zip-code'
            -    examples:
            -      zip-example:
            -        $ref: '#/components/examples/zip-example'
            -
            -

            In a response:

            -
            
            -responses:
            -  '200':
            -    description: your car appointment has been booked
            -    content:
            -      application/json:
            -        schema:
            -          $ref: '#/components/schemas/SuccessResponse'
            -        examples:
            -          confirmation-success:
            -            $ref: '#/components/examples/confirmation-success'
            -
            -

            Link Object

            -

            The Link object represents a possible design-time link for a response. -The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

            -

            Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

            -

            For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            operationRefstringA relative or absolute URI reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition. See the rules for resolving Relative References.
            operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
            parametersMap[string, Any | {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
            requestBodyAny | {expression}A literal value or {expression} to use as a request body when calling the target operation.
            descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
            serverServer ObjectA server object to be used by the target operation.
            -

            This object MAY be extended with Specification Extensions.

            -

            A linked operation MUST be identified using either an operationRef or operationId. -In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. -Because of the potential for name clashes, the operationRef syntax is preferred -for OpenAPI documents with external references.

            -

            Examples

            -

            Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

            -
            
            -paths:
            -  /users/{id}:
            -    parameters:
            -    - name: id
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -    get:
            -      responses:
            -        '200':
            -          description: the user being returned
            -          content:
            -            application/json:
            -              schema:
            -                type: object
            -                properties:
            -                  uuid: # the unique user id
            -                    type: string
            -                    format: uuid
            -          links:
            -            address:
            -              # the target link operationId
            -              operationId: getUserAddress
            -              parameters:
            -                # get the `id` field from the request path parameter named `id`
            -                userId: $request.path.id
            -  # the path item of the linked operation
            -  /users/{userid}/address:
            -    parameters:
            -    - name: userid
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -    # linked operation
            -    get:
            -      operationId: getUserAddress
            -      responses:
            -        '200':
            -          description: the user's address
            -
            -

            When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

            -

            Values from the response body can be used to drive a linked operation.

            -
            
            -links:
            -  address:
            -    operationId: getUserAddressByUUID
            -    parameters:
            -      # get the `uuid` field from the `uuid` field in the response body
            -      userUuid: $response.body#/uuid
            -
            -

            Clients follow all links at their discretion. -Neither permissions, nor the capability to make a successful call to that link, is guaranteed -solely by the existence of a relationship.

            -

            OperationRef Examples

            -

            As references to operationId MAY NOT be possible (the operationId is an optional -field in an Operation Object), references MAY also be made through a relative operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            or an absolute operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            Note that in the use of operationRef, the escaped forward-slash is necessary when -using JSON references.

            -

            Runtime Expressions

            -

            Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. -This mechanism is used by Link Objects and Callback Objects.

            -

            The runtime expression is defined by the following ABNF syntax

            -
            
            -      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
            -      source = ( header-reference / query-reference / path-reference / body-reference )
            -      header-reference = "header." token
            -      query-reference = "query." name 
            -      path-reference = "path." name
            -      body-reference = "body" ["#" json-pointer ]
            -      json-pointer    = *( "/" reference-token )
            -      reference-token = *( unescaped / escaped )
            -      unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
            -         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
            -      escaped         = "~" ( "0" / "1" )
            -        ; representing '~' and '/', respectively
            -      name = *( CHAR )
            -      token = 1*tchar
            -      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
            -        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
            -
            -

            Here, json-pointer is taken from [[!RFC6901]], char from [[!RFC7159]] and token from [[!RFC7230]].

            -

            The name identifier is case-sensitive, whereas token is not.

            -

            The table below provides examples of runtime expressions and examples of their use in a value:

            -

            Examples

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Source Locationexample expressionnotes
            HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
            Requested media type$request.header.accept
            Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
            Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
            Request URL$url
            Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
            Response header$response.header.ServerSingle header values only are available
            -

            Runtime expressions preserve the type of the referenced value. -Expressions can be embedded into string values by surrounding the expression with {} curly braces.

            -

            Header Object

            -

            The Header Object follows the structure of the Parameter Object with the following changes:

            -
              -
            1. name MUST NOT be specified, it is given in the corresponding headers map.
            2. -
            3. in MUST NOT be specified, it is implicitly in header.
            4. -
            5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
            6. -
            -

            Header Object Example

            -

            A simple header of type integer:

            -
            
            -{
            -  "description": "The number of allowed requests in the current period",
            -  "schema": {
            -    "type": "integer"
            -  }
            -}
            -
            -
            
            -description: The number of allowed requests in the current period
            -schema:
            -  type: integer
            -
            -

            Tag Object

            -

            Adds metadata to a single tag that is used by the Operation Object. -It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the tag.
            descriptionstringA description for the tag. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
            -

            This object MAY be extended with Specification Extensions.

            -

            Tag Object Example

            -
            
            -{
            -	"name": "pet",
            -	"description": "Pets operations"
            -}
            -
            -
            
            -name: pet
            -description: Pets operations
            -
            -

            Reference Object

            -

            A simple object to allow referencing other components in the OpenAPI document, internally and externally.

            -

            The $ref string value contains a URI [[!RFC3986]], which identifies the location of the value being referenced.

            -

            See the rules for resolving Relative References.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringREQUIRED. The reference identifier. This MUST be in the form of a URI.
            summarystringA short summary which by default SHOULD override that of the referenced component. If the referenced object-type does not allow a summary field, then this field has no effect.
            descriptionstringA description which by default SHOULD override that of the referenced component. CommonMark syntax MAY be used for rich text representation. If the referenced object-type does not allow a description field, then this field has no effect.
            -

            This object cannot be extended with additional properties and any properties added SHALL be ignored.

            -

            Note that this restriction on additional properties is a difference between Reference Objects and Schema Objects that contain a $ref keyword.

            -

            Reference Object Example

            -
            
            -{
            -	"$ref": "#/components/schemas/Pet"
            -}
            -
            -
            
            -$ref: '#/components/schemas/Pet'
            -
            -

            Relative Schema Document Example

            -
            
            -{
            -  "$ref": "Pet.json"
            -}
            -
            -
            
            -$ref: Pet.yaml
            -
            -

            Relative Documents With Embedded Schema Example

            -
            
            -{
            -  "$ref": "definitions.json#/Pet"
            -}
            -
            -
            
            -$ref: definitions.yaml#/Pet
            -
            -

            Schema Object

            -

            The Schema Object allows the definition of input and output data types. -These types can be objects, but also primitives and arrays. This object is a superset of the JSON Schema Specification Draft 2020-12.

            -

            For more information about the properties, see JSON Schema Core and JSON Schema Validation.

            -

            Unless stated otherwise, the property definitions follow those of JSON Schema and do not add any additional semantics. -Where JSON Schema indicates that behavior is defined by the application (e.g. for annotations), OAS also defers the definition of semantics to the application consuming the OpenAPI document.

            -

            Properties

            -

            The OpenAPI Schema Object dialect is defined as requiring the OAS base vocabulary, in addition to the vocabularies as specified in the JSON Schema draft 2020-12 general purpose meta-schema.

            -

            The OpenAPI Schema Object dialect for this version of the specification is identified by the URI https://spec.openapis.org/oas/3.1/dialect/base (the “OAS dialect schema id”).

            -

            The following properties are taken from the JSON Schema specification but their definitions have been extended by the OAS:

            -
              -
            • description - CommonMark syntax MAY be used for rich text representation.
            • -
            • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
            • -
            -

            In addition to the JSON Schema properties comprising the OAS dialect, the Schema Object supports keywords from any other vocabularies, or entirely arbitrary properties.

            -

            The OpenAPI Specification’s base vocabulary is comprised of the following keywords:

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
            xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
            externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
            exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.

            Deprecated: The example property has been deprecated in favor of the JSON Schema examples keyword. Use of example is discouraged, and later versions of this specification may remove it.
            -

            This object MAY be extended with Specification Extensions, though as noted, additional properties MAY omit the x- prefix within this object.

            -
            Composition and Inheritance (Polymorphism)
            -

            The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. -allOf takes an array of object definitions that are validated independently but together compose a single object.

            -

            While composition offers model extensibility, it does not imply a hierarchy between the models. -To support polymorphism, the OpenAPI Specification adds the discriminator field. -When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. -As such, the discriminator field MUST be a required field. -There are two ways to define the value of a discriminator for an inheriting instance.

            -
              -
            • Use the schema name.
            • -
            • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. -As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
            • -
            -
            XML Modeling
            -

            The xml property allows extra definitions when translating the JSON definition to XML. -The XML Object contains additional information about the available options.

            -
            Specifying Schema Dialects
            -

            It is important for tooling to be able to determine which dialect or meta-schema any given resource wishes to be processed with: JSON Schema Core, JSON Schema Validation, OpenAPI Schema dialect, or some custom meta-schema.

            -

            The $schema keyword MAY be present in any root Schema Object, and if present MUST be used to determine which dialect should be used when processing the schema. This allows use of Schema Objects which comply with other drafts of JSON Schema than the default Draft 2020-12 support. Tooling MUST support the OAS dialect schema id, and MAY support additional values of $schema.

            -

            To allow use of a different default $schema value for all Schema Objects contained within an OAS document, a jsonSchemaDialect value may be set within the OpenAPI Object. If this default is not set, then the OAS dialect schema id MUST be used for these Schema Objects. The value of $schema within a Schema Object always overrides any default.

            -

            When a Schema Object is referenced from an external resource which is not an OAS document (e.g. a bare JSON Schema resource), then the value of the $schema keyword for schemas within that resource MUST follow JSON Schema rules.

            -

            Schema Object Examples

            -
            Primitive Sample
            -
            
            -{
            -  "type": "string",
            -  "format": "email"
            -}
            -
            -
            
            -type: string
            -format: email
            -
            -
            Simple Model
            -
            
            -{
            -  "type": "object",
            -  "required": [
            -    "name"
            -  ],
            -  "properties": {
            -    "name": {
            -      "type": "string"
            -    },
            -    "address": {
            -      "$ref": "#/components/schemas/Address"
            -    },
            -    "age": {
            -      "type": "integer",
            -      "format": "int32",
            -      "minimum": 0
            -    }
            -  }
            -}
            -
            -
            
            -type: object
            -required:
            -- name
            -properties:
            -  name:
            -    type: string
            -  address:
            -    $ref: '#/components/schemas/Address'
            -  age:
            -    type: integer
            -    format: int32
            -    minimum: 0
            -
            -
            Model with Map/Dictionary Properties
            -

            For a simple string to string mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  type: string
            -
            -

            For a string to model mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "$ref": "#/components/schemas/ComplexModel"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  $ref: '#/components/schemas/ComplexModel'
            -
            -
            Model with Example
            -
            
            -{
            -  "type": "object",
            -  "properties": {
            -    "id": {
            -      "type": "integer",
            -      "format": "int64"
            -    },
            -    "name": {
            -      "type": "string"
            -    }
            -  },
            -  "required": [
            -    "name"
            -  ],
            -  "example": {
            -    "name": "Puma",
            -    "id": 1
            -  }
            -}
            -
            -
            
            -type: object
            -properties:
            -  id:
            -    type: integer
            -    format: int64
            -  name:
            -    type: string
            -required:
            -- name
            -example:
            -  name: Puma
            -  id: 1
            -
            -
            Models with Composition
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "ErrorModel": {
            -        "type": "object",
            -        "required": [
            -          "message",
            -          "code"
            -        ],
            -        "properties": {
            -          "message": {
            -            "type": "string"
            -          },
            -          "code": {
            -            "type": "integer",
            -            "minimum": 100,
            -            "maximum": 600
            -          }
            -        }
            -      },
            -      "ExtendedErrorModel": {
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/ErrorModel"
            -          },
            -          {
            -            "type": "object",
            -            "required": [
            -              "rootCause"
            -            ],
            -            "properties": {
            -              "rootCause": {
            -                "type": "string"
            -              }
            -            }
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    ErrorModel:
            -      type: object
            -      required:
            -      - message
            -      - code
            -      properties:
            -        message:
            -          type: string
            -        code:
            -          type: integer
            -          minimum: 100
            -          maximum: 600
            -    ExtendedErrorModel:
            -      allOf:
            -      - $ref: '#/components/schemas/ErrorModel'
            -      - type: object
            -        required:
            -        - rootCause
            -        properties:
            -          rootCause:
            -            type: string
            -
            -
            Models with Polymorphism Support
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "Pet": {
            -        "type": "object",
            -        "discriminator": {
            -          "propertyName": "petType"
            -        },
            -        "properties": {
            -          "name": {
            -            "type": "string"
            -          },
            -          "petType": {
            -            "type": "string"
            -          }
            -        },
            -        "required": [
            -          "name",
            -          "petType"
            -        ]
            -      },
            -      "Cat": {
            -        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "huntingSkill": {
            -                "type": "string",
            -                "description": "The measured skill for hunting",
            -                "default": "lazy",
            -                "enum": [
            -                  "clueless",
            -                  "lazy",
            -                  "adventurous",
            -                  "aggressive"
            -                ]
            -              }
            -            },
            -            "required": [
            -              "huntingSkill"
            -            ]
            -          }
            -        ]
            -      },
            -      "Dog": {
            -        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "packSize": {
            -                "type": "integer",
            -                "format": "int32",
            -                "description": "the size of the pack the dog is from",
            -                "default": 0,
            -                "minimum": 0
            -              }
            -            },
            -            "required": [
            -              "packSize"
            -            ]
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      discriminator:
            -        propertyName: petType
            -      properties:
            -        name:
            -          type: string
            -        petType:
            -          type: string
            -      required:
            -      - name
            -      - petType
            -    Cat:  ## "Cat" will be used as the discriminator value
            -      description: A representation of a cat
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          huntingSkill:
            -            type: string
            -            description: The measured skill for hunting
            -            enum:
            -            - clueless
            -            - lazy
            -            - adventurous
            -            - aggressive
            -        required:
            -        - huntingSkill
            -    Dog:  ## "Dog" will be used as the discriminator value
            -      description: A representation of a dog
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          packSize:
            -            type: integer
            -            format: int32
            -            description: the size of the pack the dog is from
            -            default: 0
            -            minimum: 0
            -        required:
            -        - packSize
            -
            -

            Discriminator Object

            -

            When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the document of an alternative schema based on the value associated with it.

            -

            When using the discriminator, inline schemas will not be considered.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
            mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
            -

            This object MAY be extended with Specification Extensions.

            -

            The discriminator object is legal only when using one of the composite keywords oneOf, anyOf, allOf.

            -

            In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -
            -

            which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  discriminator:
            -    propertyName: petType
            -
            -

            The expectation now is that a property with name petType MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

            -
            
            -{
            -  "id": 12345,
            -  "petType": "Cat"
            -}
            -
            -

            Will indicate that the Cat schema be used in conjunction with this payload.

            -

            In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -  discriminator:
            -    propertyName: petType
            -    mapping:
            -      dog: '#/components/schemas/Dog'
            -      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -
            -

            Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

            -

            When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

            -

            In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

            -

            For example:

            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      required:
            -      - petType
            -      properties:
            -        petType:
            -          type: string
            -      discriminator:
            -        propertyName: petType
            -        mapping:
            -          dog: Dog
            -    Cat:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Cat`
            -        properties:
            -          name:
            -            type: string
            -    Dog:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Dog`
            -        properties:
            -          bark:
            -            type: string
            -    Lizard:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Lizard`
            -        properties:
            -          lovesRocks:
            -            type: boolean
            -
            -

            a payload like this:

            -
            
            -{
            -  "petType": "Cat",
            -  "name": "misty"
            -}
            -
            -

            will indicate that the Cat schema be used. Likewise this schema:

            -
            
            -{
            -  "petType": "dog",
            -  "bark": "soft"
            -}
            -
            -

            will map to Dog because of the definition in the mapping element.

            -

            XML Object

            -

            A metadata object that allows for more fine-tuned XML model definitions.

            -

            When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. -See examples for expected behavior.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
            namespacestringThe URI of the namespace definition. This MUST be in the form of an absolute URI.
            prefixstringThe prefix to be used for the name.
            attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
            wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
            -

            This object MAY be extended with Specification Extensions.

            -

            XML Object Examples

            -

            The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

            -
            No XML Element
            -

            Basic string property:

            -
            
            -{
            -    "animals": {
            -        "type": "string"
            -    }
            -}
            -
            -
            
            -animals:
            -  type: string
            -
            -
            
            -<animals>...</animals>
            -
            -

            Basic string array property (wrapped is false by default):

            -
            
            -{
            -    "animals": {
            -        "type": "array",
            -        "items": {
            -            "type": "string"
            -        }
            -    }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -
            -
            
            -<animals>...</animals>
            -<animals>...</animals>
            -<animals>...</animals>
            -
            -
            XML Name Replacement
            -
            
            -{
            -  "animals": {
            -    "type": "string",
            -    "xml": {
            -      "name": "animal"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: string
            -  xml:
            -    name: animal
            -
            -
            
            -<animal>...</animal>
            -
            -
            XML Attribute, Prefix and Namespace
            -

            In this example, a full model definition is shown.

            -
            
            -{
            -  "Person": {
            -    "type": "object",
            -    "properties": {
            -      "id": {
            -        "type": "integer",
            -        "format": "int32",
            -        "xml": {
            -          "attribute": true
            -        }
            -      },
            -      "name": {
            -        "type": "string",
            -        "xml": {
            -          "namespace": "https://example.com/schema/sample",
            -          "prefix": "sample"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -Person:
            -  type: object
            -  properties:
            -    id:
            -      type: integer
            -      format: int32
            -      xml:
            -        attribute: true
            -    name:
            -      type: string
            -      xml:
            -        namespace: https://example.com/schema/sample
            -        prefix: sample
            -
            -
            
            -<Person id="123">
            -    <sample:name xmlns:sample="https://example.com/schema/sample">example</sample:name>
            -</Person>
            -
            -
            XML Arrays
            -

            Changing the element names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            The external name property has no effect on the XML:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animals>value</animals>
            -  <animals>value</animals>
            -</animals>
            -
            -

            To overcome the naming problem in the example above, the following definition can be used:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</animals>
            -
            -

            Affecting both internal and external names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</aliens>
            -
            -

            If we change the external element but not the internal ones:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <aliens>value</aliens>
            -  <aliens>value</aliens>
            -</aliens>
            -
            -

            Security Scheme Object

            -

            Defines a security scheme that can be used by the operations.

            -

            Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), mutual TLS (use of a client certificate), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and OpenID Connect Discovery. -Please note that as of 2020, the implicit flow is about to be deprecated by OAuth 2.0 Security Best Current Practice. Recommended for most use case is Authorization Code Grant flow with PKCE.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "mutualTLS", "oauth2", "openIdConnect".
            descriptionstringAnyA description for security scheme. CommonMark syntax MAY be used for rich text representation.
            namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
            instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
            schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]]. The values used SHOULD be registered in the IANA Authentication Scheme registry.
            bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
            flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
            openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL. The OpenID Connect standard requires the use of TLS.
            -

            This object MAY be extended with Specification Extensions.

            -

            Security Scheme Object Example

            -
            Basic Authentication Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "basic"
            -}
            -
            -
            
            -type: http
            -scheme: basic
            -
            -
            API Key Sample
            -
            
            -{
            -  "type": "apiKey",
            -  "name": "api_key",
            -  "in": "header"
            -}
            -
            -
            
            -type: apiKey
            -name: api_key
            -in: header
            -
            -
            JWT Bearer Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "bearer",
            -  "bearerFormat": "JWT",
            -}
            -
            -
            
            -type: http
            -scheme: bearer
            -bearerFormat: JWT
            -
            -
            Implicit OAuth2 Sample
            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            OAuth Flows Object

            -

            Allows configuration of the supported OAuth Flows.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
            passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
            clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
            authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object

            -

            Configuration details for a supported OAuth Flow

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
            tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
            refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
            scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object Examples

            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    },
            -    "authorizationCode": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "tokenUrl": "https://example.com/api/oauth/token",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -  authorizationCode:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    tokenUrl: https://example.com/api/oauth/token
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            Security Requirement Object

            -

            Lists the required security schemes to execute this operation. -The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

            -

            Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. -This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

            -

            When a list of Security Requirement Objects is defined on the OpenAPI Object or Operation Object, only one of the Security Requirement Objects in the list needs to be satisfied to authorize the request.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution, and the list MAY be empty if authorization does not require a specified scope. For other security scheme types, the array MAY contain a list of role names which are required for the execution, but are not otherwise defined or exchanged in-band.
            -

            Security Requirement Object Examples

            -
            Non-OAuth2 Security Requirement
            -
            
            -{
            -  "api_key": []
            -}
            -
            -
            
            -api_key: []
            -
            -
            OAuth2 Security Requirement
            -
            
            -{
            -  "petstore_auth": [
            -    "write:pets",
            -    "read:pets"
            -  ]
            -}
            -
            -
            
            -petstore_auth:
            -- write:pets
            -- read:pets
            -
            -
            Optional OAuth2 Security
            -

            Optional OAuth2 security as would be defined in an OpenAPI Object or an Operation Object:

            -
            
            -{
            -  "security": [
            -    {},
            -    {
            -      "petstore_auth": [
            -        "write:pets",
            -        "read:pets"
            -      ]
            -    }
            -  ]
            -}
            -
            -
            
            -security:
            -  - {}
            -  - petstore_auth:
            -    - write:pets
            -    - read:pets
            -
            -

            Specification Extensions

            -

            While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

            -

            The extensions properties are implemented as patterned fields that are always prefixed by "x-".

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. Field names beginning x-oai- and x-oas- are reserved for uses defined by the OpenAPI Initiative. The value can be null, a primitive, an array or an object.
            -

            The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

            -

            Security Filtering

            -

            Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

            -

            The reasoning is to allow an additional layer of access control over the documentation. -While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

            -

            Two examples of this:

            -
              -
            1. The Paths Object MAY be present but empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They would still have access to at least the Info Object which may contain additional information regarding authentication.
            2. -
            3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the Paths Object, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
            4. -
            -

            Appendix A: Revision History

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            VersionDateNotes
            3.1.02021-02-15Release of the OpenAPI Specification 3.1.0
            3.1.0-rc12020-10-08rc1 of the 3.1 specification
            3.1.0-rc02020-06-18rc0 of the 3.1 specification
            3.0.32020-02-20Patch release of the OpenAPI Specification 3.0.3
            3.0.22018-10-08Patch release of the OpenAPI Specification 3.0.2
            3.0.12017-12-06Patch release of the OpenAPI Specification 3.0.1
            3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
            3.0.0-rc22017-06-16rc2 of the 3.0 specification
            3.0.0-rc12017-04-27rc1 of the 3.0 specification
            3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
            2.02015-12-31Donation of Swagger 2.0 to the OpenAPI Initiative
            2.02014-09-08Release of Swagger 2.0
            1.22014-03-14Initial release of the formal document.
            1.12012-08-22Release of Swagger 1.1
            1.02011-08-10First release of the Swagger Specification
            - diff --git a/docs/oas/v2.0.html b/docs/oas/v2.0.html deleted file mode 100644 index 886b7ef5e7..0000000000 --- a/docs/oas/v2.0.html +++ /dev/null @@ -1,3101 +0,0 @@ -OpenAPI Specification v2.0 | Introduction, Definitions, & More - - -

            OpenAPI Specification v2.0

            The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

            Status of This Document

            The source-of-truth for the specification is the GitHub markdown file referenced above.
            -

            OpenAPI Specification

            -

            (fka Swagger RESTful API Documentation Specification)

            -

            Version 2.0

            -

            The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in [!RFC2119].

            -

            The Swagger specification is licensed under The Apache License, Version 2.0.

            -

            Introductions

            -

            Swagger™ is a project used to describe and document RESTful APIs.

            -

            The Swagger specification defines a set of files required to describe such an API. These files can then be used by the Swagger-UI project to display the API and Swagger-Codegen to generate clients in various languages. Additional utilities can also take advantage of the resulting files, such as testing tools.

            -

            Revision History

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            VersionDateNotes
            2.02014-09-08Release of Swagger 2.0
            1.22014-03-14Initial release of the formal document.
            1.12012-08-22Release of Swagger 1.1
            1.02011-08-10First release of the Swagger Specification
            -

            Definitions

            -

            Path Templating

            -

            Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

            -

            Mime Types

            -

            Mime type definitions are spread across several resources. The mime type definitions should be in compliance with [[!RFC6838]].

            -

            Some examples of possible mime type definitions:

            -
            
            -  text/plain; charset=utf-8
            -  application/json
            -  application/vnd.github+json
            -  application/vnd.github.v3+json
            -  application/vnd.github.v3.raw+json
            -  application/vnd.github.v3.text+json
            -  application/vnd.github.v3.html+json
            -  application/vnd.github.v3.full+json
            -  application/vnd.github.v3.diff
            -  application/vnd.github.v3.patch
            -
            -

            HTTP Status Codes

            -

            The HTTP Status Codes are used to indicate the status of the executed operation. The available status codes are described by [[!RFC7231]] and in the IANA Status Code Registry.

            -

            Specification

            -

            Format

            -

            The files describing the RESTful API in accordance with the Swagger specification are represented as JSON objects and conform to the JSON standards. YAML, being a superset of JSON, can be used as well to -represent a Swagger specification file.

            -

            For example, if a field is said to have an array value, the JSON array representation will be used:

            -
            
            -{
            -   "field" : [...]
            -}
            -
            -

            While the API is described using JSON it does not impose a JSON input/output to the API itself.

            -

            All field names in the specification are case sensitive.

            -

            The schema exposes two types of fields. Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name. Patterned fields can have multiple occurrences as long as each has a unique name.

            -

            File Structure

            -

            The Swagger representation of the API is made of a single file. However, parts of the definitions can be split into separate files, at the discretion of the user. This is applicable for $ref fields in the specification as follows from the JSON Schema definitions.

            -

            By convention, the Swagger specification file is named swagger.json.

            -

            Data Types

            -

            Primitive data types in the Swagger Specification are based on the types supported by the JSON-Schema Draft 4. Models are described using the Schema Object which is a subset of JSON Schema Draft 4.

            -

            An additional primitive data type "file" is used by the Parameter Object and the Response Object to set the parameter type or the response as being a file.

            -

            Primitives have an optional modifier property format. Swagger uses several known formats to more finely define the data type being used. However, the format property is an open string-valued property, and can have any value to support documentation needs. Formats such as "email", "uuid", etc., can be used even though they are not defined by this specification. Types that are not accompanied by a format property follow their definition from the JSON Schema (except for file type which is defined above). The formats defined by the Swagger Specification are:

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Common NametypeformatComments
            integerintegerint32signed 32 bits
            longintegerint64signed 64 bits
            floatnumberfloat
            doublenumberdouble
            stringstring
            bytestringbytebase64 encoded characters
            binarystringbinaryany sequence of octets
            booleanboolean
            datestringdateAs defined by full-date - [!RFC3339]
            dateTimestringdate-timeAs defined by date-time - [!RFC3339]
            passwordstringpasswordUsed to hint UIs the input needs to be obscured.
            -

            Schema

            -

            Swagger Object

            -

            This is the root document object for the API specification. It combines what previously was the Resource Listing and API Declaration (version 1.2 and earlier) together into one document.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            swaggerstringRequired. Specifies the Swagger Specification version being used. It can be used by the Swagger UI and other clients to interpret the API listing. The value MUST be "2.0".
            infoInfo ObjectRequired. Provides metadata about the API. The metadata can be used by the clients if needed.
            hoststringThe host (name or ip) serving the API. This MUST be the host only and does not include the scheme nor sub-paths. It MAY include a port. If the host is not included, the host serving the documentation is to be used (including the port). The host does not support path templating.
            basePathstringThe base path on which the API is served, which is relative to the host. If it is not included, the API is served directly under the host. The value MUST start with a leading slash (/). The basePath does not support path templating.
            schemes[string]The transfer protocol of the API. Values MUST be from the list: "http", "https", "ws", "wss". If the schemes is not included, the default scheme to be used is the one used to access the Swagger definition itself.
            consumes[string]A list of MIME types the APIs can consume. This is global to all APIs but can be overridden on specific API calls. Value MUST be as described under Mime Types.
            produces[string]A list of MIME types the APIs can produce. This is global to all APIs but can be overridden on specific API calls. Value MUST be as described under Mime Types.
            pathsPaths ObjectRequired. The available paths and operations for the API.
            definitionsDefinitions ObjectAn object to hold data types produced and consumed by operations.
            parametersParameters Definitions ObjectAn object to hold parameters that can be used across operations. This property does not define global parameters for all operations.
            responsesResponses Definitions ObjectAn object to hold responses that can be used across operations. This property does not define global responses for all operations.
            securityDefinitionsSecurity Definitions ObjectSecurity scheme definitions that can be used across the specification.
            security[Security Requirement Object]A declaration of which security schemes are applied for the API as a whole. The list of values describes alternative security schemes that can be used (that is, there is a logical OR between the security requirements). Individual operations can override this definition.
            tags[Tag Object]A list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared may be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
            externalDocsExternal Documentation ObjectAdditional external documentation.
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Info Object

            -

            The object provides metadata about the API. The metadata can be used by the clients if needed, and can be presented in the Swagger-UI for convenience.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            titlestringRequired. The title of the application.
            descriptionstringA short description of the application. GFM syntax can be used for rich text representation.
            termsOfServicestringThe Terms of Service for the API.
            contactContact ObjectThe contact information for the exposed API.
            licenseLicense ObjectThe license information for the exposed API.
            versionstringRequired Provides the version of the application API (not to be confused with the specification version).
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Info Object Example:

            -
            
            -{
            -  "title": "Swagger Sample App",
            -  "description": "This is a sample server Petstore server.",
            -  "termsOfService": "http://swagger.io/terms/",
            -  "contact": {
            -    "name": "API Support",
            -    "url": "http://www.swagger.io/support",
            -    "email": "support@swagger.io"
            -  },
            -  "license": {
            -    "name": "Apache 2.0",
            -    "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
            -  },
            -  "version": "1.0.1"
            -}
            -
            -
            
            -title: Swagger Sample App
            -description: This is a sample server Petstore server.
            -termsOfService: http://swagger.io/terms/
            -contact:
            -  name: API Support
            -  url: http://www.swagger.io/support
            -  email: support@swagger.io
            -license:
            -  name: Apache 2.0
            -  url: http://www.apache.org/licenses/LICENSE-2.0.html
            -version: 1.0.1
            -
            -

            Contact Object

            -

            Contact information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringThe identifying name of the contact person/organization.
            urlstringThe URL pointing to the contact information. MUST be in the format of a URL.
            emailstringThe email address of the contact person/organization. MUST be in the format of an email address.
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Contact Object Example:

            -
            
            -{
            -  "name": "API Support",
            -  "url": "http://www.swagger.io/support",
            -  "email": "support@swagger.io"
            -}
            -
            -
            
            -name: API Support
            -url: http://www.swagger.io/support
            -email: support@swagger.io
            -
            -

            License Object

            -

            License information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringRequired. The license name used for the API.
            urlstringA URL to the license used for the API. MUST be in the format of a URL.
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            License Object Example:

            -
            
            -{
            -  "name": "Apache 2.0",
            -  "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
            -}
            -
            -
            
            -name: Apache 2.0
            -url: http://www.apache.org/licenses/LICENSE-2.0.html
            -
            -

            Paths Object

            -

            Holds the relative paths to the individual endpoints. The path is appended to the basePath in order to construct the full URL. -The Paths may be empty, due to ACL constraints.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a slash. The path is appended to the basePath in order to construct the full URL. Path templating is allowed.
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Paths Object Example

            -
            
            -{
            -  "/pets": {
            -    "get": {
            -      "description": "Returns all pets from the system that the user has access to",
            -      "produces": [
            -        "application/json"
            -      ],
            -      "responses": {
            -        "200": {
            -          "description": "A list of pets.",
            -          "schema": {
            -            "type": "array",
            -            "items": {
            -              "$ref": "#/definitions/pet"
            -            }
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -/pets:
            -  get:
            -    description: Returns all pets from the system that the user has access to
            -    produces:
            -    - application/json
            -    responses:
            -      '200':
            -        description: A list of pets.
            -        schema:
            -          type: array
            -          items:
            -            $ref: '#/definitions/pet'
            -
            -

            Path Item Object

            -

            Describes the operations available on a single path. -A Path Item may be empty, due to ACL constraints. The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringAllows for an external definition of this path item. The referenced structure MUST be in the format of a Path Item Object. If there are conflicts between the referenced definition and this Path Item’s definition, the behavior is undefined.
            getOperation ObjectA definition of a GET operation on this path.
            putOperation ObjectA definition of a PUT operation on this path.
            postOperation ObjectA definition of a POST operation on this path.
            deleteOperation ObjectA definition of a DELETE operation on this path.
            optionsOperation ObjectA definition of a OPTIONS operation on this path.
            headOperation ObjectA definition of a HEAD operation on this path.
            patchOperation ObjectA definition of a PATCH operation on this path.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the Swagger Object’s parameters. There can be one “body” parameter at most.
            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Path Item Object Example

            -
            
            -{
            -  "get": {
            -    "description": "Returns pets based on ID",
            -    "summary": "Find pets by ID",
            -    "operationId": "getPetsById",
            -    "produces": [
            -      "application/json",
            -      "text/html"
            -    ],
            -    "responses": {
            -      "200": {
            -        "description": "pet response",
            -        "schema": {
            -          "type": "array",
            -          "items": {
            -            "$ref": "#/definitions/Pet"
            -          }
            -        }
            -      },
            -      "default": {
            -        "description": "error payload",
            -        "schema": {
            -          "$ref": "#/definitions/ErrorModel"
            -        }
            -      }
            -    }
            -  },
            -  "parameters": [
            -    {
            -      "name": "id",
            -      "in": "path",
            -      "description": "ID of pet to use",
            -      "required": true,
            -      "type": "array",
            -      "items": {
            -        "type": "string"
            -      },
            -      "collectionFormat": "csv"
            -    }
            -  ]
            -}
            -
            -
            
            -get:
            -  description: Returns pets based on ID
            -  summary: Find pets by ID
            -  operationId: getPetsById
            -  produces:
            -  - application/json
            -  - text/html
            -  responses:
            -    '200':
            -      description: pet response
            -      schema:
            -        type: array
            -        items:
            -          $ref: '#/definitions/Pet'
            -    default:
            -      description: error payload
            -      schema:
            -        $ref: '#/definitions/ErrorModel'
            -parameters:
            -- name: id
            -  in: path
            -  description: ID of pet to use
            -  required: true
            -  type: array
            -  items:
            -    type: string
            -  collectionFormat: csv
            -
            -

            Operation Object

            -

            Describes a single API operation on a path.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
            summarystringA short summary of what the operation does. For maximum readability in the swagger-ui, this field SHOULD be less than 120 characters.
            descriptionstringA verbose explanation of the operation behavior. GFM syntax can be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
            operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is recommended to follow common programming naming conventions.
            consumes[string]A list of MIME types the operation can consume. This overrides the consumes definition at the Swagger Object. An empty value MAY be used to clear the global definition. Value MUST be as described under Mime Types.
            produces[string]A list of MIME types the operation can produce. This overrides the produces definition at the Swagger Object. An empty value MAY be used to clear the global definition. Value MUST be as described under Mime Types.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it, but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the Swagger Object’s parameters. There can be one “body” parameter at most.
            responsesResponses ObjectRequired. The list of possible responses as they are returned from executing this operation.
            schemes[string]The transfer protocol for the operation. Values MUST be from the list: "http", "https", "ws", "wss". The value overrides the Swagger Object schemes definition.
            deprecatedbooleanDeclares this operation to be deprecated. Usage of the declared operation should be refrained. Default value is false.
            security[Security Requirement Object]A declaration of which security schemes are applied for this operation. The list of values describes alternative security schemes that can be used (that is, there is a logical OR between the security requirements). This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Operation Object Example

            -
            
            -{
            -  "tags": [
            -    "pet"
            -  ],
            -  "summary": "Updates a pet in the store with form data",
            -  "description": "",
            -  "operationId": "updatePetWithForm",
            -  "consumes": [
            -    "application/x-www-form-urlencoded"
            -  ],
            -  "produces": [
            -    "application/json",
            -    "application/xml"
            -  ],
            -  "parameters": [
            -    {
            -      "name": "petId",
            -      "in": "path",
            -      "description": "ID of pet that needs to be updated",
            -      "required": true,
            -      "type": "string"
            -    },
            -    {
            -      "name": "name",
            -      "in": "formData",
            -      "description": "Updated name of the pet",
            -      "required": false,
            -      "type": "string"
            -    },
            -    {
            -      "name": "status",
            -      "in": "formData",
            -      "description": "Updated status of the pet",
            -      "required": false,
            -      "type": "string"
            -    }
            -  ],
            -  "responses": {
            -    "200": {
            -      "description": "Pet updated."
            -    },
            -    "405": {
            -      "description": "Invalid input"
            -    }
            -  },
            -  "security": [
            -    {
            -      "petstore_auth": [
            -        "write:pets",
            -        "read:pets"
            -      ]
            -    }
            -  ]
            -}
            -
            -
            
            -tags:
            -- pet
            -summary: Updates a pet in the store with form data
            -description: ""
            -operationId: updatePetWithForm
            -consumes:
            -- application/x-www-form-urlencoded
            -produces:
            -- application/json
            -- application/xml
            -parameters:
            -- name: petId
            -  in: path
            -  description: ID of pet that needs to be updated
            -  required: true
            -  type: string
            -- name: name
            -  in: formData
            -  description: Updated name of the pet
            -  required: false
            -  type: string
            -- name: status
            -  in: formData
            -  description: Updated status of the pet
            -  required: false
            -  type: string
            -responses:
            -  '200':
            -    description: Pet updated.
            -  '405':
            -    description: Invalid input
            -security:
            -- petstore_auth:
            -  - write:pets
            -  - read:pets
            -
            -

            External Documentation Object

            -

            Allows referencing an external resource for extended documentation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA short description of the target documentation. GFM syntax can be used for rich text representation.
            urlstringRequired. The URL for the target documentation. Value MUST be in the format of a URL.
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            External Documentation Object Example

            -
            
            -{
            -  "description": "Find more info here",
            -  "url": "https://swagger.io"
            -}
            -
            -
            
            -description: Find more info here
            -url: https://swagger.io
            -
            -

            Parameter Object

            -

            Describes a single operation parameter.

            -

            A unique parameter is defined by a combination of a name and location.

            -

            There are five possible parameter types.

            -
              -
            • Path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
            • -
            • Query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
            • -
            • Header - Custom headers that are expected as part of the request.
            • -
            • Body - The payload that’s appended to the HTTP request. Since there can only be one payload, there can only be one body parameter. The name of the body parameter has no effect on the parameter itself and is used for documentation purposes only. Since Form parameters are also in the payload, body and form parameters cannot exist together for the same operation.
            • -
            • Form - Used to describe the payload of an HTTP request when either application/x-www-form-urlencoded, multipart/form-data or both are used as the content type of the request (in Swagger’s definition, the consumes property of an operation). This is the only parameter type that can be used to send files, thus supporting the file type. Since form parameters are sent in the payload, they cannot be declared together with a body parameter for the same operation. Form parameters have a different format based on the content-type used (for further details, consult http://www.w3.org/TR/html401/interact/forms.html#h-17.13.4): -
                -
              • application/x-www-form-urlencoded - Similar to the format of Query parameters but as a payload. For example, foo=1&bar=swagger - both foo and bar are form parameters. This is normally used for simple parameters that are being transferred.
              • -
              • multipart/form-data - each parameter takes a section in the payload with an internal header. For example, for the header Content-Disposition: form-data; name="submit-name" the name of the parameter is submit-name. This type of form parameters is more commonly used for file transfers.
              • -
              -
            • -
            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringRequired. The name of the parameter. Parameter names are case sensitive.
            • If in is "path", the name field MUST correspond to the associated path segment from the path field in the Paths Object. See Path Templating for further information.
            • For all other cases, the name corresponds to the parameter name used based on the in property.
            instringRequired. The location of the parameter. Possible values are “query”, “header”, “path”, “formData” or “body”.
            descriptionstringA brief description of the parameter. This could contain examples of use. GFM syntax can be used for rich text representation.
            requiredbooleanDetermines whether this parameter is mandatory. If the parameter is in “path”, this property is required and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
            -

            If in is "body":

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemaSchema ObjectRequired. The schema defining the type used for the body parameter.
            -

            If in is any value other than "body":

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            typestringRequired. The type of the parameter. Since the parameter is not located at the request body, it is limited to simple types (that is, not an object). The value MUST be one of "string", "number", "integer", "boolean", "array" or "file". If type is "file", the consumes MUST be either "multipart/form-data", " application/x-www-form-urlencoded" or both and the parameter MUST be in "formData".
            formatstringThe extending format for the previously mentioned type. See Data Type Formats for further details.
            allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for either query or formData parameters and allows you to send a parameter with a name only or an empty value. Default value is false.
            itemsItems ObjectRequired if type is “array”. Describes the type of items in the array.
            collectionFormatstringDetermines the format of the array if type array is used. Possible values are:
            • csv - comma separated values foo,bar.
            • ssv - space separated values foo bar.
            • tsv - tab separated values foo\tbar.
            • pipes - pipe separated values foo|bar.
            • multi - corresponds to multiple parameter instances instead of multiple values for a single instance foo=bar&foo=baz. This is valid only for parameters in “query” or “formData”.
            Default value is csv.
            default*Declares the value of the parameter that the server will use if none is provided, for example a “count” to control the number of results per page might default to 100 if not supplied by the client in the request. (Note: “default” has no meaning for required parameters.) See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-6.2. Unlike JSON Schema this value MUST conform to the defined type for this parameter.
            maximumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
            exclusiveMaximumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
            minimumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
            exclusiveMinimumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
            maxLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.1.
            minLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.2.
            patternstringSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.3.
            maxItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.2.
            minItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.3.
            uniqueItemsbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.4.
            enum[*]See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.5.1.
            multipleOfnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.1.
            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Parameter Object Examples

            -
            Body Parameters
            -

            A body parameter with a referenced schema definition (normally for a model definition):

            -
            
            -{
            -  "name": "user",
            -  "in": "body",
            -  "description": "user to add to the system",
            -  "required": true,
            -  "schema": {
            -    "$ref": "#/definitions/User"
            -  }
            -}
            -
            -
            
            -name: user
            -in: body
            -description: user to add to the system
            -required: true
            -schema:
            -  $ref: '#/definitions/User'
            -
            -

            A body parameter that is an array of string values:

            -
            
            -{
            -  "name": "user",
            -  "in": "body",
            -  "description": "user to add to the system",
            -  "required": true,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    }
            -  }
            -}
            -
            -
            
            -name: user
            -in: body
            -description: user to add to the system
            -required: true
            -schema:
            -  type: array
            -  items:
            -    type: string
            -
            -
            Other Parameters
            -

            A header parameter with an array of 64 bit integer numbers:

            -
            
            -{
            -  "name": "token",
            -  "in": "header",
            -  "description": "token to be passed as a header",
            -  "required": true,
            -  "type": "array",
            -  "items": {
            -    "type": "integer",
            -    "format": "int64"
            -  },
            -  "collectionFormat": "csv"
            -}
            -
            -
            
            -name: token
            -in: header
            -description: token to be passed as a header
            -required: true
            -type: array
            -items:
            -  type: integer
            -  format: int64
            -collectionFormat: csv
            -
            -

            A path parameter of a string value:

            -
            
            -{
            -  "name": "username",
            -  "in": "path",
            -  "description": "username to fetch",
            -  "required": true,
            -  "type": "string"
            -}
            -
            -
            
            -name: username
            -in: path
            -description: username to fetch
            -required: true
            -type: string
            -
            -

            An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

            -
            
            -{
            -  "name": "id",
            -  "in": "query",
            -  "description": "ID of the object to fetch",
            -  "required": false,
            -  "type": "array",
            -  "items": {
            -    "type": "string"
            -  },
            -  "collectionFormat": "multi"
            -}
            -
            -
            
            -name: id
            -in: query
            -description: ID of the object to fetch
            -required: false
            -type: array
            -items:
            -  type: string
            -collectionFormat: multi
            -
            -

            A form data with file type for a file upload:

            -
            
            -{
            -  "name": "avatar",
            -  "in": "formData",
            -  "description": "The avatar of the user",
            -  "required": true,
            -  "type": "file"
            -}
            -
            -
            
            -name: avatar
            -in: formData
            -description: The avatar of the user
            -required: true
            -type: file
            -
            -

            Items Object

            -

            A limited subset of JSON-Schema’s items object. It is used by parameter definitions that are not located in "body".

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            typestringRequired. The internal type of the array. The value MUST be one of "string", "number", "integer", "boolean", or "array". Files and models are not allowed.
            formatstringThe extending format for the previously mentioned type. See Data Type Formats for further details.
            itemsItems ObjectRequired if type is “array”. Describes the type of items in the array.
            collectionFormatstringDetermines the format of the array if type array is used. Possible values are:
            • csv - comma separated values foo,bar.
            • ssv - space separated values foo bar.
            • tsv - tab separated values foo\tbar.
            • pipes - pipe separated values foo|bar.
            Default value is csv.
            default*Declares the value of the item that the server will use if none is provided. (Note: “default” has no meaning for required items.) See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-6.2. Unlike JSON Schema this value MUST conform to the defined type for the data type.
            maximumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
            exclusiveMaximumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
            minimumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
            exclusiveMinimumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
            maxLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.1.
            minLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.2.
            patternstringSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.3.
            maxItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.2.
            minItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.3.
            uniqueItemsbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.4.
            enum[*]See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.5.1.
            multipleOfnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.1.
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Items Object Examples

            -

            Items must be of type string and have the minimum length of 2 characters:

            -
            
            -{
            -    "type": "string",
            -    "minLength": 2
            -}
            -
            -
            
            -type: string
            -minLength: 2
            -
            -

            An array of arrays, the internal array being of type integer, numbers must be between 0 and 63 (inclusive):

            -
            
            -{
            -    "type": "array",
            -    "items": {
            -        "type": "integer",
            -        "minimum": 0,
            -        "maximum": 63
            -    }
            -}
            -
            -
            
            -type: array
            -items:
            -  type: integer
            -  minimum: 0
            -  maximum: 63
            -
            -

            Responses Object

            -

            A container for the expected responses of an operation. The container maps a HTTP response code to the expected response. It is not expected from the documentation to necessarily cover all possible HTTP response codes, since they may not be known in advance. However, it is expected from the documentation to cover a successful operation response and any known errors.

            -

            The default can be used as the default response object for all HTTP codes that are not covered individually by the specification.

            -

            The Responses Object MUST contain at least one response code, and it SHOULD be the response for a successful operation call.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            defaultResponse Object | Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. It can be used to cover undeclared responses. Reference Object can be used to link to a response that is defined at the Swagger Object’s responses section.
            -

            Patterned Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {HTTP Status Code}Response Object | Reference ObjectAny HTTP status code can be used as the property name (one property per HTTP status code). Describes the expected response for that HTTP status code. Reference Object can be used to link to a response that is defined at the Swagger Object’s responses section.
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Responses Object Example

            -

            A 200 response for successful operation and a default response for others (implying an error):

            -
            
            -{
            -  "200": {
            -    "description": "a pet to be returned",
            -    "schema": {
            -      "$ref": "#/definitions/Pet"
            -    }
            -  },
            -  "default": {
            -    "description": "Unexpected error",
            -    "schema": {
            -      "$ref": "#/definitions/ErrorModel"
            -    }
            -  }
            -}
            -
            -
            
            -'200':
            -  description: a pet to be returned
            -  schema:
            -    $ref: '#/definitions/Pet'
            -default:
            -  description: Unexpected error
            -  schema:
            -    $ref: '#/definitions/ErrorModel'
            -
            -

            Response Object

            -

            Describes a single response from an API Operation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringRequired. A short description of the response. GFM syntax can be used for rich text representation.
            schemaSchema ObjectA definition of the response structure. It can be a primitive, an array or an object. If this field does not exist, it means no content is returned as part of the response. As an extension to the Schema Object, its root type value may also be "file". This SHOULD be accompanied by a relevant produces mime-type.
            headersHeaders ObjectA list of headers that are sent with the response.
            examplesExample ObjectAn example of the response message.
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Response Object Examples

            -

            Response of an array of a complex type:

            -
            
            -{
            -  "description": "A complex object array response",
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "$ref": "#/definitions/VeryComplexType"
            -    }
            -  }
            -}
            -
            -
            
            -description: A complex object array response
            -schema:
            -  type: array
            -  items:
            -    $ref: '#/definitions/VeryComplexType'
            -
            -

            Response with a string type:

            -
            
            -{
            -  "description": "A simple string response",
            -  "schema": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -description: A simple string response
            -schema:
            -  type: string
            -
            -

            Response with headers:

            -
            
            -{
            -  "description": "A simple string response",
            -  "schema": {
            -    "type": "string"
            -  },
            -  "headers": {
            -    "X-Rate-Limit-Limit": {
            -      "description": "The number of allowed requests in the current period",
            -      "type": "integer"
            -    },
            -    "X-Rate-Limit-Remaining": {
            -      "description": "The number of remaining requests in the current period",
            -      "type": "integer"
            -    },
            -    "X-Rate-Limit-Reset": {
            -      "description": "The number of seconds left in the current period",
            -      "type": "integer"
            -    }
            -  }
            -}
            -
            -
            
            -description: A simple string response
            -schema:
            -  type: string
            -headers:
            -  X-Rate-Limit-Limit:
            -    description: The number of allowed requests in the current period
            -    type: integer
            -  X-Rate-Limit-Remaining:
            -    description: The number of remaining requests in the current period
            -    type: integer
            -  X-Rate-Limit-Reset:
            -    description: The number of seconds left in the current period
            -    type: integer
            -
            -

            Response with no return value:

            -
            
            -{
            -  "description": "object created"
            -}
            -
            -
            
            -description: object created
            -
            -

            Headers Object

            -

            Lists the headers that can be sent as part of a response.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}Header ObjectThe name of the property corresponds to the name of the header. The value describes the type of the header.
            -

            Headers Object Example

            -

            Rate-limit headers:

            -
            
            -{
            -    "X-Rate-Limit-Limit": {
            -        "description": "The number of allowed requests in the current period",
            -        "type": "integer"
            -    },
            -    "X-Rate-Limit-Remaining": {
            -        "description": "The number of remaining requests in the current period",
            -        "type": "integer"
            -    },
            -    "X-Rate-Limit-Reset": {
            -        "description": "The number of seconds left in the current period",
            -        "type": "integer"
            -    }
            -}
            -
            -
            
            -X-Rate-Limit-Limit:
            -  description: The number of allowed requests in the current period
            -  type: integer
            -X-Rate-Limit-Remaining:
            -  description: The number of remaining requests in the current period
            -  type: integer
            -X-Rate-Limit-Reset:
            -  description: The number of seconds left in the current period
            -  type: integer
            -
            -

            Example Object

            -

            Allows sharing examples for operation responses.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {mime type}AnyThe name of the property MUST be one of the Operation produces values (either implicit or inherited). The value SHOULD be an example of what such a response would look like.
            -

            Example Object Example

            -

            Example response for application/json mimetype of a Pet data type:

            -
            
            -{
            -  "application/json": {
            -    "name": "Puma",
            -    "type": "Dog",
            -    "color": "Black",
            -    "gender": "Female",
            -    "breed": "Mixed"
            -  }
            -}
            -
            -
            
            -application/json:
            -  name: Puma
            -  type: Dog
            -  color: Black
            -  gender: Female
            -  breed: Mixed
            -
            -

            Header Object

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA short description of the header.
            typestringRequired. The type of the object. The value MUST be one of "string", "number", "integer", "boolean", or "array".
            formatstringThe extending format for the previously mentioned type. See Data Type Formats for further details.
            itemsItems ObjectRequired if type is “array”. Describes the type of items in the array.
            collectionFormatstringDetermines the format of the array if type array is used. Possible values are:
            • csv - comma separated values foo,bar.
            • ssv - space separated values foo bar.
            • tsv - tab separated values foo\tbar.
            • pipes - pipe separated values foo|bar.
            Default value is csv.
            default*Declares the value of the header that the server will use if none is provided. (Note: “default” has no meaning for required headers.) See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-6.2. Unlike JSON Schema this value MUST conform to the defined type for the header.
            maximumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
            exclusiveMaximumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.
            minimumnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
            exclusiveMinimumbooleanSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.
            maxLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.1.
            minLengthintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.2.
            patternstringSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.3.
            maxItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.2.
            minItemsintegerSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.3.
            uniqueItemsbooleanhttps://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.4.
            enum[*]See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.5.1.
            multipleOfnumberSee https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.1.
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Header Object Example

            -

            A simple header with of an integer type:

            -
            
            -{
            -  "description": "The number of allowed requests in the current period",
            -  "type": "integer"
            -}
            -
            -
            
            -description: The number of allowed requests in the current period
            -type: integer
            -
            -

            Tag Object

            -

            Allows adding meta data to a single tag that is used by the Operation Object. It is not mandatory to have a Tag Object per tag used there.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringRequired. The name of the tag.
            descriptionstringA short description for the tag. GFM syntax can be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Tag Object Example

            -
            
            -{
            -	"name": "pet",
            -	"description": "Pets operations"
            -}
            -
            -
            
            -name: pet
            -description: Pets operations
            -
            -

            Reference Object

            -

            A simple object to allow referencing other definitions in the specification. It can be used to reference parameters and responses that are defined at the top level for reuse.

            -

            The Reference Object is a JSON Reference that uses a JSON Pointer as its value. For this specification, only canonical dereferencing is supported.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringRequired. The reference string.
            -

            Reference Object Example

            -
            
            -{
            -	"$ref": "#/definitions/Pet"
            -}
            -
            -
            
            -$ref: '#/definitions/Pet'
            -
            -

            Relative Schema File Example

            -
            
            -{
            -  "$ref": "Pet.json"
            -}
            -
            -
            
            -$ref: 'Pet.yaml'
            -
            -

            Relative Files With Embedded Schema Example

            -
            
            -{
            -  "$ref": "definitions.json#/Pet"
            -}
            -
            -
            
            -$ref: 'definitions.yaml#/Pet'
            -
            -

            Schema Object

            -

            The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is based on the JSON Schema Specification Draft 4 and uses a predefined subset of it. On top of this subset, there are extensions provided by this specification to allow for more complete documentation.

            -

            Further information about the properties can be found in JSON Schema Core and JSON Schema Validation. Unless stated otherwise, the property definitions follow the JSON Schema specification as referenced here.

            -

            The following properties are taken directly from the JSON Schema definition and follow the same specifications:

            -
              -
            • $ref - As a JSON Reference
            • -
            • format (See Data Type Formats for further details)
            • -
            • title
            • -
            • description (GFM syntax can be used for rich text representation)
            • -
            • default (Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object)
            • -
            • multipleOf
            • -
            • maximum
            • -
            • exclusiveMaximum
            • -
            • minimum
            • -
            • exclusiveMinimum
            • -
            • maxLength
            • -
            • minLength
            • -
            • pattern
            • -
            • maxItems
            • -
            • minItems
            • -
            • uniqueItems
            • -
            • maxProperties
            • -
            • minProperties
            • -
            • required
            • -
            • enum
            • -
            • type
            • -
            -

            The following properties are taken from the JSON Schema definition but their definitions were adjusted to the Swagger Specification. Their definition is the same as the one from JSON Schema, only where the original definition references the JSON Schema definition, the Schema Object definition is used instead.

            -
              -
            • items
            • -
            • allOf
            • -
            • properties
            • -
            • additionalProperties
            • -
            -

            Other than the JSON Schema subset fields, the following fields may be used for further schema documentation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            discriminatorstringAdds support for polymorphism. The discriminator is the schema property name that is used to differentiate between other schema that inherit this schema. The property name used MUST be defined at this schema and it MUST be in the required property list. When used, the value MUST be the name of this schema or any schema that inherits it.
            readOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “read only”. This means that it MAY be sent as part of a response but MUST NOT be sent as part of the request. Properties marked as readOnly being true SHOULD NOT be in the required list of the defined schema. Default value is false.
            xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds Additional metadata to describe the XML representation format of this property.
            externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
            exampleAnyA free-form property to include an example of an instance for this schema.
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -
            Composition and Inheritance (Polymorphism)
            -

            Swagger allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. allOf takes in an array of object definitions that are validated independently but together compose a single object.

            -

            While composition offers model extensibility, it does not imply a hierarchy between the models. To support polymorphism, Swagger adds the support of the discriminator field. When used, the discriminator will be the name of the property used to decide which schema definition is used to validate the structure of the model. As such, the discriminator field MUST be a required field. The value of the chosen property has to be the friendly name given to the model under the definitions property. As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.

            -
            XML Modeling
            -

            The xml property allows extra definitions when translating the JSON definition to XML. The XML Object contains additional information about the available options.

            -

            Schema Object Examples

            -
            Primitive Sample
            -

            Unlike previous versions of Swagger, Schema definitions can be used to describe primitive and arrays as well.

            -
            
            -{
            -    "type": "string",
            -    "format": "email"
            -}
            -
            -
            
            -type: string
            -format: email
            -
            -
            Simple Model
            -
            
            -{
            -  "type": "object",
            -  "required": [
            -    "name"
            -  ],
            -  "properties": {
            -    "name": {
            -      "type": "string"
            -    },
            -    "address": {
            -      "$ref": "#/definitions/Address"
            -    },
            -    "age": {
            -      "type": "integer",
            -      "format": "int32",
            -      "minimum": 0
            -    }
            -  }
            -}
            -
            -
            
            -type: object
            -required:
            -- name
            -properties:
            -  name:
            -    type: string
            -  address:
            -    $ref: '#/definitions/Address'
            -  age:
            -    type: integer
            -    format: int32
            -    minimum: 0
            -
            -
            Model with Map/Dictionary Properties
            -

            For a simple string to string mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  type: string
            -
            -

            For a string to model mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "$ref": "#/definitions/ComplexModel"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  $ref: '#/definitions/ComplexModel'
            -
            -
            Model with Example
            -
            
            -{
            -  "type": "object",
            -  "properties": {
            -    "id": {
            -      "type": "integer",
            -      "format": "int64"
            -    },
            -    "name": {
            -      "type": "string"
            -    }
            -  },
            -  "required": [
            -    "name"
            -  ],
            -  "example": {
            -    "name": "Puma",
            -    "id": 1
            -  }
            -}
            -
            -
            
            -type: object
            -properties:
            -  id:
            -    type: integer
            -    format: int64
            -  name:
            -    type: string
            -required:
            -- name
            -example:
            -  name: Puma
            -  id: 1
            -
            -
            Models with Composition
            -
            
            -{
            -  "definitions": {
            -    "ErrorModel": {
            -      "type": "object",
            -      "required": [
            -        "message",
            -        "code"
            -      ],
            -      "properties": {
            -        "message": {
            -          "type": "string"
            -        },
            -        "code": {
            -          "type": "integer",
            -          "minimum": 100,
            -          "maximum": 600
            -        }
            -      }
            -    },
            -    "ExtendedErrorModel": {
            -      "allOf": [
            -        {
            -          "$ref": "#/definitions/ErrorModel"
            -        },
            -        {
            -          "type": "object",
            -          "required": [
            -            "rootCause"
            -          ],
            -          "properties": {
            -            "rootCause": {
            -              "type": "string"
            -            }
            -          }
            -        }
            -      ]
            -    }
            -  }
            -}
            -
            -
            
            -definitions:
            -  ErrorModel:
            -    type: object
            -    required:
            -    - message
            -    - code
            -    properties:
            -      message:
            -        type: string
            -      code:
            -        type: integer
            -        minimum: 100
            -        maximum: 600
            -  ExtendedErrorModel:
            -    allOf:
            -    - $ref: '#/definitions/ErrorModel'
            -    - type: object
            -      required:
            -      - rootCause
            -      properties:
            -        rootCause:
            -          type: string
            -
            -
            Models with Polymorphism Support
            -
            
            -{
            -  "definitions": {
            -    "Pet": {
            -      "type": "object",
            -      "discriminator": "petType",
            -      "properties": {
            -        "name": {
            -          "type": "string"
            -        },
            -        "petType": {
            -          "type": "string"
            -        }
            -      },
            -      "required": [
            -        "name",
            -        "petType"
            -      ]
            -    },
            -    "Cat": {
            -      "description": "A representation of a cat",
            -      "allOf": [
            -        {
            -          "$ref": "#/definitions/Pet"
            -        },
            -        {
            -          "type": "object",
            -          "properties": {
            -            "huntingSkill": {
            -              "type": "string",
            -              "description": "The measured skill for hunting",
            -              "default": "lazy",
            -              "enum": [
            -                "clueless",
            -                "lazy",
            -                "adventurous",
            -                "aggressive"
            -              ]
            -            }
            -          },
            -          "required": [
            -            "huntingSkill"
            -          ]
            -        }
            -      ]
            -    },
            -    "Dog": {
            -      "description": "A representation of a dog",
            -      "allOf": [
            -        {
            -          "$ref": "#/definitions/Pet"
            -        },
            -        {
            -          "type": "object",
            -          "properties": {
            -            "packSize": {
            -              "type": "integer",
            -              "format": "int32",
            -              "description": "the size of the pack the dog is from",
            -              "default": 0,
            -              "minimum": 0
            -            }
            -          },
            -          "required": [
            -            "packSize"
            -          ]
            -        }
            -      ]
            -    }
            -  }
            -}
            -
            -
            
            -definitions:
            -  Pet:
            -    type: object
            -    discriminator: petType
            -    properties:
            -      name:
            -        type: string
            -      petType:
            -        type: string
            -    required:
            -    - name
            -    - petType
            -  Cat:
            -    description: A representation of a cat
            -    allOf:
            -    - $ref: '#/definitions/Pet'
            -    - type: object
            -      properties:
            -        huntingSkill:
            -          type: string
            -          description: The measured skill for hunting
            -          default: lazy
            -          enum:
            -          - clueless
            -          - lazy
            -          - adventurous
            -          - aggressive
            -      required:
            -      - huntingSkill
            -  Dog:
            -    description: A representation of a dog
            -    allOf:
            -    - $ref: '#/definitions/Pet'
            -    - type: object
            -      properties:
            -        packSize:
            -          type: integer
            -          format: int32
            -          description: the size of the pack the dog is from
            -          default: 0
            -          minimum: 0
            -      required:
            -      - packSize
            -
            -

            XML Object

            -

            A metadata object that allows for more fine-tuned XML model definitions.

            -

            When using arrays, XML element names are not inferred (for singular/plural forms) and the name property should be used to add that information. See examples for expected behavior.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringReplaces the name of the element/attribute used for the described schema property. When defined within the Items Object (items), it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
            namespacestringThe URL of the namespace definition. Value SHOULD be in the form of a URL.
            prefixstringThe prefix to be used for the name.
            attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
            wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            XML Object Examples

            -

            The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

            -
            No XML Element
            -

            Basic string property:

            -
            
            -{
            -    "animals": {
            -        "type": "string"
            -    }
            -}
            -
            -
            
            -animals:
            -  type: string
            -
            -
            
            -<animals>...</animals>
            -
            -

            Basic string array property (wrapped is false by default):

            -
            
            -{
            -    "animals": {
            -        "type": "array",
            -        "items": {
            -            "type": "string"
            -        }
            -    }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -
            -
            
            -<animals>...</animals>
            -<animals>...</animals>
            -<animals>...</animals>
            -
            -
            XML Name Replacement
            -
            
            -{
            -  "animals": {
            -    "type": "string",
            -    "xml": {
            -      "name": "animal"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: string
            -  xml:
            -    name: animal
            -
            -
            
            -<animal>...</animal>
            -
            -
            XML Attribute, Prefix and Namespace
            -

            In this example, a full model definition is shown.

            -
            
            -{
            -  "Person": {
            -    "type": "object",
            -    "properties": {
            -      "id": {
            -        "type": "integer",
            -        "format": "int32",
            -        "xml": {
            -          "attribute": true
            -        }
            -      },
            -      "name": {
            -        "type": "string",
            -        "xml": {
            -          "namespace": "http://swagger.io/schema/sample",
            -          "prefix": "sample"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -Person:
            -  type: object
            -  properties:
            -    id:
            -      type: integer
            -      format: int32
            -      xml:
            -        attribute: true
            -    name:
            -      type: string
            -      xml:
            -        namespace: http://swagger.io/schema/sample
            -        prefix: sample
            -
            -
            
            -<Person id="123">
            -    <sample:name xmlns:sample="http://swagger.io/schema/sample">example</sample:name>
            -</Person>
            -
            -
            XML Arrays
            -

            Changing the element names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            The external name property has no effect on the XML:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            Even when the array is wrapped, if no name is explicitly defined, the same name will be used both internally and externally:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animals>value</animals>
            -  <animals>value</animals>
            -</animals>
            -
            -

            To overcome the above example, the following definition can be used:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</animals>
            -
            -

            Affecting both internal and external names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</aliens>
            -
            -

            If we change the external element but not the internal ones:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <aliens>value</aliens>
            -  <aliens>value</aliens>
            -</aliens>
            -
            -

            Definitions Object

            -

            An object to hold data types that can be consumed and produced by operations. These data types can be primitives, arrays or models.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}Schema ObjectA single definition, mapping a “name” to the schema it defines.
            -

            Definitions Object Example

            -
            
            -{
            -  "Category": {
            -    "type": "object",
            -    "properties": {
            -      "id": {
            -        "type": "integer",
            -        "format": "int64"
            -      },
            -      "name": {
            -        "type": "string"
            -      }
            -    }
            -  },
            -  "Tag": {
            -    "type": "object",
            -    "properties": {
            -      "id": {
            -        "type": "integer",
            -        "format": "int64"
            -      },
            -      "name": {
            -        "type": "string"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -Category:
            -  type: object
            -  properties:
            -    id:
            -      type: integer
            -      format: int64
            -    name:
            -      type: string
            -Tag:
            -  type: object
            -  properties:
            -    id:
            -      type: integer
            -      format: int64
            -    name:
            -      type: string
            -
            -

            Parameters Definitions Object

            -

            An object to hold parameters to be reused across operations. Parameter definitions can be referenced to the ones defined here.

            -

            This does not define global operation parameters.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}Parameter ObjectA single parameter definition, mapping a “name” to the parameter it defines.
            -

            Parameters Definition Object Example

            -
            
            -{
            -  "skipParam": {
            -    "name": "skip",
            -    "in": "query",
            -    "description": "number of items to skip",
            -    "required": true,
            -    "type": "integer",
            -    "format": "int32"
            -  },
            -  "limitParam": {
            -    "name": "limit",
            -    "in": "query",
            -    "description": "max records to return",
            -    "required": true,
            -    "type": "integer",
            -    "format": "int32"
            -  }
            -}
            -
            -
            
            -skipParam:
            -  name: skip
            -  in: query
            -  description: number of items to skip
            -  required: true
            -  type: integer
            -  format: int32
            -limitParam:
            -  name: limit
            -  in: query
            -  description: max records to return
            -  required: true
            -  type: integer
            -  format: int32
            -
            -

            Responses Definitions Object

            -

            An object to hold responses to be reused across operations. Response definitions can be referenced to the ones defined here.

            -

            This does not define global operation responses.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}Response ObjectA single response definition, mapping a “name” to the response it defines.
            -

            Responses Definitions Object Example

            -
            
            -{
            -  "NotFound": {
            -    "description": "Entity not found."
            -  },
            -  "IllegalInput": {
            -  	"description": "Illegal input for operation."
            -  },
            -  "GeneralError": {
            -  	"description": "General Error",
            -  	"schema": {
            -  		"$ref": "#/definitions/GeneralError"
            -  	}
            -  }
            -}
            -
            -
            
            -NotFound:
            -  description: Entity not found.
            -IllegalInput:
            -  description: Illegal input for operation.
            -GeneralError:
            -  description: General Error
            -  schema:
            -    $ref: '#/definitions/GeneralError'
            -
            -

            Security Definitions Object

            -

            A declaration of the security schemes available to be used in the specification. This does not enforce the security schemes on the operations and only serves to provide the relevant details for each scheme.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}Security Scheme ObjectA single security scheme definition, mapping a “name” to the scheme it defines.
            -

            Security Definitions Object Example

            -
            
            -{
            -  "api_key": {
            -    "type": "apiKey",
            -    "name": "api_key",
            -    "in": "header"
            -  },
            -  "petstore_auth": {
            -    "type": "oauth2",
            -    "authorizationUrl": "http://swagger.io/api/oauth/dialog",
            -    "flow": "implicit",
            -    "scopes": {
            -      "write:pets": "modify pets in your account",
            -      "read:pets": "read your pets"
            -    }
            -  }
            -}
            -
            -
            
            -api_key:
            -  type: apiKey
            -  name: api_key
            -  in: header
            -petstore_auth:
            -  type: oauth2
            -  authorizationUrl: http://swagger.io/api/oauth/dialog
            -  flow: implicit
            -  scopes:
            -    write:pets: modify pets in your account
            -    read:pets: read your pets
            -
            -

            Security Scheme Object

            -

            Allows the definition of a security scheme that can be used by the operations. Supported schemes are basic authentication, an API key (either as a header or as a query parameter) and OAuth2’s common flows (implicit, password, application and access code).

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeValidityDescription
            typestringAnyRequired. The type of the security scheme. Valid values are "basic", "apiKey" or "oauth2".
            descriptionstringAnyA short description for security scheme.
            namestringapiKeyRequired. The name of the header or query parameter to be used.
            instringapiKeyRequired The location of the API key. Valid values are "query" or "header".
            flowstringoauth2Required. The flow used by the OAuth2 security scheme. Valid values are "implicit", "password", "application" or "accessCode".
            authorizationUrlstringoauth2 ("implicit", "accessCode")Required. The authorization URL to be used for this flow. This SHOULD be in the form of a URL.
            tokenUrlstringoauth2 ("password", "application", "accessCode")Required. The token URL to be used for this flow. This SHOULD be in the form of a URL.
            scopesScopes Objectoauth2Required. The available scopes for the OAuth2 security scheme.
            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Security Scheme Object Example

            -
            Basic Authentication Sample
            -
            
            -{
            -  "type": "basic"
            -}
            -
            -
            
            -type: basic
            -
            -
            API Key Sample
            -
            
            -{
            -  "type": "apiKey",
            -  "name": "api_key",
            -  "in": "header"
            -}
            -
            -
            
            -type: apiKey
            -name: api_key
            -in: header
            -
            -
            Implicit OAuth2 Sample
            -
            
            -{
            -  "type": "oauth2",
            -  "authorizationUrl": "http://swagger.io/api/oauth/dialog",
            -  "flow": "implicit",
            -  "scopes": {
            -    "write:pets": "modify pets in your account",
            -    "read:pets": "read your pets"
            -  }
            -}
            -
            -
            
            -type: oauth2
            -authorizationUrl: http://swagger.io/api/oauth/dialog
            -flow: implicit
            -scopes:
            -  write:pets: modify pets in your account
            -  read:pets: read your pets
            -
            -

            Scopes Object

            -

            Lists the available scopes for an OAuth2 security scheme.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}stringMaps between a name of a scope to a short description of it (as the value of the property).
            -

            Patterned Objects

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the Swagger Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. See Vendor Extensions for further details.
            -

            Scopes Object Example

            -
            
            -{
            -  "write:pets": "modify pets in your account",
            -  "read:pets": "read your pets"
            -}
            -
            -
            
            -write:pets: modify pets in your account
            -read:pets: read your pets
            -
            -

            Security Requirement Object

            -

            Lists the required security schemes to execute this operation. The object can have multiple security schemes declared in it which are all required (that is, there is a logical AND between the schemes).

            -

            The name used for each property MUST correspond to a security scheme declared in the Security Definitions.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}[string]Each name must correspond to a security scheme which is declared in the Security Definitions. If the security scheme is of type "oauth2", then the value is a list of scope names required for the execution. For other security scheme types, the array MUST be empty.
            -

            Security Requirement Object Examples

            -
            Non-OAuth2 Security Requirement
            -
            
            -{
            -  "api_key": []
            -}
            -
            -
            
            -api_key: []
            -
            -
            OAuth2 Security Requirement
            -
            
            -{
            -  "petstore_auth": [
            -    "write:pets",
            -    "read:pets"
            -  ]
            -}
            -
            -
            
            -petstore_auth:
            -- write:pets
            -- read:pets
            -
            -

            Specification Extensions

            -

            While the Swagger Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

            -

            The extensions properties are always prefixed by "x-" and can have any valid JSON format value.

            -

            The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

            -

            Security Filtering

            -

            Some objects in the Swagger specification may be declared and remain empty, or completely be removed, even though they are inherently the core of the API documentation.

            -

            The reasoning behind it is to allow an additional layer of access control over the documentation itself. While not part of the specification itself, certain libraries may choose to allow access to parts of the documentation based on some form of authentication/authorization.

            -

            Two examples for this:

            -
              -
            1. The Paths Object may be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
            2. -
            3. The Path Item Object may be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the Paths Object so the user will not be aware of its existence. This allows the documentation provider a finer control over what the viewer can see.
            4. -
            - diff --git a/docs/oas/v3.0.0.html b/docs/oas/v3.0.0.html deleted file mode 100644 index 21858ba5e6..0000000000 --- a/docs/oas/v3.0.0.html +++ /dev/null @@ -1,4093 +0,0 @@ -OpenAPI Specification v3.0.0 | Introduction, Definitions, & More - - -

            OpenAPI Specification v3.0.0

            The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

            Status of This Document

            The source-of-truth for the specification is the GitHub markdown file referenced above.
            -

            OpenAPI Specification

            -

            Version 3.0.0

            -

            The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

            -

            This document is licensed under The Apache License, Version 2.0.

            -

            Introduction

            -

            The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

            -

            An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

            - -

            Definitions

            -

            OpenAPI Document

            -

            A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

            -

            Path Templating

            -

            Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

            -

            Media Types

            -

            Media type definitions are spread across several resources. -The media type definitions SHOULD be in compliance with [[!RFC6838]].

            -

            Some examples of possible media type definitions:

            -
            
            -  text/plain; charset=utf-8
            -  application/json
            -  application/vnd.github+json
            -  application/vnd.github.v3+json
            -  application/vnd.github.v3.raw+json
            -  application/vnd.github.v3.text+json
            -  application/vnd.github.v3.html+json
            -  application/vnd.github.v3.full+json
            -  application/vnd.github.v3.diff
            -  application/vnd.github.v3.patch
            -
            -

            HTTP Status Codes

            -

            The HTTP Status Codes are used to indicate the status of the executed operation. -The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

            -

            Specification

            -

            Versions

            -

            The OpenAPI Specification is versioned using Semantic Versioning 2.0.0 (semver) and follows the semver specification.

            -

            The major.minor portion of the semver (for example 3.0) SHALL designate the OAS feature set. Typically, .patch versions address errors in this document, not the feature set. Tooling which supports OAS 3.0 SHOULD be compatible with all OAS 3.0.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.0.0 and 3.0.1 for example.

            -

            Subsequent minor version releases of the OpenAPI Specification (incrementing the minor version number) SHOULD NOT interfere with tooling developed to a lower minor version and same major version. Thus a hypothetical 3.1.0 specification SHOULD be usable with tooling designed for 3.0.0.

            -

            An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the semantic version of the OAS that it uses. (OAS 2.0 documents contain a top-level version field named swagger and value "2.0".)

            -

            Format

            -

            An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

            -

            For example, if a field has an array value, the JSON array representation will be used:

            -
            
            -{
            -   "field": [ 1, 2, 3 ]
            -}
            -
            -

            All field names in the specification are case sensitive.

            -

            The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

            -

            Patterned fields MUST have unique names within the containing object.

            -

            In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

            - -

            Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

            -

            Document Structure

            -

            An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

            -

            It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

            -

            Data Types

            -

            Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. -Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. -null is not supported as a type (see nullable for an alternative solution). -Models are defined using the Schema Object, which is an extended subset of JSON Schema Specification Wright Draft 00.

            -

            Primitives have an optional modifier property: format. -OAS uses several known formats to define in fine detail the data type being used. -However, to support documentation needs, the format property is an open string-valued property, and can have any value. -Formats such as "email", "uuid", and so on, MAY be used even though undefined by this specification. -Types that are not accompanied by a format property follow the type definition in the JSON Schema. Tools that do not recognize a specific format MAY default back to the type alone, as if the format is not specified.

            -

            The formats defined by the OAS are:

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Common NametypeformatComments
            integerintegerint32signed 32 bits
            longintegerint64signed 64 bits
            floatnumberfloat
            doublenumberdouble
            stringstring
            bytestringbytebase64 encoded characters
            binarystringbinaryany sequence of octets
            booleanboolean
            datestringdateAs defined by full-date - [!RFC3339]
            dateTimestringdate-timeAs defined by date-time - [!RFC3339]
            passwordstringpasswordA hint to UIs to obscure input.
            -

            Rich Text Formatting

            -

            Throughout the specification description fields are noted as supporting CommonMark markdown formatting. -Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

            -

            Relative References in URLs

            -

            Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. -Relative references are resolved using the URLs defined in the Server Object as a Base URI.

            -

            Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

            -

            Schema

            -

            In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

            -

            OpenAPI Object

            -

            This is the root document object of the OpenAPI document.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            openapistringREQUIRED. This string MUST be the semantic version number of the OpenAPI Specification version that the OpenAPI document uses. The openapi field SHOULD be used by tooling specifications and clients to interpret the OpenAPI document. This is not related to the API info.version string.
            infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
            servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
            pathsPaths ObjectREQUIRED. The available paths and operations for the API.
            componentsComponents ObjectAn element to hold various schemas for the specification.
            security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition.
            tags[Tag Object]A list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
            externalDocsExternal Documentation ObjectAdditional external documentation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object

            -

            The object provides metadata about the API. -The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            titlestringREQUIRED. The title of the application.
            descriptionstringA short description of the application. CommonMark syntax MAY be used for rich text representation.
            termsOfServicestringA URL to the Terms of Service for the API. MUST be in the format of a URL.
            contactContact ObjectThe contact information for the exposed API.
            licenseLicense ObjectThe license information for the exposed API.
            versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object Example:

            -
            
            -{
            -  "title": "Sample Pet Store App",
            -  "description": "This is a sample server for a pet store.",
            -  "termsOfService": "http://example.com/terms/",
            -  "contact": {
            -    "name": "API Support",
            -    "url": "http://www.example.com/support",
            -    "email": "support@example.com"
            -  },
            -  "license": {
            -    "name": "Apache 2.0",
            -    "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
            -  },
            -  "version": "1.0.1"
            -}
            -
            -
            
            -title: Sample Pet Store App
            -description: This is a sample server for a pet store.
            -termsOfService: http://example.com/terms/
            -contact:
            -  name: API Support
            -  url: http://www.example.com/support
            -  email: support@example.com
            -license:
            -  name: Apache 2.0
            -  url: http://www.apache.org/licenses/LICENSE-2.0.html
            -version: 1.0.1
            -
            -

            Contact Object

            -

            Contact information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringThe identifying name of the contact person/organization.
            urlstringThe URL pointing to the contact information. MUST be in the format of a URL.
            emailstringThe email address of the contact person/organization. MUST be in the format of an email address.
            -

            This object MAY be extended with Specification Extensions.

            -

            Contact Object Example:

            -
            
            -{
            -  "name": "API Support",
            -  "url": "http://www.example.com/support",
            -  "email": "support@example.com"
            -}
            -
            -
            
            -name: API Support
            -url: http://www.example.com/support
            -email: support@example.com
            -
            -

            License Object

            -

            License information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The license name used for the API.
            urlstringA URL to the license used for the API. MUST be in the format of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            License Object Example:

            -
            
            -{
            -  "name": "Apache 2.0",
            -  "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
            -}
            -
            -
            
            -name: Apache 2.0
            -url: http://www.apache.org/licenses/LICENSE-2.0.html
            -
            -

            Server Object

            -

            An object representing a Server.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
            descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
            variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
            -

            This object MAY be extended with Specification Extensions.

            -

            Server Object Example

            -

            A single server would be described as:

            -
            
            -{
            -  "url": "https://development.gigantic-server.com/v1",
            -  "description": "Development server"
            -}
            -
            -
            
            -url: https://development.gigantic-server.com/v1
            -description: Development server
            -
            -

            The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://development.gigantic-server.com/v1",
            -      "description": "Development server"
            -    },
            -    {
            -      "url": "https://staging.gigantic-server.com/v1",
            -      "description": "Staging server"
            -    },
            -    {
            -      "url": "https://api.gigantic-server.com/v1",
            -      "description": "Production server"
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://development.gigantic-server.com/v1
            -  description: Development server
            -- url: https://staging.gigantic-server.com/v1
            -  description: Staging server
            -- url: https://api.gigantic-server.com/v1
            -  description: Production server
            -
            -

            The following shows how variables can be used for a server configuration:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
            -      "description": "The production API server",
            -      "variables": {
            -        "username": {
            -          "default": "demo",
            -          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
            -        },
            -        "port": {
            -          "enum": [
            -            "8443",
            -            "443"
            -          ],
            -          "default": "8443"
            -        },
            -        "basePath": {
            -          "default": "v2"
            -        }
            -      }
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://{username}.gigantic-server.com:{port}/{basePath}
            -  description: The production API server
            -  variables:
            -    username:
            -      # note! no enum here means it is an open value
            -      default: demo
            -      description: this value is assigned by the service provider, in this example `gigantic-server.com`
            -    port:
            -      enum:
            -        - '8443'
            -        - '443'
            -      default: '8443'
            -    basePath:
            -      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
            -      default: v2
            -
            -

            Server Variable Object

            -

            An object representing a Server Variable for server URL template substitution.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            enum[string]An enumeration of string values to be used if the substitution options are from a limited set.
            defaultstringREQUIRED. The default value to use for substitution, and to send, if an alternate value is not supplied. Unlike the Schema Object’s default, this value MUST be provided by the consumer.
            descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Components Object

            -

            Holds a set of reusable objects for different aspects of the OAS. -All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemasMap[string, Schema Object | Reference Object]An object to hold reusable Schema Objects.
            responsesMap[string, Response Object | Reference Object]An object to hold reusable Response Objects.
            parametersMap[string, Parameter Object | Reference Object]An object to hold reusable Parameter Objects.
            examplesMap[string, Example Object | Reference Object]An object to hold reusable Example Objects.
            requestBodiesMap[string, Request Body Object | Reference Object]An object to hold reusable Request Body Objects.
            headersMap[string, Header Object | Reference Object]An object to hold reusable Header Objects.
            securitySchemesMap[string, Security Scheme Object | Reference Object]An object to hold reusable Security Scheme Objects.
            linksMap[string, Link Object | Reference Object]An object to hold reusable Link Objects.
            callbacksMap[string, Callback Object | Reference Object]An object to hold reusable Callback Objects.
            -

            This object MAY be extended with Specification Extensions.

            -

            All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

            -

            Field Name Examples:

            -
            
            -User
            -User_1
            -User_Name
            -user-name
            -my.org.User
            -
            -

            Components Object Example

            -
            
            -"components": {
            -  "schemas": {
            -    "Category": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    },
            -    "Tag": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  },
            -  "parameters": {
            -    "skipParam": {
            -      "name": "skip",
            -      "in": "query",
            -      "description": "number of items to skip",
            -      "required": true,
            -      "schema": {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    },
            -    "limitParam": {
            -      "name": "limit",
            -      "in": "query",
            -      "description": "max records to return",
            -      "required": true,
            -      "schema" : {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    }
            -  },
            -  "responses": {
            -    "NotFound": {
            -      "description": "Entity not found."
            -    },
            -    "IllegalInput": {
            -      "description": "Illegal input for operation."
            -    },
            -    "GeneralError": {
            -      "description": "General Error",
            -      "content": {
            -        "application/json": {
            -          "schema": {
            -            "$ref": "#/components/schemas/GeneralError"
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "securitySchemes": {
            -    "api_key": {
            -      "type": "apiKey",
            -      "name": "api_key",
            -      "in": "header"
            -    },
            -    "petstore_auth": {
            -      "type": "oauth2",
            -      "flows": {
            -        "implicit": {
            -          "authorizationUrl": "http://example.org/api/oauth/dialog",
            -          "scopes": {
            -            "write:pets": "modify pets in your account",
            -            "read:pets": "read your pets"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    Category:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -    Tag:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -  parameters:
            -    skipParam:
            -      name: skip
            -      in: query
            -      description: number of items to skip
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -    limitParam:
            -      name: limit
            -      in: query
            -      description: max records to return
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -  responses:
            -    NotFound:
            -      description: Entity not found.
            -    IllegalInput:
            -      description: Illegal input for operation.
            -    GeneralError:
            -      description: General Error
            -      content:
            -        application/json:
            -          schema:
            -            $ref: '#/components/schemas/GeneralError'
            -  securitySchemes:
            -    api_key:
            -      type: apiKey
            -      name: api_key
            -      in: header
            -    petstore_auth:
            -      type: oauth2
            -      flows:
            -        implicit:
            -          authorizationUrl: http://example.org/api/oauth/dialog
            -          scopes:
            -            write:pets: modify pets in your account
            -            read:pets: read your pets
            -
            -

            Paths Object

            -

            Holds the relative paths to the individual endpoints and their operations. -The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a slash. The path is appended (no relative URL resolution) to the expanded URL from the Server Object’s url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Templating Matching

            -

            Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

            -
            
            -  /pets/{petId}
            -  /pets/mine
            -
            -

            The following paths are considered identical and invalid:

            -
            
            -  /pets/{petId}
            -  /pets/{name}
            -
            -

            The following may lead to ambiguous resolution:

            -
            
            -  /{entity}/me
            -  /books/{id}
            -
            -

            Paths Object Example

            -
            
            -{
            -  "/pets": {
            -    "get": {
            -      "description": "Returns all pets from the system that the user has access to",
            -      "responses": {
            -        "200": {         
            -          "description": "A list of pets.",
            -          "content": {
            -            "application/json": {
            -              "schema": {
            -                "type": "array",
            -                "items": {
            -                  "$ref": "#/components/schemas/pet"
            -                }
            -              }
            -            }
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -/pets:
            -  get:
            -    description: Returns all pets from the system that the user has access to
            -    responses:
            -      '200':
            -        description: A list of pets.
            -        content:
            -          application/json:
            -            schema:
            -              type: array
            -              items:
            -                $ref: '#/components/schemas/pet'
            -
            -

            Path Item Object

            -

            Describes the operations available on a single path. -A Path Item MAY be empty, due to ACL constraints. -The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringAllows for an external definition of this path item. The referenced structure MUST be in the format of a Path Item Object. If there are conflicts between the referenced definition and this Path Item’s definition, the behavior is undefined.
            summarystringAn optional, string summary, intended to apply to all operations in this path.
            descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
            getOperation ObjectA definition of a GET operation on this path.
            putOperation ObjectA definition of a PUT operation on this path.
            postOperation ObjectA definition of a POST operation on this path.
            deleteOperation ObjectA definition of a DELETE operation on this path.
            optionsOperation ObjectA definition of a OPTIONS operation on this path.
            headOperation ObjectA definition of a HEAD operation on this path.
            patchOperation ObjectA definition of a PATCH operation on this path.
            traceOperation ObjectA definition of a TRACE operation on this path.
            servers[Server Object]An alternative server array to service all operations in this path.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Item Object Example

            -
            
            -{
            -  "get": {
            -    "description": "Returns pets based on ID",
            -    "summary": "Find pets by ID",
            -    "operationId": "getPetsById",
            -    "responses": {
            -      "200": {
            -        "description": "pet response",
            -        "content": {
            -          "*/*": {
            -            "schema": {
            -              "type": "array",
            -              "items": {
            -                "$ref": "#/components/schemas/Pet"
            -              }
            -            }
            -          }
            -        }
            -      },
            -      "default": {
            -        "description": "error payload",
            -        "content": {
            -          "text/html": {
            -            "schema": {
            -              "$ref": "#/components/schemas/ErrorModel"
            -            }
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "parameters": [
            -    {
            -      "name": "id",
            -      "in": "path",
            -      "description": "ID of pet to use",
            -      "required": true,
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      },
            -      "style": "simple"
            -    }
            -  ]
            -}
            -
            -
            
            -get:
            -  description: Returns pets based on ID
            -  summary: Find pets by ID
            -  operationId: getPetsById
            -  responses:
            -    '200':
            -      description: pet response
            -      content:
            -        '*/*' :
            -          schema:
            -            type: array
            -            items:
            -              $ref: '#/components/schemas/Pet'
            -    default:
            -      description: error payload
            -      content:
            -        'text/html':
            -          schema:
            -            $ref: '#/components/schemas/ErrorModel'
            -parameters:
            -- name: id
            -  in: path
            -  description: ID of pet to use
            -  required: true
            -  schema:
            -    type: array
            -    style: simple
            -    items:
            -      type: string 
            -
            -

            Operation Object

            -

            Describes a single API operation on a path.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
            summarystringA short summary of what the operation does.
            descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
            operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            requestBodyRequest Body Object | Reference ObjectThe request body applicable for this operation. The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers.
            responsesResponses ObjectREQUIRED. The list of possible responses as they are returned from executing this operation.
            callbacksMap[string, Callback Object | Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses. The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.
            deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
            security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
            servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
            -

            This object MAY be extended with Specification Extensions.

            -

            Operation Object Example

            -
            
            -{
            -  "tags": [
            -    "pet"
            -  ],
            -  "summary": "Updates a pet in the store with form data",
            -  "operationId": "updatePetWithForm",
            -  "parameters": [
            -    {
            -      "name": "petId",
            -      "in": "path",
            -      "description": "ID of pet that needs to be updated",
            -      "required": true,
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  ],
            -  "requestBody": {
            -    "content": {
            -      "application/x-www-form-urlencoded": {
            -        "schema": {
            -          "type": "object",
            -           "properties": {
            -              "name": {
            -                "description": "Updated name of the pet",
            -                "type": "string"
            -              },
            -              "status": {
            -                "description": "Updated status of the pet",
            -                "type": "string"
            -             }
            -           },
            -        "required": ["status"]
            -        }
            -      }
            -    }
            -  },
            -  "responses": {
            -    "200": {
            -      "description": "Pet updated.",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    },
            -    "405": {
            -      "description": "Invalid input",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    }
            -  },
            -  "security": [
            -    {
            -      "petstore_auth": [
            -        "write:pets",
            -        "read:pets"
            -      ]
            -    }
            -  ]
            -}
            -
            -
            
            -tags:
            -- pet
            -summary: Updates a pet in the store with form data
            -operationId: updatePetWithForm
            -parameters:
            -- name: petId
            -  in: path
            -  description: ID of pet that needs to be updated
            -  required: true
            -  schema:
            -    type: string
            -requestBody:
            -  content:
            -    'application/x-www-form-urlencoded':
            -      schema:
            -       properties:
            -          name:
            -            description: Updated name of the pet
            -            type: string
            -          status:
            -            description: Updated status of the pet
            -            type: string
            -       required:
            -         - status
            -responses:
            -  '200':
            -    description: Pet updated.
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -  '405':
            -    description: Invalid input
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -security:
            -- petstore_auth:
            -  - write:pets
            -  - read:pets
            -
            -

            External Documentation Object

            -

            Allows referencing an external resource for extended documentation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA short description of the target documentation. CommonMark syntax MAY be used for rich text representation.
            urlstringREQUIRED. The URL for the target documentation. Value MUST be in the format of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            External Documentation Object Example

            -
            
            -{
            -  "description": "Find more info here",
            -  "url": "https://example.com"
            -}
            -
            -
            
            -description: Find more info here
            -url: https://example.com
            -
            -

            Parameter Object

            -

            Describes a single operation parameter.

            -

            A unique parameter is defined by a combination of a name and location.

            -

            Parameter Locations

            -

            There are four possible parameter locations specified by the in field:

            -
              -
            • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
            • -
            • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
            • -
            • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
            • -
            • cookie - Used to pass a specific cookie value to the API.
            • -
            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
            • If in is "path", the name field MUST correspond to the associated path segment from the path field in the Paths Object. See Path Templating for further information.
            • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
            • For all other cases, the name corresponds to the parameter name used by the in property.
            instringREQUIRED. The location of the parameter. Possible values are “query”, “header”, “path” or “cookie”.
            descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is “path”, this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
            deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage.
            allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored.
            -

            The rules for serialization of the parameter are specified in one of two ways. -For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
            explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
            schemaSchema Object | Reference ObjectThe schema defining the type used for the parameter.
            exampleAnyExample of the media type. The example SHOULD match the specified schema and encoding properties if present. The example object is mutually exclusive of the examples object. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
            examplesMap[ string, Example Object | Reference Object]Examples of the media type. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples object is mutually exclusive of the example object. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
            -

            For more complex scenarios, the content property can define the media type and schema of the parameter. -A parameter MUST contain either a schema property, or a content property, but not both. -When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
            -

            Style Values

            -

            In order to support common ways of serializing simple parameters, a set of style values are defined.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styletypeinComments
            matrixprimitive, array, objectpathPath-style parameters defined by [[!RFC6570]]
            labelprimitive, array, objectpathLabel style parameters defined by [[!RFC6570]]
            formprimitive, array, objectquery, cookieForm style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
            simplearraypath, headerSimple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0.
            spaceDelimitedarrayquerySpace separated array values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
            pipeDelimitedarrayqueryPipe separated array values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
            deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
            -

            Style Examples

            -

            Assume a parameter named color has one of the following values:

            -
            
            -   string -> "blue"
            -   array -> ["blue","black","brown"]
            -   object -> { "R": 100, "G": 200, "B": 150 }
            -
            -

            The following table shows examples of rendering differences for each value.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styleexplodeemptystringarrayobject
            matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
            matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
            labelfalse..blue.blue.black.brown.R.100.G.200.B.150
            labeltrue..blue.blue.black.brown.R=100.G=200.B=150
            formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
            formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
            simplefalsen/ablueblue,black,brownR,100,G,200,B,150
            simpletruen/ablueblue,black,brownR=100,G=200,B=150
            spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
            pipeDelimitedfalsen/an/ablue|black|brownR|100|G|200
            deepObjecttruen/an/an/acolor[R]=100&color[G]=200&color[B]=150
            -

            This object MAY be extended with Specification Extensions.

            -

            Parameter Object Examples

            -

            A header parameter with an array of 64 bit integer numbers:

            -
            
            -{
            -  "name": "token",
            -  "in": "header",
            -  "description": "token to be passed as a header",
            -  "required": true,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "integer",
            -      "format": "int64"
            -    }
            -  },
            -  "style": "simple"
            -}
            -
            -
            
            -name: token
            -in: header
            -description: token to be passed as a header
            -required: true
            -schema:
            -  type: array
            -  items:
            -    type: integer
            -    format: int64
            -style: simple
            -
            -

            A path parameter of a string value:

            -
            
            -{
            -  "name": "username",
            -  "in": "path",
            -  "description": "username to fetch",
            -  "required": true,
            -  "schema": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -name: username
            -in: path
            -description: username to fetch
            -required: true
            -schema:
            -  type: string
            -
            -

            An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

            -
            
            -{
            -  "name": "id",
            -  "in": "query",
            -  "description": "ID of the object to fetch",
            -  "required": false,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    }
            -  },
            -  "style": "form",
            -  "explode": true
            -}
            -
            -
            
            -name: id
            -in: query
            -description: ID of the object to fetch
            -required: false
            -schema:
            -  type: array
            -  items:
            -    type: string
            -style: form
            -explode: true
            -
            -

            A free-form query parameter, allowing undefined parameters of a specific type:

            -
            
            -{
            -  "in": "query",
            -  "name": "freeForm",
            -  "schema": {
            -    "type": "object",
            -    "additionalProperties": {
            -      "type": "integer"
            -    },
            -  },
            -  "style": "form"
            -}
            -
            -
            
            -in: query
            -name: freeForm
            -schema:
            -  type: object
            -  additionalProperties:
            -    type: integer
            -style: form
            -
            -

            A complex parameter using content to define serialization:

            -
            
            -{
            -  "in": "query",
            -  "name": "coordinates",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "object",
            -        "required": [
            -          "lat",
            -          "long"
            -        ],
            -        "properties": {
            -          "lat": {
            -            "type": "number"
            -          },
            -          "long": {
            -            "type": "number"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -in: query
            -name: coordinates
            -content:
            -  application/json:
            -    schema:
            -      type: object
            -      required:
            -        - lat
            -        - long
            -      properties:
            -        lat:
            -          type: number
            -        long:
            -          type: number
            -
            -

            Request Body Object

            -

            Describes a single request body.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            requiredbooleanDetermines if the request body is required in the request. Defaults to false.
            -

            This object MAY be extended with Specification Extensions.

            -

            Request Body Examples

            -

            A request body with a referenced model definition.

            -
            
            -{
            -  "description": "user to add to the system",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User Example",
            -            "externalValue": "http://foo.bar/examples/user-example.json"
            -          }
            -        }
            -    },
            -    "application/xml": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User example in XML",
            -            "externalValue": "http://foo.bar/examples/user-example.xml"
            -          }
            -        }
            -    },
            -    "text/plain": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in Plain text",
            -            "externalValue": "http://foo.bar/examples/user-example.txt"
            -        }
            -      }
            -    },
            -    "*/*": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in other format",
            -            "externalValue": "http://foo.bar/examples/user-example.whatever"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -content:
            -  'application/json':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User Example
            -        externalValue: 'http://foo.bar/examples/user-example.json'
            -  'application/xml':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User Example in XML
            -        externalValue: 'http://foo.bar/examples/user-example.xml'
            -  'text/plain':
            -    examples:
            -      user:
            -        summary: User example in text plain format
            -        externalValue: 'http://foo.bar/examples/user-example.txt'
            -  '*/*':
            -    examples:
            -      user:
            -        summary: User example in other format
            -        externalValue: 'http://foo.bar/examples/user-example.whatever'
            -
            -

            A body parameter that is an array of string values:

            -
            
            -{
            -  "description": "user to add to the system",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -required: true
            -content:
            -  text/plain:
            -    schema:
            -      type: array
            -      items:
            -        type: string
            -
            -

            Media Type Object

            -

            Each Media Type Object provides schema and examples for the media type identified by its key.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemaSchema Object | Reference ObjectThe schema defining the type used for the request body.
            exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example object is mutually exclusive of the examples object. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
            examplesMap[ string, Example Object | Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples object is mutually exclusive of the example object. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
            encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
            -

            This object MAY be extended with Specification Extensions.

            -

            Media Type Examples

            -
            
            -{
            -  "application/json": {
            -    "schema": {
            -         "$ref": "#/components/schemas/Pet"
            -    },
            -    "examples": {
            -      "cat" : {
            -        "summary": "An example of a cat",
            -        "value":
            -          {
            -            "name": "Fluffy",
            -            "petType": "Cat",
            -            "color": "White",
            -            "gender": "male",
            -            "breed": "Persian"
            -          }
            -      },
            -      "dog": {
            -        "summary": "An example of a dog with a cat's name",
            -        "value" :  {
            -          "name": "Puma",
            -          "petType": "Dog",
            -          "color": "Black",
            -          "gender": "Female",
            -          "breed": "Mixed"
            -        },
            -      "frog": {
            -          "$ref": "#/components/examples/frog-example"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -application/json:
            -  schema:
            -    $ref: "#/components/schemas/Pet"
            -  examples:
            -    cat:
            -      summary: An example of a cat
            -      value:
            -        name: Fluffy
            -        petType: Cat
            -        color: White
            -        gender: male
            -        breed: Persian
            -    dog:
            -      summary: An example of a dog with a cat's name
            -      value:
            -        name: Puma
            -        petType: Dog
            -        color: Black
            -        gender: Female
            -        breed: Mixed
            -    frog:
            -      $ref: "#/components/examples/frog-example"
            -
            -

            Considerations for File Uploads

            -

            In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type. Specifically:

            -
            
            -# content transferred with base64 encoding
            -schema:
            -  type: string
            -  format: base64
            -
            -
            
            -# content transferred in binary (octet-stream):
            -schema:
            -  type: string
            -  format: binary
            -
            -

            These examples apply to either input payloads of file uploads or response payloads.

            -

            A requestBody for submitting a file in a POST operation may look like the following example:

            -
            
            -requestBody:
            -  content:
            -    application/octet-stream:
            -      # any media type is accepted, functionally equivalent to `*/*`
            -      schema:
            -        # a binary file of any type
            -        type: string
            -        format: binary
            -
            -

            In addition, specific media types MAY be specified:

            -
            
            -# multiple, specific media types may be specified:
            -requestBody:
            -  content:
            -      # a binary file of type png or jpeg
            -    'image/jpeg':
            -      schema:
            -        type: string
            -        format: binary
            -    'image/png':
            -      schema:
            -        type: string
            -        format: binary       
            -
            -

            To upload multiple files, a multipart media type MUST be used:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        properties:
            -          # The property name 'file' will be used for all files.
            -          file:
            -            type: array
            -            items:
            -              type: string
            -              format: binary
            -
            -
            -

            Support for x-www-form-urlencoded Request Bodies

            -

            To submit content using form url encoding via [[!RFC1866]], the following -definition may be used:

            -
            
            -requestBody:
            -  content:
            -    application/x-www-form-urlencoded:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # complex types are stringified to support RFC 1866
            -            type: object
            -            properties: {}
            -
            -

            In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

            -

            When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object’s style property as form.

            -

            Special Considerations for multipart Content

            -

            It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

            -

            When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred — thus, the following default Content-Types are defined for multipart:

            -
              -
            • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
            • -
            • If the property is complex, or an array of complex values, the default Content-Type is application/json
            • -
            • If the property is a type: string with format: binary or format: base64 (aka a file object), the default Content-Type is application/octet-stream
            • -
            -

            Examples:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # default Content-Type for objects is `application/json`
            -            type: object
            -            properties: {}
            -          profileImage:
            -            # default Content-Type for string/binary is `application/octet-stream`
            -            type: string
            -            format: binary
            -          children:
            -            # default Content-Type for arrays is based on the `inner` type (text/plain here)
            -            type: array
            -            items:
            -              type: string
            -          addresses:
            -            # default Content-Type for arrays is based on the `inner` type (object shown, so `application/json` in this example)
            -            type: array
            -            items:
            -              type: '#/components/schemas/Address'
            -
            -

            An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

            -

            Encoding Object

            -

            A single encoding definition applied to a single schema property.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for string with format being binaryapplication/octet-stream; for other primitive types – text/plain; for object - application/json; for array – the default is defined based on the inner type. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
            headersMap[string, Header Object | Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
            stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            -

            This object MAY be extended with Specification Extensions.

            -

            Encoding Object Example

            -
            
            -requestBody:
            -  content:
            -    multipart/mixed:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            # default is text/plain
            -            type: string
            -            format: uuid
            -          address:
            -            # default is application/json
            -            type: object
            -            properties: {}
            -          historyMetadata:
            -            # need to declare XML format!
            -            description: metadata in XML format
            -            type: object
            -            properties: {}
            -          profileImage:
            -            # default is application/octet-stream, need to declare an image type only!
            -            type: string
            -            format: binary
            -      encoding:
            -        historyMetadata:
            -          # require XML Content-Type in utf-8 encoding
            -          contentType: application/xml; charset=utf-8
            -        profileImage:
            -          # only accept png/jpeg
            -          contentType: image/png, image/jpeg
            -          headers:
            -            X-Rate-Limit-Limit:
            -              description: The number of allowed requests in the current period
            -              schema:
            -                type: integer
            -
            -

            Responses Object

            -

            A container for the expected responses of an operation. -The container maps a HTTP response code to the expected response.

            -

            The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. -However, documentation is expected to cover a successful operation response and any known errors.

            -

            The default MAY be used as a default response object for all HTTP codes -that are not covered individually by the specification.

            -

            The Responses Object MUST contain at least one response code, and it -SHOULD be the response for a successful operation call.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            defaultResponse Object | Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses. A Reference Object can link to a response that the OpenAPI Object’s components/responses section defines.
            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            HTTP Status CodeResponse Object | Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. A Reference Object can link to a response that is defined in the OpenAPI Object’s components/responses section. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. The following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response range is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
            -

            This object MAY be extended with Specification Extensions.

            -

            Responses Object Example

            -

            A 200 response for a successful operation and a default response for others (implying an error):

            -
            
            -{
            -  "200": {
            -    "description": "a pet to be returned",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/Pet"
            -        }
            -      }
            -    }
            -  },
            -  "default": {
            -    "description": "Unexpected error",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/ErrorModel"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -'200':
            -  description: a pet to be returned
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/Pet'
            -default:
            -  description: Unexpected error
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/ErrorModel'
            -
            -

            Response Object

            -

            Describes a single response from an API Operation, including design-time, static -links to operations based on the response.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringREQUIRED. A short description of the response. CommonMark syntax MAY be used for rich text representation.
            headersMap[string, Header Object | Reference Object]Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
            contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            linksMap[string, Link Object | Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
            -

            This object MAY be extended with Specification Extensions.

            -

            Response Object Examples

            -

            Response of an array of a complex type:

            -
            
            -{
            -  "description": "A complex object array response",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "$ref": "#/components/schemas/VeryComplexType"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A complex object array response
            -content:
            -  application/json:
            -    schema:
            -      type: array
            -      items:
            -        $ref: '#/components/schemas/VeryComplexType'
            -
            -

            Response with a string type:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  }
            -
            -}
            -
            -
            
            -description: A simple string response
            -representations:
            -  text/plain:
            -    schema:
            -      type: string
            -
            -

            Plain text response with headers:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  },
            -  "headers": {
            -    "X-Rate-Limit-Limit": {
            -      "description": "The number of allowed requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Remaining": {
            -      "description": "The number of remaining requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Reset": {
            -      "description": "The number of seconds left in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A simple string response
            -content:
            -  text/plain:
            -    schema:
            -      type: string
            -    example: 'whoa!'
            -headers:
            -  X-Rate-Limit-Limit:
            -    description: The number of allowed requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Remaining:
            -    description: The number of remaining requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Reset:
            -    description: The number of seconds left in the current period
            -    schema:
            -      type: integer
            -
            -

            Response with no return value:

            -
            
            -{
            -  "description": "object created"
            -}
            -
            -
            
            -description: object created
            -
            -

            Callback Object

            -

            A map of possible out-of band callbacks related to the parent operation. -Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. -The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {expression}Path Item ObjectA Path Item Object used to define a callback request and expected responses. A complete example is available.
            -

            This object MAY be extended with Specification Extensions.

            -

            Key Expression

            -

            The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. -A simple example might be $request.body#/url. -However, using a runtime expression the complete HTTP message can be accessed. -This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

            -

            For example, given the following HTTP request:

            -
            
            -POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
            -Host: example.org
            -Content-Type: application/json
            -Content-Length: 187
            -
            -{
            -  "failedUrl" : "http://clientdomain.com/failed",
            -  "successUrls" : [
            -    "http://clientdomain.com/fast",
            -    "http://clientdomain.com/medium",
            -    "http://clientdomain.com/slow"
            -  ]
            -}
            -
            -201 Created
            -Location: http://example.org/subscription/1
            -
            -

            The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            ExpressionValue
            $urlhttp://example.org/subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning
            $methodPOST
            $request.path.eventTypemyevent
            $request.query.queryUrlhttp://clientdomain.com/stillrunning
            $request.header.content-Typeapplication/json
            $request.body#/failedUrlhttp://clientdomain.com/stillrunning
            $request.body#/successUrls/2http://clientdomain.com/medium
            $response.header.Locationhttp://example.org/subscription/1
            -

            Callback Object Example

            -

            The following example shows a callback to the URL specified by the id and email property in the request body.

            -
            
            -myWebhook:
            -  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
            -    post:
            -      requestBody:
            -        description: Callback payload
            -        content:
            -          'application/json':
            -            schema:
            -              $ref: '#/components/schemas/SomePayload'
            -      responses:
            -        '200':
            -          description: webhook successfully processed and no retries will be performed
            -
            -

            Example Object

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            summarystringShort description for the example.
            descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
            valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
            externalValuestringA URL that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive.
            -

            This object MAY be extended with Specification Extensions.

            -

            In all cases, the example value is expected to be compatible with the type schema -of its associated value. Tooling implementations MAY choose to -validate compatibility automatically, and reject the example value(s) if incompatible.

            -

            Example Object Example

            -
            
            -# in a model
            -schemas:
            -  properties:
            -    name:
            -      type: string
            -      examples:
            -        name:
            -          $ref: http://example.org/petapi-examples/openapi.json#/components/examples/name-example
            -
            -# in a request body:
            -  requestBody:
            -    content:
            -      'application/json':
            -        schema:
            -          $ref: '#/components/schemas/Address'
            -        examples:
            -          foo:
            -            summary: A foo example
            -            value: {"foo": "bar"}
            -          bar:
            -            summary: A bar example
            -            value: {"bar": "baz"}
            -      'application/xml':
            -        examples:
            -          xmlExample:
            -            summary: This is an example in XML
            -            externalValue: 'http://example.org/examples/address-example.xml'
            -      'text/plain':
            -        examples:
            -          textExample:
            -            summary: This is a text example
            -            externalValue: 'http://foo.bar/examples/address-example.txt'
            -
            -
            -# in a parameter
            -  parameters:
            -    - name: 'zipCode'
            -      in: 'query'
            -      schema:
            -        type: 'string'
            -        format: 'zip-code'
            -        examples:
            -          zip-example:
            -            $ref: '#/components/examples/zip-example'
            -
            -# in a response
            -  responses:
            -    '200':
            -      description: your car appointment has been booked
            -      content:
            -        application/json:
            -          schema:
            -            $ref: '#/components/schemas/SuccessResponse'
            -          examples:
            -            confirmation-success:
            -              $ref: '#/components/examples/confirmation-success'
            -
            -

            Link Object

            -

            The Link object represents a possible design-time link for a response. -The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

            -

            Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

            -

            For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            operationRefstringA relative or absolute reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition.
            operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
            parametersMap[string, Any | {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
            requestBodyAny | {expression}A literal value or {expression} to use as a request body when calling the target operation.
            descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
            serverServer ObjectA server object to be used by the target operation.
            -

            This object MAY be extended with Specification Extensions.

            -

            A linked operation MUST be identified using either an operationRef or operationId. -In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. -Because of the potential for name clashes, the operationRef syntax is preferred -for specifications with external references.

            -

            Examples

            -

            Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

            -
            
            -paths:
            -  /users/{id}:
            -    parameters:
            -    - name: id
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -    get:
            -      responses:
            -        '200':
            -          description: the user being returned
            -          content:
            -            application/json:
            -              schema:
            -                type: object
            -                properties:
            -                  uuid: # the unique user id
            -                    type: string
            -                    format: uuid
            -        links:
            -          address:
            -            # the target link operationId
            -            operationId: getUserAddress
            -            parameters:
            -              # get the `id` field from the request path parameter named `id`
            -              userId: $request.path.id
            -  # the path item of the linked operation
            -  /users/{userid}/address:
            -    parameters:
            -    - name: userid
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -      # linked operation
            -      get:
            -        operationId: getUserAddress
            -        responses:
            -          '200':
            -            description: the user's address
            -
            -

            When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

            -

            Values from the response body can be used to drive a linked operation.

            -
            
            -links:
            -  address:
            -    operationId: getUserAddressByUUID
            -    parameters:
            -      # get the `id` field from the request path parameter named `id`
            -      userUuid: $response.body#/uuid
            -
            -

            Clients follow all links at their discretion. -Neither permissions, nor the capability to make a successful call to that link, is guaranteed -solely by the existence of a relationship.

            -

            OperationRef Examples

            -

            As references to operationId MAY NOT be possible (the operationId is an optional -value), references MAY also be made through a relative operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            or an absolute operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            Note that in the use of operationRef, the escaped forward-slash is necessary when -using JSON references.

            -

            Runtime Expressions

            -

            Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. -This mechanism is used by Link Objects and Callback Objects.

            -

            The runtime expression is defined by the following ABNF syntax

            -
            
            -      expression = ( "$url" | "$method" | "$statusCode" | "$request." source | "$response." source )
            -      source = ( header-reference | query-reference | path-reference | body-reference ) 
            -      header-reference = "header." token
            -      query-reference = "query." name 
            -      path-reference = "path." name
            -      body-reference = "body" ["#" fragment]
            -      fragment = a JSON Pointer [RFC 6901](https://tools.ietf.org/html/rfc6901) 
            -      name = *( char )
            -      char = as per RFC [7159](https://tools.ietf.org/html/rfc7159#section-7)
            -      token = as per RFC [7230](https://tools.ietf.org/html/rfc7230#section-3.2.6)
            -
            -

            The name identifier is case-sensitive, whereas token is not.

            -

            The table below provides examples of runtime expressions and examples of their use in a value:

            -

            Examples

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Source Locationexample expressionnotes
            HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
            Requested media type$request.header.accept
            Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
            Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
            Request URL$url
            Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
            Response header$response.header.ServerSingle header values only are available
            -

            Runtime expressions preserve the type of the referenced value. -Expressions can be embedded into string values by surrounding the expression with {} curly braces.

            -

            Header Object

            -

            The Header Object follows the structure of the Parameter Object with the following changes:

            -
              -
            1. name MUST NOT be specified, it is given in the corresponding headers map.
            2. -
            3. in MUST NOT be specified, it is implicitly in header.
            4. -
            5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
            6. -
            -

            Header Object Example

            -

            A simple header of type integer:

            -
            
            -{
            -  "description": "The number of allowed requests in the current period",
            -  "schema": {
            -    "type": "integer"
            -  }
            -}
            -
            -
            
            -description: The number of allowed requests in the current period
            -schema:
            -  type: integer
            -
            -

            Tag Object

            -

            Adds metadata to a single tag that is used by the Operation Object. -It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the tag.
            descriptionstringA short description for the tag. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
            -

            This object MAY be extended with Specification Extensions.

            -

            Tag Object Example

            -
            
            -{
            -	"name": "pet",
            -	"description": "Pets operations"
            -}
            -
            -
            
            -name: pet
            -description: Pets operations
            -
            -

            Examples Object

            -

            In an example, a JSON Reference MAY be used, with the -explicit restriction that examples having a JSON format with object named -$ref are not allowed. Therefore, that example, structurally, can be -either a string primitive or an object, similar to additionalProperties.

            -

            In all cases, the payload is expected to be compatible with the type schema -for the associated value. Tooling implementations MAY choose to -validate compatibility automatically, and reject the example value(s) if they -are incompatible.

            -
            
            -# in a model
            -schemas:
            -  properties:
            -    name:
            -      type: string
            -      example:
            -        $ref: http://foo.bar#/examples/name-example
            -
            -# in a request body, note the plural `examples`
            -  requestBody:
            -    content:
            -      'application/json':
            -        schema:
            -          $ref: '#/components/schemas/Address'
            -        examples:
            -          foo:
            -            value: {"foo": "bar"}
            -          bar:
            -            value: {"bar": "baz"}
            -      'application/xml':
            -        examples:
            -          xml:
            -            externalValue: 'http://foo.bar/examples/address-example.xml'
            -      'text/plain':
            -        examples:
            -          text:
            -            externalValue: 'http://foo.bar/examples/address-example.txt'
            -       
            -# in a parameter
            -  parameters:
            -    - name: 'zipCode'
            -      in: 'query'
            -      schema:
            -        type: 'string'
            -        format: 'zip-code'
            -        example:
            -          $ref: 'http://foo.bar#/examples/zip-example'
            -
            -# in a response, note the singular `example`:
            -  responses:
            -    '200':
            -      description: your car appointment has been booked
            -      content:
            -        application/json:
            -          schema:
            -            $ref: '#/components/schemas/SuccessResponse'
            -          example:
            -            $ref: http://foo.bar#/examples/address-example.json
            -
            -

            Reference Object

            -

            A simple object to allow referencing other components in the specification, internally and externally.

            -

            The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

            -

            For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringREQUIRED. The reference string.
            -

            This object cannot be extended with additional properties and any properties added SHALL be ignored.

            -

            Reference Object Example

            -
            
            -{
            -	"$ref": "#/components/schemas/Pet"
            -}
            -
            -
            
            -$ref: '#/components/schemas/Pet'
            -
            -

            Relative Schema Document Example

            -
            
            -{
            -  "$ref": "Pet.json"
            -}
            -
            -
            
            -$ref: Pet.yaml
            -
            -

            Relative Documents With Embedded Schema Example

            -
            
            -{
            -  "$ref": "definitions.json#/Pet"
            -}
            -
            -
            
            -$ref: definitions.yaml#/Pet
            -
            -

            Schema Object

            -

            The Schema Object allows the definition of input and output data types. -These types can be objects, but also primitives and arrays. -This object is an extended subset of the JSON Schema Specification Wright Draft 00.

            -

            For more information about the properties, see JSON Schema Core and JSON Schema Validation. -Unless stated otherwise, the property definitions follow the JSON Schema.

            -

            Properties

            -

            The following properties are taken directly from the JSON Schema definition and follow the same specifications:

            -
              -
            • title
            • -
            • multipleOf
            • -
            • maximum
            • -
            • exclusiveMaximum
            • -
            • minimum
            • -
            • exclusiveMinimum
            • -
            • maxLength
            • -
            • minLength
            • -
            • pattern (This string SHOULD be a valid regular expression, according to the ECMA 262 regular expression dialect)
            • -
            • maxItems
            • -
            • minItems
            • -
            • uniqueItems
            • -
            • maxProperties
            • -
            • minProperties
            • -
            • required
            • -
            • enum
            • -
            -

            The following properties are taken from the JSON Schema definition but their definitions were adjusted to the OpenAPI Specification.

            -
              -
            • type - Value MUST be a string. Multiple types via an array are not supported.
            • -
            • allOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • oneOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • anyOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • not - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • items - Value MUST be an object and not an array. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. items MUST be present if the type is array.
            • -
            • properties - Property definitions MUST be a Schema Object and not a standard JSON Schema (inline or referenced).
            • -
            • additionalProperties - Value can be boolean or object. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • description - CommonMark syntax MAY be used for rich text representation.
            • -
            • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
            • -
            • default - The default value represents what would be assumed by the consumer of the input as the value of the schema if one is not provided. Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object defined at the same level. For example, if type is string, then default can be "foo" but cannot be 1.
            • -
            -

            Alternatively, any time a Schema Object can be used, a Reference Object can be used in its place. This allows referencing definitions instead of defining them inline.

            -

            Additional properties defined by the JSON Schema specification that are not mentioned here are strictly unsupported.

            -

            Other than the JSON Schema subset fields, the following fields MAY be used for further schema documentation:

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            nullablebooleanAllows sending a null value for the defined schema. Default value is false.
            discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
            readOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “read only”. This means that it MAY be sent as part of a response but SHOULD NOT be sent as part of the request. If the property is marked as readOnly being true and is in the required list, the required will take effect on the response only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
            writeOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “write only”. Therefore, it MAY be sent as part of a request but SHOULD NOT be sent as part of the response. If the property is marked as writeOnly being true and is in the required list, the required will take effect on the request only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
            xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
            externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
            exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.
            deprecatedbooleanSpecifies that a schema is deprecated and SHOULD be transitioned out of usage. Default value is false.
            -

            This object MAY be extended with Specification Extensions.

            -
            Composition and Inheritance (Polymorphism)
            -

            The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. -allOf takes an array of object definitions that are validated independently but together compose a single object.

            -

            While composition offers model extensibility, it does not imply a hierarchy between the models. -To support polymorphism, the OpenAPI Specification adds the discriminator field. -When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. -As such, the discriminator field MUST be a required field. -There are are two ways to define the value of a discriminator for an inheriting instance.

            -
              -
            • Use the schema name.
            • -
            • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. -As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
            • -
            -
            XML Modeling
            -

            The xml property allows extra definitions when translating the JSON definition to XML. -The XML Object contains additional information about the available options.

            -

            Schema Object Examples

            -
            Primitive Sample
            -
            
            -{
            -  "type": "string",
            -  "format": "email"
            -}
            -
            -
            
            -type: string
            -format: email
            -
            -
            Simple Model
            -
            
            -{
            -  "type": "object",
            -  "required": [
            -    "name"
            -  ],
            -  "properties": {
            -    "name": {
            -      "type": "string"
            -    },
            -    "address": {
            -      "$ref": "#/components/schemas/Address"
            -    },
            -    "age": {
            -      "type": "integer",
            -      "format": "int32",
            -      "minimum": 0
            -    }
            -  }
            -}
            -
            -
            
            -type: object
            -required:
            -- name
            -properties:
            -  name:
            -    type: string
            -  address:
            -    $ref: '#/components/schemas/Address'
            -  age:
            -    type: integer
            -    format: int32
            -    minimum: 0
            -
            -
            Model with Map/Dictionary Properties
            -

            For a simple string to string mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  type: string
            -
            -

            For a string to model mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "$ref": "#/components/schemas/ComplexModel"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  $ref: '#/components/schemas/ComplexModel'
            -
            -
            Model with Example
            -
            
            -{
            -  "type": "object",
            -  "properties": {
            -    "id": {
            -      "type": "integer",
            -      "format": "int64"
            -    },
            -    "name": {
            -      "type": "string"
            -    }
            -  },
            -  "required": [
            -    "name"
            -  ],
            -  "example": {
            -    "name": "Puma",
            -    "id": 1
            -  }
            -}
            -
            -
            
            -type: object
            -properties:
            -  id:
            -    type: integer
            -    format: int64
            -  name:
            -    type: string
            -required:
            -- name
            -example:
            -  name: Puma
            -  id: 1
            -
            -
            Models with Composition
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "ErrorModel": {
            -        "type": "object",
            -        "required": [
            -          "message",
            -          "code"
            -        ],
            -        "properties": {
            -          "message": {
            -            "type": "string"
            -          },
            -          "code": {
            -            "type": "integer",
            -            "minimum": 100,
            -            "maximum": 600
            -          }
            -        }
            -      },
            -      "ExtendedErrorModel": {
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/ErrorModel"
            -          },
            -          {
            -            "type": "object",
            -            "required": [
            -              "rootCause"
            -            ],
            -            "properties": {
            -              "rootCause": {
            -                "type": "string"
            -              }
            -            }
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    ErrorModel:
            -      type: object
            -      required:
            -      - message
            -      - code
            -      properties:
            -        message:
            -          type: string
            -        code:
            -          type: integer
            -          minimum: 100
            -          maximum: 600
            -    ExtendedErrorModel:
            -      allOf:
            -      - $ref: '#/components/schemas/ErrorModel'
            -      - type: object
            -        required:
            -        - rootCause
            -        properties:
            -          rootCause:
            -            type: string
            -
            -
            Models with Polymorphism Support
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "Pet": {
            -        "type": "object",
            -        "discriminator": {
            -          "propertyName": "petType"
            -        },
            -        "properties": {
            -          "name": {
            -            "type": "string"
            -          },
            -          "petType": {
            -            "type": "string"
            -          }
            -        },
            -        "required": [
            -          "name",
            -          "petType"
            -        ]
            -      },
            -      "Cat": {
            -        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "huntingSkill": {
            -                "type": "string",
            -                "description": "The measured skill for hunting",
            -                "default": "lazy",
            -                "enum": [
            -                  "clueless",
            -                  "lazy",
            -                  "adventurous",
            -                  "aggressive"
            -                ]
            -              }
            -            },
            -            "required": [
            -              "huntingSkill"
            -            ]
            -          }
            -        ]
            -      },
            -      "Dog": {
            -        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "packSize": {
            -                "type": "integer",
            -                "format": "int32",
            -                "description": "the size of the pack the dog is from",
            -                "default": 0,
            -                "minimum": 0
            -              }
            -            },
            -            "required": [
            -              "packSize"
            -            ]
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      discriminator:
            -        propertyName: petType
            -      properties:
            -        name:
            -          type: string
            -        petType:
            -          type: string
            -      required:
            -      - name
            -      - petType
            -    Cat:  ## "Cat" will be used as the discriminator value
            -      description: A representation of a cat
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          huntingSkill:
            -            type: string
            -            description: The measured skill for hunting
            -            enum:
            -            - clueless
            -            - lazy
            -            - adventurous
            -            - aggressive
            -        required:
            -        - huntingSkill
            -    Dog:  ## "Dog" will be used as the discriminator value
            -      description: A representation of a dog
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          packSize:
            -            type: integer
            -            format: int32
            -            description: the size of the pack the dog is from
            -            default: 0
            -            minimum: 0
            -        required:
            -        - packSize
            -
            -

            Discriminator Object

            -

            When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

            -

            When using the discriminator, inline schemas will not be considered.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
            mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
            -

            The discriminator attribute is legal only when using one of the composite keywords oneOf, anyOf, allOf.

            -

            In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -
            -

            which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  discriminator:
            -    propertyName: pet_type
            -
            -

            The expectation now is that a property with name pet_type MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

            -
            
            -{
            -  "id": 12345,
            -  "pet_type": "Cat"
            -}
            -
            -

            Will indicate that the Cat schema be used in conjunction with this payload.

            -

            In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -  discriminator:
            -    propertyName: pet_type
            -    mapping:
            -      dog: '#/components/schemas/Dog'
            -      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -
            -

            Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

            -

            When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

            -

            In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

            -

            For example:

            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      required:
            -      - pet_type
            -      properties:
            -        pet_type:
            -          type: string
            -      discriminator:
            -        propertyName: pet_type
            -        mapping:
            -          cachorro: Dog
            -    Cat:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Cat`
            -        properties:
            -          name:
            -            type: string
            -    Dog:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Dog`
            -        properties:
            -          bark:
            -            type: string
            -    Lizard:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Lizard`
            -        properties:
            -          lovesRocks:
            -            type: boolean
            -
            -

            a payload like this:

            -
            
            -{
            -  "pet_type": "Cat",
            -  "name": "misty"
            -}
            -
            -

            will indicate that the Cat schema be used. Likewise this schema:

            -
            
            -{
            -  "pet_type": "cachorro",
            -  "bark": "soft"
            -}
            -
            -

            will map to Dog because of the definition in the mappings element.

            -

            XML Object

            -

            A metadata object that allows for more fine-tuned XML model definitions.

            -

            When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. -See examples for expected behavior.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
            namespacestringThe URI of the namespace definition. Value MUST be in the form of an absolute URI.
            prefixstringThe prefix to be used for the name.
            attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
            wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
            -

            This object MAY be extended with Specification Extensions.

            -

            XML Object Examples

            -

            The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

            -
            No XML Element
            -

            Basic string property:

            -
            
            -{
            -    "animals": {
            -        "type": "string"
            -    }
            -}
            -
            -
            
            -animals:
            -  type: string
            -
            -
            
            -<animals>...</animals>
            -
            -

            Basic string array property (wrapped is false by default):

            -
            
            -{
            -    "animals": {
            -        "type": "array",
            -        "items": {
            -            "type": "string"
            -        }
            -    }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -
            -
            
            -<animals>...</animals>
            -<animals>...</animals>
            -<animals>...</animals>
            -
            -
            XML Name Replacement
            -
            
            -{
            -  "animals": {
            -    "type": "string",
            -    "xml": {
            -      "name": "animal"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: string
            -  xml:
            -    name: animal
            -
            -
            
            -<animal>...</animal>
            -
            -
            XML Attribute, Prefix and Namespace
            -

            In this example, a full model definition is shown.

            -
            
            -{
            -  "Person": {
            -    "type": "object",
            -    "properties": {
            -      "id": {
            -        "type": "integer",
            -        "format": "int32",
            -        "xml": {
            -          "attribute": true
            -        }
            -      },
            -      "name": {
            -        "type": "string",
            -        "xml": {
            -          "namespace": "http://example.com/schema/sample",
            -          "prefix": "sample"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -Person:
            -  type: object
            -  properties:
            -    id:
            -      type: integer
            -      format: int32
            -      xml:
            -        attribute: true
            -    name:
            -      type: string
            -      xml:
            -        namespace: http://example.com/schema/sample
            -        prefix: sample
            -
            -
            
            -<Person id="123">
            -    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
            -</Person>
            -
            -
            XML Arrays
            -

            Changing the element names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            The external name property has no effect on the XML:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animals>value</animals>
            -  <animals>value</animals>
            -</animals>
            -
            -

            To overcome the naming problem in the example above, the following definition can be used:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</animals>
            -
            -

            Affecting both internal and external names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</aliens>
            -
            -

            If we change the external element but not the internal ones:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <aliens>value</aliens>
            -  <aliens>value</aliens>
            -</aliens>
            -
            -

            Security Scheme Object

            -

            Defines a security scheme that can be used by the operations. -Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "oauth2", "openIdConnect".
            descriptionstringAnyA short description for security scheme. CommonMark syntax MAY be used for rich text representation.
            namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
            instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
            schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]].
            bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
            flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
            openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            Security Scheme Object Example

            -
            Basic Authentication Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "basic"
            -}
            -
            -
            
            -type: http
            -scheme: basic
            -
            -
            API Key Sample
            -
            
            -{
            -  "type": "apiKey",
            -  "name": "api_key",
            -  "in": "header"
            -}
            -
            -
            
            -type: apiKey
            -name: api_key
            -in: header
            -
            -
            JWT Bearer Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "bearer",
            -  "bearerFormat": "JWT",
            -}
            -
            -
            
            -type: http
            -scheme: bearer
            -bearerFormat: JWT
            -
            -
            Implicit OAuth2 Sample
            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            OAuth Flows Object

            -

            Allows configuration of the supported OAuth Flows.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
            passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
            clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
            authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object

            -

            Configuration details for a supported OAuth Flow

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL.
            tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL.
            refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL.
            scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object Examples

            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    },
            -    "authorizationCode": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "tokenUrl": "https://example.com/api/oauth/token",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -  authorizationCode:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    tokenUrl: https://example.com/api/oauth/token
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            Security Requirement Object

            -

            Lists the required security schemes to execute this operation. -The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

            -

            Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. -This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

            -

            When a list of Security Requirement Objects is defined on the Open API object or Operation Object, only one of Security Requirement Objects in the list needs to be satisfied to authorize the request.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution. For other security scheme types, the array MUST be empty.
            -

            Security Requirement Object Examples

            -
            Non-OAuth2 Security Requirement
            -
            
            -{
            -  "api_key": []
            -}
            -
            -
            
            -api_key: []
            -
            -
            OAuth2 Security Requirement
            -
            
            -{
            -  "petstore_auth": [
            -    "write:pets",
            -    "read:pets"
            -  ]
            -}
            -
            -
            
            -petstore_auth:
            -- write:pets
            -- read:pets
            -
            -

            Specification Extensions

            -

            While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

            -

            The extensions properties are implemented as patterned fields that are always prefixed by "x-".

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. Can have any valid JSON format value.
            -

            The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

            -

            Security Filtering

            -

            Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

            -

            The reasoning is to allow an additional layer of access control over the documentation. -While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

            -

            Two examples of this:

            -
              -
            1. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
            2. -
            3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the Paths Object, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
            4. -
            -

            Appendix A: Revision History

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            VersionDateNotes
            3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
            3.0.0-rc22017-06-16rc2 of the 3.0 specification
            3.0.0-rc12017-04-27rc1 of the 3.0 specification
            3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
            2.02015-12-31Donation of Swagger 2.0 to the Open API Initiative
            2.02014-09-08Release of Swagger 2.0
            1.22014-03-14Initial release of the formal document.
            1.12012-08-22Release of Swagger 1.1
            1.02011-08-10First release of the Swagger Specification
            - diff --git a/docs/oas/v3.0.1.html b/docs/oas/v3.0.1.html deleted file mode 100644 index a5349bbd20..0000000000 --- a/docs/oas/v3.0.1.html +++ /dev/null @@ -1,4039 +0,0 @@ -OpenAPI Specification v3.0.1 | Introduction, Definitions, & More - - -

            OpenAPI Specification v3.0.1

            The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

            Status of This Document

            The source-of-truth for the specification is the GitHub markdown file referenced above.
            -

            OpenAPI Specification

            -

            Version 3.0.1

            -

            The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

            -

            This document is licensed under The Apache License, Version 2.0.

            -

            Introduction

            -

            The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

            -

            An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

            - -

            Definitions

            -

            OpenAPI Document

            -

            A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

            -

            Path Templating

            -

            Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

            -

            Media Types

            -

            Media type definitions are spread across several resources. -The media type definitions SHOULD be in compliance with [[!RFC6838]].

            -

            Some examples of possible media type definitions:

            -
            
            -  text/plain; charset=utf-8
            -  application/json
            -  application/vnd.github+json
            -  application/vnd.github.v3+json
            -  application/vnd.github.v3.raw+json
            -  application/vnd.github.v3.text+json
            -  application/vnd.github.v3.html+json
            -  application/vnd.github.v3.full+json
            -  application/vnd.github.v3.diff
            -  application/vnd.github.v3.patch
            -
            -

            HTTP Status Codes

            -

            The HTTP Status Codes are used to indicate the status of the executed operation. -The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

            -

            Specification

            -

            Versions

            -

            The OpenAPI Specification is versioned using Semantic Versioning 2.0.0 (semver) and follows the semver specification.

            -

            The major.minor portion of the semver (for example 3.0) SHALL designate the OAS feature set. Typically, .patch versions address errors in this document, not the feature set. Tooling which supports OAS 3.0 SHOULD be compatible with all OAS 3.0.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.0.0 and 3.0.1 for example.

            -

            Subsequent minor version releases of the OpenAPI Specification (incrementing the minor version number) SHOULD NOT interfere with tooling developed to a lower minor version and same major version. Thus a hypothetical 3.1.0 specification SHOULD be usable with tooling designed for 3.0.0.

            -

            An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the semantic version of the OAS that it uses. (OAS 2.0 documents contain a top-level version field named swagger and value "2.0".)

            -

            Format

            -

            An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

            -

            For example, if a field has an array value, the JSON array representation will be used:

            -
            
            -{
            -   "field": [ 1, 2, 3 ]
            -}
            -
            -

            All field names in the specification are case sensitive.

            -

            The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

            -

            Patterned fields MUST have unique names within the containing object.

            -

            In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

            - -

            Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

            -

            Document Structure

            -

            An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

            -

            It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

            -

            Data Types

            -

            Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. -Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. -null is not supported as a type (see nullable for an alternative solution). -Models are defined using the Schema Object, which is an extended subset of JSON Schema Specification Wright Draft 00.

            -

            Primitives have an optional modifier property: format. -OAS uses several known formats to define in fine detail the data type being used. -However, to support documentation needs, the format property is an open string-valued property, and can have any value. -Formats such as "email", "uuid", and so on, MAY be used even though undefined by this specification. -Types that are not accompanied by a format property follow the type definition in the JSON Schema. Tools that do not recognize a specific format MAY default back to the type alone, as if the format is not specified.

            -

            The formats defined by the OAS are:

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Common NametypeformatComments
            integerintegerint32signed 32 bits
            longintegerint64signed 64 bits
            floatnumberfloat
            doublenumberdouble
            stringstring
            bytestringbytebase64 encoded characters
            binarystringbinaryany sequence of octets
            booleanboolean
            datestringdateAs defined by full-date - [!RFC3339]
            dateTimestringdate-timeAs defined by date-time - [!RFC3339]
            passwordstringpasswordA hint to UIs to obscure input.
            -

            Rich Text Formatting

            -

            Throughout the specification description fields are noted as supporting CommonMark markdown formatting. -Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

            -

            Relative References in URLs

            -

            Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. -Relative references are resolved using the URLs defined in the Server Object as a Base URI.

            -

            Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

            -

            Schema

            -

            In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

            -

            OpenAPI Object

            -

            This is the root document object of the OpenAPI document.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            openapistringREQUIRED. This string MUST be the semantic version number of the OpenAPI Specification version that the OpenAPI document uses. The openapi field SHOULD be used by tooling specifications and clients to interpret the OpenAPI document. This is not related to the API info.version string.
            infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
            servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
            pathsPaths ObjectREQUIRED. The available paths and operations for the API.
            componentsComponents ObjectAn element to hold various schemas for the specification.
            security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition.
            tags[Tag Object]A list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
            externalDocsExternal Documentation ObjectAdditional external documentation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object

            -

            The object provides metadata about the API. -The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            titlestringREQUIRED. The title of the application.
            descriptionstringA short description of the application. CommonMark syntax MAY be used for rich text representation.
            termsOfServicestringA URL to the Terms of Service for the API. MUST be in the format of a URL.
            contactContact ObjectThe contact information for the exposed API.
            licenseLicense ObjectThe license information for the exposed API.
            versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object Example:

            -
            
            -{
            -  "title": "Sample Pet Store App",
            -  "description": "This is a sample server for a pet store.",
            -  "termsOfService": "http://example.com/terms/",
            -  "contact": {
            -    "name": "API Support",
            -    "url": "http://www.example.com/support",
            -    "email": "support@example.com"
            -  },
            -  "license": {
            -    "name": "Apache 2.0",
            -    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
            -  },
            -  "version": "1.0.1"
            -}
            -
            -
            
            -title: Sample Pet Store App
            -description: This is a sample server for a pet store.
            -termsOfService: http://example.com/terms/
            -contact:
            -  name: API Support
            -  url: http://www.example.com/support
            -  email: support@example.com
            -license:
            -  name: Apache 2.0
            -  url: https://www.apache.org/licenses/LICENSE-2.0.html
            -version: 1.0.1
            -
            -

            Contact Object

            -

            Contact information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringThe identifying name of the contact person/organization.
            urlstringThe URL pointing to the contact information. MUST be in the format of a URL.
            emailstringThe email address of the contact person/organization. MUST be in the format of an email address.
            -

            This object MAY be extended with Specification Extensions.

            -

            Contact Object Example:

            -
            
            -{
            -  "name": "API Support",
            -  "url": "http://www.example.com/support",
            -  "email": "support@example.com"
            -}
            -
            -
            
            -name: API Support
            -url: http://www.example.com/support
            -email: support@example.com
            -
            -

            License Object

            -

            License information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The license name used for the API.
            urlstringA URL to the license used for the API. MUST be in the format of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            License Object Example:

            -
            
            -{
            -  "name": "Apache 2.0",
            -  "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
            -}
            -
            -
            
            -name: Apache 2.0
            -url: https://www.apache.org/licenses/LICENSE-2.0.html
            -
            -

            Server Object

            -

            An object representing a Server.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
            descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
            variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
            -

            This object MAY be extended with Specification Extensions.

            -

            Server Object Example

            -

            A single server would be described as:

            -
            
            -{
            -  "url": "https://development.gigantic-server.com/v1",
            -  "description": "Development server"
            -}
            -
            -
            
            -url: https://development.gigantic-server.com/v1
            -description: Development server
            -
            -

            The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://development.gigantic-server.com/v1",
            -      "description": "Development server"
            -    },
            -    {
            -      "url": "https://staging.gigantic-server.com/v1",
            -      "description": "Staging server"
            -    },
            -    {
            -      "url": "https://api.gigantic-server.com/v1",
            -      "description": "Production server"
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://development.gigantic-server.com/v1
            -  description: Development server
            -- url: https://staging.gigantic-server.com/v1
            -  description: Staging server
            -- url: https://api.gigantic-server.com/v1
            -  description: Production server
            -
            -

            The following shows how variables can be used for a server configuration:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
            -      "description": "The production API server",
            -      "variables": {
            -        "username": {
            -          "default": "demo",
            -          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
            -        },
            -        "port": {
            -          "enum": [
            -            "8443",
            -            "443"
            -          ],
            -          "default": "8443"
            -        },
            -        "basePath": {
            -          "default": "v2"
            -        }
            -      }
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://{username}.gigantic-server.com:{port}/{basePath}
            -  description: The production API server
            -  variables:
            -    username:
            -      # note! no enum here means it is an open value
            -      default: demo
            -      description: this value is assigned by the service provider, in this example `gigantic-server.com`
            -    port:
            -      enum:
            -        - '8443'
            -        - '443'
            -      default: '8443'
            -    basePath:
            -      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
            -      default: v2
            -
            -

            Server Variable Object

            -

            An object representing a Server Variable for server URL template substitution.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            enum[string]An enumeration of string values to be used if the substitution options are from a limited set.
            defaultstringREQUIRED. The default value to use for substitution, and to send, if an alternate value is not supplied. Unlike the Schema Object’s default, this value MUST be provided by the consumer.
            descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Components Object

            -

            Holds a set of reusable objects for different aspects of the OAS. -All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemasMap[string, Schema Object | Reference Object]An object to hold reusable Schema Objects.
            responsesMap[string, Response Object | Reference Object]An object to hold reusable Response Objects.
            parametersMap[string, Parameter Object | Reference Object]An object to hold reusable Parameter Objects.
            examplesMap[string, Example Object | Reference Object]An object to hold reusable Example Objects.
            requestBodiesMap[string, Request Body Object | Reference Object]An object to hold reusable Request Body Objects.
            headersMap[string, Header Object | Reference Object]An object to hold reusable Header Objects.
            securitySchemesMap[string, Security Scheme Object | Reference Object]An object to hold reusable Security Scheme Objects.
            linksMap[string, Link Object | Reference Object]An object to hold reusable Link Objects.
            callbacksMap[string, Callback Object | Reference Object]An object to hold reusable Callback Objects.
            -

            This object MAY be extended with Specification Extensions.

            -

            All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

            -

            Field Name Examples:

            -
            
            -User
            -User_1
            -User_Name
            -user-name
            -my.org.User
            -
            -

            Components Object Example

            -
            
            -"components": {
            -  "schemas": {
            -    "Category": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    },
            -    "Tag": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  },
            -  "parameters": {
            -    "skipParam": {
            -      "name": "skip",
            -      "in": "query",
            -      "description": "number of items to skip",
            -      "required": true,
            -      "schema": {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    },
            -    "limitParam": {
            -      "name": "limit",
            -      "in": "query",
            -      "description": "max records to return",
            -      "required": true,
            -      "schema" : {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    }
            -  },
            -  "responses": {
            -    "NotFound": {
            -      "description": "Entity not found."
            -    },
            -    "IllegalInput": {
            -      "description": "Illegal input for operation."
            -    },
            -    "GeneralError": {
            -      "description": "General Error",
            -      "content": {
            -        "application/json": {
            -          "schema": {
            -            "$ref": "#/components/schemas/GeneralError"
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "securitySchemes": {
            -    "api_key": {
            -      "type": "apiKey",
            -      "name": "api_key",
            -      "in": "header"
            -    },
            -    "petstore_auth": {
            -      "type": "oauth2",
            -      "flows": {
            -        "implicit": {
            -          "authorizationUrl": "http://example.org/api/oauth/dialog",
            -          "scopes": {
            -            "write:pets": "modify pets in your account",
            -            "read:pets": "read your pets"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    Category:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -    Tag:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -  parameters:
            -    skipParam:
            -      name: skip
            -      in: query
            -      description: number of items to skip
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -    limitParam:
            -      name: limit
            -      in: query
            -      description: max records to return
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -  responses:
            -    NotFound:
            -      description: Entity not found.
            -    IllegalInput:
            -      description: Illegal input for operation.
            -    GeneralError:
            -      description: General Error
            -      content:
            -        application/json:
            -          schema:
            -            $ref: '#/components/schemas/GeneralError'
            -  securitySchemes:
            -    api_key:
            -      type: apiKey
            -      name: api_key
            -      in: header
            -    petstore_auth:
            -      type: oauth2
            -      flows:
            -        implicit:
            -          authorizationUrl: http://example.org/api/oauth/dialog
            -          scopes:
            -            write:pets: modify pets in your account
            -            read:pets: read your pets
            -
            -

            Paths Object

            -

            Holds the relative paths to the individual endpoints and their operations. -The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a slash. The path is appended (no relative URL resolution) to the expanded URL from the Server Object’s url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Templating Matching

            -

            Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

            -
            
            -  /pets/{petId}
            -  /pets/mine
            -
            -

            The following paths are considered identical and invalid:

            -
            
            -  /pets/{petId}
            -  /pets/{name}
            -
            -

            The following may lead to ambiguous resolution:

            -
            
            -  /{entity}/me
            -  /books/{id}
            -
            -

            Paths Object Example

            -
            
            -{
            -  "/pets": {
            -    "get": {
            -      "description": "Returns all pets from the system that the user has access to",
            -      "responses": {
            -        "200": {         
            -          "description": "A list of pets.",
            -          "content": {
            -            "application/json": {
            -              "schema": {
            -                "type": "array",
            -                "items": {
            -                  "$ref": "#/components/schemas/pet"
            -                }
            -              }
            -            }
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -/pets:
            -  get:
            -    description: Returns all pets from the system that the user has access to
            -    responses:
            -      '200':
            -        description: A list of pets.
            -        content:
            -          application/json:
            -            schema:
            -              type: array
            -              items:
            -                $ref: '#/components/schemas/pet'
            -
            -

            Path Item Object

            -

            Describes the operations available on a single path. -A Path Item MAY be empty, due to ACL constraints. -The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringAllows for an external definition of this path item. The referenced structure MUST be in the format of a Path Item Object. If there are conflicts between the referenced definition and this Path Item’s definition, the behavior is undefined.
            summarystringAn optional, string summary, intended to apply to all operations in this path.
            descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
            getOperation ObjectA definition of a GET operation on this path.
            putOperation ObjectA definition of a PUT operation on this path.
            postOperation ObjectA definition of a POST operation on this path.
            deleteOperation ObjectA definition of a DELETE operation on this path.
            optionsOperation ObjectA definition of a OPTIONS operation on this path.
            headOperation ObjectA definition of a HEAD operation on this path.
            patchOperation ObjectA definition of a PATCH operation on this path.
            traceOperation ObjectA definition of a TRACE operation on this path.
            servers[Server Object]An alternative server array to service all operations in this path.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Item Object Example

            -
            
            -{
            -  "get": {
            -    "description": "Returns pets based on ID",
            -    "summary": "Find pets by ID",
            -    "operationId": "getPetsById",
            -    "responses": {
            -      "200": {
            -        "description": "pet response",
            -        "content": {
            -          "*/*": {
            -            "schema": {
            -              "type": "array",
            -              "items": {
            -                "$ref": "#/components/schemas/Pet"
            -              }
            -            }
            -          }
            -        }
            -      },
            -      "default": {
            -        "description": "error payload",
            -        "content": {
            -          "text/html": {
            -            "schema": {
            -              "$ref": "#/components/schemas/ErrorModel"
            -            }
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "parameters": [
            -    {
            -      "name": "id",
            -      "in": "path",
            -      "description": "ID of pet to use",
            -      "required": true,
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      },
            -      "style": "simple"
            -    }
            -  ]
            -}
            -
            -
            
            -get:
            -  description: Returns pets based on ID
            -  summary: Find pets by ID
            -  operationId: getPetsById
            -  responses:
            -    '200':
            -      description: pet response
            -      content:
            -        '*/*' :
            -          schema:
            -            type: array
            -            items:
            -              $ref: '#/components/schemas/Pet'
            -    default:
            -      description: error payload
            -      content:
            -        'text/html':
            -          schema:
            -            $ref: '#/components/schemas/ErrorModel'
            -parameters:
            -- name: id
            -  in: path
            -  description: ID of pet to use
            -  required: true
            -  schema:
            -    type: array
            -    style: simple
            -    items:
            -      type: string 
            -
            -

            Operation Object

            -

            Describes a single API operation on a path.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
            summarystringA short summary of what the operation does.
            descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
            operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            requestBodyRequest Body Object | Reference ObjectThe request body applicable for this operation. The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers.
            responsesResponses ObjectREQUIRED. The list of possible responses as they are returned from executing this operation.
            callbacksMap[string, Callback Object | Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses. The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.
            deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
            security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
            servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
            -

            This object MAY be extended with Specification Extensions.

            -

            Operation Object Example

            -
            
            -{
            -  "tags": [
            -    "pet"
            -  ],
            -  "summary": "Updates a pet in the store with form data",
            -  "operationId": "updatePetWithForm",
            -  "parameters": [
            -    {
            -      "name": "petId",
            -      "in": "path",
            -      "description": "ID of pet that needs to be updated",
            -      "required": true,
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  ],
            -  "requestBody": {
            -    "content": {
            -      "application/x-www-form-urlencoded": {
            -        "schema": {
            -          "type": "object",
            -           "properties": {
            -              "name": {
            -                "description": "Updated name of the pet",
            -                "type": "string"
            -              },
            -              "status": {
            -                "description": "Updated status of the pet",
            -                "type": "string"
            -             }
            -           },
            -        "required": ["status"]
            -        }
            -      }
            -    }
            -  },
            -  "responses": {
            -    "200": {
            -      "description": "Pet updated.",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    },
            -    "405": {
            -      "description": "Invalid input",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    }
            -  },
            -  "security": [
            -    {
            -      "petstore_auth": [
            -        "write:pets",
            -        "read:pets"
            -      ]
            -    }
            -  ]
            -}
            -
            -
            
            -tags:
            -- pet
            -summary: Updates a pet in the store with form data
            -operationId: updatePetWithForm
            -parameters:
            -- name: petId
            -  in: path
            -  description: ID of pet that needs to be updated
            -  required: true
            -  schema:
            -    type: string
            -requestBody:
            -  content:
            -    'application/x-www-form-urlencoded':
            -      schema:
            -       properties:
            -          name:
            -            description: Updated name of the pet
            -            type: string
            -          status:
            -            description: Updated status of the pet
            -            type: string
            -       required:
            -         - status
            -responses:
            -  '200':
            -    description: Pet updated.
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -  '405':
            -    description: Invalid input
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -security:
            -- petstore_auth:
            -  - write:pets
            -  - read:pets
            -
            -

            External Documentation Object

            -

            Allows referencing an external resource for extended documentation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA short description of the target documentation. CommonMark syntax MAY be used for rich text representation.
            urlstringREQUIRED. The URL for the target documentation. Value MUST be in the format of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            External Documentation Object Example

            -
            
            -{
            -  "description": "Find more info here",
            -  "url": "https://example.com"
            -}
            -
            -
            
            -description: Find more info here
            -url: https://example.com
            -
            -

            Parameter Object

            -

            Describes a single operation parameter.

            -

            A unique parameter is defined by a combination of a name and location.

            -

            Parameter Locations

            -

            There are four possible parameter locations specified by the in field:

            -
              -
            • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
            • -
            • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
            • -
            • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
            • -
            • cookie - Used to pass a specific cookie value to the API.
            • -
            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
            • If in is "path", the name field MUST correspond to the associated path segment from the path field in the Paths Object. See Path Templating for further information.
            • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
            • For all other cases, the name corresponds to the parameter name used by the in property.
            instringREQUIRED. The location of the parameter. Possible values are “query”, “header”, “path” or “cookie”.
            descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is “path”, this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
            deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage.
            allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored.
            -

            The rules for serialization of the parameter are specified in one of two ways. -For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
            explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
            schemaSchema Object | Reference ObjectThe schema defining the type used for the parameter.
            exampleAnyExample of the media type. The example SHOULD match the specified schema and encoding properties if present. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
            examplesMap[ string, Example Object | Reference Object]Examples of the media type. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
            -

            For more complex scenarios, the content property can define the media type and schema of the parameter. -A parameter MUST contain either a schema property, or a content property, but not both. -When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
            -

            Style Values

            -

            In order to support common ways of serializing simple parameters, a set of style values are defined.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styletypeinComments
            matrixprimitive, array, objectpathPath-style parameters defined by [[!RFC6570]]
            labelprimitive, array, objectpathLabel style parameters defined by [[!RFC6570]]
            formprimitive, array, objectquery, cookieForm style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
            simplearraypath, headerSimple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0.
            spaceDelimitedarrayquerySpace separated array values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
            pipeDelimitedarrayqueryPipe separated array values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
            deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
            -

            Style Examples

            -

            Assume a parameter named color has one of the following values:

            -
            
            -   string -> "blue"
            -   array -> ["blue","black","brown"]
            -   object -> { "R": 100, "G": 200, "B": 150 }
            -
            -

            The following table shows examples of rendering differences for each value.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styleexplodeemptystringarrayobject
            matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
            matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
            labelfalse..blue.blue.black.brown.R.100.G.200.B.150
            labeltrue..blue.blue.black.brown.R=100.G=200.B=150
            formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
            formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
            simplefalsen/ablueblue,black,brownR,100,G,200,B,150
            simpletruen/ablueblue,black,brownR=100,G=200,B=150
            spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
            pipeDelimitedfalsen/an/ablue|black|brownR|100|G|200
            deepObjecttruen/an/an/acolor[R]=100&color[G]=200&color[B]=150
            -

            This object MAY be extended with Specification Extensions.

            -

            Parameter Object Examples

            -

            A header parameter with an array of 64 bit integer numbers:

            -
            
            -{
            -  "name": "token",
            -  "in": "header",
            -  "description": "token to be passed as a header",
            -  "required": true,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "integer",
            -      "format": "int64"
            -    }
            -  },
            -  "style": "simple"
            -}
            -
            -
            
            -name: token
            -in: header
            -description: token to be passed as a header
            -required: true
            -schema:
            -  type: array
            -  items:
            -    type: integer
            -    format: int64
            -style: simple
            -
            -

            A path parameter of a string value:

            -
            
            -{
            -  "name": "username",
            -  "in": "path",
            -  "description": "username to fetch",
            -  "required": true,
            -  "schema": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -name: username
            -in: path
            -description: username to fetch
            -required: true
            -schema:
            -  type: string
            -
            -

            An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

            -
            
            -{
            -  "name": "id",
            -  "in": "query",
            -  "description": "ID of the object to fetch",
            -  "required": false,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    }
            -  },
            -  "style": "form",
            -  "explode": true
            -}
            -
            -
            
            -name: id
            -in: query
            -description: ID of the object to fetch
            -required: false
            -schema:
            -  type: array
            -  items:
            -    type: string
            -style: form
            -explode: true
            -
            -

            A free-form query parameter, allowing undefined parameters of a specific type:

            -
            
            -{
            -  "in": "query",
            -  "name": "freeForm",
            -  "schema": {
            -    "type": "object",
            -    "additionalProperties": {
            -      "type": "integer"
            -    },
            -  },
            -  "style": "form"
            -}
            -
            -
            
            -in: query
            -name: freeForm
            -schema:
            -  type: object
            -  additionalProperties:
            -    type: integer
            -style: form
            -
            -

            A complex parameter using content to define serialization:

            -
            
            -{
            -  "in": "query",
            -  "name": "coordinates",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "object",
            -        "required": [
            -          "lat",
            -          "long"
            -        ],
            -        "properties": {
            -          "lat": {
            -            "type": "number"
            -          },
            -          "long": {
            -            "type": "number"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -in: query
            -name: coordinates
            -content:
            -  application/json:
            -    schema:
            -      type: object
            -      required:
            -        - lat
            -        - long
            -      properties:
            -        lat:
            -          type: number
            -        long:
            -          type: number
            -
            -

            Request Body Object

            -

            Describes a single request body.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            requiredbooleanDetermines if the request body is required in the request. Defaults to false.
            -

            This object MAY be extended with Specification Extensions.

            -

            Request Body Examples

            -

            A request body with a referenced model definition.

            -
            
            -{
            -  "description": "user to add to the system",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User Example",
            -            "externalValue": "http://foo.bar/examples/user-example.json"
            -          }
            -        }
            -    },
            -    "application/xml": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User example in XML",
            -            "externalValue": "http://foo.bar/examples/user-example.xml"
            -          }
            -        }
            -    },
            -    "text/plain": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in Plain text",
            -            "externalValue": "http://foo.bar/examples/user-example.txt"
            -        }
            -      }
            -    },
            -    "*/*": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in other format",
            -            "externalValue": "http://foo.bar/examples/user-example.whatever"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -content:
            -  'application/json':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User Example
            -        externalValue: 'http://foo.bar/examples/user-example.json'
            -  'application/xml':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User Example in XML
            -        externalValue: 'http://foo.bar/examples/user-example.xml'
            -  'text/plain':
            -    examples:
            -      user:
            -        summary: User example in text plain format
            -        externalValue: 'http://foo.bar/examples/user-example.txt'
            -  '*/*':
            -    examples:
            -      user:
            -        summary: User example in other format
            -        externalValue: 'http://foo.bar/examples/user-example.whatever'
            -
            -

            A body parameter that is an array of string values:

            -
            
            -{
            -  "description": "user to add to the system",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -required: true
            -content:
            -  text/plain:
            -    schema:
            -      type: array
            -      items:
            -        type: string
            -
            -

            Media Type Object

            -

            Each Media Type Object provides schema and examples for the media type identified by its key.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemaSchema Object | Reference ObjectThe schema defining the type used for the request body.
            exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
            examplesMap[ string, Example Object | Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
            encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
            -

            This object MAY be extended with Specification Extensions.

            -

            Media Type Examples

            -
            
            -{
            -  "application/json": {
            -    "schema": {
            -         "$ref": "#/components/schemas/Pet"
            -    },
            -    "examples": {
            -      "cat" : {
            -        "summary": "An example of a cat",
            -        "value":
            -          {
            -            "name": "Fluffy",
            -            "petType": "Cat",
            -            "color": "White",
            -            "gender": "male",
            -            "breed": "Persian"
            -          }
            -      },
            -      "dog": {
            -        "summary": "An example of a dog with a cat's name",
            -        "value" :  {
            -          "name": "Puma",
            -          "petType": "Dog",
            -          "color": "Black",
            -          "gender": "Female",
            -          "breed": "Mixed"
            -        },
            -      "frog": {
            -          "$ref": "#/components/examples/frog-example"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -application/json:
            -  schema:
            -    $ref: "#/components/schemas/Pet"
            -  examples:
            -    cat:
            -      summary: An example of a cat
            -      value:
            -        name: Fluffy
            -        petType: Cat
            -        color: White
            -        gender: male
            -        breed: Persian
            -    dog:
            -      summary: An example of a dog with a cat's name
            -      value:
            -        name: Puma
            -        petType: Dog
            -        color: Black
            -        gender: Female
            -        breed: Mixed
            -    frog:
            -      $ref: "#/components/examples/frog-example"
            -
            -

            Considerations for File Uploads

            -

            In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type. Specifically:

            -
            
            -# content transferred with base64 encoding
            -schema:
            -  type: string
            -  format: base64
            -
            -
            
            -# content transferred in binary (octet-stream):
            -schema:
            -  type: string
            -  format: binary
            -
            -

            These examples apply to either input payloads of file uploads or response payloads.

            -

            A requestBody for submitting a file in a POST operation may look like the following example:

            -
            
            -requestBody:
            -  content:
            -    application/octet-stream:
            -      # any media type is accepted, functionally equivalent to `*/*`
            -      schema:
            -        # a binary file of any type
            -        type: string
            -        format: binary
            -
            -

            In addition, specific media types MAY be specified:

            -
            
            -# multiple, specific media types may be specified:
            -requestBody:
            -  content:
            -      # a binary file of type png or jpeg
            -    'image/jpeg':
            -      schema:
            -        type: string
            -        format: binary
            -    'image/png':
            -      schema:
            -        type: string
            -        format: binary       
            -
            -

            To upload multiple files, a multipart media type MUST be used:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        properties:
            -          # The property name 'file' will be used for all files.
            -          file:
            -            type: array
            -            items:
            -              type: string
            -              format: binary
            -
            -
            -

            Support for x-www-form-urlencoded Request Bodies

            -

            To submit content using form url encoding via [[!RFC1866]], the following -definition may be used:

            -
            
            -requestBody:
            -  content:
            -    application/x-www-form-urlencoded:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # complex types are stringified to support RFC 1866
            -            type: object
            -            properties: {}
            -
            -

            In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

            -

            When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object’s style property as form.

            -

            Special Considerations for multipart Content

            -

            It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

            -

            When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred — thus, the following default Content-Types are defined for multipart:

            -
              -
            • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
            • -
            • If the property is complex, or an array of complex values, the default Content-Type is application/json
            • -
            • If the property is a type: string with format: binary or format: base64 (aka a file object), the default Content-Type is application/octet-stream
            • -
            -

            Examples:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # default Content-Type for objects is `application/json`
            -            type: object
            -            properties: {}
            -          profileImage:
            -            # default Content-Type for string/binary is `application/octet-stream`
            -            type: string
            -            format: binary
            -          children:
            -            # default Content-Type for arrays is based on the `inner` type (text/plain here)
            -            type: array
            -            items:
            -              type: string
            -          addresses:
            -            # default Content-Type for arrays is based on the `inner` type (object shown, so `application/json` in this example)
            -            type: array
            -            items:
            -              type: '#/components/schemas/Address'
            -
            -

            An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

            -

            Encoding Object

            -

            A single encoding definition applied to a single schema property.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for string with format being binaryapplication/octet-stream; for other primitive types – text/plain; for object - application/json; for array – the default is defined based on the inner type. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
            headersMap[string, Header Object | Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
            stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            -

            This object MAY be extended with Specification Extensions.

            -

            Encoding Object Example

            -
            
            -requestBody:
            -  content:
            -    multipart/mixed:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            # default is text/plain
            -            type: string
            -            format: uuid
            -          address:
            -            # default is application/json
            -            type: object
            -            properties: {}
            -          historyMetadata:
            -            # need to declare XML format!
            -            description: metadata in XML format
            -            type: object
            -            properties: {}
            -          profileImage:
            -            # default is application/octet-stream, need to declare an image type only!
            -            type: string
            -            format: binary
            -      encoding:
            -        historyMetadata:
            -          # require XML Content-Type in utf-8 encoding
            -          contentType: application/xml; charset=utf-8
            -        profileImage:
            -          # only accept png/jpeg
            -          contentType: image/png, image/jpeg
            -          headers:
            -            X-Rate-Limit-Limit:
            -              description: The number of allowed requests in the current period
            -              schema:
            -                type: integer
            -
            -

            Responses Object

            -

            A container for the expected responses of an operation. -The container maps a HTTP response code to the expected response.

            -

            The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. -However, documentation is expected to cover a successful operation response and any known errors.

            -

            The default MAY be used as a default response object for all HTTP codes -that are not covered individually by the specification.

            -

            The Responses Object MUST contain at least one response code, and it -SHOULD be the response for a successful operation call.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            defaultResponse Object | Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses. A Reference Object can link to a response that the OpenAPI Object’s components/responses section defines.
            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            HTTP Status CodeResponse Object | Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. A Reference Object can link to a response that is defined in the OpenAPI Object’s components/responses section. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. The following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response range is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
            -

            This object MAY be extended with Specification Extensions.

            -

            Responses Object Example

            -

            A 200 response for a successful operation and a default response for others (implying an error):

            -
            
            -{
            -  "200": {
            -    "description": "a pet to be returned",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/Pet"
            -        }
            -      }
            -    }
            -  },
            -  "default": {
            -    "description": "Unexpected error",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/ErrorModel"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -'200':
            -  description: a pet to be returned
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/Pet'
            -default:
            -  description: Unexpected error
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/ErrorModel'
            -
            -

            Response Object

            -

            Describes a single response from an API Operation, including design-time, static -links to operations based on the response.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringREQUIRED. A short description of the response. CommonMark syntax MAY be used for rich text representation.
            headersMap[string, Header Object | Reference Object]Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
            contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            linksMap[string, Link Object | Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
            -

            This object MAY be extended with Specification Extensions.

            -

            Response Object Examples

            -

            Response of an array of a complex type:

            -
            
            -{
            -  "description": "A complex object array response",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "$ref": "#/components/schemas/VeryComplexType"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A complex object array response
            -content:
            -  application/json:
            -    schema:
            -      type: array
            -      items:
            -        $ref: '#/components/schemas/VeryComplexType'
            -
            -

            Response with a string type:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  }
            -
            -}
            -
            -
            
            -description: A simple string response
            -content:
            -  text/plain:
            -    schema:
            -      type: string
            -
            -

            Plain text response with headers:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  },
            -  "headers": {
            -    "X-Rate-Limit-Limit": {
            -      "description": "The number of allowed requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Remaining": {
            -      "description": "The number of remaining requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Reset": {
            -      "description": "The number of seconds left in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A simple string response
            -content:
            -  text/plain:
            -    schema:
            -      type: string
            -    example: 'whoa!'
            -headers:
            -  X-Rate-Limit-Limit:
            -    description: The number of allowed requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Remaining:
            -    description: The number of remaining requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Reset:
            -    description: The number of seconds left in the current period
            -    schema:
            -      type: integer
            -
            -

            Response with no return value:

            -
            
            -{
            -  "description": "object created"
            -}
            -
            -
            
            -description: object created
            -
            -

            Callback Object

            -

            A map of possible out-of band callbacks related to the parent operation. -Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. -The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {expression}Path Item ObjectA Path Item Object used to define a callback request and expected responses. A complete example is available.
            -

            This object MAY be extended with Specification Extensions.

            -

            Key Expression

            -

            The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. -A simple example might be $request.body#/url. -However, using a runtime expression the complete HTTP message can be accessed. -This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

            -

            For example, given the following HTTP request:

            -
            
            -POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
            -Host: example.org
            -Content-Type: application/json
            -Content-Length: 187
            -
            -{
            -  "failedUrl" : "http://clientdomain.com/failed",
            -  "successUrls" : [
            -    "http://clientdomain.com/fast",
            -    "http://clientdomain.com/medium",
            -    "http://clientdomain.com/slow"
            -  ]
            -}
            -
            -201 Created
            -Location: http://example.org/subscription/1
            -
            -

            The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            ExpressionValue
            $urlhttp://example.org/subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning
            $methodPOST
            $request.path.eventTypemyevent
            $request.query.queryUrlhttp://clientdomain.com/stillrunning
            $request.header.content-Typeapplication/json
            $request.body#/failedUrlhttp://clientdomain.com/stillrunning
            $request.body#/successUrls/2http://clientdomain.com/medium
            $response.header.Locationhttp://example.org/subscription/1
            -

            Callback Object Example

            -

            The following example shows a callback to the URL specified by the id and email property in the request body.

            -
            
            -myWebhook:
            -  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
            -    post:
            -      requestBody:
            -        description: Callback payload
            -        content:
            -          'application/json':
            -            schema:
            -              $ref: '#/components/schemas/SomePayload'
            -      responses:
            -        '200':
            -          description: webhook successfully processed and no retries will be performed
            -
            -

            Example Object

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            summarystringShort description for the example.
            descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
            valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
            externalValuestringA URL that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive.
            -

            This object MAY be extended with Specification Extensions.

            -

            In all cases, the example value is expected to be compatible with the type schema -of its associated value. Tooling implementations MAY choose to -validate compatibility automatically, and reject the example value(s) if incompatible.

            -

            Example Object Example

            -
            
            -# in a model
            -schemas:
            -  properties:
            -    name:
            -      type: string
            -      examples:
            -        name:
            -          $ref: http://example.org/petapi-examples/openapi.json#/components/examples/name-example
            -
            -# in a request body:
            -  requestBody:
            -    content:
            -      'application/json':
            -        schema:
            -          $ref: '#/components/schemas/Address'
            -        examples:
            -          foo:
            -            summary: A foo example
            -            value: {"foo": "bar"}
            -          bar:
            -            summary: A bar example
            -            value: {"bar": "baz"}
            -      'application/xml':
            -        examples:
            -          xmlExample:
            -            summary: This is an example in XML
            -            externalValue: 'http://example.org/examples/address-example.xml'
            -      'text/plain':
            -        examples:
            -          textExample:
            -            summary: This is a text example
            -            externalValue: 'http://foo.bar/examples/address-example.txt'
            -
            -
            -# in a parameter
            -  parameters:
            -    - name: 'zipCode'
            -      in: 'query'
            -      schema:
            -        type: 'string'
            -        format: 'zip-code'
            -        examples:
            -          zip-example:
            -            $ref: '#/components/examples/zip-example'
            -
            -# in a response
            -  responses:
            -    '200':
            -      description: your car appointment has been booked
            -      content:
            -        application/json:
            -          schema:
            -            $ref: '#/components/schemas/SuccessResponse'
            -          examples:
            -            confirmation-success:
            -              $ref: '#/components/examples/confirmation-success'
            -
            -

            Link Object

            -

            The Link object represents a possible design-time link for a response. -The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

            -

            Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

            -

            For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            operationRefstringA relative or absolute reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition.
            operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
            parametersMap[string, Any | {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
            requestBodyAny | {expression}A literal value or {expression} to use as a request body when calling the target operation.
            descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
            serverServer ObjectA server object to be used by the target operation.
            -

            This object MAY be extended with Specification Extensions.

            -

            A linked operation MUST be identified using either an operationRef or operationId. -In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. -Because of the potential for name clashes, the operationRef syntax is preferred -for specifications with external references.

            -

            Examples

            -

            Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

            -
            
            -paths:
            -  /users/{id}:
            -    parameters:
            -    - name: id
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -    get:
            -      responses:
            -        '200':
            -          description: the user being returned
            -          content:
            -            application/json:
            -              schema:
            -                type: object
            -                properties:
            -                  uuid: # the unique user id
            -                    type: string
            -                    format: uuid
            -          links:
            -            address:
            -              # the target link operationId
            -              operationId: getUserAddress
            -              parameters:
            -                # get the `id` field from the request path parameter named `id`
            -                userId: $request.path.id
            -  # the path item of the linked operation
            -  /users/{userid}/address:
            -    parameters:
            -    - name: userid
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -    # linked operation
            -    get:
            -      operationId: getUserAddress
            -      responses:
            -        '200':
            -          description: the user's address
            -
            -

            When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

            -

            Values from the response body can be used to drive a linked operation.

            -
            
            -links:
            -  address:
            -    operationId: getUserAddressByUUID
            -    parameters:
            -      # get the `uuid` field from the `uuid` field in the response body
            -      userUuid: $response.body#/uuid
            -
            -

            Clients follow all links at their discretion. -Neither permissions, nor the capability to make a successful call to that link, is guaranteed -solely by the existence of a relationship.

            -

            OperationRef Examples

            -

            As references to operationId MAY NOT be possible (the operationId is an optional -value), references MAY also be made through a relative operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            or an absolute operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            Note that in the use of operationRef, the escaped forward-slash is necessary when -using JSON references.

            -

            Runtime Expressions

            -

            Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. -This mechanism is used by Link Objects and Callback Objects.

            -

            The runtime expression is defined by the following ABNF syntax

            -
            
            -      expression = ( "$url" | "$method" | "$statusCode" | "$request." source | "$response." source )
            -      source = ( header-reference | query-reference | path-reference | body-reference ) 
            -      header-reference = "header." token
            -      query-reference = "query." name 
            -      path-reference = "path." name
            -      body-reference = "body" ["#" fragment]
            -      fragment = a JSON Pointer [RFC 6901](https://tools.ietf.org/html/rfc6901) 
            -      name = *( char )
            -      char = as per RFC [7159](https://tools.ietf.org/html/rfc7159#section-7)
            -      token = as per RFC [7230](https://tools.ietf.org/html/rfc7230#section-3.2.6)
            -
            -

            The name identifier is case-sensitive, whereas token is not.

            -

            The table below provides examples of runtime expressions and examples of their use in a value:

            -

            Examples

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Source Locationexample expressionnotes
            HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
            Requested media type$request.header.accept
            Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
            Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
            Request URL$url
            Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
            Response header$response.header.ServerSingle header values only are available
            -

            Runtime expressions preserve the type of the referenced value. -Expressions can be embedded into string values by surrounding the expression with {} curly braces.

            -

            Header Object

            -

            The Header Object follows the structure of the Parameter Object with the following changes:

            -
              -
            1. name MUST NOT be specified, it is given in the corresponding headers map.
            2. -
            3. in MUST NOT be specified, it is implicitly in header.
            4. -
            5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
            6. -
            -

            Header Object Example

            -

            A simple header of type integer:

            -
            
            -{
            -  "description": "The number of allowed requests in the current period",
            -  "schema": {
            -    "type": "integer"
            -  }
            -}
            -
            -
            
            -description: The number of allowed requests in the current period
            -schema:
            -  type: integer
            -
            -

            Tag Object

            -

            Adds metadata to a single tag that is used by the Operation Object. -It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the tag.
            descriptionstringA short description for the tag. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
            -

            This object MAY be extended with Specification Extensions.

            -

            Tag Object Example

            -
            
            -{
            -	"name": "pet",
            -	"description": "Pets operations"
            -}
            -
            -
            
            -name: pet
            -description: Pets operations
            -
            -

            Reference Object

            -

            A simple object to allow referencing other components in the specification, internally and externally.

            -

            The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

            -

            For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringREQUIRED. The reference string.
            -

            This object cannot be extended with additional properties and any properties added SHALL be ignored.

            -

            Reference Object Example

            -
            
            -{
            -	"$ref": "#/components/schemas/Pet"
            -}
            -
            -
            
            -$ref: '#/components/schemas/Pet'
            -
            -

            Relative Schema Document Example

            -
            
            -{
            -  "$ref": "Pet.json"
            -}
            -
            -
            
            -$ref: Pet.yaml
            -
            -

            Relative Documents With Embedded Schema Example

            -
            
            -{
            -  "$ref": "definitions.json#/Pet"
            -}
            -
            -
            
            -$ref: definitions.yaml#/Pet
            -
            -

            Schema Object

            -

            The Schema Object allows the definition of input and output data types. -These types can be objects, but also primitives and arrays. -This object is an extended subset of the JSON Schema Specification Wright Draft 00.

            -

            For more information about the properties, see JSON Schema Core and JSON Schema Validation. -Unless stated otherwise, the property definitions follow the JSON Schema.

            -

            Properties

            -

            The following properties are taken directly from the JSON Schema definition and follow the same specifications:

            -
              -
            • title
            • -
            • multipleOf
            • -
            • maximum
            • -
            • exclusiveMaximum
            • -
            • minimum
            • -
            • exclusiveMinimum
            • -
            • maxLength
            • -
            • minLength
            • -
            • pattern (This string SHOULD be a valid regular expression, according to the ECMA 262 regular expression dialect)
            • -
            • maxItems
            • -
            • minItems
            • -
            • uniqueItems
            • -
            • maxProperties
            • -
            • minProperties
            • -
            • required
            • -
            • enum
            • -
            -

            The following properties are taken from the JSON Schema definition but their definitions were adjusted to the OpenAPI Specification.

            -
              -
            • type - Value MUST be a string. Multiple types via an array are not supported.
            • -
            • allOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • oneOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • anyOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • not - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • items - Value MUST be an object and not an array. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. items MUST be present if the type is array.
            • -
            • properties - Property definitions MUST be a Schema Object and not a standard JSON Schema (inline or referenced).
            • -
            • additionalProperties - Value can be boolean or object. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • description - CommonMark syntax MAY be used for rich text representation.
            • -
            • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
            • -
            • default - The default value represents what would be assumed by the consumer of the input as the value of the schema if one is not provided. Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object defined at the same level. For example, if type is string, then default can be "foo" but cannot be 1.
            • -
            -

            Alternatively, any time a Schema Object can be used, a Reference Object can be used in its place. This allows referencing definitions instead of defining them inline.

            -

            Additional properties defined by the JSON Schema specification that are not mentioned here are strictly unsupported.

            -

            Other than the JSON Schema subset fields, the following fields MAY be used for further schema documentation:

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            nullablebooleanAllows sending a null value for the defined schema. Default value is false.
            discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
            readOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “read only”. This means that it MAY be sent as part of a response but SHOULD NOT be sent as part of the request. If the property is marked as readOnly being true and is in the required list, the required will take effect on the response only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
            writeOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “write only”. Therefore, it MAY be sent as part of a request but SHOULD NOT be sent as part of the response. If the property is marked as writeOnly being true and is in the required list, the required will take effect on the request only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
            xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
            externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
            exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.
            deprecatedbooleanSpecifies that a schema is deprecated and SHOULD be transitioned out of usage. Default value is false.
            -

            This object MAY be extended with Specification Extensions.

            -
            Composition and Inheritance (Polymorphism)
            -

            The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. -allOf takes an array of object definitions that are validated independently but together compose a single object.

            -

            While composition offers model extensibility, it does not imply a hierarchy between the models. -To support polymorphism, the OpenAPI Specification adds the discriminator field. -When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. -As such, the discriminator field MUST be a required field. -There are two ways to define the value of a discriminator for an inheriting instance.

            -
              -
            • Use the schema name.
            • -
            • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. -As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
            • -
            -
            XML Modeling
            -

            The xml property allows extra definitions when translating the JSON definition to XML. -The XML Object contains additional information about the available options.

            -

            Schema Object Examples

            -
            Primitive Sample
            -
            
            -{
            -  "type": "string",
            -  "format": "email"
            -}
            -
            -
            
            -type: string
            -format: email
            -
            -
            Simple Model
            -
            
            -{
            -  "type": "object",
            -  "required": [
            -    "name"
            -  ],
            -  "properties": {
            -    "name": {
            -      "type": "string"
            -    },
            -    "address": {
            -      "$ref": "#/components/schemas/Address"
            -    },
            -    "age": {
            -      "type": "integer",
            -      "format": "int32",
            -      "minimum": 0
            -    }
            -  }
            -}
            -
            -
            
            -type: object
            -required:
            -- name
            -properties:
            -  name:
            -    type: string
            -  address:
            -    $ref: '#/components/schemas/Address'
            -  age:
            -    type: integer
            -    format: int32
            -    minimum: 0
            -
            -
            Model with Map/Dictionary Properties
            -

            For a simple string to string mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  type: string
            -
            -

            For a string to model mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "$ref": "#/components/schemas/ComplexModel"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  $ref: '#/components/schemas/ComplexModel'
            -
            -
            Model with Example
            -
            
            -{
            -  "type": "object",
            -  "properties": {
            -    "id": {
            -      "type": "integer",
            -      "format": "int64"
            -    },
            -    "name": {
            -      "type": "string"
            -    }
            -  },
            -  "required": [
            -    "name"
            -  ],
            -  "example": {
            -    "name": "Puma",
            -    "id": 1
            -  }
            -}
            -
            -
            
            -type: object
            -properties:
            -  id:
            -    type: integer
            -    format: int64
            -  name:
            -    type: string
            -required:
            -- name
            -example:
            -  name: Puma
            -  id: 1
            -
            -
            Models with Composition
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "ErrorModel": {
            -        "type": "object",
            -        "required": [
            -          "message",
            -          "code"
            -        ],
            -        "properties": {
            -          "message": {
            -            "type": "string"
            -          },
            -          "code": {
            -            "type": "integer",
            -            "minimum": 100,
            -            "maximum": 600
            -          }
            -        }
            -      },
            -      "ExtendedErrorModel": {
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/ErrorModel"
            -          },
            -          {
            -            "type": "object",
            -            "required": [
            -              "rootCause"
            -            ],
            -            "properties": {
            -              "rootCause": {
            -                "type": "string"
            -              }
            -            }
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    ErrorModel:
            -      type: object
            -      required:
            -      - message
            -      - code
            -      properties:
            -        message:
            -          type: string
            -        code:
            -          type: integer
            -          minimum: 100
            -          maximum: 600
            -    ExtendedErrorModel:
            -      allOf:
            -      - $ref: '#/components/schemas/ErrorModel'
            -      - type: object
            -        required:
            -        - rootCause
            -        properties:
            -          rootCause:
            -            type: string
            -
            -
            Models with Polymorphism Support
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "Pet": {
            -        "type": "object",
            -        "discriminator": {
            -          "propertyName": "petType"
            -        },
            -        "properties": {
            -          "name": {
            -            "type": "string"
            -          },
            -          "petType": {
            -            "type": "string"
            -          }
            -        },
            -        "required": [
            -          "name",
            -          "petType"
            -        ]
            -      },
            -      "Cat": {
            -        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "huntingSkill": {
            -                "type": "string",
            -                "description": "The measured skill for hunting",
            -                "default": "lazy",
            -                "enum": [
            -                  "clueless",
            -                  "lazy",
            -                  "adventurous",
            -                  "aggressive"
            -                ]
            -              }
            -            },
            -            "required": [
            -              "huntingSkill"
            -            ]
            -          }
            -        ]
            -      },
            -      "Dog": {
            -        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "packSize": {
            -                "type": "integer",
            -                "format": "int32",
            -                "description": "the size of the pack the dog is from",
            -                "default": 0,
            -                "minimum": 0
            -              }
            -            },
            -            "required": [
            -              "packSize"
            -            ]
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      discriminator:
            -        propertyName: petType
            -      properties:
            -        name:
            -          type: string
            -        petType:
            -          type: string
            -      required:
            -      - name
            -      - petType
            -    Cat:  ## "Cat" will be used as the discriminator value
            -      description: A representation of a cat
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          huntingSkill:
            -            type: string
            -            description: The measured skill for hunting
            -            enum:
            -            - clueless
            -            - lazy
            -            - adventurous
            -            - aggressive
            -        required:
            -        - huntingSkill
            -    Dog:  ## "Dog" will be used as the discriminator value
            -      description: A representation of a dog
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          packSize:
            -            type: integer
            -            format: int32
            -            description: the size of the pack the dog is from
            -            default: 0
            -            minimum: 0
            -        required:
            -        - packSize
            -
            -

            Discriminator Object

            -

            When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

            -

            When using the discriminator, inline schemas will not be considered.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
            mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
            -

            The discriminator attribute is legal only when using one of the composite keywords oneOf, anyOf, allOf.

            -

            In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -
            -

            which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  discriminator:
            -    propertyName: pet_type
            -
            -

            The expectation now is that a property with name pet_type MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

            -
            
            -{
            -  "id": 12345,
            -  "pet_type": "Cat"
            -}
            -
            -

            Will indicate that the Cat schema be used in conjunction with this payload.

            -

            In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -  discriminator:
            -    propertyName: pet_type
            -    mapping:
            -      dog: '#/components/schemas/Dog'
            -      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -
            -

            Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

            -

            When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

            -

            In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

            -

            For example:

            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      required:
            -      - pet_type
            -      properties:
            -        pet_type:
            -          type: string
            -      discriminator:
            -        propertyName: pet_type
            -        mapping:
            -          cachorro: Dog
            -    Cat:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Cat`
            -        properties:
            -          name:
            -            type: string
            -    Dog:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Dog`
            -        properties:
            -          bark:
            -            type: string
            -    Lizard:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Lizard`
            -        properties:
            -          lovesRocks:
            -            type: boolean
            -
            -

            a payload like this:

            -
            
            -{
            -  "pet_type": "Cat",
            -  "name": "misty"
            -}
            -
            -

            will indicate that the Cat schema be used. Likewise this schema:

            -
            
            -{
            -  "pet_type": "cachorro",
            -  "bark": "soft"
            -}
            -
            -

            will map to Dog because of the definition in the mappings element.

            -

            XML Object

            -

            A metadata object that allows for more fine-tuned XML model definitions.

            -

            When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. -See examples for expected behavior.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
            namespacestringThe URI of the namespace definition. Value MUST be in the form of an absolute URI.
            prefixstringThe prefix to be used for the name.
            attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
            wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
            -

            This object MAY be extended with Specification Extensions.

            -

            XML Object Examples

            -

            The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

            -
            No XML Element
            -

            Basic string property:

            -
            
            -{
            -    "animals": {
            -        "type": "string"
            -    }
            -}
            -
            -
            
            -animals:
            -  type: string
            -
            -
            
            -<animals>...</animals>
            -
            -

            Basic string array property (wrapped is false by default):

            -
            
            -{
            -    "animals": {
            -        "type": "array",
            -        "items": {
            -            "type": "string"
            -        }
            -    }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -
            -
            
            -<animals>...</animals>
            -<animals>...</animals>
            -<animals>...</animals>
            -
            -
            XML Name Replacement
            -
            
            -{
            -  "animals": {
            -    "type": "string",
            -    "xml": {
            -      "name": "animal"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: string
            -  xml:
            -    name: animal
            -
            -
            
            -<animal>...</animal>
            -
            -
            XML Attribute, Prefix and Namespace
            -

            In this example, a full model definition is shown.

            -
            
            -{
            -  "Person": {
            -    "type": "object",
            -    "properties": {
            -      "id": {
            -        "type": "integer",
            -        "format": "int32",
            -        "xml": {
            -          "attribute": true
            -        }
            -      },
            -      "name": {
            -        "type": "string",
            -        "xml": {
            -          "namespace": "http://example.com/schema/sample",
            -          "prefix": "sample"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -Person:
            -  type: object
            -  properties:
            -    id:
            -      type: integer
            -      format: int32
            -      xml:
            -        attribute: true
            -    name:
            -      type: string
            -      xml:
            -        namespace: http://example.com/schema/sample
            -        prefix: sample
            -
            -
            
            -<Person id="123">
            -    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
            -</Person>
            -
            -
            XML Arrays
            -

            Changing the element names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            The external name property has no effect on the XML:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animals>value</animals>
            -  <animals>value</animals>
            -</animals>
            -
            -

            To overcome the naming problem in the example above, the following definition can be used:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</animals>
            -
            -

            Affecting both internal and external names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</aliens>
            -
            -

            If we change the external element but not the internal ones:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <aliens>value</aliens>
            -  <aliens>value</aliens>
            -</aliens>
            -
            -

            Security Scheme Object

            -

            Defines a security scheme that can be used by the operations. -Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "oauth2", "openIdConnect".
            descriptionstringAnyA short description for security scheme. CommonMark syntax MAY be used for rich text representation.
            namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
            instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
            schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]].
            bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
            flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
            openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            Security Scheme Object Example

            -
            Basic Authentication Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "basic"
            -}
            -
            -
            
            -type: http
            -scheme: basic
            -
            -
            API Key Sample
            -
            
            -{
            -  "type": "apiKey",
            -  "name": "api_key",
            -  "in": "header"
            -}
            -
            -
            
            -type: apiKey
            -name: api_key
            -in: header
            -
            -
            JWT Bearer Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "bearer",
            -  "bearerFormat": "JWT",
            -}
            -
            -
            
            -type: http
            -scheme: bearer
            -bearerFormat: JWT
            -
            -
            Implicit OAuth2 Sample
            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            OAuth Flows Object

            -

            Allows configuration of the supported OAuth Flows.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
            passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
            clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
            authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object

            -

            Configuration details for a supported OAuth Flow

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL.
            tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL.
            refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL.
            scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object Examples

            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    },
            -    "authorizationCode": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "tokenUrl": "https://example.com/api/oauth/token",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -  authorizationCode:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    tokenUrl: https://example.com/api/oauth/token
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            Security Requirement Object

            -

            Lists the required security schemes to execute this operation. -The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

            -

            Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. -This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

            -

            When a list of Security Requirement Objects is defined on the Open API object or Operation Object, only one of Security Requirement Objects in the list needs to be satisfied to authorize the request.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution. For other security scheme types, the array MUST be empty.
            -

            Security Requirement Object Examples

            -
            Non-OAuth2 Security Requirement
            -
            
            -{
            -  "api_key": []
            -}
            -
            -
            
            -api_key: []
            -
            -
            OAuth2 Security Requirement
            -
            
            -{
            -  "petstore_auth": [
            -    "write:pets",
            -    "read:pets"
            -  ]
            -}
            -
            -
            
            -petstore_auth:
            -- write:pets
            -- read:pets
            -
            -

            Specification Extensions

            -

            While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

            -

            The extensions properties are implemented as patterned fields that are always prefixed by "x-".

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. Can have any valid JSON format value.
            -

            The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

            -

            Security Filtering

            -

            Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

            -

            The reasoning is to allow an additional layer of access control over the documentation. -While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

            -

            Two examples of this:

            -
              -
            1. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
            2. -
            3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the Paths Object, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
            4. -
            -

            Appendix A: Revision History

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            VersionDateNotes
            3.0.12017-12-06Patch release of the OpenAPI Specification 3.0.1
            3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
            3.0.0-rc22017-06-16rc2 of the 3.0 specification
            3.0.0-rc12017-04-27rc1 of the 3.0 specification
            3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
            2.02015-12-31Donation of Swagger 2.0 to the Open API Initiative
            2.02014-09-08Release of Swagger 2.0
            1.22014-03-14Initial release of the formal document.
            1.12012-08-22Release of Swagger 1.1
            1.02011-08-10First release of the Swagger Specification
            - diff --git a/docs/oas/v3.0.2.html b/docs/oas/v3.0.2.html deleted file mode 100644 index 62d24105fa..0000000000 --- a/docs/oas/v3.0.2.html +++ /dev/null @@ -1,4055 +0,0 @@ -OpenAPI Specification v3.0.2 | Introduction, Definitions, & More - - -

            OpenAPI Specification v3.0.2

            The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

            Status of This Document

            The source-of-truth for the specification is the GitHub markdown file referenced above.
            -

            OpenAPI Specification

            -

            Version 3.0.2

            -

            The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

            -

            This document is licensed under The Apache License, Version 2.0.

            -

            Introduction

            -

            The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

            -

            An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

            - -

            Definitions

            -

            OpenAPI Document

            -

            A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

            -

            Path Templating

            -

            Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.

            -

            Media Types

            -

            Media type definitions are spread across several resources. -The media type definitions SHOULD be in compliance with [[!RFC6838]].

            -

            Some examples of possible media type definitions:

            -
            
            -  text/plain; charset=utf-8
            -  application/json
            -  application/vnd.github+json
            -  application/vnd.github.v3+json
            -  application/vnd.github.v3.raw+json
            -  application/vnd.github.v3.text+json
            -  application/vnd.github.v3.html+json
            -  application/vnd.github.v3.full+json
            -  application/vnd.github.v3.diff
            -  application/vnd.github.v3.patch
            -
            -

            HTTP Status Codes

            -

            The HTTP Status Codes are used to indicate the status of the executed operation. -The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

            -

            Specification

            -

            Versions

            -

            The OpenAPI Specification is versioned using Semantic Versioning 2.0.0 (semver) and follows the semver specification.

            -

            The major.minor portion of the semver (for example 3.0) SHALL designate the OAS feature set. Typically, .patch versions address errors in this document, not the feature set. Tooling which supports OAS 3.0 SHOULD be compatible with all OAS 3.0.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.0.0 and 3.0.1 for example.

            -

            Subsequent minor version releases of the OpenAPI Specification (incrementing the minor version number) SHOULD NOT interfere with tooling developed to a lower minor version and same major version. Thus a hypothetical 3.1.0 specification SHOULD be usable with tooling designed for 3.0.0.

            -

            An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the semantic version of the OAS that it uses. (OAS 2.0 documents contain a top-level version field named swagger and value "2.0".)

            -

            Format

            -

            An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

            -

            For example, if a field has an array value, the JSON array representation will be used:

            -
            
            -{
            -   "field": [ 1, 2, 3 ]
            -}
            -
            -

            All field names in the specification are case sensitive. -This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

            -

            The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

            -

            Patterned fields MUST have unique names within the containing object.

            -

            In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

            - -

            Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

            -

            Document Structure

            -

            An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

            -

            It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

            -

            Data Types

            -

            Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. -Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. -null is not supported as a type (see nullable for an alternative solution). -Models are defined using the Schema Object, which is an extended subset of JSON Schema Specification Wright Draft 00.

            -

            Primitives have an optional modifier property: format. -OAS uses several known formats to define in fine detail the data type being used. -However, to support documentation needs, the format property is an open string-valued property, and can have any value. -Formats such as "email", "uuid", and so on, MAY be used even though undefined by this specification. -Types that are not accompanied by a format property follow the type definition in the JSON Schema. Tools that do not recognize a specific format MAY default back to the type alone, as if the format is not specified.

            -

            The formats defined by the OAS are:

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            typeformatComments
            integerint32signed 32 bits
            integerint64signed 64 bits (a.k.a long)
            numberfloat
            numberdouble
            string
            stringbytebase64 encoded characters
            stringbinaryany sequence of octets
            boolean
            stringdateAs defined by full-date - [!RFC3339]
            stringdate-timeAs defined by date-time - [!RFC3339]
            stringpasswordA hint to UIs to obscure input.
            -

            Rich Text Formatting

            -

            Throughout the specification description fields are noted as supporting CommonMark markdown formatting. -Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

            -

            Relative References in URLs

            -

            Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. -Relative references are resolved using the URLs defined in the Server Object as a Base URI.

            -

            Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

            -

            Schema

            -

            In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

            -

            OpenAPI Object

            -

            This is the root document object of the OpenAPI document.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            openapistringREQUIRED. This string MUST be the semantic version number of the OpenAPI Specification version that the OpenAPI document uses. The openapi field SHOULD be used by tooling specifications and clients to interpret the OpenAPI document. This is not related to the API info.version string.
            infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
            servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
            pathsPaths ObjectREQUIRED. The available paths and operations for the API.
            componentsComponents ObjectAn element to hold various schemas for the specification.
            security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition.
            tags[Tag Object]A list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
            externalDocsExternal Documentation ObjectAdditional external documentation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object

            -

            The object provides metadata about the API. -The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            titlestringREQUIRED. The title of the application.
            descriptionstringA short description of the application. CommonMark syntax MAY be used for rich text representation.
            termsOfServicestringA URL to the Terms of Service for the API. MUST be in the format of a URL.
            contactContact ObjectThe contact information for the exposed API.
            licenseLicense ObjectThe license information for the exposed API.
            versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object Example

            -
            
            -{
            -  "title": "Sample Pet Store App",
            -  "description": "This is a sample server for a pet store.",
            -  "termsOfService": "http://example.com/terms/",
            -  "contact": {
            -    "name": "API Support",
            -    "url": "http://www.example.com/support",
            -    "email": "support@example.com"
            -  },
            -  "license": {
            -    "name": "Apache 2.0",
            -    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
            -  },
            -  "version": "1.0.1"
            -}
            -
            -
            
            -title: Sample Pet Store App
            -description: This is a sample server for a pet store.
            -termsOfService: http://example.com/terms/
            -contact:
            -  name: API Support
            -  url: http://www.example.com/support
            -  email: support@example.com
            -license:
            -  name: Apache 2.0
            -  url: https://www.apache.org/licenses/LICENSE-2.0.html
            -version: 1.0.1
            -
            -

            Contact Object

            -

            Contact information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringThe identifying name of the contact person/organization.
            urlstringThe URL pointing to the contact information. MUST be in the format of a URL.
            emailstringThe email address of the contact person/organization. MUST be in the format of an email address.
            -

            This object MAY be extended with Specification Extensions.

            -

            Contact Object Example

            -
            
            -{
            -  "name": "API Support",
            -  "url": "http://www.example.com/support",
            -  "email": "support@example.com"
            -}
            -
            -
            
            -name: API Support
            -url: http://www.example.com/support
            -email: support@example.com
            -
            -

            License Object

            -

            License information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The license name used for the API.
            urlstringA URL to the license used for the API. MUST be in the format of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            License Object Example

            -
            
            -{
            -  "name": "Apache 2.0",
            -  "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
            -}
            -
            -
            
            -name: Apache 2.0
            -url: https://www.apache.org/licenses/LICENSE-2.0.html
            -
            -

            Server Object

            -

            An object representing a Server.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
            descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
            variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
            -

            This object MAY be extended with Specification Extensions.

            -

            Server Object Example

            -

            A single server would be described as:

            -
            
            -{
            -  "url": "https://development.gigantic-server.com/v1",
            -  "description": "Development server"
            -}
            -
            -
            
            -url: https://development.gigantic-server.com/v1
            -description: Development server
            -
            -

            The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://development.gigantic-server.com/v1",
            -      "description": "Development server"
            -    },
            -    {
            -      "url": "https://staging.gigantic-server.com/v1",
            -      "description": "Staging server"
            -    },
            -    {
            -      "url": "https://api.gigantic-server.com/v1",
            -      "description": "Production server"
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://development.gigantic-server.com/v1
            -  description: Development server
            -- url: https://staging.gigantic-server.com/v1
            -  description: Staging server
            -- url: https://api.gigantic-server.com/v1
            -  description: Production server
            -
            -

            The following shows how variables can be used for a server configuration:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
            -      "description": "The production API server",
            -      "variables": {
            -        "username": {
            -          "default": "demo",
            -          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
            -        },
            -        "port": {
            -          "enum": [
            -            "8443",
            -            "443"
            -          ],
            -          "default": "8443"
            -        },
            -        "basePath": {
            -          "default": "v2"
            -        }
            -      }
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://{username}.gigantic-server.com:{port}/{basePath}
            -  description: The production API server
            -  variables:
            -    username:
            -      # note! no enum here means it is an open value
            -      default: demo
            -      description: this value is assigned by the service provider, in this example `gigantic-server.com`
            -    port:
            -      enum:
            -        - '8443'
            -        - '443'
            -      default: '8443'
            -    basePath:
            -      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
            -      default: v2
            -
            -

            Server Variable Object

            -

            An object representing a Server Variable for server URL template substitution.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            enum[string]An enumeration of string values to be used if the substitution options are from a limited set.
            defaultstringREQUIRED. The default value to use for substitution, which SHALL be sent if an alternate value is not supplied. Note this behavior is different than the Schema Object’s treatment of default values, because in those cases parameter values are optional.
            descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Components Object

            -

            Holds a set of reusable objects for different aspects of the OAS. -All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemasMap[string, Schema Object | Reference Object]An object to hold reusable Schema Objects.
            responsesMap[string, Response Object | Reference Object]An object to hold reusable Response Objects.
            parametersMap[string, Parameter Object | Reference Object]An object to hold reusable Parameter Objects.
            examplesMap[string, Example Object | Reference Object]An object to hold reusable Example Objects.
            requestBodiesMap[string, Request Body Object | Reference Object]An object to hold reusable Request Body Objects.
            headersMap[string, Header Object | Reference Object]An object to hold reusable Header Objects.
            securitySchemesMap[string, Security Scheme Object | Reference Object]An object to hold reusable Security Scheme Objects.
            linksMap[string, Link Object | Reference Object]An object to hold reusable Link Objects.
            callbacksMap[string, Callback Object | Reference Object]An object to hold reusable Callback Objects.
            -

            This object MAY be extended with Specification Extensions.

            -

            All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

            -

            Field Name Examples:

            -
            
            -User
            -User_1
            -User_Name
            -user-name
            -my.org.User
            -
            -

            Components Object Example

            -
            
            -"components": {
            -  "schemas": {
            -    "GeneralError": {
            -      "type": "object",
            -      "properties": {
            -        "code": {
            -          "type": "integer",
            -          "format": "int32"
            -        },
            -        "message": {
            -          "type": "string"
            -        }
            -      }
            -    },
            -    "Category": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    },
            -    "Tag": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  },
            -  "parameters": {
            -    "skipParam": {
            -      "name": "skip",
            -      "in": "query",
            -      "description": "number of items to skip",
            -      "required": true,
            -      "schema": {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    },
            -    "limitParam": {
            -      "name": "limit",
            -      "in": "query",
            -      "description": "max records to return",
            -      "required": true,
            -      "schema" : {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    }
            -  },
            -  "responses": {
            -    "NotFound": {
            -      "description": "Entity not found."
            -    },
            -    "IllegalInput": {
            -      "description": "Illegal input for operation."
            -    },
            -    "GeneralError": {
            -      "description": "General Error",
            -      "content": {
            -        "application/json": {
            -          "schema": {
            -            "$ref": "#/components/schemas/GeneralError"
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "securitySchemes": {
            -    "api_key": {
            -      "type": "apiKey",
            -      "name": "api_key",
            -      "in": "header"
            -    },
            -    "petstore_auth": {
            -      "type": "oauth2",
            -      "flows": {
            -        "implicit": {
            -          "authorizationUrl": "http://example.org/api/oauth/dialog",
            -          "scopes": {
            -            "write:pets": "modify pets in your account",
            -            "read:pets": "read your pets"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    GeneralError:
            -      type: object
            -      properties:
            -        code:
            -          type: integer
            -          format: int32
            -        message:
            -          type: string
            -    Category:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -    Tag:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -  parameters:
            -    skipParam:
            -      name: skip
            -      in: query
            -      description: number of items to skip
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -    limitParam:
            -      name: limit
            -      in: query
            -      description: max records to return
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -  responses:
            -    NotFound:
            -      description: Entity not found.
            -    IllegalInput:
            -      description: Illegal input for operation.
            -    GeneralError:
            -      description: General Error
            -      content:
            -        application/json:
            -          schema:
            -            $ref: '#/components/schemas/GeneralError'
            -  securitySchemes:
            -    api_key:
            -      type: apiKey
            -      name: api_key
            -      in: header
            -    petstore_auth:
            -      type: oauth2
            -      flows:
            -        implicit:
            -          authorizationUrl: http://example.org/api/oauth/dialog
            -          scopes:
            -            write:pets: modify pets in your account
            -            read:pets: read your pets
            -
            -

            Paths Object

            -

            Holds the relative paths to the individual endpoints and their operations. -The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a slash. The path is appended (no relative URL resolution) to the expanded URL from the Server Object’s url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Templating Matching

            -

            Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

            -
            
            -  /pets/{petId}
            -  /pets/mine
            -
            -

            The following paths are considered identical and invalid:

            -
            
            -  /pets/{petId}
            -  /pets/{name}
            -
            -

            The following may lead to ambiguous resolution:

            -
            
            -  /{entity}/me
            -  /books/{id}
            -
            -

            Paths Object Example

            -
            
            -{
            -  "/pets": {
            -    "get": {
            -      "description": "Returns all pets from the system that the user has access to",
            -      "responses": {
            -        "200": {         
            -          "description": "A list of pets.",
            -          "content": {
            -            "application/json": {
            -              "schema": {
            -                "type": "array",
            -                "items": {
            -                  "$ref": "#/components/schemas/pet"
            -                }
            -              }
            -            }
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -/pets:
            -  get:
            -    description: Returns all pets from the system that the user has access to
            -    responses:
            -      '200':
            -        description: A list of pets.
            -        content:
            -          application/json:
            -            schema:
            -              type: array
            -              items:
            -                $ref: '#/components/schemas/pet'
            -
            -

            Path Item Object

            -

            Describes the operations available on a single path. -A Path Item MAY be empty, due to ACL constraints. -The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringAllows for an external definition of this path item. The referenced structure MUST be in the format of a Path Item Object. If there are conflicts between the referenced definition and this Path Item’s definition, the behavior is undefined.
            summarystringAn optional, string summary, intended to apply to all operations in this path.
            descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
            getOperation ObjectA definition of a GET operation on this path.
            putOperation ObjectA definition of a PUT operation on this path.
            postOperation ObjectA definition of a POST operation on this path.
            deleteOperation ObjectA definition of a DELETE operation on this path.
            optionsOperation ObjectA definition of a OPTIONS operation on this path.
            headOperation ObjectA definition of a HEAD operation on this path.
            patchOperation ObjectA definition of a PATCH operation on this path.
            traceOperation ObjectA definition of a TRACE operation on this path.
            servers[Server Object]An alternative server array to service all operations in this path.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Item Object Example

            -
            
            -{
            -  "get": {
            -    "description": "Returns pets based on ID",
            -    "summary": "Find pets by ID",
            -    "operationId": "getPetsById",
            -    "responses": {
            -      "200": {
            -        "description": "pet response",
            -        "content": {
            -          "*/*": {
            -            "schema": {
            -              "type": "array",
            -              "items": {
            -                "$ref": "#/components/schemas/Pet"
            -              }
            -            }
            -          }
            -        }
            -      },
            -      "default": {
            -        "description": "error payload",
            -        "content": {
            -          "text/html": {
            -            "schema": {
            -              "$ref": "#/components/schemas/ErrorModel"
            -            }
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "parameters": [
            -    {
            -      "name": "id",
            -      "in": "path",
            -      "description": "ID of pet to use",
            -      "required": true,
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      },
            -      "style": "simple"
            -    }
            -  ]
            -}
            -
            -
            
            -get:
            -  description: Returns pets based on ID
            -  summary: Find pets by ID
            -  operationId: getPetsById
            -  responses:
            -    '200':
            -      description: pet response
            -      content:
            -        '*/*' :
            -          schema:
            -            type: array
            -            items:
            -              $ref: '#/components/schemas/Pet'
            -    default:
            -      description: error payload
            -      content:
            -        'text/html':
            -          schema:
            -            $ref: '#/components/schemas/ErrorModel'
            -parameters:
            -- name: id
            -  in: path
            -  description: ID of pet to use
            -  required: true
            -  schema:
            -    type: array
            -    style: simple
            -    items:
            -      type: string 
            -
            -

            Operation Object

            -

            Describes a single API operation on a path.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
            summarystringA short summary of what the operation does.
            descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
            operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. The operationId value is case-sensitive. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            requestBodyRequest Body Object | Reference ObjectThe request body applicable for this operation. The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers.
            responsesResponses ObjectREQUIRED. The list of possible responses as they are returned from executing this operation.
            callbacksMap[string, Callback Object | Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses. The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.
            deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
            security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
            servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
            -

            This object MAY be extended with Specification Extensions.

            -

            Operation Object Example

            -
            
            -{
            -  "tags": [
            -    "pet"
            -  ],
            -  "summary": "Updates a pet in the store with form data",
            -  "operationId": "updatePetWithForm",
            -  "parameters": [
            -    {
            -      "name": "petId",
            -      "in": "path",
            -      "description": "ID of pet that needs to be updated",
            -      "required": true,
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  ],
            -  "requestBody": {
            -    "content": {
            -      "application/x-www-form-urlencoded": {
            -        "schema": {
            -          "type": "object",
            -           "properties": {
            -              "name": {
            -                "description": "Updated name of the pet",
            -                "type": "string"
            -              },
            -              "status": {
            -                "description": "Updated status of the pet",
            -                "type": "string"
            -             }
            -           },
            -        "required": ["status"]
            -        }
            -      }
            -    }
            -  },
            -  "responses": {
            -    "200": {
            -      "description": "Pet updated.",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    },
            -    "405": {
            -      "description": "Method Not Allowed",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    }
            -  },
            -  "security": [
            -    {
            -      "petstore_auth": [
            -        "write:pets",
            -        "read:pets"
            -      ]
            -    }
            -  ]
            -}
            -
            -
            
            -tags:
            -- pet
            -summary: Updates a pet in the store with form data
            -operationId: updatePetWithForm
            -parameters:
            -- name: petId
            -  in: path
            -  description: ID of pet that needs to be updated
            -  required: true
            -  schema:
            -    type: string
            -requestBody:
            -  content:
            -    'application/x-www-form-urlencoded':
            -      schema:
            -       properties:
            -          name:
            -            description: Updated name of the pet
            -            type: string
            -          status:
            -            description: Updated status of the pet
            -            type: string
            -       required:
            -         - status
            -responses:
            -  '200':
            -    description: Pet updated.
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -  '405':
            -    description: Method Not Allowed
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -security:
            -- petstore_auth:
            -  - write:pets
            -  - read:pets
            -
            -

            External Documentation Object

            -

            Allows referencing an external resource for extended documentation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA short description of the target documentation. CommonMark syntax MAY be used for rich text representation.
            urlstringREQUIRED. The URL for the target documentation. Value MUST be in the format of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            External Documentation Object Example

            -
            
            -{
            -  "description": "Find more info here",
            -  "url": "https://example.com"
            -}
            -
            -
            
            -description: Find more info here
            -url: https://example.com
            -
            -

            Parameter Object

            -

            Describes a single operation parameter.

            -

            A unique parameter is defined by a combination of a name and location.

            -

            Parameter Locations

            -

            There are four possible parameter locations specified by the in field:

            -
              -
            • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
            • -
            • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
            • -
            • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
            • -
            • cookie - Used to pass a specific cookie value to the API.
            • -
            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
            • If in is "path", the name field MUST correspond to the associated path segment from the path field in the Paths Object. See Path Templating for further information.
            • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
            • For all other cases, the name corresponds to the parameter name used by the in property.
            instringREQUIRED. The location of the parameter. Possible values are “query”, “header”, “path” or “cookie”.
            descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is “path”, this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
            deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage. Default value is false.
            allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored. Use of this property is NOT RECOMMENDED, as it is likely to be removed in a later revision.
            -

            The rules for serialization of the parameter are specified in one of two ways. -For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
            explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
            schemaSchema Object | Reference ObjectThe schema defining the type used for the parameter.
            exampleAnyExample of the media type. The example SHOULD match the specified schema and encoding properties if present. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
            examplesMap[ string, Example Object | Reference Object]Examples of the media type. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
            -

            For more complex scenarios, the content property can define the media type and schema of the parameter. -A parameter MUST contain either a schema property, or a content property, but not both. -When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
            -

            Style Values

            -

            In order to support common ways of serializing simple parameters, a set of style values are defined.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styletypeinComments
            matrixprimitive, array, objectpathPath-style parameters defined by [[!RFC6570]]
            labelprimitive, array, objectpathLabel style parameters defined by [[!RFC6570]]
            formprimitive, array, objectquery, cookieForm style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
            simplearraypath, headerSimple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0.
            spaceDelimitedarrayquerySpace separated array values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
            pipeDelimitedarrayqueryPipe separated array values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
            deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
            -

            Style Examples

            -

            Assume a parameter named color has one of the following values:

            -
            
            -   string -> "blue"
            -   array -> ["blue","black","brown"]
            -   object -> { "R": 100, "G": 200, "B": 150 }
            -
            -

            The following table shows examples of rendering differences for each value.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styleexplodeemptystringarrayobject
            matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
            matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
            labelfalse..blue.blue.black.brown.R.100.G.200.B.150
            labeltrue..blue.blue.black.brown.R=100.G=200.B=150
            formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
            formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
            simplefalsen/ablueblue,black,brownR,100,G,200,B,150
            simpletruen/ablueblue,black,brownR=100,G=200,B=150
            spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
            pipeDelimitedfalsen/an/ablue|black|brownR|100|G|200
            deepObjecttruen/an/an/acolor[R]=100&color[G]=200&color[B]=150
            -

            This object MAY be extended with Specification Extensions.

            -

            Parameter Object Examples

            -

            A header parameter with an array of 64 bit integer numbers:

            -
            
            -{
            -  "name": "token",
            -  "in": "header",
            -  "description": "token to be passed as a header",
            -  "required": true,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "integer",
            -      "format": "int64"
            -    }
            -  },
            -  "style": "simple"
            -}
            -
            -
            
            -name: token
            -in: header
            -description: token to be passed as a header
            -required: true
            -schema:
            -  type: array
            -  items:
            -    type: integer
            -    format: int64
            -style: simple
            -
            -

            A path parameter of a string value:

            -
            
            -{
            -  "name": "username",
            -  "in": "path",
            -  "description": "username to fetch",
            -  "required": true,
            -  "schema": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -name: username
            -in: path
            -description: username to fetch
            -required: true
            -schema:
            -  type: string
            -
            -

            An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

            -
            
            -{
            -  "name": "id",
            -  "in": "query",
            -  "description": "ID of the object to fetch",
            -  "required": false,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    }
            -  },
            -  "style": "form",
            -  "explode": true
            -}
            -
            -
            
            -name: id
            -in: query
            -description: ID of the object to fetch
            -required: false
            -schema:
            -  type: array
            -  items:
            -    type: string
            -style: form
            -explode: true
            -
            -

            A free-form query parameter, allowing undefined parameters of a specific type:

            -
            
            -{
            -  "in": "query",
            -  "name": "freeForm",
            -  "schema": {
            -    "type": "object",
            -    "additionalProperties": {
            -      "type": "integer"
            -    },
            -  },
            -  "style": "form"
            -}
            -
            -
            
            -in: query
            -name: freeForm
            -schema:
            -  type: object
            -  additionalProperties:
            -    type: integer
            -style: form
            -
            -

            A complex parameter using content to define serialization:

            -
            
            -{
            -  "in": "query",
            -  "name": "coordinates",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "object",
            -        "required": [
            -          "lat",
            -          "long"
            -        ],
            -        "properties": {
            -          "lat": {
            -            "type": "number"
            -          },
            -          "long": {
            -            "type": "number"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -in: query
            -name: coordinates
            -content:
            -  application/json:
            -    schema:
            -      type: object
            -      required:
            -        - lat
            -        - long
            -      properties:
            -        lat:
            -          type: number
            -        long:
            -          type: number
            -
            -

            Request Body Object

            -

            Describes a single request body.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            requiredbooleanDetermines if the request body is required in the request. Defaults to false.
            -

            This object MAY be extended with Specification Extensions.

            -

            Request Body Examples

            -

            A request body with a referenced model definition.

            -
            
            -{
            -  "description": "user to add to the system",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User Example",
            -            "externalValue": "http://foo.bar/examples/user-example.json"
            -          }
            -        }
            -    },
            -    "application/xml": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User example in XML",
            -            "externalValue": "http://foo.bar/examples/user-example.xml"
            -          }
            -        }
            -    },
            -    "text/plain": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in Plain text",
            -            "externalValue": "http://foo.bar/examples/user-example.txt"
            -        }
            -      }
            -    },
            -    "*/*": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in other format",
            -            "externalValue": "http://foo.bar/examples/user-example.whatever"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -content:
            -  'application/json':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User Example
            -        externalValue: 'http://foo.bar/examples/user-example.json'
            -  'application/xml':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User Example in XML
            -        externalValue: 'http://foo.bar/examples/user-example.xml'
            -  'text/plain':
            -    examples:
            -      user:
            -        summary: User example in text plain format
            -        externalValue: 'http://foo.bar/examples/user-example.txt'
            -  '*/*':
            -    examples:
            -      user:
            -        summary: User example in other format
            -        externalValue: 'http://foo.bar/examples/user-example.whatever'
            -
            -

            A body parameter that is an array of string values:

            -
            
            -{
            -  "description": "user to add to the system",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -required: true
            -content:
            -  text/plain:
            -    schema:
            -      type: array
            -      items:
            -        type: string
            -
            -

            Media Type Object

            -

            Each Media Type Object provides schema and examples for the media type identified by its key.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemaSchema Object | Reference ObjectThe schema defining the content of the request, response, or parameter.
            exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
            examplesMap[ string, Example Object | Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
            encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
            -

            This object MAY be extended with Specification Extensions.

            -

            Media Type Examples

            -
            
            -{
            -  "application/json": {
            -    "schema": {
            -         "$ref": "#/components/schemas/Pet"
            -    },
            -    "examples": {
            -      "cat" : {
            -        "summary": "An example of a cat",
            -        "value":
            -          {
            -            "name": "Fluffy",
            -            "petType": "Cat",
            -            "color": "White",
            -            "gender": "male",
            -            "breed": "Persian"
            -          }
            -      },
            -      "dog": {
            -        "summary": "An example of a dog with a cat's name",
            -        "value" :  {
            -          "name": "Puma",
            -          "petType": "Dog",
            -          "color": "Black",
            -          "gender": "Female",
            -          "breed": "Mixed"
            -        },
            -      "frog": {
            -          "$ref": "#/components/examples/frog-example"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -application/json:
            -  schema:
            -    $ref: "#/components/schemas/Pet"
            -  examples:
            -    cat:
            -      summary: An example of a cat
            -      value:
            -        name: Fluffy
            -        petType: Cat
            -        color: White
            -        gender: male
            -        breed: Persian
            -    dog:
            -      summary: An example of a dog with a cat's name
            -      value:
            -        name: Puma
            -        petType: Dog
            -        color: Black
            -        gender: Female
            -        breed: Mixed
            -    frog:
            -      $ref: "#/components/examples/frog-example"
            -
            -

            Considerations for File Uploads

            -

            In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type. Specifically:

            -
            
            -# content transferred with base64 encoding
            -schema:
            -  type: string
            -  format: base64
            -
            -
            
            -# content transferred in binary (octet-stream):
            -schema:
            -  type: string
            -  format: binary
            -
            -

            These examples apply to either input payloads of file uploads or response payloads.

            -

            A requestBody for submitting a file in a POST operation may look like the following example:

            -
            
            -requestBody:
            -  content:
            -    application/octet-stream:
            -      # any media type is accepted, functionally equivalent to `*/*`
            -      schema:
            -        # a binary file of any type
            -        type: string
            -        format: binary
            -
            -

            In addition, specific media types MAY be specified:

            -
            
            -# multiple, specific media types may be specified:
            -requestBody:
            -  content:
            -      # a binary file of type png or jpeg
            -    'image/jpeg':
            -      schema:
            -        type: string
            -        format: binary
            -    'image/png':
            -      schema:
            -        type: string
            -        format: binary       
            -
            -

            To upload multiple files, a multipart media type MUST be used:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        properties:
            -          # The property name 'file' will be used for all files.
            -          file:
            -            type: array
            -            items:
            -              type: string
            -              format: binary
            -
            -
            -

            Support for x-www-form-urlencoded Request Bodies

            -

            To submit content using form url encoding via [[!RFC1866]], the following -definition may be used:

            -
            
            -requestBody:
            -  content:
            -    application/x-www-form-urlencoded:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # complex types are stringified to support RFC 1866
            -            type: object
            -            properties: {}
            -
            -

            In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

            -

            When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object’s style property as form.

            -

            Special Considerations for multipart Content

            -

            It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

            -

            When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred — thus, the following default Content-Types are defined for multipart:

            -
              -
            • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
            • -
            • If the property is complex, or an array of complex values, the default Content-Type is application/json
            • -
            • If the property is a type: string with format: binary or format: base64 (aka a file object), the default Content-Type is application/octet-stream
            • -
            -

            Examples:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # default Content-Type for objects is `application/json`
            -            type: object
            -            properties: {}
            -          profileImage:
            -            # default Content-Type for string/binary is `application/octet-stream`
            -            type: string
            -            format: binary
            -          children:
            -            # default Content-Type for arrays is based on the `inner` type (text/plain here)
            -            type: array
            -            items:
            -              type: string
            -          addresses:
            -            # default Content-Type for arrays is based on the `inner` type (object shown, so `application/json` in this example)
            -            type: array
            -            items:
            -              type: '#/components/schemas/Address'
            -
            -

            An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

            -

            Encoding Object

            -

            A single encoding definition applied to a single schema property.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for string with format being binaryapplication/octet-stream; for other primitive types – text/plain; for object - application/json; for array – the default is defined based on the inner type. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
            headersMap[string, Header Object | Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
            stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            -

            This object MAY be extended with Specification Extensions.

            -

            Encoding Object Example

            -
            
            -requestBody:
            -  content:
            -    multipart/mixed:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            # default is text/plain
            -            type: string
            -            format: uuid
            -          address:
            -            # default is application/json
            -            type: object
            -            properties: {}
            -          historyMetadata:
            -            # need to declare XML format!
            -            description: metadata in XML format
            -            type: object
            -            properties: {}
            -          profileImage:
            -            # default is application/octet-stream, need to declare an image type only!
            -            type: string
            -            format: binary
            -      encoding:
            -        historyMetadata:
            -          # require XML Content-Type in utf-8 encoding
            -          contentType: application/xml; charset=utf-8
            -        profileImage:
            -          # only accept png/jpeg
            -          contentType: image/png, image/jpeg
            -          headers:
            -            X-Rate-Limit-Limit:
            -              description: The number of allowed requests in the current period
            -              schema:
            -                type: integer
            -
            -

            Responses Object

            -

            A container for the expected responses of an operation. -The container maps a HTTP response code to the expected response.

            -

            The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. -However, documentation is expected to cover a successful operation response and any known errors.

            -

            The default MAY be used as a default response object for all HTTP codes -that are not covered individually by the specification.

            -

            The Responses Object MUST contain at least one response code, and it -SHOULD be the response for a successful operation call.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            defaultResponse Object | Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses. A Reference Object can link to a response that the OpenAPI Object’s components/responses section defines.
            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            HTTP Status CodeResponse Object | Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. A Reference Object can link to a response that is defined in the OpenAPI Object’s components/responses section. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. Only the following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
            -

            This object MAY be extended with Specification Extensions.

            -

            Responses Object Example

            -

            A 200 response for a successful operation and a default response for others (implying an error):

            -
            
            -{
            -  "200": {
            -    "description": "a pet to be returned",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/Pet"
            -        }
            -      }
            -    }
            -  },
            -  "default": {
            -    "description": "Unexpected error",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/ErrorModel"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -'200':
            -  description: a pet to be returned
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/Pet'
            -default:
            -  description: Unexpected error
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/ErrorModel'
            -
            -

            Response Object

            -

            Describes a single response from an API Operation, including design-time, static -links to operations based on the response.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringREQUIRED. A short description of the response. CommonMark syntax MAY be used for rich text representation.
            headersMap[string, Header Object | Reference Object]Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
            contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            linksMap[string, Link Object | Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
            -

            This object MAY be extended with Specification Extensions.

            -

            Response Object Examples

            -

            Response of an array of a complex type:

            -
            
            -{
            -  "description": "A complex object array response",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "$ref": "#/components/schemas/VeryComplexType"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A complex object array response
            -content:
            -  application/json:
            -    schema:
            -      type: array
            -      items:
            -        $ref: '#/components/schemas/VeryComplexType'
            -
            -

            Response with a string type:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  }
            -
            -}
            -
            -
            
            -description: A simple string response
            -content:
            -  text/plain:
            -    schema:
            -      type: string
            -
            -

            Plain text response with headers:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  },
            -  "headers": {
            -    "X-Rate-Limit-Limit": {
            -      "description": "The number of allowed requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Remaining": {
            -      "description": "The number of remaining requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Reset": {
            -      "description": "The number of seconds left in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A simple string response
            -content:
            -  text/plain:
            -    schema:
            -      type: string
            -    example: 'whoa!'
            -headers:
            -  X-Rate-Limit-Limit:
            -    description: The number of allowed requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Remaining:
            -    description: The number of remaining requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Reset:
            -    description: The number of seconds left in the current period
            -    schema:
            -      type: integer
            -
            -

            Response with no return value:

            -
            
            -{
            -  "description": "object created"
            -}
            -
            -
            
            -description: object created
            -
            -

            Callback Object

            -

            A map of possible out-of band callbacks related to the parent operation. -Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. -The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {expression}Path Item ObjectA Path Item Object used to define a callback request and expected responses. A complete example is available.
            -

            This object MAY be extended with Specification Extensions.

            -

            Key Expression

            -

            The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. -A simple example might be $request.body#/url. -However, using a runtime expression the complete HTTP message can be accessed. -This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

            -

            For example, given the following HTTP request:

            -
            
            -POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
            -Host: example.org
            -Content-Type: application/json
            -Content-Length: 187
            -
            -{
            -  "failedUrl" : "http://clientdomain.com/failed",
            -  "successUrls" : [
            -    "http://clientdomain.com/fast",
            -    "http://clientdomain.com/medium",
            -    "http://clientdomain.com/slow"
            -  ]
            -}
            -
            -201 Created
            -Location: http://example.org/subscription/1
            -
            -

            The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            ExpressionValue
            $urlhttp://example.org/subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning
            $methodPOST
            $request.path.eventTypemyevent
            $request.query.queryUrlhttp://clientdomain.com/stillrunning
            $request.header.content-Typeapplication/json
            $request.body#/failedUrlhttp://clientdomain.com/failed
            $request.body#/successUrls/2http://clientdomain.com/medium
            $response.header.Locationhttp://example.org/subscription/1
            -

            Callback Object Example

            -

            The following example shows a callback to the URL specified by the id and email property in the request body.

            -
            
            -myWebhook:
            -  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
            -    post:
            -      requestBody:
            -        description: Callback payload
            -        content:
            -          'application/json':
            -            schema:
            -              $ref: '#/components/schemas/SomePayload'
            -      responses:
            -        '200':
            -          description: webhook successfully processed and no retries will be performed
            -
            -

            Example Object

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            summarystringShort description for the example.
            descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
            valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
            externalValuestringA URL that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive.
            -

            This object MAY be extended with Specification Extensions.

            -

            In all cases, the example value is expected to be compatible with the type schema -of its associated value. Tooling implementations MAY choose to -validate compatibility automatically, and reject the example value(s) if incompatible.

            -

            Example Object Examples

            -

            In a model:

            -
            
            -schemas:
            -  properties:
            -    name:
            -      type: string
            -      examples:
            -        name:
            -          $ref: http://example.org/petapi-examples/openapi.json#/components/examples/name-example
            -
            -

            In a request body:

            -
            
            -requestBody:
            -  content:
            -    'application/json':
            -      schema:
            -        $ref: '#/components/schemas/Address'
            -      examples:
            -        foo:
            -          summary: A foo example
            -          value: {"foo": "bar"}
            -        bar:
            -          summary: A bar example
            -          value: {"bar": "baz"}
            -    'application/xml':
            -      examples:
            -        xmlExample:
            -          summary: This is an example in XML
            -          externalValue: 'http://example.org/examples/address-example.xml'
            -    'text/plain':
            -      examples:
            -        textExample:
            -          summary: This is a text example
            -          externalValue: 'http://foo.bar/examples/address-example.txt'
            -
            -

            In a parameter:

            -
            
            -parameters:
            -  - name: 'zipCode'
            -    in: 'query'
            -    schema:
            -      type: 'string'
            -      format: 'zip-code'
            -      examples:
            -        zip-example:
            -          $ref: '#/components/examples/zip-example'
            -
            -

            In a response:

            -
            
            -responses:
            -  '200':
            -    description: your car appointment has been booked
            -    content:
            -      application/json:
            -        schema:
            -          $ref: '#/components/schemas/SuccessResponse'
            -        examples:
            -          confirmation-success:
            -            $ref: '#/components/examples/confirmation-success'
            -
            -

            Link Object

            -

            The Link object represents a possible design-time link for a response. -The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

            -

            Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

            -

            For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            operationRefstringA relative or absolute reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition.
            operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
            parametersMap[string, Any | {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
            requestBodyAny | {expression}A literal value or {expression} to use as a request body when calling the target operation.
            descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
            serverServer ObjectA server object to be used by the target operation.
            -

            This object MAY be extended with Specification Extensions.

            -

            A linked operation MUST be identified using either an operationRef or operationId. -In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. -Because of the potential for name clashes, the operationRef syntax is preferred -for specifications with external references.

            -

            Examples

            -

            Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

            -
            
            -paths:
            -  /users/{id}:
            -    parameters:
            -    - name: id
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -    get:
            -      responses:
            -        '200':
            -          description: the user being returned
            -          content:
            -            application/json:
            -              schema:
            -                type: object
            -                properties:
            -                  uuid: # the unique user id
            -                    type: string
            -                    format: uuid
            -          links:
            -            address:
            -              # the target link operationId
            -              operationId: getUserAddress
            -              parameters:
            -                # get the `id` field from the request path parameter named `id`
            -                userId: $request.path.id
            -  # the path item of the linked operation
            -  /users/{userid}/address:
            -    parameters:
            -    - name: userid
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -    # linked operation
            -    get:
            -      operationId: getUserAddress
            -      responses:
            -        '200':
            -          description: the user's address
            -
            -

            When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

            -

            Values from the response body can be used to drive a linked operation.

            -
            
            -links:
            -  address:
            -    operationId: getUserAddressByUUID
            -    parameters:
            -      # get the `uuid` field from the `uuid` field in the response body
            -      userUuid: $response.body#/uuid
            -
            -

            Clients follow all links at their discretion. -Neither permissions, nor the capability to make a successful call to that link, is guaranteed -solely by the existence of a relationship.

            -

            OperationRef Examples

            -

            As references to operationId MAY NOT be possible (the operationId is an optional -value), references MAY also be made through a relative operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            or an absolute operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            Note that in the use of operationRef, the escaped forward-slash is necessary when -using JSON references.

            -

            Runtime Expressions

            -

            Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. -This mechanism is used by Link Objects and Callback Objects.

            -

            The runtime expression is defined by the following ABNF syntax

            -
            
            -      expression = ( "$url" | "$method" | "$statusCode" | "$request." source | "$response." source )
            -      source = ( header-reference | query-reference | path-reference | body-reference ) 
            -      header-reference = "header." token
            -      query-reference = "query." name 
            -      path-reference = "path." name
            -      body-reference = "body" ["#" fragment]
            -      fragment = a JSON Pointer [RFC 6901](https://tools.ietf.org/html/rfc6901) 
            -      name = *( char )
            -      char = as per RFC [7159](https://tools.ietf.org/html/rfc7159#section-7)
            -      token = as per RFC [7230](https://tools.ietf.org/html/rfc7230#section-3.2.6)
            -
            -

            The name identifier is case-sensitive, whereas token is not.

            -

            The table below provides examples of runtime expressions and examples of their use in a value:

            -

            Examples

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Source Locationexample expressionnotes
            HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
            Requested media type$request.header.accept
            Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
            Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
            Request URL$url
            Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
            Response header$response.header.ServerSingle header values only are available
            -

            Runtime expressions preserve the type of the referenced value. -Expressions can be embedded into string values by surrounding the expression with {} curly braces.

            -

            Header Object

            -

            The Header Object follows the structure of the Parameter Object with the following changes:

            -
              -
            1. name MUST NOT be specified, it is given in the corresponding headers map.
            2. -
            3. in MUST NOT be specified, it is implicitly in header.
            4. -
            5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
            6. -
            -

            Header Object Example

            -

            A simple header of type integer:

            -
            
            -{
            -  "description": "The number of allowed requests in the current period",
            -  "schema": {
            -    "type": "integer"
            -  }
            -}
            -
            -
            
            -description: The number of allowed requests in the current period
            -schema:
            -  type: integer
            -
            -

            Tag Object

            -

            Adds metadata to a single tag that is used by the Operation Object. -It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the tag.
            descriptionstringA short description for the tag. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
            -

            This object MAY be extended with Specification Extensions.

            -

            Tag Object Example

            -
            
            -{
            -	"name": "pet",
            -	"description": "Pets operations"
            -}
            -
            -
            
            -name: pet
            -description: Pets operations
            -
            -

            Reference Object

            -

            A simple object to allow referencing other components in the specification, internally and externally.

            -

            The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

            -

            For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringREQUIRED. The reference string.
            -

            This object cannot be extended with additional properties and any properties added SHALL be ignored.

            -

            Reference Object Example

            -
            
            -{
            -	"$ref": "#/components/schemas/Pet"
            -}
            -
            -
            
            -$ref: '#/components/schemas/Pet'
            -
            -

            Relative Schema Document Example

            -
            
            -{
            -  "$ref": "Pet.json"
            -}
            -
            -
            
            -$ref: Pet.yaml
            -
            -

            Relative Documents With Embedded Schema Example

            -
            
            -{
            -  "$ref": "definitions.json#/Pet"
            -}
            -
            -
            
            -$ref: definitions.yaml#/Pet
            -
            -

            Schema Object

            -

            The Schema Object allows the definition of input and output data types. -These types can be objects, but also primitives and arrays. -This object is an extended subset of the JSON Schema Specification Wright Draft 00.

            -

            For more information about the properties, see JSON Schema Core and JSON Schema Validation. -Unless stated otherwise, the property definitions follow the JSON Schema.

            -

            Properties

            -

            The following properties are taken directly from the JSON Schema definition and follow the same specifications:

            -
              -
            • title
            • -
            • multipleOf
            • -
            • maximum
            • -
            • exclusiveMaximum
            • -
            • minimum
            • -
            • exclusiveMinimum
            • -
            • maxLength
            • -
            • minLength
            • -
            • pattern (This string SHOULD be a valid regular expression, according to the ECMA 262 regular expression dialect)
            • -
            • maxItems
            • -
            • minItems
            • -
            • uniqueItems
            • -
            • maxProperties
            • -
            • minProperties
            • -
            • required
            • -
            • enum
            • -
            -

            The following properties are taken from the JSON Schema definition but their definitions were adjusted to the OpenAPI Specification.

            -
              -
            • type - Value MUST be a string. Multiple types via an array are not supported.
            • -
            • allOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • oneOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • anyOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • not - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • items - Value MUST be an object and not an array. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. items MUST be present if the type is array.
            • -
            • properties - Property definitions MUST be a Schema Object and not a standard JSON Schema (inline or referenced).
            • -
            • additionalProperties - Value can be boolean or object. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. Consistent with JSON Schema, additionalProperties defaults to true.
            • -
            • description - CommonMark syntax MAY be used for rich text representation.
            • -
            • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
            • -
            • default - The default value represents what would be assumed by the consumer of the input as the value of the schema if one is not provided. Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object defined at the same level. For example, if type is string, then default can be "foo" but cannot be 1.
            • -
            -

            Alternatively, any time a Schema Object can be used, a Reference Object can be used in its place. This allows referencing definitions instead of defining them inline.

            -

            Additional properties defined by the JSON Schema specification that are not mentioned here are strictly unsupported.

            -

            Other than the JSON Schema subset fields, the following fields MAY be used for further schema documentation:

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            nullablebooleanAllows sending a null value for the defined schema. Default value is false.
            discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
            readOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “read only”. This means that it MAY be sent as part of a response but SHOULD NOT be sent as part of the request. If the property is marked as readOnly being true and is in the required list, the required will take effect on the response only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
            writeOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “write only”. Therefore, it MAY be sent as part of a request but SHOULD NOT be sent as part of the response. If the property is marked as writeOnly being true and is in the required list, the required will take effect on the request only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
            xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
            externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
            exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.
            deprecatedbooleanSpecifies that a schema is deprecated and SHOULD be transitioned out of usage. Default value is false.
            -

            This object MAY be extended with Specification Extensions.

            -
            Composition and Inheritance (Polymorphism)
            -

            The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. -allOf takes an array of object definitions that are validated independently but together compose a single object.

            -

            While composition offers model extensibility, it does not imply a hierarchy between the models. -To support polymorphism, the OpenAPI Specification adds the discriminator field. -When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. -As such, the discriminator field MUST be a required field. -There are two ways to define the value of a discriminator for an inheriting instance.

            -
              -
            • Use the schema name.
            • -
            • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. -As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
            • -
            -
            XML Modeling
            -

            The xml property allows extra definitions when translating the JSON definition to XML. -The XML Object contains additional information about the available options.

            -

            Schema Object Examples

            -
            Primitive Sample
            -
            
            -{
            -  "type": "string",
            -  "format": "email"
            -}
            -
            -
            
            -type: string
            -format: email
            -
            -
            Simple Model
            -
            
            -{
            -  "type": "object",
            -  "required": [
            -    "name"
            -  ],
            -  "properties": {
            -    "name": {
            -      "type": "string"
            -    },
            -    "address": {
            -      "$ref": "#/components/schemas/Address"
            -    },
            -    "age": {
            -      "type": "integer",
            -      "format": "int32",
            -      "minimum": 0
            -    }
            -  }
            -}
            -
            -
            
            -type: object
            -required:
            -- name
            -properties:
            -  name:
            -    type: string
            -  address:
            -    $ref: '#/components/schemas/Address'
            -  age:
            -    type: integer
            -    format: int32
            -    minimum: 0
            -
            -
            Model with Map/Dictionary Properties
            -

            For a simple string to string mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  type: string
            -
            -

            For a string to model mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "$ref": "#/components/schemas/ComplexModel"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  $ref: '#/components/schemas/ComplexModel'
            -
            -
            Model with Example
            -
            
            -{
            -  "type": "object",
            -  "properties": {
            -    "id": {
            -      "type": "integer",
            -      "format": "int64"
            -    },
            -    "name": {
            -      "type": "string"
            -    }
            -  },
            -  "required": [
            -    "name"
            -  ],
            -  "example": {
            -    "name": "Puma",
            -    "id": 1
            -  }
            -}
            -
            -
            
            -type: object
            -properties:
            -  id:
            -    type: integer
            -    format: int64
            -  name:
            -    type: string
            -required:
            -- name
            -example:
            -  name: Puma
            -  id: 1
            -
            -
            Models with Composition
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "ErrorModel": {
            -        "type": "object",
            -        "required": [
            -          "message",
            -          "code"
            -        ],
            -        "properties": {
            -          "message": {
            -            "type": "string"
            -          },
            -          "code": {
            -            "type": "integer",
            -            "minimum": 100,
            -            "maximum": 600
            -          }
            -        }
            -      },
            -      "ExtendedErrorModel": {
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/ErrorModel"
            -          },
            -          {
            -            "type": "object",
            -            "required": [
            -              "rootCause"
            -            ],
            -            "properties": {
            -              "rootCause": {
            -                "type": "string"
            -              }
            -            }
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    ErrorModel:
            -      type: object
            -      required:
            -      - message
            -      - code
            -      properties:
            -        message:
            -          type: string
            -        code:
            -          type: integer
            -          minimum: 100
            -          maximum: 600
            -    ExtendedErrorModel:
            -      allOf:
            -      - $ref: '#/components/schemas/ErrorModel'
            -      - type: object
            -        required:
            -        - rootCause
            -        properties:
            -          rootCause:
            -            type: string
            -
            -
            Models with Polymorphism Support
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "Pet": {
            -        "type": "object",
            -        "discriminator": {
            -          "propertyName": "petType"
            -        },
            -        "properties": {
            -          "name": {
            -            "type": "string"
            -          },
            -          "petType": {
            -            "type": "string"
            -          }
            -        },
            -        "required": [
            -          "name",
            -          "petType"
            -        ]
            -      },
            -      "Cat": {
            -        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "huntingSkill": {
            -                "type": "string",
            -                "description": "The measured skill for hunting",
            -                "default": "lazy",
            -                "enum": [
            -                  "clueless",
            -                  "lazy",
            -                  "adventurous",
            -                  "aggressive"
            -                ]
            -              }
            -            },
            -            "required": [
            -              "huntingSkill"
            -            ]
            -          }
            -        ]
            -      },
            -      "Dog": {
            -        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "packSize": {
            -                "type": "integer",
            -                "format": "int32",
            -                "description": "the size of the pack the dog is from",
            -                "default": 0,
            -                "minimum": 0
            -              }
            -            },
            -            "required": [
            -              "packSize"
            -            ]
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      discriminator:
            -        propertyName: petType
            -      properties:
            -        name:
            -          type: string
            -        petType:
            -          type: string
            -      required:
            -      - name
            -      - petType
            -    Cat:  ## "Cat" will be used as the discriminator value
            -      description: A representation of a cat
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          huntingSkill:
            -            type: string
            -            description: The measured skill for hunting
            -            enum:
            -            - clueless
            -            - lazy
            -            - adventurous
            -            - aggressive
            -        required:
            -        - huntingSkill
            -    Dog:  ## "Dog" will be used as the discriminator value
            -      description: A representation of a dog
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          packSize:
            -            type: integer
            -            format: int32
            -            description: the size of the pack the dog is from
            -            default: 0
            -            minimum: 0
            -        required:
            -        - packSize
            -
            -

            Discriminator Object

            -

            When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

            -

            When using the discriminator, inline schemas will not be considered.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
            mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
            -

            The discriminator object is legal only when using one of the composite keywords oneOf, anyOf, allOf.

            -

            In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -
            -

            which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  discriminator:
            -    propertyName: petType
            -
            -

            The expectation now is that a property with name petType MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

            -
            
            -{
            -  "id": 12345,
            -  "petType": "Cat"
            -}
            -
            -

            Will indicate that the Cat schema be used in conjunction with this payload.

            -

            In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -  discriminator:
            -    propertyName: petType
            -    mapping:
            -      dog: '#/components/schemas/Dog'
            -      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -
            -

            Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

            -

            When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

            -

            In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

            -

            For example:

            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      required:
            -      - petType
            -      properties:
            -        petType:
            -          type: string
            -      discriminator:
            -        propertyName: petType
            -        mapping:
            -          dog: Dog
            -    Cat:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Cat`
            -        properties:
            -          name:
            -            type: string
            -    Dog:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Dog`
            -        properties:
            -          bark:
            -            type: string
            -    Lizard:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Lizard`
            -        properties:
            -          lovesRocks:
            -            type: boolean
            -
            -

            a payload like this:

            -
            
            -{
            -  "petType": "Cat",
            -  "name": "misty"
            -}
            -
            -

            will indicate that the Cat schema be used. Likewise this schema:

            -
            
            -{
            -  "petType": "dog",
            -  "bark": "soft"
            -}
            -
            -

            will map to Dog because of the definition in the mappings element.

            -

            XML Object

            -

            A metadata object that allows for more fine-tuned XML model definitions.

            -

            When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. -See examples for expected behavior.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
            namespacestringThe URI of the namespace definition. Value MUST be in the form of an absolute URI.
            prefixstringThe prefix to be used for the name.
            attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
            wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
            -

            This object MAY be extended with Specification Extensions.

            -

            XML Object Examples

            -

            The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

            -
            No XML Element
            -

            Basic string property:

            -
            
            -{
            -    "animals": {
            -        "type": "string"
            -    }
            -}
            -
            -
            
            -animals:
            -  type: string
            -
            -
            
            -<animals>...</animals>
            -
            -

            Basic string array property (wrapped is false by default):

            -
            
            -{
            -    "animals": {
            -        "type": "array",
            -        "items": {
            -            "type": "string"
            -        }
            -    }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -
            -
            
            -<animals>...</animals>
            -<animals>...</animals>
            -<animals>...</animals>
            -
            -
            XML Name Replacement
            -
            
            -{
            -  "animals": {
            -    "type": "string",
            -    "xml": {
            -      "name": "animal"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: string
            -  xml:
            -    name: animal
            -
            -
            
            -<animal>...</animal>
            -
            -
            XML Attribute, Prefix and Namespace
            -

            In this example, a full model definition is shown.

            -
            
            -{
            -  "Person": {
            -    "type": "object",
            -    "properties": {
            -      "id": {
            -        "type": "integer",
            -        "format": "int32",
            -        "xml": {
            -          "attribute": true
            -        }
            -      },
            -      "name": {
            -        "type": "string",
            -        "xml": {
            -          "namespace": "http://example.com/schema/sample",
            -          "prefix": "sample"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -Person:
            -  type: object
            -  properties:
            -    id:
            -      type: integer
            -      format: int32
            -      xml:
            -        attribute: true
            -    name:
            -      type: string
            -      xml:
            -        namespace: http://example.com/schema/sample
            -        prefix: sample
            -
            -
            
            -<Person id="123">
            -    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
            -</Person>
            -
            -
            XML Arrays
            -

            Changing the element names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            The external name property has no effect on the XML:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animals>value</animals>
            -  <animals>value</animals>
            -</animals>
            -
            -

            To overcome the naming problem in the example above, the following definition can be used:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</animals>
            -
            -

            Affecting both internal and external names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</aliens>
            -
            -

            If we change the external element but not the internal ones:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <aliens>value</aliens>
            -  <aliens>value</aliens>
            -</aliens>
            -
            -

            Security Scheme Object

            -

            Defines a security scheme that can be used by the operations. -Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "oauth2", "openIdConnect".
            descriptionstringAnyA short description for security scheme. CommonMark syntax MAY be used for rich text representation.
            namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
            instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
            schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]].
            bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
            flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
            openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            Security Scheme Object Example

            -
            Basic Authentication Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "basic"
            -}
            -
            -
            
            -type: http
            -scheme: basic
            -
            -
            API Key Sample
            -
            
            -{
            -  "type": "apiKey",
            -  "name": "api_key",
            -  "in": "header"
            -}
            -
            -
            
            -type: apiKey
            -name: api_key
            -in: header
            -
            -
            JWT Bearer Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "bearer",
            -  "bearerFormat": "JWT",
            -}
            -
            -
            
            -type: http
            -scheme: bearer
            -bearerFormat: JWT
            -
            -
            Implicit OAuth2 Sample
            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            OAuth Flows Object

            -

            Allows configuration of the supported OAuth Flows.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
            passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
            clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
            authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object

            -

            Configuration details for a supported OAuth Flow

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL.
            tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL.
            refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL.
            scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object Examples

            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    },
            -    "authorizationCode": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "tokenUrl": "https://example.com/api/oauth/token",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -  authorizationCode:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    tokenUrl: https://example.com/api/oauth/token
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            Security Requirement Object

            -

            Lists the required security schemes to execute this operation. -The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

            -

            Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. -This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

            -

            When a list of Security Requirement Objects is defined on the OpenAPI Object or Operation Object, only one of the Security Requirement Objects in the list needs to be satisfied to authorize the request.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution. For other security scheme types, the array MUST be empty.
            -

            Security Requirement Object Examples

            -
            Non-OAuth2 Security Requirement
            -
            
            -{
            -  "api_key": []
            -}
            -
            -
            
            -api_key: []
            -
            -
            OAuth2 Security Requirement
            -
            
            -{
            -  "petstore_auth": [
            -    "write:pets",
            -    "read:pets"
            -  ]
            -}
            -
            -
            
            -petstore_auth:
            -- write:pets
            -- read:pets
            -
            -

            Specification Extensions

            -

            While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

            -

            The extensions properties are implemented as patterned fields that are always prefixed by "x-".

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. Can have any valid JSON format value.
            -

            The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

            -

            Security Filtering

            -

            Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

            -

            The reasoning is to allow an additional layer of access control over the documentation. -While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

            -

            Two examples of this:

            -
              -
            1. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
            2. -
            3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the Paths Object, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
            4. -
            -

            Appendix A: Revision History

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            VersionDateNotes
            3.0.22018-10-08Patch release of the OpenAPI Specification 3.0.2
            3.0.12017-12-06Patch release of the OpenAPI Specification 3.0.1
            3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
            3.0.0-rc22017-06-16rc2 of the 3.0 specification
            3.0.0-rc12017-04-27rc1 of the 3.0 specification
            3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
            2.02015-12-31Donation of Swagger 2.0 to the Open API Initiative
            2.02014-09-08Release of Swagger 2.0
            1.22014-03-14Initial release of the formal document.
            1.12012-08-22Release of Swagger 1.1
            1.02011-08-10First release of the Swagger Specification
            - diff --git a/docs/oas/v3.0.3.html b/docs/oas/v3.0.3.html deleted file mode 100644 index 27549a8920..0000000000 --- a/docs/oas/v3.0.3.html +++ /dev/null @@ -1,4096 +0,0 @@ -OpenAPI Specification v3.0.3 | Introduction, Definitions, & More - - -

            OpenAPI Specification v3.0.3

            The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

            Status of This Document

            The source-of-truth for the specification is the GitHub markdown file referenced above.
            -

            OpenAPI Specification

            -

            Version 3.0.3

            -

            The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

            -

            This document is licensed under The Apache License, Version 2.0.

            -

            Introduction

            -

            The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

            -

            An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

            - -

            Definitions

            -

            OpenAPI Document

            -

            A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.

            -

            Path Templating

            -

            Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.

            -

            Each template expression in the path MUST correspond to a path parameter that is included in the Path Item itself and/or in each of the Path Item’s Operations.

            -

            Media Types

            -

            Media type definitions are spread across several resources. -The media type definitions SHOULD be in compliance with [[!RFC6838]].

            -

            Some examples of possible media type definitions:

            -
            
            -  text/plain; charset=utf-8
            -  application/json
            -  application/vnd.github+json
            -  application/vnd.github.v3+json
            -  application/vnd.github.v3.raw+json
            -  application/vnd.github.v3.text+json
            -  application/vnd.github.v3.html+json
            -  application/vnd.github.v3.full+json
            -  application/vnd.github.v3.diff
            -  application/vnd.github.v3.patch
            -
            -

            HTTP Status Codes

            -

            The HTTP Status Codes are used to indicate the status of the executed operation. -The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

            -

            Specification

            -

            Versions

            -

            The OpenAPI Specification is versioned using Semantic Versioning 2.0.0 (semver) and follows the semver specification.

            -

            The major.minor portion of the semver (for example 3.0) SHALL designate the OAS feature set. Typically, .patch versions address errors in this document, not the feature set. Tooling which supports OAS 3.0 SHOULD be compatible with all OAS 3.0.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.0.0 and 3.0.1 for example.

            -

            Each new minor version of the OpenAPI Specification SHALL allow any OpenAPI document that is valid against any previous minor version of the Specification, within the same major version, to be updated to the new Specification version with equivalent semantics. Such an update MUST only require changing the openapi property to the new minor version.

            -

            For example, a valid OpenAPI 3.0.2 document, upon changing its openapi property to 3.1.0, SHALL be a valid OpenAPI 3.1.0 document, semantically equivalent to the original OpenAPI 3.0.2 document. New minor versions of the OpenAPI Specification MUST be written to ensure this form of backward compatibility.

            -

            An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the semantic version of the OAS that it uses. (OAS 2.0 documents contain a top-level version field named swagger and value "2.0".)

            -

            Format

            -

            An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

            -

            For example, if a field has an array value, the JSON array representation will be used:

            -
            
            -{
            -   "field": [ 1, 2, 3 ]
            -}
            -
            -

            All field names in the specification are case sensitive. -This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

            -

            The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

            -

            Patterned fields MUST have unique names within the containing object.

            -

            In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

            - -

            Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

            -

            Document Structure

            -

            An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

            -

            It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

            -

            Data Types

            -

            Primitive data types in the OAS are based on the types supported by the JSON Schema Specification Wright Draft 00. -Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. -null is not supported as a type (see nullable for an alternative solution). -Models are defined using the Schema Object, which is an extended subset of JSON Schema Specification Wright Draft 00.

            -

            Primitives have an optional modifier property: format. -OAS uses several known formats to define in fine detail the data type being used. -However, to support documentation needs, the format property is an open string-valued property, and can have any value. -Formats such as "email", "uuid", and so on, MAY be used even though undefined by this specification. -Types that are not accompanied by a format property follow the type definition in the JSON Schema. Tools that do not recognize a specific format MAY default back to the type alone, as if the format is not specified.

            -

            The formats defined by the OAS are:

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            typeformatComments
            integerint32signed 32 bits
            integerint64signed 64 bits (a.k.a long)
            numberfloat
            numberdouble
            string
            stringbytebase64 encoded characters
            stringbinaryany sequence of octets
            boolean
            stringdateAs defined by full-date - [!RFC3339]
            stringdate-timeAs defined by date-time - [!RFC3339]
            stringpasswordA hint to UIs to obscure input.
            -

            Rich Text Formatting

            -

            Throughout the specification description fields are noted as supporting CommonMark markdown formatting. -Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

            -

            Relative References in URLs

            -

            Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. -Relative references are resolved using the URLs defined in the Server Object as a Base URI.

            -

            Relative references used in $ref are processed as per JSON Reference, using the URL of the current document as the base URI. See also the Reference Object.

            -

            Schema

            -

            In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

            -

            OpenAPI Object

            -

            This is the root document object of the OpenAPI document.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            openapistringREQUIRED. This string MUST be the semantic version number of the OpenAPI Specification version that the OpenAPI document uses. The openapi field SHOULD be used by tooling specifications and clients to interpret the OpenAPI document. This is not related to the API info.version string.
            infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
            servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
            pathsPaths ObjectREQUIRED. The available paths and operations for the API.
            componentsComponents ObjectAn element to hold various schemas for the specification.
            security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition. To make security optional, an empty security requirement ({}) can be included in the array.
            tags[Tag Object]A list of tags used by the specification with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
            externalDocsExternal Documentation ObjectAdditional external documentation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object

            -

            The object provides metadata about the API. -The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            titlestringREQUIRED. The title of the API.
            descriptionstringA short description of the API. CommonMark syntax MAY be used for rich text representation.
            termsOfServicestringA URL to the Terms of Service for the API. MUST be in the format of a URL.
            contactContact ObjectThe contact information for the exposed API.
            licenseLicense ObjectThe license information for the exposed API.
            versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object Example

            -
            
            -{
            -  "title": "Sample Pet Store App",
            -  "description": "This is a sample server for a pet store.",
            -  "termsOfService": "http://example.com/terms/",
            -  "contact": {
            -    "name": "API Support",
            -    "url": "http://www.example.com/support",
            -    "email": "support@example.com"
            -  },
            -  "license": {
            -    "name": "Apache 2.0",
            -    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
            -  },
            -  "version": "1.0.1"
            -}
            -
            -
            
            -title: Sample Pet Store App
            -description: This is a sample server for a pet store.
            -termsOfService: http://example.com/terms/
            -contact:
            -  name: API Support
            -  url: http://www.example.com/support
            -  email: support@example.com
            -license:
            -  name: Apache 2.0
            -  url: https://www.apache.org/licenses/LICENSE-2.0.html
            -version: 1.0.1
            -
            -

            Contact Object

            -

            Contact information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringThe identifying name of the contact person/organization.
            urlstringThe URL pointing to the contact information. MUST be in the format of a URL.
            emailstringThe email address of the contact person/organization. MUST be in the format of an email address.
            -

            This object MAY be extended with Specification Extensions.

            -

            Contact Object Example

            -
            
            -{
            -  "name": "API Support",
            -  "url": "http://www.example.com/support",
            -  "email": "support@example.com"
            -}
            -
            -
            
            -name: API Support
            -url: http://www.example.com/support
            -email: support@example.com
            -
            -

            License Object

            -

            License information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The license name used for the API.
            urlstringA URL to the license used for the API. MUST be in the format of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            License Object Example

            -
            
            -{
            -  "name": "Apache 2.0",
            -  "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
            -}
            -
            -
            
            -name: Apache 2.0
            -url: https://www.apache.org/licenses/LICENSE-2.0.html
            -
            -

            Server Object

            -

            An object representing a Server.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
            descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
            variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
            -

            This object MAY be extended with Specification Extensions.

            -

            Server Object Example

            -

            A single server would be described as:

            -
            
            -{
            -  "url": "https://development.gigantic-server.com/v1",
            -  "description": "Development server"
            -}
            -
            -
            
            -url: https://development.gigantic-server.com/v1
            -description: Development server
            -
            -

            The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://development.gigantic-server.com/v1",
            -      "description": "Development server"
            -    },
            -    {
            -      "url": "https://staging.gigantic-server.com/v1",
            -      "description": "Staging server"
            -    },
            -    {
            -      "url": "https://api.gigantic-server.com/v1",
            -      "description": "Production server"
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://development.gigantic-server.com/v1
            -  description: Development server
            -- url: https://staging.gigantic-server.com/v1
            -  description: Staging server
            -- url: https://api.gigantic-server.com/v1
            -  description: Production server
            -
            -

            The following shows how variables can be used for a server configuration:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
            -      "description": "The production API server",
            -      "variables": {
            -        "username": {
            -          "default": "demo",
            -          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
            -        },
            -        "port": {
            -          "enum": [
            -            "8443",
            -            "443"
            -          ],
            -          "default": "8443"
            -        },
            -        "basePath": {
            -          "default": "v2"
            -        }
            -      }
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://{username}.gigantic-server.com:{port}/{basePath}
            -  description: The production API server
            -  variables:
            -    username:
            -      # note! no enum here means it is an open value
            -      default: demo
            -      description: this value is assigned by the service provider, in this example `gigantic-server.com`
            -    port:
            -      enum:
            -        - '8443'
            -        - '443'
            -      default: '8443'
            -    basePath:
            -      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
            -      default: v2
            -
            -

            Server Variable Object

            -

            An object representing a Server Variable for server URL template substitution.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            enum[string]An enumeration of string values to be used if the substitution options are from a limited set. The array SHOULD NOT be empty.
            defaultstringREQUIRED. The default value to use for substitution, which SHALL be sent if an alternate value is not supplied. Note this behavior is different than the Schema Object’s treatment of default values, because in those cases parameter values are optional. If the enum is defined, the value SHOULD exist in the enum’s values.
            descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Components Object

            -

            Holds a set of reusable objects for different aspects of the OAS. -All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemasMap[string, Schema Object | Reference Object]An object to hold reusable Schema Objects.
            responsesMap[string, Response Object | Reference Object]An object to hold reusable Response Objects.
            parametersMap[string, Parameter Object | Reference Object]An object to hold reusable Parameter Objects.
            examplesMap[string, Example Object | Reference Object]An object to hold reusable Example Objects.
            requestBodiesMap[string, Request Body Object | Reference Object]An object to hold reusable Request Body Objects.
            headersMap[string, Header Object | Reference Object]An object to hold reusable Header Objects.
            securitySchemesMap[string, Security Scheme Object | Reference Object]An object to hold reusable Security Scheme Objects.
            linksMap[string, Link Object | Reference Object]An object to hold reusable Link Objects.
            callbacksMap[string, Callback Object | Reference Object]An object to hold reusable Callback Objects.
            -

            This object MAY be extended with Specification Extensions.

            -

            All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

            -

            Field Name Examples:

            -
            
            -User
            -User_1
            -User_Name
            -user-name
            -my.org.User
            -
            -

            Components Object Example

            -
            
            -"components": {
            -  "schemas": {
            -    "GeneralError": {
            -      "type": "object",
            -      "properties": {
            -        "code": {
            -          "type": "integer",
            -          "format": "int32"
            -        },
            -        "message": {
            -          "type": "string"
            -        }
            -      }
            -    },
            -    "Category": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    },
            -    "Tag": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  },
            -  "parameters": {
            -    "skipParam": {
            -      "name": "skip",
            -      "in": "query",
            -      "description": "number of items to skip",
            -      "required": true,
            -      "schema": {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    },
            -    "limitParam": {
            -      "name": "limit",
            -      "in": "query",
            -      "description": "max records to return",
            -      "required": true,
            -      "schema" : {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    }
            -  },
            -  "responses": {
            -    "NotFound": {
            -      "description": "Entity not found."
            -    },
            -    "IllegalInput": {
            -      "description": "Illegal input for operation."
            -    },
            -    "GeneralError": {
            -      "description": "General Error",
            -      "content": {
            -        "application/json": {
            -          "schema": {
            -            "$ref": "#/components/schemas/GeneralError"
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "securitySchemes": {
            -    "api_key": {
            -      "type": "apiKey",
            -      "name": "api_key",
            -      "in": "header"
            -    },
            -    "petstore_auth": {
            -      "type": "oauth2",
            -      "flows": {
            -        "implicit": {
            -          "authorizationUrl": "http://example.org/api/oauth/dialog",
            -          "scopes": {
            -            "write:pets": "modify pets in your account",
            -            "read:pets": "read your pets"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    GeneralError:
            -      type: object
            -      properties:
            -        code:
            -          type: integer
            -          format: int32
            -        message:
            -          type: string
            -    Category:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -    Tag:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -  parameters:
            -    skipParam:
            -      name: skip
            -      in: query
            -      description: number of items to skip
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -    limitParam:
            -      name: limit
            -      in: query
            -      description: max records to return
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -  responses:
            -    NotFound:
            -      description: Entity not found.
            -    IllegalInput:
            -      description: Illegal input for operation.
            -    GeneralError:
            -      description: General Error
            -      content:
            -        application/json:
            -          schema:
            -            $ref: '#/components/schemas/GeneralError'
            -  securitySchemes:
            -    api_key:
            -      type: apiKey
            -      name: api_key
            -      in: header
            -    petstore_auth:
            -      type: oauth2
            -      flows:
            -        implicit:
            -          authorizationUrl: http://example.org/api/oauth/dialog
            -          scopes:
            -            write:pets: modify pets in your account
            -            read:pets: read your pets
            -
            -

            Paths Object

            -

            Holds the relative paths to the individual endpoints and their operations. -The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to ACL constraints.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a forward slash (/). The path is appended (no relative URL resolution) to the expanded URL from the Server Object’s url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Templating Matching

            -

            Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

            -
            
            -  /pets/{petId}
            -  /pets/mine
            -
            -

            The following paths are considered identical and invalid:

            -
            
            -  /pets/{petId}
            -  /pets/{name}
            -
            -

            The following may lead to ambiguous resolution:

            -
            
            -  /{entity}/me
            -  /books/{id}
            -
            -

            Paths Object Example

            -
            
            -{
            -  "/pets": {
            -    "get": {
            -      "description": "Returns all pets from the system that the user has access to",
            -      "responses": {
            -        "200": {         
            -          "description": "A list of pets.",
            -          "content": {
            -            "application/json": {
            -              "schema": {
            -                "type": "array",
            -                "items": {
            -                  "$ref": "#/components/schemas/pet"
            -                }
            -              }
            -            }
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -/pets:
            -  get:
            -    description: Returns all pets from the system that the user has access to
            -    responses:
            -      '200':
            -        description: A list of pets.
            -        content:
            -          application/json:
            -            schema:
            -              type: array
            -              items:
            -                $ref: '#/components/schemas/pet'
            -
            -

            Path Item Object

            -

            Describes the operations available on a single path. -A Path Item MAY be empty, due to ACL constraints. -The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringAllows for an external definition of this path item. The referenced structure MUST be in the format of a Path Item Object. In case a Path Item Object field appears both in the defined object and the referenced object, the behavior is undefined.
            summarystringAn optional, string summary, intended to apply to all operations in this path.
            descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
            getOperation ObjectA definition of a GET operation on this path.
            putOperation ObjectA definition of a PUT operation on this path.
            postOperation ObjectA definition of a POST operation on this path.
            deleteOperation ObjectA definition of a DELETE operation on this path.
            optionsOperation ObjectA definition of a OPTIONS operation on this path.
            headOperation ObjectA definition of a HEAD operation on this path.
            patchOperation ObjectA definition of a PATCH operation on this path.
            traceOperation ObjectA definition of a TRACE operation on this path.
            servers[Server Object]An alternative server array to service all operations in this path.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Item Object Example

            -
            
            -{
            -  "get": {
            -    "description": "Returns pets based on ID",
            -    "summary": "Find pets by ID",
            -    "operationId": "getPetsById",
            -    "responses": {
            -      "200": {
            -        "description": "pet response",
            -        "content": {
            -          "*/*": {
            -            "schema": {
            -              "type": "array",
            -              "items": {
            -                "$ref": "#/components/schemas/Pet"
            -              }
            -            }
            -          }
            -        }
            -      },
            -      "default": {
            -        "description": "error payload",
            -        "content": {
            -          "text/html": {
            -            "schema": {
            -              "$ref": "#/components/schemas/ErrorModel"
            -            }
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "parameters": [
            -    {
            -      "name": "id",
            -      "in": "path",
            -      "description": "ID of pet to use",
            -      "required": true,
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      },
            -      "style": "simple"
            -    }
            -  ]
            -}
            -
            -
            
            -get:
            -  description: Returns pets based on ID
            -  summary: Find pets by ID
            -  operationId: getPetsById
            -  responses:
            -    '200':
            -      description: pet response
            -      content:
            -        '*/*' :
            -          schema:
            -            type: array
            -            items:
            -              $ref: '#/components/schemas/Pet'
            -    default:
            -      description: error payload
            -      content:
            -        'text/html':
            -          schema:
            -            $ref: '#/components/schemas/ErrorModel'
            -parameters:
            -- name: id
            -  in: path
            -  description: ID of pet to use
            -  required: true
            -  schema:
            -    type: array
            -    items:
            -      type: string 
            -  style: simple
            -
            -

            Operation Object

            -

            Describes a single API operation on a path.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
            summarystringA short summary of what the operation does.
            descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
            operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. The operationId value is case-sensitive. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            requestBodyRequest Body Object | Reference ObjectThe request body applicable for this operation. The requestBody is only supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague, requestBody SHALL be ignored by consumers.
            responsesResponses ObjectREQUIRED. The list of possible responses as they are returned from executing this operation.
            callbacksMap[string, Callback Object | Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses.
            deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
            security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. To make security optional, an empty security requirement ({}) can be included in the array. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
            servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
            -

            This object MAY be extended with Specification Extensions.

            -

            Operation Object Example

            -
            
            -{
            -  "tags": [
            -    "pet"
            -  ],
            -  "summary": "Updates a pet in the store with form data",
            -  "operationId": "updatePetWithForm",
            -  "parameters": [
            -    {
            -      "name": "petId",
            -      "in": "path",
            -      "description": "ID of pet that needs to be updated",
            -      "required": true,
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  ],
            -  "requestBody": {
            -    "content": {
            -      "application/x-www-form-urlencoded": {
            -        "schema": {
            -          "type": "object",
            -          "properties": {
            -            "name": {
            -              "description": "Updated name of the pet",
            -              "type": "string"
            -            },
            -            "status": {
            -              "description": "Updated status of the pet",
            -              "type": "string"
            -            }
            -          },
            -          "required": ["status"]
            -        }
            -      }
            -    }
            -  },
            -  "responses": {
            -    "200": {
            -      "description": "Pet updated.",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    },
            -    "405": {
            -      "description": "Method Not Allowed",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    }
            -  },
            -  "security": [
            -    {
            -      "petstore_auth": [
            -        "write:pets",
            -        "read:pets"
            -      ]
            -    }
            -  ]
            -}
            -
            -
            
            -tags:
            -- pet
            -summary: Updates a pet in the store with form data
            -operationId: updatePetWithForm
            -parameters:
            -- name: petId
            -  in: path
            -  description: ID of pet that needs to be updated
            -  required: true
            -  schema:
            -    type: string
            -requestBody:
            -  content:
            -    'application/x-www-form-urlencoded':
            -      schema:
            -       properties:
            -          name:
            -            description: Updated name of the pet
            -            type: string
            -          status:
            -            description: Updated status of the pet
            -            type: string
            -       required:
            -         - status
            -responses:
            -  '200':
            -    description: Pet updated.
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -  '405':
            -    description: Method Not Allowed
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -security:
            -- petstore_auth:
            -  - write:pets
            -  - read:pets
            -
            -

            External Documentation Object

            -

            Allows referencing an external resource for extended documentation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA short description of the target documentation. CommonMark syntax MAY be used for rich text representation.
            urlstringREQUIRED. The URL for the target documentation. Value MUST be in the format of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            External Documentation Object Example

            -
            
            -{
            -  "description": "Find more info here",
            -  "url": "https://example.com"
            -}
            -
            -
            
            -description: Find more info here
            -url: https://example.com
            -
            -

            Parameter Object

            -

            Describes a single operation parameter.

            -

            A unique parameter is defined by a combination of a name and location.

            -

            Parameter Locations

            -

            There are four possible parameter locations specified by the in field:

            -
              -
            • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
            • -
            • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
            • -
            • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
            • -
            • cookie - Used to pass a specific cookie value to the API.
            • -
            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
            • If in is "path", the name field MUST correspond to a template expression occurring within the path field in the Paths Object. See Path Templating for further information.
            • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
            • For all other cases, the name corresponds to the parameter name used by the in property.
            instringREQUIRED. The location of the parameter. Possible values are "query", "header", "path" or "cookie".
            descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is "path", this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
            deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage. Default value is false.
            allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored. Use of this property is NOT RECOMMENDED, as it is likely to be removed in a later revision.
            -

            The rules for serialization of the parameter are specified in one of two ways. -For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
            explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
            schemaSchema Object | Reference ObjectThe schema defining the type used for the parameter.
            exampleAnyExample of the parameter’s potential value. The example SHOULD match the specified schema and encoding properties if present. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema that contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
            examplesMap[ string, Example Object | Reference Object]Examples of the parameter’s potential value. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema that contains an example, the examples value SHALL override the example provided by the schema.
            -

            For more complex scenarios, the content property can define the media type and schema of the parameter. -A parameter MUST contain either a schema property, or a content property, but not both. -When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
            -

            Style Values

            -

            In order to support common ways of serializing simple parameters, a set of style values are defined.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styletypeinComments
            matrixprimitive, array, objectpathPath-style parameters defined by [[!RFC6570]]
            labelprimitive, array, objectpathLabel style parameters defined by [[!RFC6570]]
            formprimitive, array, objectquery, cookieForm style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
            simplearraypath, headerSimple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0.
            spaceDelimitedarrayquerySpace separated array values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
            pipeDelimitedarrayqueryPipe separated array values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
            deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
            -

            Style Examples

            -

            Assume a parameter named color has one of the following values:

            -
            
            -   string -> "blue"
            -   array -> ["blue","black","brown"]
            -   object -> { "R": 100, "G": 200, "B": 150 }
            -
            -

            The following table shows examples of rendering differences for each value.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styleexplodeemptystringarrayobject
            matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
            matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
            labelfalse..blue.blue.black.brown.R.100.G.200.B.150
            labeltrue..blue.blue.black.brown.R=100.G=200.B=150
            formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
            formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
            simplefalsen/ablueblue,black,brownR,100,G,200,B,150
            simpletruen/ablueblue,black,brownR=100,G=200,B=150
            spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
            pipeDelimitedfalsen/an/ablue|black|brownR|100|G|200|B|150
            deepObjecttruen/an/an/acolor[R]=100&color[G]=200&color[B]=150
            -

            This object MAY be extended with Specification Extensions.

            -

            Parameter Object Examples

            -

            A header parameter with an array of 64 bit integer numbers:

            -
            
            -{
            -  "name": "token",
            -  "in": "header",
            -  "description": "token to be passed as a header",
            -  "required": true,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "integer",
            -      "format": "int64"
            -    }
            -  },
            -  "style": "simple"
            -}
            -
            -
            
            -name: token
            -in: header
            -description: token to be passed as a header
            -required: true
            -schema:
            -  type: array
            -  items:
            -    type: integer
            -    format: int64
            -style: simple
            -
            -

            A path parameter of a string value:

            -
            
            -{
            -  "name": "username",
            -  "in": "path",
            -  "description": "username to fetch",
            -  "required": true,
            -  "schema": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -name: username
            -in: path
            -description: username to fetch
            -required: true
            -schema:
            -  type: string
            -
            -

            An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

            -
            
            -{
            -  "name": "id",
            -  "in": "query",
            -  "description": "ID of the object to fetch",
            -  "required": false,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    }
            -  },
            -  "style": "form",
            -  "explode": true
            -}
            -
            -
            
            -name: id
            -in: query
            -description: ID of the object to fetch
            -required: false
            -schema:
            -  type: array
            -  items:
            -    type: string
            -style: form
            -explode: true
            -
            -

            A free-form query parameter, allowing undefined parameters of a specific type:

            -
            
            -{
            -  "in": "query",
            -  "name": "freeForm",
            -  "schema": {
            -    "type": "object",
            -    "additionalProperties": {
            -      "type": "integer"
            -    },
            -  },
            -  "style": "form"
            -}
            -
            -
            
            -in: query
            -name: freeForm
            -schema:
            -  type: object
            -  additionalProperties:
            -    type: integer
            -style: form
            -
            -

            A complex parameter using content to define serialization:

            -
            
            -{
            -  "in": "query",
            -  "name": "coordinates",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "object",
            -        "required": [
            -          "lat",
            -          "long"
            -        ],
            -        "properties": {
            -          "lat": {
            -            "type": "number"
            -          },
            -          "long": {
            -            "type": "number"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -in: query
            -name: coordinates
            -content:
            -  application/json:
            -    schema:
            -      type: object
            -      required:
            -        - lat
            -        - long
            -      properties:
            -        lat:
            -          type: number
            -        long:
            -          type: number
            -
            -

            Request Body Object

            -

            Describes a single request body.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            requiredbooleanDetermines if the request body is required in the request. Defaults to false.
            -

            This object MAY be extended with Specification Extensions.

            -

            Request Body Examples

            -

            A request body with a referenced model definition.

            -
            
            -{
            -  "description": "user to add to the system",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User Example",
            -            "externalValue": "http://foo.bar/examples/user-example.json"
            -          }
            -        }
            -    },
            -    "application/xml": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User example in XML",
            -            "externalValue": "http://foo.bar/examples/user-example.xml"
            -          }
            -        }
            -    },
            -    "text/plain": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in Plain text",
            -            "externalValue": "http://foo.bar/examples/user-example.txt"
            -        }
            -      }
            -    },
            -    "*/*": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in other format",
            -            "externalValue": "http://foo.bar/examples/user-example.whatever"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -content:
            -  'application/json':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User Example
            -        externalValue: 'http://foo.bar/examples/user-example.json'
            -  'application/xml':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User Example in XML
            -        externalValue: 'http://foo.bar/examples/user-example.xml'
            -  'text/plain':
            -    examples:
            -      user:
            -        summary: User example in text plain format
            -        externalValue: 'http://foo.bar/examples/user-example.txt'
            -  '*/*':
            -    examples:
            -      user:
            -        summary: User example in other format
            -        externalValue: 'http://foo.bar/examples/user-example.whatever'
            -
            -

            A body parameter that is an array of string values:

            -
            
            -{
            -  "description": "user to add to the system",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -required: true
            -content:
            -  text/plain:
            -    schema:
            -      type: array
            -      items:
            -        type: string
            -
            -

            Media Type Object

            -

            Each Media Type Object provides schema and examples for the media type identified by its key.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemaSchema Object | Reference ObjectThe schema defining the content of the request, response, or parameter.
            exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
            examplesMap[ string, Example Object | Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
            encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
            -

            This object MAY be extended with Specification Extensions.

            -

            Media Type Examples

            -
            
            -{
            -  "application/json": {
            -    "schema": {
            -         "$ref": "#/components/schemas/Pet"
            -    },
            -    "examples": {
            -      "cat" : {
            -        "summary": "An example of a cat",
            -        "value":
            -          {
            -            "name": "Fluffy",
            -            "petType": "Cat",
            -            "color": "White",
            -            "gender": "male",
            -            "breed": "Persian"
            -          }
            -      },
            -      "dog": {
            -        "summary": "An example of a dog with a cat's name",
            -        "value" :  {
            -          "name": "Puma",
            -          "petType": "Dog",
            -          "color": "Black",
            -          "gender": "Female",
            -          "breed": "Mixed"
            -        },
            -      "frog": {
            -          "$ref": "#/components/examples/frog-example"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -application/json:
            -  schema:
            -    $ref: "#/components/schemas/Pet"
            -  examples:
            -    cat:
            -      summary: An example of a cat
            -      value:
            -        name: Fluffy
            -        petType: Cat
            -        color: White
            -        gender: male
            -        breed: Persian
            -    dog:
            -      summary: An example of a dog with a cat's name
            -      value:
            -        name: Puma
            -        petType: Dog
            -        color: Black
            -        gender: Female
            -        breed: Mixed
            -    frog:
            -      $ref: "#/components/examples/frog-example"
            -
            -

            Considerations for File Uploads

            -

            In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type. Specifically:

            -
            
            -# content transferred with base64 encoding
            -schema:
            -  type: string
            -  format: base64
            -
            -
            
            -# content transferred in binary (octet-stream):
            -schema:
            -  type: string
            -  format: binary
            -
            -

            These examples apply to either input payloads of file uploads or response payloads.

            -

            A requestBody for submitting a file in a POST operation may look like the following example:

            -
            
            -requestBody:
            -  content:
            -    application/octet-stream:
            -      schema:
            -        # a binary file of any type
            -        type: string
            -        format: binary
            -
            -

            In addition, specific media types MAY be specified:

            -
            
            -# multiple, specific media types may be specified:
            -requestBody:
            -  content:
            -      # a binary file of type png or jpeg
            -    'image/jpeg':
            -      schema:
            -        type: string
            -        format: binary
            -    'image/png':
            -      schema:
            -        type: string
            -        format: binary       
            -
            -

            To upload multiple files, a multipart media type MUST be used:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        properties:
            -          # The property name 'file' will be used for all files.
            -          file:
            -            type: array
            -            items:
            -              type: string
            -              format: binary
            -
            -
            -

            Support for x-www-form-urlencoded Request Bodies

            -

            To submit content using form url encoding via [[!RFC1866]], the following -definition may be used:

            -
            
            -requestBody:
            -  content:
            -    application/x-www-form-urlencoded:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # complex types are stringified to support RFC 1866
            -            type: object
            -            properties: {}
            -
            -

            In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

            -

            When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object’s style property as form.

            -

            Special Considerations for multipart Content

            -

            It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

            -

            When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred — thus, the following default Content-Types are defined for multipart:

            -
              -
            • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
            • -
            • If the property is complex, or an array of complex values, the default Content-Type is application/json
            • -
            • If the property is a type: string with format: binary or format: base64 (aka a file object), the default Content-Type is application/octet-stream
            • -
            -

            Examples:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # default Content-Type for objects is `application/json`
            -            type: object
            -            properties: {}
            -          profileImage:
            -            # default Content-Type for string/binary is `application/octet-stream`
            -            type: string
            -            format: binary
            -          children:
            -            # default Content-Type for arrays is based on the `inner` type (text/plain here)
            -            type: array
            -            items:
            -              type: string
            -          addresses:
            -            # default Content-Type for arrays is based on the `inner` type (object shown, so `application/json` in this example)
            -            type: array
            -            items:
            -              type: '#/components/schemas/Address'
            -
            -

            An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

            -

            Encoding Object

            -

            A single encoding definition applied to a single schema property.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for string with format being binaryapplication/octet-stream; for other primitive types – text/plain; for object - application/json; for array – the default is defined based on the inner type. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
            headersMap[string, Header Object | Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
            stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded.
            -

            This object MAY be extended with Specification Extensions.

            -

            Encoding Object Example

            -
            
            -requestBody:
            -  content:
            -    multipart/mixed:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            # default is text/plain
            -            type: string
            -            format: uuid
            -          address:
            -            # default is application/json
            -            type: object
            -            properties: {}
            -          historyMetadata:
            -            # need to declare XML format!
            -            description: metadata in XML format
            -            type: object
            -            properties: {}
            -          profileImage:
            -            # default is application/octet-stream, need to declare an image type only!
            -            type: string
            -            format: binary
            -      encoding:
            -        historyMetadata:
            -          # require XML Content-Type in utf-8 encoding
            -          contentType: application/xml; charset=utf-8
            -        profileImage:
            -          # only accept png/jpeg
            -          contentType: image/png, image/jpeg
            -          headers:
            -            X-Rate-Limit-Limit:
            -              description: The number of allowed requests in the current period
            -              schema:
            -                type: integer
            -
            -

            Responses Object

            -

            A container for the expected responses of an operation. -The container maps a HTTP response code to the expected response.

            -

            The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. -However, documentation is expected to cover a successful operation response and any known errors.

            -

            The default MAY be used as a default response object for all HTTP codes -that are not covered individually by the specification.

            -

            The Responses Object MUST contain at least one response code, and it -SHOULD be the response for a successful operation call.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            defaultResponse Object | Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses. A Reference Object can link to a response that the OpenAPI Object’s components/responses section defines.
            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            HTTP Status CodeResponse Object | Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. A Reference Object can link to a response that is defined in the OpenAPI Object’s components/responses section. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. Only the following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
            -

            This object MAY be extended with Specification Extensions.

            -

            Responses Object Example

            -

            A 200 response for a successful operation and a default response for others (implying an error):

            -
            
            -{
            -  "200": {
            -    "description": "a pet to be returned",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/Pet"
            -        }
            -      }
            -    }
            -  },
            -  "default": {
            -    "description": "Unexpected error",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/ErrorModel"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -'200':
            -  description: a pet to be returned
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/Pet'
            -default:
            -  description: Unexpected error
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/ErrorModel'
            -
            -

            Response Object

            -

            Describes a single response from an API Operation, including design-time, static -links to operations based on the response.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringREQUIRED. A short description of the response. CommonMark syntax MAY be used for rich text representation.
            headersMap[string, Header Object | Reference Object]Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
            contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            linksMap[string, Link Object | Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
            -

            This object MAY be extended with Specification Extensions.

            -

            Response Object Examples

            -

            Response of an array of a complex type:

            -
            
            -{
            -  "description": "A complex object array response",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "$ref": "#/components/schemas/VeryComplexType"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A complex object array response
            -content:
            -  application/json:
            -    schema:
            -      type: array
            -      items:
            -        $ref: '#/components/schemas/VeryComplexType'
            -
            -

            Response with a string type:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  }
            -
            -}
            -
            -
            
            -description: A simple string response
            -content:
            -  text/plain:
            -    schema:
            -      type: string
            -
            -

            Plain text response with headers:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string",
            -        "example": "whoa!"
            -      }
            -    }
            -  },
            -  "headers": {
            -    "X-Rate-Limit-Limit": {
            -      "description": "The number of allowed requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Remaining": {
            -      "description": "The number of remaining requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Reset": {
            -      "description": "The number of seconds left in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A simple string response
            -content:
            -  text/plain:
            -    schema:
            -      type: string
            -    example: 'whoa!'
            -headers:
            -  X-Rate-Limit-Limit:
            -    description: The number of allowed requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Remaining:
            -    description: The number of remaining requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Reset:
            -    description: The number of seconds left in the current period
            -    schema:
            -      type: integer
            -
            -

            Response with no return value:

            -
            
            -{
            -  "description": "object created"
            -}
            -
            -
            
            -description: object created
            -
            -

            Callback Object

            -

            A map of possible out-of band callbacks related to the parent operation. -Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. -The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {expression}Path Item ObjectA Path Item Object used to define a callback request and expected responses. A complete example is available.
            -

            This object MAY be extended with Specification Extensions.

            -

            Key Expression

            -

            The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. -A simple example might be $request.body#/url. -However, using a runtime expression the complete HTTP message can be accessed. -This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

            -

            For example, given the following HTTP request:

            -
            
            -POST /subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning HTTP/1.1
            -Host: example.org
            -Content-Type: application/json
            -Content-Length: 187
            -
            -{
            -  "failedUrl" : "http://clientdomain.com/failed",
            -  "successUrls" : [
            -    "http://clientdomain.com/fast",
            -    "http://clientdomain.com/medium",
            -    "http://clientdomain.com/slow"
            -  ]
            -}
            -
            -201 Created
            -Location: http://example.org/subscription/1
            -
            -

            The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            ExpressionValue
            $urlhttp://example.org/subscribe/myevent?queryUrl=http://clientdomain.com/stillrunning
            $methodPOST
            $request.path.eventTypemyevent
            $request.query.queryUrlhttp://clientdomain.com/stillrunning
            $request.header.content-Typeapplication/json
            $request.body#/failedUrlhttp://clientdomain.com/failed
            $request.body#/successUrls/2http://clientdomain.com/medium
            $response.header.Locationhttp://example.org/subscription/1
            -

            Callback Object Examples

            -

            The following example uses the user provided queryUrl query string parameter to define the callback URL. This is an example of how to use a callback object to describe a WebHook callback that goes with the subscription operation to enable registering for the WebHook.

            -
            
            -myCallback:
            -  '{$request.query.queryUrl}':
            -    post:
            -      requestBody:
            -        description: Callback payload
            -        content:
            -          'application/json':
            -            schema:
            -              $ref: '#/components/schemas/SomePayload'
            -      responses:
            -        '200':
            -          description: callback successfully processed
            -
            -

            The following example shows a callback where the server is hard-coded, but the query string parameters are populated from the id and email property in the request body.

            -
            
            -transactionCallback:
            -  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
            -    post:
            -      requestBody:
            -        description: Callback payload
            -        content:
            -          'application/json':
            -            schema:
            -              $ref: '#/components/schemas/SomePayload'
            -      responses:
            -        '200':
            -          description: callback successfully processed
            -
            -

            Example Object

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            summarystringShort description for the example.
            descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
            valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
            externalValuestringA URL that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive.
            -

            This object MAY be extended with Specification Extensions.

            -

            In all cases, the example value is expected to be compatible with the type schema -of its associated value. Tooling implementations MAY choose to -validate compatibility automatically, and reject the example value(s) if incompatible.

            -

            Example Object Examples

            -

            In a request body:

            -
            
            -requestBody:
            -  content:
            -    'application/json':
            -      schema:
            -        $ref: '#/components/schemas/Address'
            -      examples:
            -        foo:
            -          summary: A foo example
            -          value: {"foo": "bar"}
            -        bar:
            -          summary: A bar example
            -          value: {"bar": "baz"}
            -    'application/xml':
            -      examples:
            -        xmlExample:
            -          summary: This is an example in XML
            -          externalValue: 'http://example.org/examples/address-example.xml'
            -    'text/plain':
            -      examples:
            -        textExample:
            -          summary: This is a text example
            -          externalValue: 'http://foo.bar/examples/address-example.txt'
            -
            -

            In a parameter:

            -
            
            -parameters:
            -  - name: 'zipCode'
            -    in: 'query'
            -    schema:
            -      type: 'string'
            -      format: 'zip-code'
            -    examples:
            -      zip-example:
            -        $ref: '#/components/examples/zip-example'
            -
            -

            In a response:

            -
            
            -responses:
            -  '200':
            -    description: your car appointment has been booked
            -    content:
            -      application/json:
            -        schema:
            -          $ref: '#/components/schemas/SuccessResponse'
            -        examples:
            -          confirmation-success:
            -            $ref: '#/components/examples/confirmation-success'
            -
            -

            Link Object

            -

            The Link object represents a possible design-time link for a response. -The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

            -

            Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

            -

            For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            operationRefstringA relative or absolute URI reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition.
            operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
            parametersMap[string, Any | {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
            requestBodyAny | {expression}A literal value or {expression} to use as a request body when calling the target operation.
            descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
            serverServer ObjectA server object to be used by the target operation.
            -

            This object MAY be extended with Specification Extensions.

            -

            A linked operation MUST be identified using either an operationRef or operationId. -In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. -Because of the potential for name clashes, the operationRef syntax is preferred -for specifications with external references.

            -

            Examples

            -

            Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

            -
            
            -paths:
            -  /users/{id}:
            -    parameters:
            -    - name: id
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -    get:
            -      responses:
            -        '200':
            -          description: the user being returned
            -          content:
            -            application/json:
            -              schema:
            -                type: object
            -                properties:
            -                  uuid: # the unique user id
            -                    type: string
            -                    format: uuid
            -          links:
            -            address:
            -              # the target link operationId
            -              operationId: getUserAddress
            -              parameters:
            -                # get the `id` field from the request path parameter named `id`
            -                userId: $request.path.id
            -  # the path item of the linked operation
            -  /users/{userid}/address:
            -    parameters:
            -    - name: userid
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -    # linked operation
            -    get:
            -      operationId: getUserAddress
            -      responses:
            -        '200':
            -          description: the user's address
            -
            -

            When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

            -

            Values from the response body can be used to drive a linked operation.

            -
            
            -links:
            -  address:
            -    operationId: getUserAddressByUUID
            -    parameters:
            -      # get the `uuid` field from the `uuid` field in the response body
            -      userUuid: $response.body#/uuid
            -
            -

            Clients follow all links at their discretion. -Neither permissions, nor the capability to make a successful call to that link, is guaranteed -solely by the existence of a relationship.

            -

            OperationRef Examples

            -

            As references to operationId MAY NOT be possible (the operationId is an optional -field in an Operation Object), references MAY also be made through a relative operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            or an absolute operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            Note that in the use of operationRef, the escaped forward-slash is necessary when -using JSON references.

            -

            Runtime Expressions

            -

            Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. -This mechanism is used by Link Objects and Callback Objects.

            -

            The runtime expression is defined by the following ABNF syntax

            -
            
            -      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
            -      source = ( header-reference / query-reference / path-reference / body-reference )
            -      header-reference = "header." token
            -      query-reference = "query." name 
            -      path-reference = "path." name
            -      body-reference = "body" ["#" json-pointer ]
            -      json-pointer    = *( "/" reference-token )
            -      reference-token = *( unescaped / escaped )
            -      unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
            -         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
            -      escaped         = "~" ( "0" / "1" )
            -        ; representing '~' and '/', respectively
            -      name = *( CHAR )
            -      token = 1*tchar
            -      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
            -        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
            -
            -

            Here, json-pointer is taken from [[!RFC6901]], char from [[!RFC7159]] and token from [[!RFC7230]].

            -

            The name identifier is case-sensitive, whereas token is not.

            -

            The table below provides examples of runtime expressions and examples of their use in a value:

            -

            Examples

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Source Locationexample expressionnotes
            HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
            Requested media type$request.header.accept
            Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
            Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
            Request URL$url
            Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
            Response header$response.header.ServerSingle header values only are available
            -

            Runtime expressions preserve the type of the referenced value. -Expressions can be embedded into string values by surrounding the expression with {} curly braces.

            -

            Header Object

            -

            The Header Object follows the structure of the Parameter Object with the following changes:

            -
              -
            1. name MUST NOT be specified, it is given in the corresponding headers map.
            2. -
            3. in MUST NOT be specified, it is implicitly in header.
            4. -
            5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
            6. -
            -

            Header Object Example

            -

            A simple header of type integer:

            -
            
            -{
            -  "description": "The number of allowed requests in the current period",
            -  "schema": {
            -    "type": "integer"
            -  }
            -}
            -
            -
            
            -description: The number of allowed requests in the current period
            -schema:
            -  type: integer
            -
            -

            Tag Object

            -

            Adds metadata to a single tag that is used by the Operation Object. -It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the tag.
            descriptionstringA short description for the tag. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
            -

            This object MAY be extended with Specification Extensions.

            -

            Tag Object Example

            -
            
            -{
            -	"name": "pet",
            -	"description": "Pets operations"
            -}
            -
            -
            
            -name: pet
            -description: Pets operations
            -
            -

            Reference Object

            -

            A simple object to allow referencing other components in the specification, internally and externally.

            -

            The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.

            -

            For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringREQUIRED. The reference string.
            -

            This object cannot be extended with additional properties and any properties added SHALL be ignored.

            -

            Reference Object Example

            -
            
            -{
            -	"$ref": "#/components/schemas/Pet"
            -}
            -
            -
            
            -$ref: '#/components/schemas/Pet'
            -
            -

            Relative Schema Document Example

            -
            
            -{
            -  "$ref": "Pet.json"
            -}
            -
            -
            
            -$ref: Pet.yaml
            -
            -

            Relative Documents With Embedded Schema Example

            -
            
            -{
            -  "$ref": "definitions.json#/Pet"
            -}
            -
            -
            
            -$ref: definitions.yaml#/Pet
            -
            -

            Schema Object

            -

            The Schema Object allows the definition of input and output data types. -These types can be objects, but also primitives and arrays. -This object is an extended subset of the JSON Schema Specification Wright Draft 00.

            -

            For more information about the properties, see JSON Schema Core and JSON Schema Validation. -Unless stated otherwise, the property definitions follow the JSON Schema.

            -

            Properties

            -

            The following properties are taken directly from the JSON Schema definition and follow the same specifications:

            -
              -
            • title
            • -
            • multipleOf
            • -
            • maximum
            • -
            • exclusiveMaximum
            • -
            • minimum
            • -
            • exclusiveMinimum
            • -
            • maxLength
            • -
            • minLength
            • -
            • pattern (This string SHOULD be a valid regular expression, according to the Ecma-262 Edition 5.1 regular expression dialect)
            • -
            • maxItems
            • -
            • minItems
            • -
            • uniqueItems
            • -
            • maxProperties
            • -
            • minProperties
            • -
            • required
            • -
            • enum
            • -
            -

            The following properties are taken from the JSON Schema definition but their definitions were adjusted to the OpenAPI Specification.

            -
              -
            • type - Value MUST be a string. Multiple types via an array are not supported.
            • -
            • allOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • oneOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • anyOf - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • not - Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.
            • -
            • items - Value MUST be an object and not an array. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. items MUST be present if the type is array.
            • -
            • properties - Property definitions MUST be a Schema Object and not a standard JSON Schema (inline or referenced).
            • -
            • additionalProperties - Value can be boolean or object. Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema. Consistent with JSON Schema, additionalProperties defaults to true.
            • -
            • description - CommonMark syntax MAY be used for rich text representation.
            • -
            • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
            • -
            • default - The default value represents what would be assumed by the consumer of the input as the value of the schema if one is not provided. Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object defined at the same level. For example, if type is string, then default can be "foo" but cannot be 1.
            • -
            -

            Alternatively, any time a Schema Object can be used, a Reference Object can be used in its place. This allows referencing definitions instead of defining them inline.

            -

            Additional properties defined by the JSON Schema specification that are not mentioned here are strictly unsupported.

            -

            Other than the JSON Schema subset fields, the following fields MAY be used for further schema documentation:

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            nullablebooleanA true value adds "null" to the allowed type specified by the type keyword, only if type is explicitly defined within the same Schema Object. Other Schema Object constraints retain their defined behavior, and therefore may disallow the use of null as a value. A false value leaves the specified or default type unmodified. The default value is false.
            discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
            readOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “read only”. This means that it MAY be sent as part of a response but SHOULD NOT be sent as part of the request. If the property is marked as readOnly being true and is in the required list, the required will take effect on the response only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
            writeOnlybooleanRelevant only for Schema "properties" definitions. Declares the property as “write only”. Therefore, it MAY be sent as part of a request but SHOULD NOT be sent as part of the response. If the property is marked as writeOnly being true and is in the required list, the required will take effect on the request only. A property MUST NOT be marked as both readOnly and writeOnly being true. Default value is false.
            xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
            externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
            exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.
            deprecatedbooleanSpecifies that a schema is deprecated and SHOULD be transitioned out of usage. Default value is false.
            -

            This object MAY be extended with Specification Extensions.

            -
            Composition and Inheritance (Polymorphism)
            -

            The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. -allOf takes an array of object definitions that are validated independently but together compose a single object.

            -

            While composition offers model extensibility, it does not imply a hierarchy between the models. -To support polymorphism, the OpenAPI Specification adds the discriminator field. -When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. -As such, the discriminator field MUST be a required field. -There are two ways to define the value of a discriminator for an inheriting instance.

            -
              -
            • Use the schema name.
            • -
            • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. -As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
            • -
            -
            XML Modeling
            -

            The xml property allows extra definitions when translating the JSON definition to XML. -The XML Object contains additional information about the available options.

            -

            Schema Object Examples

            -
            Primitive Sample
            -
            
            -{
            -  "type": "string",
            -  "format": "email"
            -}
            -
            -
            
            -type: string
            -format: email
            -
            -
            Simple Model
            -
            
            -{
            -  "type": "object",
            -  "required": [
            -    "name"
            -  ],
            -  "properties": {
            -    "name": {
            -      "type": "string"
            -    },
            -    "address": {
            -      "$ref": "#/components/schemas/Address"
            -    },
            -    "age": {
            -      "type": "integer",
            -      "format": "int32",
            -      "minimum": 0
            -    }
            -  }
            -}
            -
            -
            
            -type: object
            -required:
            -- name
            -properties:
            -  name:
            -    type: string
            -  address:
            -    $ref: '#/components/schemas/Address'
            -  age:
            -    type: integer
            -    format: int32
            -    minimum: 0
            -
            -
            Model with Map/Dictionary Properties
            -

            For a simple string to string mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  type: string
            -
            -

            For a string to model mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "$ref": "#/components/schemas/ComplexModel"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  $ref: '#/components/schemas/ComplexModel'
            -
            -
            Model with Example
            -
            
            -{
            -  "type": "object",
            -  "properties": {
            -    "id": {
            -      "type": "integer",
            -      "format": "int64"
            -    },
            -    "name": {
            -      "type": "string"
            -    }
            -  },
            -  "required": [
            -    "name"
            -  ],
            -  "example": {
            -    "name": "Puma",
            -    "id": 1
            -  }
            -}
            -
            -
            
            -type: object
            -properties:
            -  id:
            -    type: integer
            -    format: int64
            -  name:
            -    type: string
            -required:
            -- name
            -example:
            -  name: Puma
            -  id: 1
            -
            -
            Models with Composition
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "ErrorModel": {
            -        "type": "object",
            -        "required": [
            -          "message",
            -          "code"
            -        ],
            -        "properties": {
            -          "message": {
            -            "type": "string"
            -          },
            -          "code": {
            -            "type": "integer",
            -            "minimum": 100,
            -            "maximum": 600
            -          }
            -        }
            -      },
            -      "ExtendedErrorModel": {
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/ErrorModel"
            -          },
            -          {
            -            "type": "object",
            -            "required": [
            -              "rootCause"
            -            ],
            -            "properties": {
            -              "rootCause": {
            -                "type": "string"
            -              }
            -            }
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    ErrorModel:
            -      type: object
            -      required:
            -      - message
            -      - code
            -      properties:
            -        message:
            -          type: string
            -        code:
            -          type: integer
            -          minimum: 100
            -          maximum: 600
            -    ExtendedErrorModel:
            -      allOf:
            -      - $ref: '#/components/schemas/ErrorModel'
            -      - type: object
            -        required:
            -        - rootCause
            -        properties:
            -          rootCause:
            -            type: string
            -
            -
            Models with Polymorphism Support
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "Pet": {
            -        "type": "object",
            -        "discriminator": {
            -          "propertyName": "petType"
            -        },
            -        "properties": {
            -          "name": {
            -            "type": "string"
            -          },
            -          "petType": {
            -            "type": "string"
            -          }
            -        },
            -        "required": [
            -          "name",
            -          "petType"
            -        ]
            -      },
            -      "Cat": {
            -        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "huntingSkill": {
            -                "type": "string",
            -                "description": "The measured skill for hunting",
            -                "default": "lazy",
            -                "enum": [
            -                  "clueless",
            -                  "lazy",
            -                  "adventurous",
            -                  "aggressive"
            -                ]
            -              }
            -            },
            -            "required": [
            -              "huntingSkill"
            -            ]
            -          }
            -        ]
            -      },
            -      "Dog": {
            -        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "packSize": {
            -                "type": "integer",
            -                "format": "int32",
            -                "description": "the size of the pack the dog is from",
            -                "default": 0,
            -                "minimum": 0
            -              }
            -            },
            -            "required": [
            -              "packSize"
            -            ]
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      discriminator:
            -        propertyName: petType
            -      properties:
            -        name:
            -          type: string
            -        petType:
            -          type: string
            -      required:
            -      - name
            -      - petType
            -    Cat:  ## "Cat" will be used as the discriminator value
            -      description: A representation of a cat
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          huntingSkill:
            -            type: string
            -            description: The measured skill for hunting
            -            enum:
            -            - clueless
            -            - lazy
            -            - adventurous
            -            - aggressive
            -        required:
            -        - huntingSkill
            -    Dog:  ## "Dog" will be used as the discriminator value
            -      description: A representation of a dog
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          packSize:
            -            type: integer
            -            format: int32
            -            description: the size of the pack the dog is from
            -            default: 0
            -            minimum: 0
            -        required:
            -        - packSize
            -
            -

            Discriminator Object

            -

            When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.

            -

            When using the discriminator, inline schemas will not be considered.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
            mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
            -

            The discriminator object is legal only when using one of the composite keywords oneOf, anyOf, allOf.

            -

            In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -
            -

            which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  discriminator:
            -    propertyName: petType
            -
            -

            The expectation now is that a property with name petType MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

            -
            
            -{
            -  "id": 12345,
            -  "petType": "Cat"
            -}
            -
            -

            Will indicate that the Cat schema be used in conjunction with this payload.

            -

            In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -  discriminator:
            -    propertyName: petType
            -    mapping:
            -      dog: '#/components/schemas/Dog'
            -      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -
            -

            Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

            -

            When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

            -

            In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

            -

            For example:

            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      required:
            -      - petType
            -      properties:
            -        petType:
            -          type: string
            -      discriminator:
            -        propertyName: petType
            -        mapping:
            -          dog: Dog
            -    Cat:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Cat`
            -        properties:
            -          name:
            -            type: string
            -    Dog:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Dog`
            -        properties:
            -          bark:
            -            type: string
            -    Lizard:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Lizard`
            -        properties:
            -          lovesRocks:
            -            type: boolean
            -
            -

            a payload like this:

            -
            
            -{
            -  "petType": "Cat",
            -  "name": "misty"
            -}
            -
            -

            will indicate that the Cat schema be used. Likewise this schema:

            -
            
            -{
            -  "petType": "dog",
            -  "bark": "soft"
            -}
            -
            -

            will map to Dog because of the definition in the mappings element.

            -

            XML Object

            -

            A metadata object that allows for more fine-tuned XML model definitions.

            -

            When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. -See examples for expected behavior.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
            namespacestringThe URI of the namespace definition. Value MUST be in the form of an absolute URI.
            prefixstringThe prefix to be used for the name.
            attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
            wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
            -

            This object MAY be extended with Specification Extensions.

            -

            XML Object Examples

            -

            The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

            -
            No XML Element
            -

            Basic string property:

            -
            
            -{
            -    "animals": {
            -        "type": "string"
            -    }
            -}
            -
            -
            
            -animals:
            -  type: string
            -
            -
            
            -<animals>...</animals>
            -
            -

            Basic string array property (wrapped is false by default):

            -
            
            -{
            -    "animals": {
            -        "type": "array",
            -        "items": {
            -            "type": "string"
            -        }
            -    }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -
            -
            
            -<animals>...</animals>
            -<animals>...</animals>
            -<animals>...</animals>
            -
            -
            XML Name Replacement
            -
            
            -{
            -  "animals": {
            -    "type": "string",
            -    "xml": {
            -      "name": "animal"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: string
            -  xml:
            -    name: animal
            -
            -
            
            -<animal>...</animal>
            -
            -
            XML Attribute, Prefix and Namespace
            -

            In this example, a full model definition is shown.

            -
            
            -{
            -  "Person": {
            -    "type": "object",
            -    "properties": {
            -      "id": {
            -        "type": "integer",
            -        "format": "int32",
            -        "xml": {
            -          "attribute": true
            -        }
            -      },
            -      "name": {
            -        "type": "string",
            -        "xml": {
            -          "namespace": "http://example.com/schema/sample",
            -          "prefix": "sample"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -Person:
            -  type: object
            -  properties:
            -    id:
            -      type: integer
            -      format: int32
            -      xml:
            -        attribute: true
            -    name:
            -      type: string
            -      xml:
            -        namespace: http://example.com/schema/sample
            -        prefix: sample
            -
            -
            
            -<Person id="123">
            -    <sample:name xmlns:sample="http://example.com/schema/sample">example</sample:name>
            -</Person>
            -
            -
            XML Arrays
            -

            Changing the element names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            The external name property has no effect on the XML:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animals>value</animals>
            -  <animals>value</animals>
            -</animals>
            -
            -

            To overcome the naming problem in the example above, the following definition can be used:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</animals>
            -
            -

            Affecting both internal and external names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</aliens>
            -
            -

            If we change the external element but not the internal ones:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <aliens>value</aliens>
            -  <aliens>value</aliens>
            -</aliens>
            -
            -

            Security Scheme Object

            -

            Defines a security scheme that can be used by the operations. -Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and OpenID Connect Discovery.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "oauth2", "openIdConnect".
            descriptionstringAnyA short description for security scheme. CommonMark syntax MAY be used for rich text representation.
            namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
            instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
            schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]]. The values used SHOULD be registered in the IANA Authentication Scheme registry.
            bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
            flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
            openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            Security Scheme Object Example

            -
            Basic Authentication Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "basic"
            -}
            -
            -
            
            -type: http
            -scheme: basic
            -
            -
            API Key Sample
            -
            
            -{
            -  "type": "apiKey",
            -  "name": "api_key",
            -  "in": "header"
            -}
            -
            -
            
            -type: apiKey
            -name: api_key
            -in: header
            -
            -
            JWT Bearer Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "bearer",
            -  "bearerFormat": "JWT",
            -}
            -
            -
            
            -type: http
            -scheme: bearer
            -bearerFormat: JWT
            -
            -
            Implicit OAuth2 Sample
            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            OAuth Flows Object

            -

            Allows configuration of the supported OAuth Flows.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
            passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
            clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
            authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object

            -

            Configuration details for a supported OAuth Flow

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL.
            tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL.
            refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL.
            scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object Examples

            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    },
            -    "authorizationCode": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "tokenUrl": "https://example.com/api/oauth/token",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -  authorizationCode:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    tokenUrl: https://example.com/api/oauth/token
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            Security Requirement Object

            -

            Lists the required security schemes to execute this operation. -The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

            -

            Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. -This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

            -

            When a list of Security Requirement Objects is defined on the OpenAPI Object or Operation Object, only one of the Security Requirement Objects in the list needs to be satisfied to authorize the request.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution, and the list MAY be empty if authorization does not require a specified scope. For other security scheme types, the array MUST be empty.
            -

            Security Requirement Object Examples

            -
            Non-OAuth2 Security Requirement
            -
            
            -{
            -  "api_key": []
            -}
            -
            -
            
            -api_key: []
            -
            -
            OAuth2 Security Requirement
            -
            
            -{
            -  "petstore_auth": [
            -    "write:pets",
            -    "read:pets"
            -  ]
            -}
            -
            -
            
            -petstore_auth:
            -- write:pets
            -- read:pets
            -
            -
            Optional OAuth2 Security
            -

            Optional OAuth2 security as would be defined in an OpenAPI Object or an Operation Object:

            -
            
            -{
            -  "security": [
            -    {},
            -    {
            -      "petstore_auth": [
            -        "write:pets",
            -        "read:pets"
            -      ]
            -    }
            -  ]
            -}
            -
            -
            
            -security:
            -  - {}
            -  - petstore_auth:
            -    - write:pets
            -    - read:pets
            -
            -

            Specification Extensions

            -

            While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

            -

            The extensions properties are implemented as patterned fields that are always prefixed by "x-".

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. The value can be null, a primitive, an array or an object. Can have any valid JSON format value.
            -

            The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

            -

            Security Filtering

            -

            Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

            -

            The reasoning is to allow an additional layer of access control over the documentation. -While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

            -

            Two examples of this:

            -
              -
            1. The Paths Object MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the Info Object which may contain additional information regarding authentication.
            2. -
            3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the Paths Object, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
            4. -
            -

            Appendix A: Revision History

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            VersionDateNotes
            3.0.32020-02-20Patch release of the OpenAPI Specification 3.0.3
            3.0.22018-10-08Patch release of the OpenAPI Specification 3.0.2
            3.0.12017-12-06Patch release of the OpenAPI Specification 3.0.1
            3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
            3.0.0-rc22017-06-16rc2 of the 3.0 specification
            3.0.0-rc12017-04-27rc1 of the 3.0 specification
            3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
            2.02015-12-31Donation of Swagger 2.0 to the OpenAPI Initiative
            2.02014-09-08Release of Swagger 2.0
            1.22014-03-14Initial release of the formal document.
            1.12012-08-22Release of Swagger 1.1
            1.02011-08-10First release of the Swagger Specification
            - diff --git a/docs/oas/v3.1.0.html b/docs/oas/v3.1.0.html deleted file mode 100644 index 6a8ea9e54d..0000000000 --- a/docs/oas/v3.1.0.html +++ /dev/null @@ -1,4083 +0,0 @@ -OpenAPI Specification v3.1.0 | Introduction, Definitions, & More - - -

            OpenAPI Specification v3.1.0

            The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

            Status of This Document

            The source-of-truth for the specification is the GitHub markdown file referenced above.
            -

            OpenAPI Specification

            -

            Version 3.1.0

            -

            The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [[!RFC2119]] [[!RFC8174]] when, and only when, they appear in all capitals, as shown here.

            -

            This document is licensed under The Apache License, Version 2.0.

            -

            Introduction

            -

            The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to HTTP APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

            -

            An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

            - -

            Definitions

            -

            OpenAPI Document

            -

            A self-contained or composite resource which defines or describes an API or elements of an API. The OpenAPI document MUST contain at least one paths field, a components field or a webhooks field. An OpenAPI document uses and conforms to the OpenAPI Specification.

            -

            Path Templating

            -

            Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.

            -

            Each template expression in the path MUST correspond to a path parameter that is included in the Path Item itself and/or in each of the Path Item’s Operations. An exception is if the path item is empty, for example due to ACL constraints, matching path parameters are not required.

            -

            The value for these path parameters MUST NOT contain any unescaped “generic syntax” characters described by [[!RFC3986]]: forward slashes (/), question marks (?), or hashes (#).

            -

            Media Types

            -

            Media type definitions are spread across several resources. -The media type definitions SHOULD be in compliance with [[!RFC6838]].

            -

            Some examples of possible media type definitions:

            -
            
            -  text/plain; charset=utf-8
            -  application/json
            -  application/vnd.github+json
            -  application/vnd.github.v3+json
            -  application/vnd.github.v3.raw+json
            -  application/vnd.github.v3.text+json
            -  application/vnd.github.v3.html+json
            -  application/vnd.github.v3.full+json
            -  application/vnd.github.v3.diff
            -  application/vnd.github.v3.patch
            -
            -

            HTTP Status Codes

            -

            The HTTP Status Codes are used to indicate the status of the executed operation. -The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the IANA Status Code Registry.

            -

            Specification

            -

            Versions

            -

            The OpenAPI Specification is versioned using a major.minor.patch versioning scheme. The major.minor portion of the version string (for example 3.1) SHALL designate the OAS feature set. .patch versions address errors in, or provide clarifications to, this document, not the feature set. Tooling which supports OAS 3.1 SHOULD be compatible with all OAS 3.1.* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between 3.1.0 and 3.1.1 for example.

            -

            Occasionally, non-backwards compatible changes may be made in minor versions of the OAS where impact is believed to be low relative to the benefit provided.

            -

            An OpenAPI document compatible with OAS 3.*.* contains a required openapi field which designates the version of the OAS that it uses.

            -

            Format

            -

            An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.

            -

            For example, if a field has an array value, the JSON array representation will be used:

            -
            
            -{
            -   "field": [ 1, 2, 3 ]
            -}
            -
            -

            All field names in the specification are case sensitive. -This includes all fields that are used as keys in a map, except where explicitly noted that keys are case insensitive.

            -

            The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.

            -

            Patterned fields MUST have unique names within the containing object.

            -

            In order to preserve the ability to round-trip between YAML and JSON formats, YAML version 1.2 is RECOMMENDED along with some additional constraints:

            - -

            Note: While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.

            -

            Document Structure

            -

            An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. In the latter case, Reference Objects and Schema Object $ref keywords are used.

            -

            It is RECOMMENDED that the root OpenAPI document be named: openapi.json or openapi.yaml.

            -

            Data Types

            -

            Data types in the OAS are based on the types supported by the JSON Schema Specification Draft 2020-12. -Note that integer as a type is also supported and is defined as a JSON number without a fraction or exponent part. -Models are defined using the Schema Object, which is a superset of JSON Schema Specification Draft 2020-12.

            -

            As defined by the JSON Schema Validation vocabulary, data types can have an optional modifier property: format. -OAS defines additional formats to provide fine detail for primitive data types.

            -

            The formats defined by the OAS are:

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            typeformatComments
            integerint32signed 32 bits
            integerint64signed 64 bits (a.k.a long)
            numberfloat
            numberdouble
            stringpasswordA hint to UIs to obscure input.
            -

            Rich Text Formatting

            -

            Throughout the specification description fields are noted as supporting CommonMark markdown formatting. -Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27. Tooling MAY choose to ignore some CommonMark features to address security concerns.

            -

            Relative References in URIs

            -

            Unless specified otherwise, all properties that are URIs MAY be relative references as defined by [[!RFC3986]].

            -

            Relative references, including those in Reference Objects, PathItem Object $ref fields, Link Object operationRef fields and Example Object externalValue fields, are resolved using the referring document as the Base URI according to [[!RFC3986]].

            -

            If a URI contains a fragment identifier, then the fragment should be resolved per the fragment resolution mechanism of the referenced document. If the representation of the referenced document is JSON or YAML, then the fragment identifier SHOULD be interpreted as a JSON-Pointer as per [[!RFC6901]].

            -

            Relative references in Schema Objects, including any that appear as $id values, use the nearest parent $id as a Base URI, as described by JSON Schema Specification Draft 2020-12. If no parent schema contains an $id, then the Base URI MUST be determined according to [[!RFC3986]].

            -

            Relative References in URLs

            -

            Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]]. -Unless specified otherwise, relative references are resolved using the URLs defined in the Server Object as a Base URL. Note that these themselves MAY be relative to the referring document.

            -

            Schema

            -

            In the following description, if a field is not explicitly REQUIRED or described with a MUST or SHALL, it can be considered OPTIONAL.

            -

            OpenAPI Object

            -

            This is the root object of the OpenAPI document.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            openapistringREQUIRED. This string MUST be the version number of the OpenAPI Specification that the OpenAPI document uses. The openapi field SHOULD be used by tooling to interpret the OpenAPI document. This is not related to the API info.version string.
            infoInfo ObjectREQUIRED. Provides metadata about the API. The metadata MAY be used by tooling as required.
            jsonSchemaDialectstringThe default value for the $schema keyword within Schema Objects contained within this OAS document. This MUST be in the form of a URI.
            servers[Server Object]An array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.
            pathsPaths ObjectThe available paths and operations for the API.
            webhooksMap[string, Path Item Object | Reference Object] ]The incoming webhooks that MAY be received as part of this API and that the API consumer MAY choose to implement. Closely related to the callbacks feature, this section describes requests initiated other than by an API call, for example by an out of band registration. The key name is a unique string to refer to each webhook, while the (optionally referenced) Path Item Object describes a request that may be initiated by the API provider and the expected responses. An example is available.
            componentsComponents ObjectAn element to hold various schemas for the document.
            security[Security Requirement Object]A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition. To make security optional, an empty security requirement ({}) can be included in the array.
            tags[Tag Object]A list of tags used by the document with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the Operation Object must be declared. The tags that are not declared MAY be organized randomly or based on the tools’ logic. Each tag name in the list MUST be unique.
            externalDocsExternal Documentation ObjectAdditional external documentation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object

            -

            The object provides metadata about the API. -The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            titlestringREQUIRED. The title of the API.
            summarystringA short summary of the API.
            descriptionstringA description of the API. CommonMark syntax MAY be used for rich text representation.
            termsOfServicestringA URL to the Terms of Service for the API. This MUST be in the form of a URL.
            contactContact ObjectThe contact information for the exposed API.
            licenseLicense ObjectThe license information for the exposed API.
            versionstringREQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
            -

            This object MAY be extended with Specification Extensions.

            -

            Info Object Example

            -
            
            -{
            -  "title": "Sample Pet Store App",
            -  "summary": "A pet store manager.",
            -  "description": "This is a sample server for a pet store.",
            -  "termsOfService": "https://example.com/terms/",
            -  "contact": {
            -    "name": "API Support",
            -    "url": "https://www.example.com/support",
            -    "email": "support@example.com"
            -  },
            -  "license": {
            -    "name": "Apache 2.0",
            -    "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
            -  },
            -  "version": "1.0.1"
            -}
            -
            -
            
            -title: Sample Pet Store App
            -summary: A pet store manager.
            -description: This is a sample server for a pet store.
            -termsOfService: https://example.com/terms/
            -contact:
            -  name: API Support
            -  url: https://www.example.com/support
            -  email: support@example.com
            -license:
            -  name: Apache 2.0
            -  url: https://www.apache.org/licenses/LICENSE-2.0.html
            -version: 1.0.1
            -
            -

            Contact Object

            -

            Contact information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringThe identifying name of the contact person/organization.
            urlstringThe URL pointing to the contact information. This MUST be in the form of a URL.
            emailstringThe email address of the contact person/organization. This MUST be in the form of an email address.
            -

            This object MAY be extended with Specification Extensions.

            -

            Contact Object Example

            -
            
            -{
            -  "name": "API Support",
            -  "url": "https://www.example.com/support",
            -  "email": "support@example.com"
            -}
            -
            -
            
            -name: API Support
            -url: https://www.example.com/support
            -email: support@example.com
            -
            -

            License Object

            -

            License information for the exposed API.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The license name used for the API.
            identifierstringAn SPDX license expression for the API. The identifier field is mutually exclusive of the url field.
            urlstringA URL to the license used for the API. This MUST be in the form of a URL. The url field is mutually exclusive of the identifier field.
            -

            This object MAY be extended with Specification Extensions.

            -

            License Object Example

            -
            
            -{
            -  "name": "Apache 2.0",
            -  "identifier": "Apache-2.0"
            -}
            -
            -
            
            -name: Apache 2.0
            -identifier: Apache-2.0
            -
            -

            Server Object

            -

            An object representing a Server.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            urlstringREQUIRED. A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host location is relative to the location where the OpenAPI document is being served. Variable substitutions will be made when a variable is named in {brackets}.
            descriptionstringAn optional string describing the host designated by the URL. CommonMark syntax MAY be used for rich text representation.
            variablesMap[string, Server Variable Object]A map between a variable name and its value. The value is used for substitution in the server’s URL template.
            -

            This object MAY be extended with Specification Extensions.

            -

            Server Object Example

            -

            A single server would be described as:

            -
            
            -{
            -  "url": "https://development.gigantic-server.com/v1",
            -  "description": "Development server"
            -}
            -
            -
            
            -url: https://development.gigantic-server.com/v1
            -description: Development server
            -
            -

            The following shows how multiple servers can be described, for example, at the OpenAPI Object’s servers:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://development.gigantic-server.com/v1",
            -      "description": "Development server"
            -    },
            -    {
            -      "url": "https://staging.gigantic-server.com/v1",
            -      "description": "Staging server"
            -    },
            -    {
            -      "url": "https://api.gigantic-server.com/v1",
            -      "description": "Production server"
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://development.gigantic-server.com/v1
            -  description: Development server
            -- url: https://staging.gigantic-server.com/v1
            -  description: Staging server
            -- url: https://api.gigantic-server.com/v1
            -  description: Production server
            -
            -

            The following shows how variables can be used for a server configuration:

            -
            
            -{
            -  "servers": [
            -    {
            -      "url": "https://{username}.gigantic-server.com:{port}/{basePath}",
            -      "description": "The production API server",
            -      "variables": {
            -        "username": {
            -          "default": "demo",
            -          "description": "this value is assigned by the service provider, in this example `gigantic-server.com`"
            -        },
            -        "port": {
            -          "enum": [
            -            "8443",
            -            "443"
            -          ],
            -          "default": "8443"
            -        },
            -        "basePath": {
            -          "default": "v2"
            -        }
            -      }
            -    }
            -  ]
            -}
            -
            -
            
            -servers:
            -- url: https://{username}.gigantic-server.com:{port}/{basePath}
            -  description: The production API server
            -  variables:
            -    username:
            -      # note! no enum here means it is an open value
            -      default: demo
            -      description: this value is assigned by the service provider, in this example `gigantic-server.com`
            -    port:
            -      enum:
            -        - '8443'
            -        - '443'
            -      default: '8443'
            -    basePath:
            -      # open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`
            -      default: v2
            -
            -

            Server Variable Object

            -

            An object representing a Server Variable for server URL template substitution.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            enum[string]An enumeration of string values to be used if the substitution options are from a limited set. The array MUST NOT be empty.
            defaultstringREQUIRED. The default value to use for substitution, which SHALL be sent if an alternate value is not supplied. Note this behavior is different than the Schema Object’s treatment of default values, because in those cases parameter values are optional. If the enum is defined, the value MUST exist in the enum’s values.
            descriptionstringAn optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
            -

            This object MAY be extended with Specification Extensions.

            -

            Components Object

            -

            Holds a set of reusable objects for different aspects of the OAS. -All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemasMap[string, Schema Object]An object to hold reusable Schema Objects.
            responsesMap[string, Response Object | Reference Object]An object to hold reusable Response Objects.
            parametersMap[string, Parameter Object | Reference Object]An object to hold reusable Parameter Objects.
            examplesMap[string, Example Object | Reference Object]An object to hold reusable Example Objects.
            requestBodiesMap[string, Request Body Object | Reference Object]An object to hold reusable Request Body Objects.
            headersMap[string, Header Object | Reference Object]An object to hold reusable Header Objects.
            securitySchemesMap[string, Security Scheme Object | Reference Object]An object to hold reusable Security Scheme Objects.
            linksMap[string, Link Object | Reference Object]An object to hold reusable Link Objects.
            callbacksMap[string, Callback Object | Reference Object]An object to hold reusable Callback Objects.
            pathItemsMap[string, Path Item Object | Reference Object]An object to hold reusable Path Item Object.
            -

            This object MAY be extended with Specification Extensions.

            -

            All the fixed fields declared above are objects that MUST use keys that match the regular expression: ^[a-zA-Z0-9\.\-_]+$.

            -

            Field Name Examples:

            -
            
            -User
            -User_1
            -User_Name
            -user-name
            -my.org.User
            -
            -

            Components Object Example

            -
            
            -"components": {
            -  "schemas": {
            -    "GeneralError": {
            -      "type": "object",
            -      "properties": {
            -        "code": {
            -          "type": "integer",
            -          "format": "int32"
            -        },
            -        "message": {
            -          "type": "string"
            -        }
            -      }
            -    },
            -    "Category": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    },
            -    "Tag": {
            -      "type": "object",
            -      "properties": {
            -        "id": {
            -          "type": "integer",
            -          "format": "int64"
            -        },
            -        "name": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  },
            -  "parameters": {
            -    "skipParam": {
            -      "name": "skip",
            -      "in": "query",
            -      "description": "number of items to skip",
            -      "required": true,
            -      "schema": {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    },
            -    "limitParam": {
            -      "name": "limit",
            -      "in": "query",
            -      "description": "max records to return",
            -      "required": true,
            -      "schema" : {
            -        "type": "integer",
            -        "format": "int32"
            -      }
            -    }
            -  },
            -  "responses": {
            -    "NotFound": {
            -      "description": "Entity not found."
            -    },
            -    "IllegalInput": {
            -      "description": "Illegal input for operation."
            -    },
            -    "GeneralError": {
            -      "description": "General Error",
            -      "content": {
            -        "application/json": {
            -          "schema": {
            -            "$ref": "#/components/schemas/GeneralError"
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "securitySchemes": {
            -    "api_key": {
            -      "type": "apiKey",
            -      "name": "api_key",
            -      "in": "header"
            -    },
            -    "petstore_auth": {
            -      "type": "oauth2",
            -      "flows": {
            -        "implicit": {
            -          "authorizationUrl": "https://example.org/api/oauth/dialog",
            -          "scopes": {
            -            "write:pets": "modify pets in your account",
            -            "read:pets": "read your pets"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    GeneralError:
            -      type: object
            -      properties:
            -        code:
            -          type: integer
            -          format: int32
            -        message:
            -          type: string
            -    Category:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -    Tag:
            -      type: object
            -      properties:
            -        id:
            -          type: integer
            -          format: int64
            -        name:
            -          type: string
            -  parameters:
            -    skipParam:
            -      name: skip
            -      in: query
            -      description: number of items to skip
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -    limitParam:
            -      name: limit
            -      in: query
            -      description: max records to return
            -      required: true
            -      schema:
            -        type: integer
            -        format: int32
            -  responses:
            -    NotFound:
            -      description: Entity not found.
            -    IllegalInput:
            -      description: Illegal input for operation.
            -    GeneralError:
            -      description: General Error
            -      content:
            -        application/json:
            -          schema:
            -            $ref: '#/components/schemas/GeneralError'
            -  securitySchemes:
            -    api_key:
            -      type: apiKey
            -      name: api_key
            -      in: header
            -    petstore_auth:
            -      type: oauth2
            -      flows:
            -        implicit:
            -          authorizationUrl: https://example.org/api/oauth/dialog
            -          scopes:
            -            write:pets: modify pets in your account
            -            read:pets: read your pets
            -
            -

            Paths Object

            -

            Holds the relative paths to the individual endpoints and their operations. -The path is appended to the URL from the Server Object in order to construct the full URL. The Paths MAY be empty, due to Access Control List (ACL) constraints.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            /{path}Path Item ObjectA relative path to an individual endpoint. The field name MUST begin with a forward slash (/). The path is appended (no relative URL resolution) to the expanded URL from the Server Object’s url field in order to construct the full URL. Path templating is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it’s up to the tooling to decide which one to use.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Templating Matching

            -

            Assuming the following paths, the concrete definition, /pets/mine, will be matched first if used:

            -
            
            -  /pets/{petId}
            -  /pets/mine
            -
            -

            The following paths are considered identical and invalid:

            -
            
            -  /pets/{petId}
            -  /pets/{name}
            -
            -

            The following may lead to ambiguous resolution:

            -
            
            -  /{entity}/me
            -  /books/{id}
            -
            -

            Paths Object Example

            -
            
            -{
            -  "/pets": {
            -    "get": {
            -      "description": "Returns all pets from the system that the user has access to",
            -      "responses": {
            -        "200": {         
            -          "description": "A list of pets.",
            -          "content": {
            -            "application/json": {
            -              "schema": {
            -                "type": "array",
            -                "items": {
            -                  "$ref": "#/components/schemas/pet"
            -                }
            -              }
            -            }
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -/pets:
            -  get:
            -    description: Returns all pets from the system that the user has access to
            -    responses:
            -      '200':
            -        description: A list of pets.
            -        content:
            -          application/json:
            -            schema:
            -              type: array
            -              items:
            -                $ref: '#/components/schemas/pet'
            -
            -

            Path Item Object

            -

            Describes the operations available on a single path. -A Path Item MAY be empty, due to ACL constraints. -The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringAllows for a referenced definition of this path item. The referenced structure MUST be in the form of a Path Item Object. In case a Path Item Object field appears both in the defined object and the referenced object, the behavior is undefined. See the rules for resolving Relative References.
            summarystringAn optional, string summary, intended to apply to all operations in this path.
            descriptionstringAn optional, string description, intended to apply to all operations in this path. CommonMark syntax MAY be used for rich text representation.
            getOperation ObjectA definition of a GET operation on this path.
            putOperation ObjectA definition of a PUT operation on this path.
            postOperation ObjectA definition of a POST operation on this path.
            deleteOperation ObjectA definition of a DELETE operation on this path.
            optionsOperation ObjectA definition of a OPTIONS operation on this path.
            headOperation ObjectA definition of a HEAD operation on this path.
            patchOperation ObjectA definition of a PATCH operation on this path.
            traceOperation ObjectA definition of a TRACE operation on this path.
            servers[Server Object]An alternative server array to service all operations in this path.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for all the operations described under this path. These parameters can be overridden at the operation level, but cannot be removed there. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            -

            This object MAY be extended with Specification Extensions.

            -

            Path Item Object Example

            -
            
            -{
            -  "get": {
            -    "description": "Returns pets based on ID",
            -    "summary": "Find pets by ID",
            -    "operationId": "getPetsById",
            -    "responses": {
            -      "200": {
            -        "description": "pet response",
            -        "content": {
            -          "*/*": {
            -            "schema": {
            -              "type": "array",
            -              "items": {
            -                "$ref": "#/components/schemas/Pet"
            -              }
            -            }
            -          }
            -        }
            -      },
            -      "default": {
            -        "description": "error payload",
            -        "content": {
            -          "text/html": {
            -            "schema": {
            -              "$ref": "#/components/schemas/ErrorModel"
            -            }
            -          }
            -        }
            -      }
            -    }
            -  },
            -  "parameters": [
            -    {
            -      "name": "id",
            -      "in": "path",
            -      "description": "ID of pet to use",
            -      "required": true,
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      },
            -      "style": "simple"
            -    }
            -  ]
            -}
            -
            -
            
            -get:
            -  description: Returns pets based on ID
            -  summary: Find pets by ID
            -  operationId: getPetsById
            -  responses:
            -    '200':
            -      description: pet response
            -      content:
            -        '*/*' :
            -          schema:
            -            type: array
            -            items:
            -              $ref: '#/components/schemas/Pet'
            -    default:
            -      description: error payload
            -      content:
            -        'text/html':
            -          schema:
            -            $ref: '#/components/schemas/ErrorModel'
            -parameters:
            -- name: id
            -  in: path
            -  description: ID of pet to use
            -  required: true
            -  schema:
            -    type: array
            -    items:
            -      type: string 
            -  style: simple
            -
            -

            Operation Object

            -

            Describes a single API operation on a path.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
            summarystringA short summary of what the operation does.
            descriptionstringA verbose explanation of the operation behavior. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this operation.
            operationIdstringUnique string used to identify the operation. The id MUST be unique among all operations described in the API. The operationId value is case-sensitive. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions.
            parameters[Parameter Object | Reference Object]A list of parameters that are applicable for this operation. If a parameter is already defined at the Path Item, the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object’s components/parameters.
            requestBodyRequest Body Object | Reference ObjectThe request body applicable for this operation. The requestBody is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as GET, HEAD and DELETE), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.
            responsesResponses ObjectThe list of possible responses as they are returned from executing this operation.
            callbacksMap[string, Callback Object | Reference Object]A map of possible out-of band callbacks related to the parent operation. The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a request that may be initiated by the API provider and the expected responses.
            deprecatedbooleanDeclares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is false.
            security[Security Requirement Object]A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. To make security optional, an empty security requirement ({}) can be included in the array. This definition overrides any declared top-level security. To remove a top-level security declaration, an empty array can be used.
            servers[Server Object]An alternative server array to service this operation. If an alternative server object is specified at the Path Item Object or Root level, it will be overridden by this value.
            -

            This object MAY be extended with Specification Extensions.

            -

            Operation Object Example

            -
            
            -{
            -  "tags": [
            -    "pet"
            -  ],
            -  "summary": "Updates a pet in the store with form data",
            -  "operationId": "updatePetWithForm",
            -  "parameters": [
            -    {
            -      "name": "petId",
            -      "in": "path",
            -      "description": "ID of pet that needs to be updated",
            -      "required": true,
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  ],
            -  "requestBody": {
            -    "content": {
            -      "application/x-www-form-urlencoded": {
            -        "schema": {
            -          "type": "object",
            -          "properties": {
            -            "name": {
            -              "description": "Updated name of the pet",
            -              "type": "string"
            -            },
            -            "status": {
            -              "description": "Updated status of the pet",
            -              "type": "string"
            -            }
            -          },
            -          "required": ["status"]
            -        }
            -      }
            -    }
            -  },
            -  "responses": {
            -    "200": {
            -      "description": "Pet updated.",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    },
            -    "405": {
            -      "description": "Method Not Allowed",
            -      "content": {
            -        "application/json": {},
            -        "application/xml": {}
            -      }
            -    }
            -  },
            -  "security": [
            -    {
            -      "petstore_auth": [
            -        "write:pets",
            -        "read:pets"
            -      ]
            -    }
            -  ]
            -}
            -
            -
            
            -tags:
            -- pet
            -summary: Updates a pet in the store with form data
            -operationId: updatePetWithForm
            -parameters:
            -- name: petId
            -  in: path
            -  description: ID of pet that needs to be updated
            -  required: true
            -  schema:
            -    type: string
            -requestBody:
            -  content:
            -    'application/x-www-form-urlencoded':
            -      schema:
            -       type: object
            -       properties:
            -          name:
            -            description: Updated name of the pet
            -            type: string
            -          status:
            -            description: Updated status of the pet
            -            type: string
            -       required:
            -         - status
            -responses:
            -  '200':
            -    description: Pet updated.
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -  '405':
            -    description: Method Not Allowed
            -    content:
            -      'application/json': {}
            -      'application/xml': {}
            -security:
            -- petstore_auth:
            -  - write:pets
            -  - read:pets
            -
            -

            External Documentation Object

            -

            Allows referencing an external resource for extended documentation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA description of the target documentation. CommonMark syntax MAY be used for rich text representation.
            urlstringREQUIRED. The URL for the target documentation. This MUST be in the form of a URL.
            -

            This object MAY be extended with Specification Extensions.

            -

            External Documentation Object Example

            -
            
            -{
            -  "description": "Find more info here",
            -  "url": "https://example.com"
            -}
            -
            -
            
            -description: Find more info here
            -url: https://example.com
            -
            -

            Parameter Object

            -

            Describes a single operation parameter.

            -

            A unique parameter is defined by a combination of a name and location.

            -

            Parameter Locations

            -

            There are four possible parameter locations specified by the in field:

            -
              -
            • path - Used together with Path Templating, where the parameter value is actually part of the operation’s URL. This does not include the host or base path of the API. For example, in /items/{itemId}, the path parameter is itemId.
            • -
            • query - Parameters that are appended to the URL. For example, in /items?id=###, the query parameter is id.
            • -
            • header - Custom headers that are expected as part of the request. Note that [[!RFC7230]] states header names are case insensitive.
            • -
            • cookie - Used to pass a specific cookie value to the API.
            • -
            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the parameter. Parameter names are case sensitive.
            • If in is "path", the name field MUST correspond to a template expression occurring within the path field in the Paths Object. See Path Templating for further information.
            • If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored.
            • For all other cases, the name corresponds to the parameter name used by the in property.
            instringREQUIRED. The location of the parameter. Possible values are "query", "header", "path" or "cookie".
            descriptionstringA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            requiredbooleanDetermines whether this parameter is mandatory. If the parameter location is "path", this property is REQUIRED and its value MUST be true. Otherwise, the property MAY be included and its default value is false.
            deprecatedbooleanSpecifies that a parameter is deprecated and SHOULD be transitioned out of usage. Default value is false.
            allowEmptyValuebooleanSets the ability to pass empty-valued parameters. This is valid only for query parameters and allows sending a parameter with an empty value. Default value is false. If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue SHALL be ignored. Use of this property is NOT RECOMMENDED, as it is likely to be removed in a later revision.
            -

            The rules for serialization of the parameter are specified in one of two ways. -For simpler scenarios, a schema and style can describe the structure and syntax of the parameter.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            stylestringDescribes how the parameter value will be serialized depending on the type of the parameter value. Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
            explodebooleanWhen this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. For other types of parameters this property has no effect. When style is form, the default value is true. For all other styles, the default value is false.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. This property only applies to parameters with an in value of query. The default value is false.
            schemaSchema ObjectThe schema defining the type used for the parameter.
            exampleAnyExample of the parameter’s potential value. The example SHOULD match the specified schema and encoding properties if present. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema that contains an example, the example value SHALL override the example provided by the schema. To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
            examplesMap[ string, Example Object | Reference Object]Examples of the parameter’s potential value. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema that contains an example, the examples value SHALL override the example provided by the schema.
            -

            For more complex scenarios, the content property can define the media type and schema of the parameter. -A parameter MUST contain either a schema property, or a content property, but not both. -When example or examples are provided in conjunction with the schema object, the example MUST follow the prescribed serialization strategy for the parameter.

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentMap[string, Media Type Object]A map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
            -

            Style Values

            -

            In order to support common ways of serializing simple parameters, a set of style values are defined.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styletypeinComments
            matrixprimitive, array, objectpathPath-style parameters defined by [[!RFC6570]]
            labelprimitive, array, objectpathLabel style parameters defined by [[!RFC6570]]
            formprimitive, array, objectquery, cookieForm style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
            simplearraypath, headerSimple style parameters defined by [[!RFC6570]]. This option replaces collectionFormat with a csv value from OpenAPI 2.0.
            spaceDelimitedarray, objectquerySpace separated array or object values. This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
            pipeDelimitedarray, objectqueryPipe separated array or object values. This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
            deepObjectobjectqueryProvides a simple way of rendering nested objects using form parameters.
            -

            Style Examples

            -

            Assume a parameter named color has one of the following values:

            -
            
            -   string -> "blue"
            -   array -> ["blue","black","brown"]
            -   object -> { "R": 100, "G": 200, "B": 150 }
            -
            -

            The following table shows examples of rendering differences for each value.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            styleexplodeemptystringarrayobject
            matrixfalse;color;color=blue;color=blue,black,brown;color=R,100,G,200,B,150
            matrixtrue;color;color=blue;color=blue;color=black;color=brown;R=100;G=200;B=150
            labelfalse..blue.blue.black.brown.R.100.G.200.B.150
            labeltrue..blue.blue.black.brown.R=100.G=200.B=150
            formfalsecolor=color=bluecolor=blue,black,browncolor=R,100,G,200,B,150
            formtruecolor=color=bluecolor=blue&color=black&color=brownR=100&G=200&B=150
            simplefalsen/ablueblue,black,brownR,100,G,200,B,150
            simpletruen/ablueblue,black,brownR=100,G=200,B=150
            spaceDelimitedfalsen/an/ablue%20black%20brownR%20100%20G%20200%20B%20150
            pipeDelimitedfalsen/an/ablue|black|brownR|100|G|200|B|150
            deepObjecttruen/an/an/acolor[R]=100&color[G]=200&color[B]=150
            -

            This object MAY be extended with Specification Extensions.

            -

            Parameter Object Examples

            -

            A header parameter with an array of 64 bit integer numbers:

            -
            
            -{
            -  "name": "token",
            -  "in": "header",
            -  "description": "token to be passed as a header",
            -  "required": true,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "integer",
            -      "format": "int64"
            -    }
            -  },
            -  "style": "simple"
            -}
            -
            -
            
            -name: token
            -in: header
            -description: token to be passed as a header
            -required: true
            -schema:
            -  type: array
            -  items:
            -    type: integer
            -    format: int64
            -style: simple
            -
            -

            A path parameter of a string value:

            -
            
            -{
            -  "name": "username",
            -  "in": "path",
            -  "description": "username to fetch",
            -  "required": true,
            -  "schema": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -name: username
            -in: path
            -description: username to fetch
            -required: true
            -schema:
            -  type: string
            -
            -

            An optional query parameter of a string value, allowing multiple values by repeating the query parameter:

            -
            
            -{
            -  "name": "id",
            -  "in": "query",
            -  "description": "ID of the object to fetch",
            -  "required": false,
            -  "schema": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    }
            -  },
            -  "style": "form",
            -  "explode": true
            -}
            -
            -
            
            -name: id
            -in: query
            -description: ID of the object to fetch
            -required: false
            -schema:
            -  type: array
            -  items:
            -    type: string
            -style: form
            -explode: true
            -
            -

            A free-form query parameter, allowing undefined parameters of a specific type:

            -
            
            -{
            -  "in": "query",
            -  "name": "freeForm",
            -  "schema": {
            -    "type": "object",
            -    "additionalProperties": {
            -      "type": "integer"
            -    },
            -  },
            -  "style": "form"
            -}
            -
            -
            
            -in: query
            -name: freeForm
            -schema:
            -  type: object
            -  additionalProperties:
            -    type: integer
            -style: form
            -
            -

            A complex parameter using content to define serialization:

            -
            
            -{
            -  "in": "query",
            -  "name": "coordinates",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "object",
            -        "required": [
            -          "lat",
            -          "long"
            -        ],
            -        "properties": {
            -          "lat": {
            -            "type": "number"
            -          },
            -          "long": {
            -            "type": "number"
            -          }
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -in: query
            -name: coordinates
            -content:
            -  application/json:
            -    schema:
            -      type: object
            -      required:
            -        - lat
            -        - long
            -      properties:
            -        lat:
            -          type: number
            -        long:
            -          type: number
            -
            -

            Request Body Object

            -

            Describes a single request body.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringA brief description of the request body. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
            contentMap[string, Media Type Object]REQUIRED. The content of the request body. The key is a media type or media type range and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            requiredbooleanDetermines if the request body is required in the request. Defaults to false.
            -

            This object MAY be extended with Specification Extensions.

            -

            Request Body Examples

            -

            A request body with a referenced model definition.

            -
            
            -{
            -  "description": "user to add to the system",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User Example",
            -            "externalValue": "https://foo.bar/examples/user-example.json"
            -          }
            -        }
            -    },
            -    "application/xml": {
            -      "schema": {
            -        "$ref": "#/components/schemas/User"
            -      },
            -      "examples": {
            -          "user" : {
            -            "summary": "User example in XML",
            -            "externalValue": "https://foo.bar/examples/user-example.xml"
            -          }
            -        }
            -    },
            -    "text/plain": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in Plain text",
            -            "externalValue": "https://foo.bar/examples/user-example.txt"
            -        }
            -      }
            -    },
            -    "*/*": {
            -      "examples": {
            -        "user" : {
            -            "summary": "User example in other format",
            -            "externalValue": "https://foo.bar/examples/user-example.whatever"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -content:
            -  'application/json':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User Example
            -        externalValue: 'https://foo.bar/examples/user-example.json'
            -  'application/xml':
            -    schema:
            -      $ref: '#/components/schemas/User'
            -    examples:
            -      user:
            -        summary: User example in XML
            -        externalValue: 'https://foo.bar/examples/user-example.xml'
            -  'text/plain':
            -    examples:
            -      user:
            -        summary: User example in Plain text
            -        externalValue: 'https://foo.bar/examples/user-example.txt'
            -  '*/*':
            -    examples:
            -      user:
            -        summary: User example in other format
            -        externalValue: 'https://foo.bar/examples/user-example.whatever'
            -
            -

            A body parameter that is an array of string values:

            -
            
            -{
            -  "description": "user to add to the system",
            -  "required": true,
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "type": "string"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: user to add to the system
            -required: true
            -content:
            -  text/plain:
            -    schema:
            -      type: array
            -      items:
            -        type: string
            -
            -

            Media Type Object

            -

            Each Media Type Object provides schema and examples for the media type identified by its key.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            schemaSchema ObjectThe schema defining the content of the request, response, or parameter.
            exampleAnyExample of the media type. The example object SHOULD be in the correct format as specified by the media type. The example field is mutually exclusive of the examples field. Furthermore, if referencing a schema which contains an example, the example value SHALL override the example provided by the schema.
            examplesMap[ string, Example Object | Reference Object]Examples of the media type. Each example object SHOULD match the media type and specified schema if present. The examples field is mutually exclusive of the example field. Furthermore, if referencing a schema which contains an example, the examples value SHALL override the example provided by the schema.
            encodingMap[string, Encoding Object]A map between a property name and its encoding information. The key, being the property name, MUST exist in the schema as a property. The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded.
            -

            This object MAY be extended with Specification Extensions.

            -

            Media Type Examples

            -
            
            -{
            -  "application/json": {
            -    "schema": {
            -         "$ref": "#/components/schemas/Pet"
            -    },
            -    "examples": {
            -      "cat" : {
            -        "summary": "An example of a cat",
            -        "value":
            -          {
            -            "name": "Fluffy",
            -            "petType": "Cat",
            -            "color": "White",
            -            "gender": "male",
            -            "breed": "Persian"
            -          }
            -      },
            -      "dog": {
            -        "summary": "An example of a dog with a cat's name",
            -        "value" :  {
            -          "name": "Puma",
            -          "petType": "Dog",
            -          "color": "Black",
            -          "gender": "Female",
            -          "breed": "Mixed"
            -        },
            -      "frog": {
            -          "$ref": "#/components/examples/frog-example"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -application/json:
            -  schema:
            -    $ref: "#/components/schemas/Pet"
            -  examples:
            -    cat:
            -      summary: An example of a cat
            -      value:
            -        name: Fluffy
            -        petType: Cat
            -        color: White
            -        gender: male
            -        breed: Persian
            -    dog:
            -      summary: An example of a dog with a cat's name
            -      value:
            -        name: Puma
            -        petType: Dog
            -        color: Black
            -        gender: Female
            -        breed: Mixed
            -    frog:
            -      $ref: "#/components/examples/frog-example"
            -
            -

            Considerations for File Uploads

            -

            In contrast with the 2.0 specification, file input/output content in OpenAPI is described with the same semantics as any other schema type.

            -

            In contrast with the 3.0 specification, the format keyword has no effect on the content-encoding of the schema. JSON Schema offers a contentEncoding keyword, which may be used to specify the Content-Encoding for the schema. The contentEncoding keyword supports all encodings defined in [[!RFC4648]], including “base64” and “base64url”, as well as “quoted-printable” from [[!RFC2045]]. The encoding specified by the contentEncoding keyword is independent of an encoding specified by the Content-Type header in the request or response or metadata of a multipart body – when both are present, the encoding specified in the contentEncoding is applied first and then the encoding specified in the Content-Type header.

            -

            JSON Schema also offers a contentMediaType keyword. However, when the media type is already specified by the Media Type Object’s key, or by the contentType field of an Encoding Object, the contentMediaType keyword SHALL be ignored if present.

            -

            Examples:

            -

            Content transferred in binary (octet-stream) MAY omit schema:

            -
            
            -# a PNG image as a binary file:
            -content:
            -    image/png: {}
            -
            -
            
            -# an arbitrary binary file:
            -content:
            -    application/octet-stream: {}
            -
            -

            Binary content transferred with base64 encoding:

            -
            
            -content:
            -    image/png:
            -        schema:
            -            type: string
            -            contentMediaType: image/png
            -            contentEncoding: base64
            -
            -

            Note that the Content-Type remains image/png, describing the semantics of the payload. The JSON Schema type and contentEncoding fields explain that the payload is transferred as text. The JSON Schema contentMediaType is technically redundant, but can be used by JSON Schema tools that may not be aware of the OpenAPI context.

            -

            These examples apply to either input payloads of file uploads or response payloads.

            -

            A requestBody for submitting a file in a POST operation may look like the following example:

            -
            
            -requestBody:
            -  content:
            -    application/octet-stream: {}
            -
            -

            In addition, specific media types MAY be specified:

            -
            
            -# multiple, specific media types may be specified:
            -requestBody:
            -  content:
            -    # a binary file of type png or jpeg
            -    image/jpeg: {}
            -    image/png: {}
            -
            -

            To upload multiple files, a multipart media type MUST be used:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        properties:
            -          # The property name 'file' will be used for all files.
            -          file:
            -            type: array
            -            items: {}
            -
            -

            As seen in the section on multipart/form-data below, the empty schema for items indicates a media type of application/octet-stream.

            -

            Support for x-www-form-urlencoded Request Bodies

            -

            To submit content using form url encoding via [[!RFC1866]], the following -definition may be used:

            -
            
            -requestBody:
            -  content:
            -    application/x-www-form-urlencoded:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # complex types are stringified to support RFC 1866
            -            type: object
            -            properties: {}
            -
            -

            In this example, the contents in the requestBody MUST be stringified per [[!RFC1866]] when passed to the server. In addition, the address field complex object will be stringified.

            -

            When passing complex objects in the application/x-www-form-urlencoded content type, the default serialization strategy of such properties is described in the Encoding Object’s style property as form.

            -

            Special Considerations for multipart Content

            -

            It is common to use multipart/form-data as a Content-Type when transferring request bodies to operations. In contrast to 2.0, a schema is REQUIRED to define the input parameters to the operation when using multipart content. This supports complex structures as well as supporting mechanisms for multiple file uploads.

            -

            In a multipart/form-data request body, each schema property, or each element of a schema array property, takes a section in the payload with an internal header as defined by [[!RFC7578]]. The serialization strategy for each property of a multipart/form-data request body can be specified in an associated Encoding Object.

            -

            When passing in multipart types, boundaries MAY be used to separate sections of the content being transferred – thus, the following default Content-Types are defined for multipart:

            -
              -
            • If the property is a primitive, or an array of primitive values, the default Content-Type is text/plain
            • -
            • If the property is complex, or an array of complex values, the default Content-Type is application/json
            • -
            • If the property is a type: string with a contentEncoding, the default Content-Type is application/octet-stream
            • -
            -

            Per the JSON Schema specification, contentMediaType without contentEncoding present is treated as if contentEncoding: identity were present. While useful for embedding text documents such as text/html into JSON strings, it is not useful for a multipart/form-data part, as it just causes the document to be treated as text/plain instead of its actual media type. Use the Encoding Object without contentMediaType if no contentEncoding is required.

            -

            Examples:

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            type: string
            -            format: uuid
            -          address:
            -            # default Content-Type for objects is `application/json`
            -            type: object
            -            properties: {}
            -          profileImage:
            -            # Content-Type for application-level encoded resource is `text/plain`
            -            type: string
            -            contentMediaType: image/png
            -            contentEncoding: base64
            -          children:
            -            # default Content-Type for arrays is based on the _inner_ type (`text/plain` here)
            -            type: array
            -            items:
            -              type: string
            -          addresses:
            -            # default Content-Type for arrays is based on the _inner_ type (object shown, so `application/json` in this example)
            -            type: array
            -            items:
            -              type: object
            -              $ref: '#/components/schemas/Address'
            -
            -

            An encoding attribute is introduced to give you control over the serialization of parts of multipart request bodies. This attribute is only applicable to multipart and application/x-www-form-urlencoded request bodies.

            -

            Encoding Object

            -

            A single encoding definition applied to a single schema property.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            contentTypestringThe Content-Type for encoding a specific property. Default value depends on the property type: for object - application/json; for array – the default is defined based on the inner type; for all other cases the default is application/octet-stream. The value can be a specific media type (e.g. application/json), a wildcard media type (e.g. image/*), or a comma-separated list of the two types.
            headersMap[string, Header Object | Reference Object]A map allowing additional information to be provided as headers, for example Content-Disposition. Content-Type is described separately and SHALL be ignored in this section. This property SHALL be ignored if the request body media type is not a multipart.
            stylestringDescribes how a specific property value will be serialized depending on its type. See Parameter Object for details on the style property. The behavior follows the same values as query parameters, including default values. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
            explodebooleanWhen this is true, property values of type array or object generate separate parameters for each value of the array, or key-value-pair of the map. For other types of properties this property has no effect. When style is form, the default value is true. For all other styles, the default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
            allowReservedbooleanDetermines whether the parameter value SHOULD allow reserved characters, as defined by [[!RFC3986]] :/?#[]@!$&'()*+,;= to be included without percent-encoding. The default value is false. This property SHALL be ignored if the request body media type is not application/x-www-form-urlencoded or multipart/form-data. If a value is explicitly defined, then the value of contentType (implicit or explicit) SHALL be ignored.
            -

            This object MAY be extended with Specification Extensions.

            -

            Encoding Object Example

            -
            
            -requestBody:
            -  content:
            -    multipart/form-data:
            -      schema:
            -        type: object
            -        properties:
            -          id:
            -            # default is text/plain
            -            type: string
            -            format: uuid
            -          address:
            -            # default is application/json
            -            type: object
            -            properties: {}
            -          historyMetadata:
            -            # need to declare XML format!
            -            description: metadata in XML format
            -            type: object
            -            properties: {}
            -          profileImage: {}
            -      encoding:
            -        historyMetadata:
            -          # require XML Content-Type in utf-8 encoding
            -          contentType: application/xml; charset=utf-8
            -        profileImage:
            -          # only accept png/jpeg
            -          contentType: image/png, image/jpeg
            -          headers:
            -            X-Rate-Limit-Limit:
            -              description: The number of allowed requests in the current period
            -              schema:
            -                type: integer
            -
            -

            Responses Object

            -

            A container for the expected responses of an operation. -The container maps a HTTP response code to the expected response.

            -

            The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance. -However, documentation is expected to cover a successful operation response and any known errors.

            -

            The default MAY be used as a default response object for all HTTP codes -that are not covered individually by the Responses Object.

            -

            The Responses Object MUST contain at least one response code, and if only one -response code is provided it SHOULD be the response for a successful operation -call.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            defaultResponse Object | Reference ObjectThe documentation of responses other than the ones declared for specific HTTP response codes. Use this field to cover undeclared responses.
            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            HTTP Status CodeResponse Object | Reference ObjectAny HTTP status code can be used as the property name, but only one property per code, to describe the expected response for that HTTP status code. This field MUST be enclosed in quotation marks (for example, “200”) for compatibility between JSON and YAML. To define a range of response codes, this field MAY contain the uppercase wildcard character X. For example, 2XX represents all response codes between [200-299]. Only the following range definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response is defined using an explicit code, the explicit code definition takes precedence over the range definition for that code.
            -

            This object MAY be extended with Specification Extensions.

            -

            Responses Object Example

            -

            A 200 response for a successful operation and a default response for others (implying an error):

            -
            
            -{
            -  "200": {
            -    "description": "a pet to be returned",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/Pet"
            -        }
            -      }
            -    }
            -  },
            -  "default": {
            -    "description": "Unexpected error",
            -    "content": {
            -      "application/json": {
            -        "schema": {
            -          "$ref": "#/components/schemas/ErrorModel"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -'200':
            -  description: a pet to be returned
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/Pet'
            -default:
            -  description: Unexpected error
            -  content:
            -    application/json:
            -      schema:
            -        $ref: '#/components/schemas/ErrorModel'
            -
            -

            Response Object

            -

            Describes a single response from an API Operation, including design-time, static -links to operations based on the response.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            descriptionstringREQUIRED. A description of the response. CommonMark syntax MAY be used for rich text representation.
            headersMap[string, Header Object | Reference Object]Maps a header name to its definition. [[!RFC7230]] states header names are case insensitive. If a response header is defined with the name "Content-Type", it SHALL be ignored.
            contentMap[string, Media Type Object]A map containing descriptions of potential response payloads. The key is a media type or media type range and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*
            linksMap[string, Link Object | Reference Object]A map of operations links that can be followed from the response. The key of the map is a short name for the link, following the naming constraints of the names for Component Objects.
            -

            This object MAY be extended with Specification Extensions.

            -

            Response Object Examples

            -

            Response of an array of a complex type:

            -
            
            -{
            -  "description": "A complex object array response",
            -  "content": {
            -    "application/json": {
            -      "schema": {
            -        "type": "array",
            -        "items": {
            -          "$ref": "#/components/schemas/VeryComplexType"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A complex object array response
            -content:
            -  application/json:
            -    schema:
            -      type: array
            -      items:
            -        $ref: '#/components/schemas/VeryComplexType'
            -
            -

            Response with a string type:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string"
            -      }
            -    }
            -  }
            -
            -}
            -
            -
            
            -description: A simple string response
            -content:
            -  text/plain:
            -    schema:
            -      type: string
            -
            -

            Plain text response with headers:

            -
            
            -{
            -  "description": "A simple string response",
            -  "content": {
            -    "text/plain": {
            -      "schema": {
            -        "type": "string",
            -        "example": "whoa!"
            -      }
            -    }
            -  },
            -  "headers": {
            -    "X-Rate-Limit-Limit": {
            -      "description": "The number of allowed requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Remaining": {
            -      "description": "The number of remaining requests in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    },
            -    "X-Rate-Limit-Reset": {
            -      "description": "The number of seconds left in the current period",
            -      "schema": {
            -        "type": "integer"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -description: A simple string response
            -content:
            -  text/plain:
            -    schema:
            -      type: string
            -    example: 'whoa!'
            -headers:
            -  X-Rate-Limit-Limit:
            -    description: The number of allowed requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Remaining:
            -    description: The number of remaining requests in the current period
            -    schema:
            -      type: integer
            -  X-Rate-Limit-Reset:
            -    description: The number of seconds left in the current period
            -    schema:
            -      type: integer
            -
            -

            Response with no return value:

            -
            
            -{
            -  "description": "object created"
            -}
            -
            -
            
            -description: object created
            -
            -

            Callback Object

            -

            A map of possible out-of band callbacks related to the parent operation. -Each value in the map is a Path Item Object that describes a set of requests that may be initiated by the API provider and the expected responses. -The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.

            -

            To describe incoming requests from the API provider independent from another API call, use the webhooks field.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {expression}Path Item Object | Reference ObjectA Path Item Object, or a reference to one, used to define a callback request and expected responses. A complete example is available.
            -

            This object MAY be extended with Specification Extensions.

            -

            Key Expression

            -

            The key that identifies the Path Item Object is a runtime expression that can be evaluated in the context of a runtime HTTP request/response to identify the URL to be used for the callback request. -A simple example might be $request.body#/url. -However, using a runtime expression the complete HTTP message can be accessed. -This includes accessing any part of a body that a JSON Pointer [[!RFC6901]] can reference.

            -

            For example, given the following HTTP request:

            -
            
            -POST /subscribe/myevent?queryUrl=https://clientdomain.com/stillrunning HTTP/1.1
            -Host: example.org
            -Content-Type: application/json
            -Content-Length: 187
            -
            -{
            -  "failedUrl" : "https://clientdomain.com/failed",
            -  "successUrls" : [
            -    "https://clientdomain.com/fast",
            -    "https://clientdomain.com/medium",
            -    "https://clientdomain.com/slow"
            -  ]
            -}
            -
            -201 Created
            -Location: https://example.org/subscription/1
            -
            -

            The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named eventType and a query parameter named queryUrl.

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            ExpressionValue
            $urlhttps://example.org/subscribe/myevent?queryUrl=https://clientdomain.com/stillrunning
            $methodPOST
            $request.path.eventTypemyevent
            $request.query.queryUrlhttps://clientdomain.com/stillrunning
            $request.header.content-Typeapplication/json
            $request.body#/failedUrlhttps://clientdomain.com/failed
            $request.body#/successUrls/2https://clientdomain.com/medium
            $response.header.Locationhttps://example.org/subscription/1
            -

            Callback Object Examples

            -

            The following example uses the user provided queryUrl query string parameter to define the callback URL. This is an example of how to use a callback object to describe a WebHook callback that goes with the subscription operation to enable registering for the WebHook.

            -
            
            -myCallback:
            -  '{$request.query.queryUrl}':
            -    post:
            -      requestBody:
            -        description: Callback payload
            -        content:
            -          'application/json':
            -            schema:
            -              $ref: '#/components/schemas/SomePayload'
            -      responses:
            -        '200':
            -          description: callback successfully processed
            -
            -

            The following example shows a callback where the server is hard-coded, but the query string parameters are populated from the id and email property in the request body.

            -
            
            -transactionCallback:
            -  'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
            -    post:
            -      requestBody:
            -        description: Callback payload
            -        content:
            -          'application/json':
            -            schema:
            -              $ref: '#/components/schemas/SomePayload'
            -      responses:
            -        '200':
            -          description: callback successfully processed
            -
            -

            Example Object

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            summarystringShort description for the example.
            descriptionstringLong description for the example. CommonMark syntax MAY be used for rich text representation.
            valueAnyEmbedded literal example. The value field and externalValue field are mutually exclusive. To represent examples of media types that cannot naturally represented in JSON or YAML, use a string value to contain the example, escaping where necessary.
            externalValuestringA URI that points to the literal example. This provides the capability to reference examples that cannot easily be included in JSON or YAML documents. The value field and externalValue field are mutually exclusive. See the rules for resolving Relative References.
            -

            This object MAY be extended with Specification Extensions.

            -

            In all cases, the example value is expected to be compatible with the type schema -of its associated value. Tooling implementations MAY choose to -validate compatibility automatically, and reject the example value(s) if incompatible.

            -

            Example Object Examples

            -

            In a request body:

            -
            
            -requestBody:
            -  content:
            -    'application/json':
            -      schema:
            -        $ref: '#/components/schemas/Address'
            -      examples:
            -        foo:
            -          summary: A foo example
            -          value: {"foo": "bar"}
            -        bar:
            -          summary: A bar example
            -          value: {"bar": "baz"}
            -    'application/xml':
            -      examples:
            -        xmlExample:
            -          summary: This is an example in XML
            -          externalValue: 'https://example.org/examples/address-example.xml'
            -    'text/plain':
            -      examples:
            -        textExample:
            -          summary: This is a text example
            -          externalValue: 'https://foo.bar/examples/address-example.txt'
            -
            -

            In a parameter:

            -
            
            -parameters:
            -  - name: 'zipCode'
            -    in: 'query'
            -    schema:
            -      type: 'string'
            -      format: 'zip-code'
            -    examples:
            -      zip-example:
            -        $ref: '#/components/examples/zip-example'
            -
            -

            In a response:

            -
            
            -responses:
            -  '200':
            -    description: your car appointment has been booked
            -    content:
            -      application/json:
            -        schema:
            -          $ref: '#/components/schemas/SuccessResponse'
            -        examples:
            -          confirmation-success:
            -            $ref: '#/components/examples/confirmation-success'
            -
            -

            Link Object

            -

            The Link object represents a possible design-time link for a response. -The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.

            -

            Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.

            -

            For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            operationRefstringA relative or absolute URI reference to an OAS operation. This field is mutually exclusive of the operationId field, and MUST point to an Operation Object. Relative operationRef values MAY be used to locate an existing Operation Object in the OpenAPI definition. See the rules for resolving Relative References.
            operationIdstringThe name of an existing, resolvable OAS operation, as defined with a unique operationId. This field is mutually exclusive of the operationRef field.
            parametersMap[string, Any | {expression}]A map representing parameters to pass to an operation as specified with operationId or identified via operationRef. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation. The parameter name can be qualified using the parameter location [{in}.]{name} for operations that use the same parameter name in different locations (e.g. path.id).
            requestBodyAny | {expression}A literal value or {expression} to use as a request body when calling the target operation.
            descriptionstringA description of the link. CommonMark syntax MAY be used for rich text representation.
            serverServer ObjectA server object to be used by the target operation.
            -

            This object MAY be extended with Specification Extensions.

            -

            A linked operation MUST be identified using either an operationRef or operationId. -In the case of an operationId, it MUST be unique and resolved in the scope of the OAS document. -Because of the potential for name clashes, the operationRef syntax is preferred -for OpenAPI documents with external references.

            -

            Examples

            -

            Computing a link from a request operation where the $request.path.id is used to pass a request parameter to the linked operation.

            -
            
            -paths:
            -  /users/{id}:
            -    parameters:
            -    - name: id
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -    get:
            -      responses:
            -        '200':
            -          description: the user being returned
            -          content:
            -            application/json:
            -              schema:
            -                type: object
            -                properties:
            -                  uuid: # the unique user id
            -                    type: string
            -                    format: uuid
            -          links:
            -            address:
            -              # the target link operationId
            -              operationId: getUserAddress
            -              parameters:
            -                # get the `id` field from the request path parameter named `id`
            -                userId: $request.path.id
            -  # the path item of the linked operation
            -  /users/{userid}/address:
            -    parameters:
            -    - name: userid
            -      in: path
            -      required: true
            -      description: the user identifier, as userId
            -      schema:
            -        type: string
            -    # linked operation
            -    get:
            -      operationId: getUserAddress
            -      responses:
            -        '200':
            -          description: the user's address
            -
            -

            When a runtime expression fails to evaluate, no parameter value is passed to the target operation.

            -

            Values from the response body can be used to drive a linked operation.

            -
            
            -links:
            -  address:
            -    operationId: getUserAddressByUUID
            -    parameters:
            -      # get the `uuid` field from the `uuid` field in the response body
            -      userUuid: $response.body#/uuid
            -
            -

            Clients follow all links at their discretion. -Neither permissions, nor the capability to make a successful call to that link, is guaranteed -solely by the existence of a relationship.

            -

            OperationRef Examples

            -

            As references to operationId MAY NOT be possible (the operationId is an optional -field in an Operation Object), references MAY also be made through a relative operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            or an absolute operationRef:

            -
            
            -links:
            -  UserRepositories:
            -    # returns array of '#/components/schemas/repository'
            -    operationRef: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get'
            -    parameters:
            -      username: $response.body#/username
            -
            -

            Note that in the use of operationRef, the escaped forward-slash is necessary when -using JSON references.

            -

            Runtime Expressions

            -

            Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. -This mechanism is used by Link Objects and Callback Objects.

            -

            The runtime expression is defined by the following ABNF syntax

            -
            
            -      expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
            -      source = ( header-reference / query-reference / path-reference / body-reference )
            -      header-reference = "header." token
            -      query-reference = "query." name 
            -      path-reference = "path." name
            -      body-reference = "body" ["#" json-pointer ]
            -      json-pointer    = *( "/" reference-token )
            -      reference-token = *( unescaped / escaped )
            -      unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
            -         ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
            -      escaped         = "~" ( "0" / "1" )
            -        ; representing '~' and '/', respectively
            -      name = *( CHAR )
            -      token = 1*tchar
            -      tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
            -        "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
            -
            -

            Here, json-pointer is taken from [[!RFC6901]], char from [[!RFC7159]] and token from [[!RFC7230]].

            -

            The name identifier is case-sensitive, whereas token is not.

            -

            The table below provides examples of runtime expressions and examples of their use in a value:

            -

            Examples

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Source Locationexample expressionnotes
            HTTP Method$methodThe allowable values for the $method will be those for the HTTP operation.
            Requested media type$request.header.accept
            Request parameter$request.path.idRequest parameters MUST be declared in the parameters section of the parent operation or they cannot be evaluated. This includes request headers.
            Request body property$request.body#/user/uuidIn operations which accept payloads, references may be made to portions of the requestBody or the entire body.
            Request URL$url
            Response value$response.body#/statusIn operations which return payloads, references may be made to portions of the response body or the entire body.
            Response header$response.header.ServerSingle header values only are available
            -

            Runtime expressions preserve the type of the referenced value. -Expressions can be embedded into string values by surrounding the expression with {} curly braces.

            -

            Header Object

            -

            The Header Object follows the structure of the Parameter Object with the following changes:

            -
              -
            1. name MUST NOT be specified, it is given in the corresponding headers map.
            2. -
            3. in MUST NOT be specified, it is implicitly in header.
            4. -
            5. All traits that are affected by the location MUST be applicable to a location of header (for example, style).
            6. -
            -

            Header Object Example

            -

            A simple header of type integer:

            -
            
            -{
            -  "description": "The number of allowed requests in the current period",
            -  "schema": {
            -    "type": "integer"
            -  }
            -}
            -
            -
            
            -description: The number of allowed requests in the current period
            -schema:
            -  type: integer
            -
            -

            Tag Object

            -

            Adds metadata to a single tag that is used by the Operation Object. -It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringREQUIRED. The name of the tag.
            descriptionstringA description for the tag. CommonMark syntax MAY be used for rich text representation.
            externalDocsExternal Documentation ObjectAdditional external documentation for this tag.
            -

            This object MAY be extended with Specification Extensions.

            -

            Tag Object Example

            -
            
            -{
            -	"name": "pet",
            -	"description": "Pets operations"
            -}
            -
            -
            
            -name: pet
            -description: Pets operations
            -
            -

            Reference Object

            -

            A simple object to allow referencing other components in the OpenAPI document, internally and externally.

            -

            The $ref string value contains a URI [[!RFC3986]], which identifies the location of the value being referenced.

            -

            See the rules for resolving Relative References.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            $refstringREQUIRED. The reference identifier. This MUST be in the form of a URI.
            summarystringA short summary which by default SHOULD override that of the referenced component. If the referenced object-type does not allow a summary field, then this field has no effect.
            descriptionstringA description which by default SHOULD override that of the referenced component. CommonMark syntax MAY be used for rich text representation. If the referenced object-type does not allow a description field, then this field has no effect.
            -

            This object cannot be extended with additional properties and any properties added SHALL be ignored.

            -

            Note that this restriction on additional properties is a difference between Reference Objects and Schema Objects that contain a $ref keyword.

            -

            Reference Object Example

            -
            
            -{
            -	"$ref": "#/components/schemas/Pet"
            -}
            -
            -
            
            -$ref: '#/components/schemas/Pet'
            -
            -

            Relative Schema Document Example

            -
            
            -{
            -  "$ref": "Pet.json"
            -}
            -
            -
            
            -$ref: Pet.yaml
            -
            -

            Relative Documents With Embedded Schema Example

            -
            
            -{
            -  "$ref": "definitions.json#/Pet"
            -}
            -
            -
            
            -$ref: definitions.yaml#/Pet
            -
            -

            Schema Object

            -

            The Schema Object allows the definition of input and output data types. -These types can be objects, but also primitives and arrays. This object is a superset of the JSON Schema Specification Draft 2020-12.

            -

            For more information about the properties, see JSON Schema Core and JSON Schema Validation.

            -

            Unless stated otherwise, the property definitions follow those of JSON Schema and do not add any additional semantics. -Where JSON Schema indicates that behavior is defined by the application (e.g. for annotations), OAS also defers the definition of semantics to the application consuming the OpenAPI document.

            -

            Properties

            -

            The OpenAPI Schema Object dialect is defined as requiring the OAS base vocabulary, in addition to the vocabularies as specified in the JSON Schema draft 2020-12 general purpose meta-schema.

            -

            The OpenAPI Schema Object dialect for this version of the specification is identified by the URI https://spec.openapis.org/oas/3.1/dialect/base (the “OAS dialect schema id”).

            -

            The following properties are taken from the JSON Schema specification but their definitions have been extended by the OAS:

            -
              -
            • description - CommonMark syntax MAY be used for rich text representation.
            • -
            • format - See Data Type Formats for further details. While relying on JSON Schema’s defined formats, the OAS offers a few additional predefined formats.
            • -
            -

            In addition to the JSON Schema properties comprising the OAS dialect, the Schema Object supports keywords from any other vocabularies, or entirely arbitrary properties.

            -

            The OpenAPI Specification’s base vocabulary is comprised of the following keywords:

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            discriminatorDiscriminator ObjectAdds support for polymorphism. The discriminator is an object name that is used to differentiate between other schemas which may satisfy the payload description. See Composition and Inheritance for more details.
            xmlXML ObjectThis MAY be used only on properties schemas. It has no effect on root schemas. Adds additional metadata to describe the XML representation of this property.
            externalDocsExternal Documentation ObjectAdditional external documentation for this schema.
            exampleAnyA free-form property to include an example of an instance for this schema. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.

            Deprecated: The example property has been deprecated in favor of the JSON Schema examples keyword. Use of example is discouraged, and later versions of this specification may remove it.
            -

            This object MAY be extended with Specification Extensions, though as noted, additional properties MAY omit the x- prefix within this object.

            -
            Composition and Inheritance (Polymorphism)
            -

            The OpenAPI Specification allows combining and extending model definitions using the allOf property of JSON Schema, in effect offering model composition. -allOf takes an array of object definitions that are validated independently but together compose a single object.

            -

            While composition offers model extensibility, it does not imply a hierarchy between the models. -To support polymorphism, the OpenAPI Specification adds the discriminator field. -When used, the discriminator will be the name of the property that decides which schema definition validates the structure of the model. -As such, the discriminator field MUST be a required field. -There are two ways to define the value of a discriminator for an inheriting instance.

            -
              -
            • Use the schema name.
            • -
            • Override the schema name by overriding the property with a new value. If a new value exists, this takes precedence over the schema name. -As such, inline schema definitions, which do not have a given id, cannot be used in polymorphism.
            • -
            -
            XML Modeling
            -

            The xml property allows extra definitions when translating the JSON definition to XML. -The XML Object contains additional information about the available options.

            -
            Specifying Schema Dialects
            -

            It is important for tooling to be able to determine which dialect or meta-schema any given resource wishes to be processed with: JSON Schema Core, JSON Schema Validation, OpenAPI Schema dialect, or some custom meta-schema.

            -

            The $schema keyword MAY be present in any root Schema Object, and if present MUST be used to determine which dialect should be used when processing the schema. This allows use of Schema Objects which comply with other drafts of JSON Schema than the default Draft 2020-12 support. Tooling MUST support the OAS dialect schema id, and MAY support additional values of $schema.

            -

            To allow use of a different default $schema value for all Schema Objects contained within an OAS document, a jsonSchemaDialect value may be set within the OpenAPI Object. If this default is not set, then the OAS dialect schema id MUST be used for these Schema Objects. The value of $schema within a Schema Object always overrides any default.

            -

            When a Schema Object is referenced from an external resource which is not an OAS document (e.g. a bare JSON Schema resource), then the value of the $schema keyword for schemas within that resource MUST follow JSON Schema rules.

            -

            Schema Object Examples

            -
            Primitive Sample
            -
            
            -{
            -  "type": "string",
            -  "format": "email"
            -}
            -
            -
            
            -type: string
            -format: email
            -
            -
            Simple Model
            -
            
            -{
            -  "type": "object",
            -  "required": [
            -    "name"
            -  ],
            -  "properties": {
            -    "name": {
            -      "type": "string"
            -    },
            -    "address": {
            -      "$ref": "#/components/schemas/Address"
            -    },
            -    "age": {
            -      "type": "integer",
            -      "format": "int32",
            -      "minimum": 0
            -    }
            -  }
            -}
            -
            -
            
            -type: object
            -required:
            -- name
            -properties:
            -  name:
            -    type: string
            -  address:
            -    $ref: '#/components/schemas/Address'
            -  age:
            -    type: integer
            -    format: int32
            -    minimum: 0
            -
            -
            Model with Map/Dictionary Properties
            -

            For a simple string to string mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "type": "string"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  type: string
            -
            -

            For a string to model mapping:

            -
            
            -{
            -  "type": "object",
            -  "additionalProperties": {
            -    "$ref": "#/components/schemas/ComplexModel"
            -  }
            -}
            -
            -
            
            -type: object
            -additionalProperties:
            -  $ref: '#/components/schemas/ComplexModel'
            -
            -
            Model with Example
            -
            
            -{
            -  "type": "object",
            -  "properties": {
            -    "id": {
            -      "type": "integer",
            -      "format": "int64"
            -    },
            -    "name": {
            -      "type": "string"
            -    }
            -  },
            -  "required": [
            -    "name"
            -  ],
            -  "example": {
            -    "name": "Puma",
            -    "id": 1
            -  }
            -}
            -
            -
            
            -type: object
            -properties:
            -  id:
            -    type: integer
            -    format: int64
            -  name:
            -    type: string
            -required:
            -- name
            -example:
            -  name: Puma
            -  id: 1
            -
            -
            Models with Composition
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "ErrorModel": {
            -        "type": "object",
            -        "required": [
            -          "message",
            -          "code"
            -        ],
            -        "properties": {
            -          "message": {
            -            "type": "string"
            -          },
            -          "code": {
            -            "type": "integer",
            -            "minimum": 100,
            -            "maximum": 600
            -          }
            -        }
            -      },
            -      "ExtendedErrorModel": {
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/ErrorModel"
            -          },
            -          {
            -            "type": "object",
            -            "required": [
            -              "rootCause"
            -            ],
            -            "properties": {
            -              "rootCause": {
            -                "type": "string"
            -              }
            -            }
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    ErrorModel:
            -      type: object
            -      required:
            -      - message
            -      - code
            -      properties:
            -        message:
            -          type: string
            -        code:
            -          type: integer
            -          minimum: 100
            -          maximum: 600
            -    ExtendedErrorModel:
            -      allOf:
            -      - $ref: '#/components/schemas/ErrorModel'
            -      - type: object
            -        required:
            -        - rootCause
            -        properties:
            -          rootCause:
            -            type: string
            -
            -
            Models with Polymorphism Support
            -
            
            -{
            -  "components": {
            -    "schemas": {
            -      "Pet": {
            -        "type": "object",
            -        "discriminator": {
            -          "propertyName": "petType"
            -        },
            -        "properties": {
            -          "name": {
            -            "type": "string"
            -          },
            -          "petType": {
            -            "type": "string"
            -          }
            -        },
            -        "required": [
            -          "name",
            -          "petType"
            -        ]
            -      },
            -      "Cat": {
            -        "description": "A representation of a cat. Note that `Cat` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "huntingSkill": {
            -                "type": "string",
            -                "description": "The measured skill for hunting",
            -                "default": "lazy",
            -                "enum": [
            -                  "clueless",
            -                  "lazy",
            -                  "adventurous",
            -                  "aggressive"
            -                ]
            -              }
            -            },
            -            "required": [
            -              "huntingSkill"
            -            ]
            -          }
            -        ]
            -      },
            -      "Dog": {
            -        "description": "A representation of a dog. Note that `Dog` will be used as the discriminator value.",
            -        "allOf": [
            -          {
            -            "$ref": "#/components/schemas/Pet"
            -          },
            -          {
            -            "type": "object",
            -            "properties": {
            -              "packSize": {
            -                "type": "integer",
            -                "format": "int32",
            -                "description": "the size of the pack the dog is from",
            -                "default": 0,
            -                "minimum": 0
            -              }
            -            },
            -            "required": [
            -              "packSize"
            -            ]
            -          }
            -        ]
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      discriminator:
            -        propertyName: petType
            -      properties:
            -        name:
            -          type: string
            -        petType:
            -          type: string
            -      required:
            -      - name
            -      - petType
            -    Cat:  ## "Cat" will be used as the discriminator value
            -      description: A representation of a cat
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          huntingSkill:
            -            type: string
            -            description: The measured skill for hunting
            -            enum:
            -            - clueless
            -            - lazy
            -            - adventurous
            -            - aggressive
            -        required:
            -        - huntingSkill
            -    Dog:  ## "Dog" will be used as the discriminator value
            -      description: A representation of a dog
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        properties:
            -          packSize:
            -            type: integer
            -            format: int32
            -            description: the size of the pack the dog is from
            -            default: 0
            -            minimum: 0
            -        required:
            -        - packSize
            -
            -

            Discriminator Object

            -

            When request bodies or response payloads may be one of a number of different schemas, a discriminator object can be used to aid in serialization, deserialization, and validation. The discriminator is a specific object in a schema which is used to inform the consumer of the document of an alternative schema based on the value associated with it.

            -

            When using the discriminator, inline schemas will not be considered.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            propertyNamestringREQUIRED. The name of the property in the payload that will hold the discriminator value.
            mappingMap[string, string]An object to hold mappings between payload values and schema names or references.
            -

            This object MAY be extended with Specification Extensions.

            -

            The discriminator object is legal only when using one of the composite keywords oneOf, anyOf, allOf.

            -

            In OAS 3.0, a response payload MAY be described to be exactly one of any number of types:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -
            -

            which means the payload MUST, by validation, match exactly one of the schemas described by Cat, Dog, or Lizard. In this case, a discriminator MAY act as a “hint” to shortcut validation and selection of the matching schema which may be a costly operation, depending on the complexity of the schema. We can then describe exactly which field tells us which schema to use:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  discriminator:
            -    propertyName: petType
            -
            -

            The expectation now is that a property with name petType MUST be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document. Thus the response payload:

            -
            
            -{
            -  "id": 12345,
            -  "petType": "Cat"
            -}
            -
            -

            Will indicate that the Cat schema be used in conjunction with this payload.

            -

            In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional mapping definition MAY be used:

            -
            
            -MyResponseType:
            -  oneOf:
            -  - $ref: '#/components/schemas/Cat'
            -  - $ref: '#/components/schemas/Dog'
            -  - $ref: '#/components/schemas/Lizard'
            -  - $ref: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -  discriminator:
            -    propertyName: petType
            -    mapping:
            -      dog: '#/components/schemas/Dog'
            -      monster: 'https://gigantic-server.com/schemas/Monster/schema.json'
            -
            -

            Here the discriminator value of dog will map to the schema #/components/schemas/Dog, rather than the default (implicit) value of Dog. If the discriminator value does not match an implicit or explicit mapping, no schema can be determined and validation SHOULD fail. Mapping keys MUST be string values, but tooling MAY convert response values to strings for comparison.

            -

            When used in conjunction with the anyOf construct, the use of the discriminator can avoid ambiguity where multiple schemas may satisfy a single payload.

            -

            In both the oneOf and anyOf use cases, all possible schemas MUST be listed explicitly. To avoid redundancy, the discriminator MAY be added to a parent schema definition, and all schemas comprising the parent schema in an allOf construct may be used as an alternate schema.

            -

            For example:

            -
            
            -components:
            -  schemas:
            -    Pet:
            -      type: object
            -      required:
            -      - petType
            -      properties:
            -        petType:
            -          type: string
            -      discriminator:
            -        propertyName: petType
            -        mapping:
            -          dog: Dog
            -    Cat:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Cat`
            -        properties:
            -          name:
            -            type: string
            -    Dog:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Dog`
            -        properties:
            -          bark:
            -            type: string
            -    Lizard:
            -      allOf:
            -      - $ref: '#/components/schemas/Pet'
            -      - type: object
            -        # all other properties specific to a `Lizard`
            -        properties:
            -          lovesRocks:
            -            type: boolean
            -
            -

            a payload like this:

            -
            
            -{
            -  "petType": "Cat",
            -  "name": "misty"
            -}
            -
            -

            will indicate that the Cat schema be used. Likewise this schema:

            -
            
            -{
            -  "petType": "dog",
            -  "bark": "soft"
            -}
            -
            -

            will map to Dog because of the definition in the mapping element.

            -

            XML Object

            -

            A metadata object that allows for more fine-tuned XML model definitions.

            -

            When using arrays, XML element names are not inferred (for singular/plural forms) and the name property SHOULD be used to add that information. -See examples for expected behavior.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            namestringReplaces the name of the element/attribute used for the described schema property. When defined within items, it will affect the name of the individual XML elements within the list. When defined alongside type being array (outside the items), it will affect the wrapping element and only if wrapped is true. If wrapped is false, it will be ignored.
            namespacestringThe URI of the namespace definition. This MUST be in the form of an absolute URI.
            prefixstringThe prefix to be used for the name.
            attributebooleanDeclares whether the property definition translates to an attribute instead of an element. Default value is false.
            wrappedbooleanMAY be used only for an array definition. Signifies whether the array is wrapped (for example, <books><book/><book/></books>) or unwrapped (<book/><book/>). Default value is false. The definition takes effect only when defined alongside type being array (outside the items).
            -

            This object MAY be extended with Specification Extensions.

            -

            XML Object Examples

            -

            The examples of the XML object definitions are included inside a property definition of a Schema Object with a sample of the XML representation of it.

            -
            No XML Element
            -

            Basic string property:

            -
            
            -{
            -    "animals": {
            -        "type": "string"
            -    }
            -}
            -
            -
            
            -animals:
            -  type: string
            -
            -
            
            -<animals>...</animals>
            -
            -

            Basic string array property (wrapped is false by default):

            -
            
            -{
            -    "animals": {
            -        "type": "array",
            -        "items": {
            -            "type": "string"
            -        }
            -    }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -
            -
            
            -<animals>...</animals>
            -<animals>...</animals>
            -<animals>...</animals>
            -
            -
            XML Name Replacement
            -
            
            -{
            -  "animals": {
            -    "type": "string",
            -    "xml": {
            -      "name": "animal"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: string
            -  xml:
            -    name: animal
            -
            -
            
            -<animal>...</animal>
            -
            -
            XML Attribute, Prefix and Namespace
            -

            In this example, a full model definition is shown.

            -
            
            -{
            -  "Person": {
            -    "type": "object",
            -    "properties": {
            -      "id": {
            -        "type": "integer",
            -        "format": "int32",
            -        "xml": {
            -          "attribute": true
            -        }
            -      },
            -      "name": {
            -        "type": "string",
            -        "xml": {
            -          "namespace": "https://example.com/schema/sample",
            -          "prefix": "sample"
            -        }
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -Person:
            -  type: object
            -  properties:
            -    id:
            -      type: integer
            -      format: int32
            -      xml:
            -        attribute: true
            -    name:
            -      type: string
            -      xml:
            -        namespace: https://example.com/schema/sample
            -        prefix: sample
            -
            -
            
            -<Person id="123">
            -    <sample:name xmlns:sample="https://example.com/schema/sample">example</sample:name>
            -</Person>
            -
            -
            XML Arrays
            -

            Changing the element names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            The external name property has no effect on the XML:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens"
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -
            -
            
            -<animal>value</animal>
            -<animal>value</animal>
            -
            -

            Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animals>value</animals>
            -  <animals>value</animals>
            -</animals>
            -
            -

            To overcome the naming problem in the example above, the following definition can be used:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    wrapped: true
            -
            -
            
            -<animals>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</animals>
            -
            -

            Affecting both internal and external names:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string",
            -      "xml": {
            -        "name": "animal"
            -      }
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -    xml:
            -      name: animal
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <animal>value</animal>
            -  <animal>value</animal>
            -</aliens>
            -
            -

            If we change the external element but not the internal ones:

            -
            
            -{
            -  "animals": {
            -    "type": "array",
            -    "items": {
            -      "type": "string"
            -    },
            -    "xml": {
            -      "name": "aliens",
            -      "wrapped": true
            -    }
            -  }
            -}
            -
            -
            
            -animals:
            -  type: array
            -  items:
            -    type: string
            -  xml:
            -    name: aliens
            -    wrapped: true
            -
            -
            
            -<aliens>
            -  <aliens>value</aliens>
            -  <aliens>value</aliens>
            -</aliens>
            -
            -

            Security Scheme Object

            -

            Defines a security scheme that can be used by the operations.

            -

            Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), mutual TLS (use of a client certificate), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and OpenID Connect Discovery. -Please note that as of 2020, the implicit flow is about to be deprecated by OAuth 2.0 Security Best Current Practice. Recommended for most use case is Authorization Code Grant flow with PKCE.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            typestringAnyREQUIRED. The type of the security scheme. Valid values are "apiKey", "http", "mutualTLS", "oauth2", "openIdConnect".
            descriptionstringAnyA description for security scheme. CommonMark syntax MAY be used for rich text representation.
            namestringapiKeyREQUIRED. The name of the header, query or cookie parameter to be used.
            instringapiKeyREQUIRED. The location of the API key. Valid values are "query", "header" or "cookie".
            schemestringhttpREQUIRED. The name of the HTTP Authorization scheme to be used in the Authorization header as defined in [[!RFC7235]]. The values used SHOULD be registered in the IANA Authentication Scheme registry.
            bearerFormatstringhttp ("bearer")A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated by an authorization server, so this information is primarily for documentation purposes.
            flowsOAuth Flows Objectoauth2REQUIRED. An object containing configuration information for the flow types supported.
            openIdConnectUrlstringopenIdConnectREQUIRED. OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL. The OpenID Connect standard requires the use of TLS.
            -

            This object MAY be extended with Specification Extensions.

            -

            Security Scheme Object Example

            -
            Basic Authentication Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "basic"
            -}
            -
            -
            
            -type: http
            -scheme: basic
            -
            -
            API Key Sample
            -
            
            -{
            -  "type": "apiKey",
            -  "name": "api_key",
            -  "in": "header"
            -}
            -
            -
            
            -type: apiKey
            -name: api_key
            -in: header
            -
            -
            JWT Bearer Sample
            -
            
            -{
            -  "type": "http",
            -  "scheme": "bearer",
            -  "bearerFormat": "JWT",
            -}
            -
            -
            
            -type: http
            -scheme: bearer
            -bearerFormat: JWT
            -
            -
            Implicit OAuth2 Sample
            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            OAuth Flows Object

            -

            Allows configuration of the supported OAuth Flows.

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeDescription
            implicitOAuth Flow ObjectConfiguration for the OAuth Implicit flow
            passwordOAuth Flow ObjectConfiguration for the OAuth Resource Owner Password flow
            clientCredentialsOAuth Flow ObjectConfiguration for the OAuth Client Credentials flow. Previously called application in OpenAPI 2.0.
            authorizationCodeOAuth Flow ObjectConfiguration for the OAuth Authorization Code flow. Previously called accessCode in OpenAPI 2.0.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object

            -

            Configuration details for a supported OAuth Flow

            -

            Fixed Fields

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            Field NameTypeApplies ToDescription
            authorizationUrlstringoauth2 ("implicit", "authorizationCode")REQUIRED. The authorization URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
            tokenUrlstringoauth2 ("password", "clientCredentials", "authorizationCode")REQUIRED. The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
            refreshUrlstringoauth2The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.
            scopesMap[string, string]oauth2REQUIRED. The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.
            -

            This object MAY be extended with Specification Extensions.

            -

            OAuth Flow Object Examples

            -
            
            -{
            -  "type": "oauth2",
            -  "flows": {
            -    "implicit": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    },
            -    "authorizationCode": {
            -      "authorizationUrl": "https://example.com/api/oauth/dialog",
            -      "tokenUrl": "https://example.com/api/oauth/token",
            -      "scopes": {
            -        "write:pets": "modify pets in your account",
            -        "read:pets": "read your pets"
            -      }
            -    }
            -  }
            -}
            -
            -
            
            -type: oauth2
            -flows:
            -  implicit:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -  authorizationCode:
            -    authorizationUrl: https://example.com/api/oauth/dialog
            -    tokenUrl: https://example.com/api/oauth/token
            -    scopes:
            -      write:pets: modify pets in your account
            -      read:pets: read your pets
            -
            -

            Security Requirement Object

            -

            Lists the required security schemes to execute this operation. -The name used for each property MUST correspond to a security scheme declared in the Security Schemes under the Components Object.

            -

            Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized. -This enables support for scenarios where multiple query parameters or HTTP headers are required to convey security information.

            -

            When a list of Security Requirement Objects is defined on the OpenAPI Object or Operation Object, only one of the Security Requirement Objects in the list needs to be satisfied to authorize the request.

            -

            Patterned Fields

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            {name}[string]Each name MUST correspond to a security scheme which is declared in the Security Schemes under the Components Object. If the security scheme is of type "oauth2" or "openIdConnect", then the value is a list of scope names required for the execution, and the list MAY be empty if authorization does not require a specified scope. For other security scheme types, the array MAY contain a list of role names which are required for the execution, but are not otherwise defined or exchanged in-band.
            -

            Security Requirement Object Examples

            -
            Non-OAuth2 Security Requirement
            -
            
            -{
            -  "api_key": []
            -}
            -
            -
            
            -api_key: []
            -
            -
            OAuth2 Security Requirement
            -
            
            -{
            -  "petstore_auth": [
            -    "write:pets",
            -    "read:pets"
            -  ]
            -}
            -
            -
            
            -petstore_auth:
            -- write:pets
            -- read:pets
            -
            -
            Optional OAuth2 Security
            -

            Optional OAuth2 security as would be defined in an OpenAPI Object or an Operation Object:

            -
            
            -{
            -  "security": [
            -    {},
            -    {
            -      "petstore_auth": [
            -        "write:pets",
            -        "read:pets"
            -      ]
            -    }
            -  ]
            -}
            -
            -
            
            -security:
            -  - {}
            -  - petstore_auth:
            -    - write:pets
            -    - read:pets
            -
            -

            Specification Extensions

            -

            While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.

            -

            The extensions properties are implemented as patterned fields that are always prefixed by "x-".

            - - - - - - - - - - - - - - - -
            Field PatternTypeDescription
            ^x-AnyAllows extensions to the OpenAPI Schema. The field name MUST begin with x-, for example, x-internal-id. Field names beginning x-oai- and x-oas- are reserved for uses defined by the OpenAPI Initiative. The value can be null, a primitive, an array or an object.
            -

            The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).

            -

            Security Filtering

            -

            Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.

            -

            The reasoning is to allow an additional layer of access control over the documentation. -While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.

            -

            Two examples of this:

            -
              -
            1. The Paths Object MAY be present but empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They would still have access to at least the Info Object which may contain additional information regarding authentication.
            2. -
            3. The Path Item Object MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the Paths Object, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.
            4. -
            -

            Appendix A: Revision History

            - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            VersionDateNotes
            3.1.02021-02-15Release of the OpenAPI Specification 3.1.0
            3.1.0-rc12020-10-08rc1 of the 3.1 specification
            3.1.0-rc02020-06-18rc0 of the 3.1 specification
            3.0.32020-02-20Patch release of the OpenAPI Specification 3.0.3
            3.0.22018-10-08Patch release of the OpenAPI Specification 3.0.2
            3.0.12017-12-06Patch release of the OpenAPI Specification 3.0.1
            3.0.02017-07-26Release of the OpenAPI Specification 3.0.0
            3.0.0-rc22017-06-16rc2 of the 3.0 specification
            3.0.0-rc12017-04-27rc1 of the 3.0 specification
            3.0.0-rc02017-02-28Implementer’s Draft of the 3.0 specification
            2.02015-12-31Donation of Swagger 2.0 to the OpenAPI Initiative
            2.02014-09-08Release of Swagger 2.0
            1.22014-03-14Initial release of the formal document.
            1.12012-08-22Release of Swagger 1.1
            1.02011-08-10First release of the Swagger Specification
            - diff --git a/docs/registries/_alternative-schema/jsonSchema.md b/docs/registries/_alternative-schema/jsonSchema.md deleted file mode 100644 index ba6858e107..0000000000 --- a/docs/registries/_alternative-schema/jsonSchema.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -owner: darrelmiller -issue: 1532 -description: JSON Schema -layout: default ---- - -{% capture summary %} -The `{{ page.slug }}` `alternativeSchema` `type` refers to [JSON Schema](http://json-schema.org/) in any version. -{% endcapture %} - -{% include alternative-schema-entry.md summary=summary %} diff --git a/docs/registries/_alternative-schema/xmlSchema.md b/docs/registries/_alternative-schema/xmlSchema.md deleted file mode 100644 index b833244f04..0000000000 --- a/docs/registries/_alternative-schema/xmlSchema.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -owner: darrelmiller -issue: 1532 -description: xml Schema -layout: default ---- - -{% capture summary %} -The `{{ page.slug }}` `alternativeSchema` `type` refers to [xml Schema](https://www.w3.org/XML/Schema) in any version. -{% endcapture %} - -{% include alternative-schema-entry.md summary=summary %} diff --git a/docs/registries/_draft-feature/alternativeSchema.md b/docs/registries/_draft-feature/alternativeSchema.md deleted file mode 100644 index 01147f2b40..0000000000 --- a/docs/registries/_draft-feature/alternativeSchema.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -owner: darrelmiller -issue: 1532 -description: x-oas-draft-alternativeSchema - -layout: default ---- - -# {{ page.collection }} - -## {{ page.slug }} - {{ page.description }} - -#### Media Type Object - - -##### Fixed Fields - -Field Name | Type | Description ----|:---:|--- -alternativeSchemas | [[alternative Schema Object](#alternativeSchemaObject)] | List of alternative schemas. These schemas can be used in addition to, or as an alternative to any existing `schema` property. If both OAS Schema and alternative schemas are present then both the OAS schema and one of the alternative schemas SHOULD be respected. Alternative schemas MUST be processed in order. It is sufficient for tooling to process just the first alternative schema they are capable of processing in order to consider the content as valid. If tooling cannot process any alternative schemas, then they MAY issue a warning, but MUST not report the OpenAPI description as invalid. - -#### Alternative Schema Object - -This object makes it possible to reference an external file that contains a schema that does not follow the OAS specification. - -##### Fixed Fields - -| Field Name | Type | Description | -|---|:---:|---| -type | `string` | **REQUIRED**. The value MUST match one of the values identified in the alternative Schema Registry name of the tag. -externalValue | `url` | **REQUIRED**. This is a absolute or relative reference to an external file containing a schema of a known type. - -This object MAY be extended with [Specification Extensions](#specificationExtensions). diff --git a/docs/registries/_extension/x-twitter.md b/docs/registries/_extension/x-twitter.md deleted file mode 100644 index 6fe0ea333c..0000000000 --- a/docs/registries/_extension/x-twitter.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -owner: MikeRalphson -issue: -description: Used to hold a reference to the API provider's Twitter account. -schema: - type: string -objects: [ "contactObject" ] -layout: default ---- - -{% capture summary %} -The `x-twitter` extension is used to hold a reference to the API provider's Twitter account. It can appear as a property in the following objects: `{{page.objects|jsonify}}`. -{% endcapture %} - -{% capture example %} -```yaml -openapi: 3.0.0 -info: - title: My API - version: 1.0.0 - contact: - x-twitter: APIs-guru -``` - -Used by: (informational) - -* APIs.guru -{% endcapture %} - -{% include extension-entry.md summary=summary example=example %} diff --git a/docs/registries/_format/base64url.md b/docs/registries/_format/base64url.md deleted file mode 100644 index eac3e8ec22..0000000000 --- a/docs/registries/_format/base64url.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: Binary data encoded as a url-safe string as defined in [RFC4648](https://www.rfc-editor.org/rfc/rfc4648#section-5) -base_type: string -layout: default -deprecated_note: '3.1' -remarks: "When using OpenAPI 3.1 it's recommended not to use this format and instead use [`contentEncoding` with a value of `base64url`](https://json-schema.org/draft/2020-12/json-schema-validation.html#name-contentencoding)." ---- - -{% capture summary %} -The `{{page.slug}}` format is binary data encoded as a url-safe string as defined in [RFC4648](https://www.rfc-editor.org/rfc/rfc4648#section-5). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/binary.md b/docs/registries/_format/binary.md deleted file mode 100644 index 6b77446759..0000000000 --- a/docs/registries/_format/binary.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -owner: DarrelMiller -issue: -description: any sequence of octets -base_type: string -layout: default -deprecated_note: '3.1' -remarks: "In OpenAPI 3.1, instead set the media type appropriately and do not use a schema property. Note that only complete HTTP message bodies or complete parts in a multipart media type can accommodate binary data. JSON strings and URL path components cannot." -source: https://spec.openapis.org/oas/v3.0.3.html#data-types -source_label: OAS ---- - -{% capture summary %} -The `{{page.slug}}` format represents any sequence of octets. This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/byte.md b/docs/registries/_format/byte.md deleted file mode 100644 index 920c65ce2c..0000000000 --- a/docs/registries/_format/byte.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -owner: DarrelMiller -issue: -description: base64 encoded data as defined in [RFC4648](https://www.rfc-editor.org/rfc/rfc4648#section-4) -base_type: string -layout: default -deprecated_note: '3.1' -remarks: "In OpenAPI 3.1, instead use [`contentEncoding: base64`](https://json-schema.org/draft/2020-12/json-schema-validation.html#name-contentencoding), optionally alongside [contentMediaType](https://json-schema.org/draft/2020-12/json-schema-validation.html#name-contentmediatype)." -source: https://spec.openapis.org/oas/v3.0.3.html#data-types -source_label: OAS ---- - -{% capture summary %} -The `{{page.slug}}` format represents any sequence of octets encoded as a base64 string as defined in [RFC4648](https://www.rfc-editor.org/rfc/rfc4648#section-4). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/char.md b/docs/registries/_format/char.md deleted file mode 100644 index a475303718..0000000000 --- a/docs/registries/_format/char.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -owner: baywet -issue: -description: A single character -base_type: string -layout: default ---- - -{% capture summary %} -The `{{page.slug}}` format is a single character. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/commonmark.md b/docs/registries/_format/commonmark.md deleted file mode 100644 index 1e0adc0f26..0000000000 --- a/docs/registries/_format/commonmark.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: MikeRalphson -description: commonmark-formatted text -base_type: string -issue: -layout: default -source: https://spec.openapis.org/oas/latest.html#data-types -source_label: OAS ---- - -{% capture summary %} -The `{{page.slug}}` format represents [CommonMark](https://commonmark.org/) formatted text. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/date-time.md b/docs/registries/_format/date-time.md deleted file mode 100644 index 8c4aeb43ce..0000000000 --- a/docs/registries/_format/date-time.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: DarrelMiller -issue: -description: date and time as defined by date-time - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6) -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-dates-times-and-duration ---- - -{% capture summary %} -The `{{page.slug}}` format represents a date and time as defined by date-time - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/date.md b/docs/registries/_format/date.md deleted file mode 100644 index 7d9fc70533..0000000000 --- a/docs/registries/_format/date.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: DarrelMiller -issue: -description: date as defined by full-date - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6) -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-dates-times-and-duration ---- - -{% capture summary %} -The `{{page.slug}}` format represents a date as defined by full-date - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/decimal.md b/docs/registries/_format/decimal.md deleted file mode 100644 index 6dbcb1b723..0000000000 --- a/docs/registries/_format/decimal.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -owner: baywet -issue: 889 -description: A fixed point decimal number of unspecified precision and range -base_type: [string, number] -layout: default -remarks: This format is used in a variety of conflicting ways and is not interoperable. ---- - -{% capture summary %} -The `{{page.slug}}` format represents a fixed point decimal number of unspecified precision and range. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/decimal128.md b/docs/registries/_format/decimal128.md deleted file mode 100644 index da2d806535..0000000000 --- a/docs/registries/_format/decimal128.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -owner: -issue: -description: A decimal floating-point number with 34 significant decimal digits -base_type: [string, number] -layout: default ---- - -{% capture summary %} -The `{{page.slug}}` format represents a [128-bit decimal floating-point number](https://en.wikipedia.org/wiki/Decimal128_floating-point_format) as defined by IEEE 754 2008 and ISO/IEC/IEEE 60559:2011. - -Representation as a JSON string is preferred as this avoids problems with recipients that parse JSON numbers into [binary64](https://en.wikipedia.org/wiki/Double-precision_floating-point_format) memory representation. - -String representation allows expressing the special values `NaN`, `-INF`, and `INF` that cannot be expressed as JSON numbers. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/double-int.md b/docs/registries/_format/double-int.md deleted file mode 100644 index 87a821f708..0000000000 --- a/docs/registries/_format/double-int.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: mikekistler -issue: -description: an integer that can be stored in an IEEE 754 double-precision number without loss of precision -base_type: integer -layout: default ---- - -{% capture summary %} -The `{{page.slug}}` format represents an integer that can be stored in an IEEE 754 double-precision number without loss of precision. The range of values is -(253)+1 to (253)-1. - -This format is useful for systems that need to support languages (such as JavaScript) that store all numeric values as IEEE 754 double-precision numbers. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/double.md b/docs/registries/_format/double.md deleted file mode 100644 index 15336c4701..0000000000 --- a/docs/registries/_format/double.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: DarrelMiller -issue: -description: double precision floating point number -base_type: number -layout: default -source: https://spec.openapis.org/oas/latest.html#data-types -source_label: OAS ---- - -{% capture summary %} -The `{{page.slug}}` format represents a double precision (64bit) floating point number as defined by [IEEE Std 754-2019](https://ieeexplore.ieee.org/document/8766229). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/duration.md b/docs/registries/_format/duration.md deleted file mode 100644 index 9240ade90b..0000000000 --- a/docs/registries/_format/duration.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -owner: baywet -issue: -description: duration as defined by duration - RFC3339 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-dates-times-and-duration ---- - -{% capture summary %} -The `{{page.slug}}` format represents a duration as defined by duration - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339.html#appendix-A). -{% endcapture %} - -{% include format-entry.md summary=summary %} - diff --git a/docs/registries/_format/email.md b/docs/registries/_format/email.md deleted file mode 100644 index 995943ee4b..0000000000 --- a/docs/registries/_format/email.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: An email address as defined as Mailbox in RFC5321 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-email-addresses ---- - -{% capture summary %} -The `{{page.slug}}` format is an email address as defined as Mailbox in [RFC5321](https://www.rfc-editor.org/rfc/rfc5321). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/float.md b/docs/registries/_format/float.md deleted file mode 100644 index c2f845500b..0000000000 --- a/docs/registries/_format/float.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: DarrelMiller -issue: -description: single precision floating point number -base_type: number -layout: default -source: https://spec.openapis.org/oas/latest.html#data-types -source_label: OAS ---- - -{% capture summary %} -The `{{page.slug}}` format represents a single precision (32bit) floating point number as defined by [IEEE Std 754-2019](https://ieeexplore.ieee.org/document/8766229). This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/hostname.md b/docs/registries/_format/hostname.md deleted file mode 100644 index 24fa8d7940..0000000000 --- a/docs/registries/_format/hostname.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: A host name as defined by RFC1123 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-hostnames ---- - -{% capture summary %} -The `{{page.slug}}` format is a host name as defined by [RFC1123](https://www.rfc-editor.org/info/rfc1123). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/html.md b/docs/registries/_format/html.md deleted file mode 100644 index 51f7c1999f..0000000000 --- a/docs/registries/_format/html.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: MikeRalphson -description: HTML-formatted text -base_type: string -issue: -layout: default -source: https://spec.openapis.org/oas/latest.html#data-types -source_label: OAS ---- - -{% capture summary %} -The `{{page.slug}}` format represents HTML-formatted text. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/http-date.md b/docs/registries/_format/http-date.md deleted file mode 100644 index 303332a0ea..0000000000 --- a/docs/registries/_format/http-date.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -owner: mikekistler -issue: -description: date and time as defined by HTTP-date - [RFC7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1) -base_type: string -layout: default ---- - -{% capture summary %} -The `{{page.slug}}` format represents a date and time as defined by HTTP-date - [RFC7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1). - -Example: "Sun, 06 Nov 1994 08:49:37 GMT" - -This is the format for dates passed in HTTP headers. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/idn-email.md b/docs/registries/_format/idn-email.md deleted file mode 100644 index 622046e718..0000000000 --- a/docs/registries/_format/idn-email.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: An email address as defined as Mailbox in RFC6531 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-email-addresses ---- - -{% capture summary %} -The `{{page.slug}}` format is an email address as defined as Mailbox in [RFC6531](https://www.rfc-editor.org/rfc/rfc6531). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/idn-hostname.md b/docs/registries/_format/idn-hostname.md deleted file mode 100644 index 5f2c7dcee0..0000000000 --- a/docs/registries/_format/idn-hostname.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: An internationalized host name as defined by RFC5890 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-hostnames ---- - -{% capture summary %} -The `{{page.slug}}` format is an internationalized host name as defined by [RFC5890](https://www.rfc-editor.org/rfc/rfc5890.html). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/int16.md b/docs/registries/_format/int16.md deleted file mode 100644 index 203f5104fe..0000000000 --- a/docs/registries/_format/int16.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -owner: DarrelMiller -issue: -description: signed 16-bit integer -base_type: number -layout: default ---- - -{% capture summary %} -The `{{page.slug}}` format represents a signed 16-bit integer, with the range -32768 through +32767. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/int32.md b/docs/registries/_format/int32.md deleted file mode 100644 index 135b568201..0000000000 --- a/docs/registries/_format/int32.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: DarrelMiller -issue: -description: signed 32-bit integer -base_type: number -layout: default -source: https://spec.openapis.org/oas/latest.html#data-types -source_label: OAS ---- - -{% capture summary %} -The `{{page.slug}}` format represents a signed 32-bit integer, with the range −2,147,483,648 through 2,147,483,647. This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/int64.md b/docs/registries/_format/int64.md deleted file mode 100644 index e21d32a155..0000000000 --- a/docs/registries/_format/int64.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -owner: DarrelMiller -issue: -description: signed 64-bit integer -base_type: [number, string] -layout: default -source: https://spec.openapis.org/oas/latest.html#data-types -source_label: OAS ---- - -{% capture summary %} -The `{{page.slug}}` format represents a signed 64-bit integer, with the range -9223372036854775808 through 9223372036854775807. This format entry is to ensure future versions of OpenAPI maintain compatibility with [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.0). - -Representation as a JSON string is recommended for values outside the 53-bit range (-9007199254740991 through 9007199254740991) as this avoids problems with recipients that parse JSON numbers into [binary64](https://en.wikipedia.org/wiki/Double-precision_floating-point_format) memory representation. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/int8.md b/docs/registries/_format/int8.md deleted file mode 100644 index c02618917a..0000000000 --- a/docs/registries/_format/int8.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: MikeRalphson -issue: 845 -description: signed 8-bit integer -base_type: number -layout: default -source: https://spec.openapis.org/oas/latest.html#data-types -source_label: OAS ---- - -{% capture summary %} -The `{{page.slug}}` format represents a signed 8-bit integer, with the range -128 to 127. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/ipv4.md b/docs/registries/_format/ipv4.md deleted file mode 100644 index 19463a9ee3..0000000000 --- a/docs/registries/_format/ipv4.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: An IPv4 address as defined as dotted-quad by RFC2673 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-ip-addresses ---- - -{% capture summary %} -The `{{page.slug}}` format is an IPv4 address as defined as dotted-quad by [RFC2673](https://www.rfc-editor.org/info/rfc2673). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/ipv6.md b/docs/registries/_format/ipv6.md deleted file mode 100644 index 11ce1f1679..0000000000 --- a/docs/registries/_format/ipv6.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: An IPv6 address as defined by RFC4673 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-ip-addresses ---- - -{% capture summary %} -The `{{page.slug}}` format is an IPv6 address as defined by [RFC4291](https://www.rfc-editor.org/info/rfc4291). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/iri-reference.md b/docs/registries/_format/iri-reference.md deleted file mode 100644 index ae76e46da0..0000000000 --- a/docs/registries/_format/iri-reference.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: A Internationalized Resource Identifier as defined in RFC3987 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-resource-identifiers ---- - -{% capture summary %} -The `{{page.slug}}` format is a Internationalized Resource Identifier as defined in [RFC3987](https://www.rfc-editor.org/info/rfc3987). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/iri.md b/docs/registries/_format/iri.md deleted file mode 100644 index ae76e46da0..0000000000 --- a/docs/registries/_format/iri.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: A Internationalized Resource Identifier as defined in RFC3987 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-resource-identifiers ---- - -{% capture summary %} -The `{{page.slug}}` format is a Internationalized Resource Identifier as defined in [RFC3987](https://www.rfc-editor.org/info/rfc3987). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/json-pointer.md b/docs/registries/_format/json-pointer.md deleted file mode 100644 index 5803c2d9e3..0000000000 --- a/docs/registries/_format/json-pointer.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: A JSON string representation of a JSON Pointer as defined in RFC6901 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-json-pointers ---- - -{% capture summary %} -The `{{page.slug}}` format is a JSON string representation of a JSON Pointer as defined in [RFC6901](https://www.rfc-editor.org/info/rfc6901). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/media-range.md b/docs/registries/_format/media-range.md deleted file mode 100644 index 7e3f404078..0000000000 --- a/docs/registries/_format/media-range.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -owner: jdesrosiers -issue: -description: A media type as defined by the `media-range` ABNF production in RFC9110. -base_type: string -layout: default -source_label: OpenAPI -source: https://www.rfc-editor.org/rfc/rfc9110#field.accept ---- - -{% capture summary %} -The `{{page.slug}}` format is a media type as defined by the `media-range` ABNF -production in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/password.md b/docs/registries/_format/password.md deleted file mode 100644 index c3bdcbc04b..0000000000 --- a/docs/registries/_format/password.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: a string that hints to obscure the value. -base_type: string -layout: default -source: https://spec.openapis.org/oas/latest.html#data-types -source_label: OAS ---- - -{% capture summary %} -The `{{page.slug}}` format is a string that hints to obscure the value. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/regex.md b/docs/registries/_format/regex.md deleted file mode 100644 index c5adf6d9ce..0000000000 --- a/docs/registries/_format/regex.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: A regular expression as defined in ECMA-262 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-regex ---- - -{% capture summary %} -The `{{page.slug}}` format is a regular expression as defined in ECMA-262. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/relative-json-pointer.md b/docs/registries/_format/relative-json-pointer.md deleted file mode 100644 index d771b21a82..0000000000 --- a/docs/registries/_format/relative-json-pointer.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -owner: baywet -issue: -description: A JSON string representation of a relative JSON Pointer as defined in draft RFC 01 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-json-pointers ---- - -{% capture summary %} -The `{{page.slug}}` format is a JSON string representation of a relative JSON Pointer as defined in draft RFC 01. - -[Relative JSON pointers draft RFC 01](https://datatracker.ietf.org/doc/html/draft-handrews-relative-json-pointer-01). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/sf-binary.md b/docs/registries/_format/sf-binary.md deleted file mode 100644 index 8c9ba10804..0000000000 --- a/docs/registries/_format/sf-binary.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -owner: mikekistler -issue: -description: structured fields byte sequence as defined in [RFC8941] -source: https://www.rfc-editor.org/rfc/rfc8941#name-byte-sequences -source_label: RFC 8941 -base_type: string -layout: default ---- - -{% capture summary %} -The `{{page.slug}}` format represents a structured fields byte sequence as defined in [RFC8941]. - -```abnf -sf-binary = ":" *(base64) ":" -base64 = ALPHA / DIGIT / "+" / "/" / "=" -``` - -A Byte Sequence is delimited with colons and encoded using base64 ([RFC4648], Section 4). - -This format is appropriate for a header value that must conform to the {{page.slug}} structured field definition. -{% endcapture %} - -{% include format-entry.md summary=summary %} - -[RFC8941]: https://www.rfc-editor.org/rfc/rfc8941#name-byte-sequences -[RFC4648]: https://www.rfc-editor.org/rfc/rfc4648#section-4 diff --git a/docs/registries/_format/sf-boolean.md b/docs/registries/_format/sf-boolean.md deleted file mode 100644 index 4a2681bd08..0000000000 --- a/docs/registries/_format/sf-boolean.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -owner: mikekistler -issue: -description: structured fields boolean as defined in [RFC8941] -source: https://www.rfc-editor.org/rfc/rfc8941#name-booleans -source_label: RFC 8941 -base_type: string -layout: default ---- - -{% capture summary %} -The `{{page.slug}}` format represents a structured fields boolean as defined in [RFC8941]. - -```abnf -sf-boolean = "?" boolean -boolean = "0" / "1" -``` - -A Boolean is indicated with a leading "?" character followed by a "1" for a true value or "0" for false. - -This format is appropriate for a header value that must conform to the {{page.slug}} structured field definition. -{% endcapture %} - -{% include format-entry.md summary=summary %} - -[RFC8941]: https://www.rfc-editor.org/rfc/rfc8941#name-booleans diff --git a/docs/registries/_format/sf-decimal.md b/docs/registries/_format/sf-decimal.md deleted file mode 100644 index 083c55adec..0000000000 --- a/docs/registries/_format/sf-decimal.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -owner: mikekistler -issue: -description: structured fields decimal as defined in [RFC8941] -source: https://www.rfc-editor.org/rfc/rfc8941#name-decimals -source_label: RFC 8941 -base_type: number -layout: default ---- - -{% capture summary %} -The `{{page.slug}}` format represents a structured fields decimal as defined in [RFC8941]. - -```abnf -sf-decimal = ["-"] 1*12DIGIT "." 1*3DIGIT -``` - -Decimals are numbers with an integer and a fractional component. -The integer component has at most 12 digits; the fractional component has at most three digits. - -This format is appropriate for a header value that must conform to the {{page.slug}} structured field definition. -{% endcapture %} - -{% include format-entry.md summary=summary %} - -[RFC8941]: https://www.rfc-editor.org/rfc/rfc8941#name-decimals diff --git a/docs/registries/_format/sf-integer.md b/docs/registries/_format/sf-integer.md deleted file mode 100644 index 8edc872cee..0000000000 --- a/docs/registries/_format/sf-integer.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -owner: mikekistler -issue: -description: structured fields integer as defined in [RFC8941] -source: https://www.rfc-editor.org/rfc/rfc8941#name-integers -source_label: RFC 8941 -base_type: [integer, number] -layout: default ---- - -{% capture summary %} -The `{{page.slug}}` format represents a structured fields integer as defined in [RFC8941]. - -```abnf -sf-integer = ["-"] 1*15DIGIT -``` - -Integers have a range of -999,999,999,999,999 to 999,999,999,999,999 inclusive (i.e., up to fifteen digits, signed), -for IEEE 754 compatibility [IEEE754]. - -This format is appropriate for a header value that must conform to the {{page.slug}} structured field definition. -{% endcapture %} - -{% include format-entry.md summary=summary %} - -[RFC8941]: https://www.rfc-editor.org/rfc/rfc8941#name-integers -[IEEE754]: https://ieeexplore.ieee.org/document/8766229 diff --git a/docs/registries/_format/sf-string.md b/docs/registries/_format/sf-string.md deleted file mode 100644 index e016bb1650..0000000000 --- a/docs/registries/_format/sf-string.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -owner: mikekistler -issue: -description: structured fields string as defined in [RFC8941] -source: https://www.rfc-editor.org/rfc/rfc8941#name-strings -source_label: RFC 8941 -base_type: string -layout: default ---- - -{% capture summary %} -The `{{page.slug}}` format represents a structured fields string as defined in [RFC8941]. - -```abnf -sf-string = DQUOTE *chr DQUOTE -chr = unescaped / escaped -unescaped = %x20-21 / %x23-5B / %x5D-7E -escaped = "\" ( DQUOTE / "\" ) -``` - -Strings are zero or more printable ASCII [RFC0020] characters (i.e., the range %x20 to %x7E). -Note that this excludes tabs, newlines, carriage returns, etc. - -Strings are delimited with double quotes, using a backslash ("\") to escape double quotes and backslashes. - -This format is appropriate for a header value that must conform to the {{page.slug}} structured field definition. -{% endcapture %} - -{% include format-entry.md summary=summary %} - -[RFC8941]: https://www.rfc-editor.org/rfc/rfc8941#name-strings diff --git a/docs/registries/_format/sf-token.md b/docs/registries/_format/sf-token.md deleted file mode 100644 index b022a03789..0000000000 --- a/docs/registries/_format/sf-token.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -owner: mikekistler -issue: -description: structured fields token as defined in [RFC8941] -source: https://www.rfc-editor.org/rfc/rfc8941#name-tokens -source_label: RFC 8941 -base_type: string -layout: default ---- - -{% capture summary %} -The `{{page.slug}}` format represents a structured fields token as defined in [RFC8941]. - -```abnf -sf-token = ( ALPHA / "*" ) *( tchar / ":" / "/" ) -``` - -Tokens are short textual words; their abstract model is identical to their expression in the HTTP field value serialization. - -This format is appropriate for a header value that must conform to the {{page.slug}} structured field definition. -{% endcapture %} - -{% include format-entry.md summary=summary %} - -[RFC8941]: https://www.rfc-editor.org/rfc/rfc8941#name-tokens diff --git a/docs/registries/_format/time.md b/docs/registries/_format/time.md deleted file mode 100644 index bc96e6b1e0..0000000000 --- a/docs/registries/_format/time.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: time as defined by full-time - RFC3339 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-dates-times-and-duration ---- - -{% capture summary %} -The `{{page.slug}}` format represents a time as defined by full-time - [RFC3339](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/uint8.md b/docs/registries/_format/uint8.md deleted file mode 100644 index 9f63ffc0d7..0000000000 --- a/docs/registries/_format/uint8.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: MikeRalphson -issue: 845 -description: unsigned 8-bit integer -base_type: number -layout: default -source: https://spec.openapis.org/oas/latest.html#data-types -source_label: OAS ---- - -{% capture summary %} -The `{{page.slug}}` format represents an unsigned 8-bit integer, with the range 0 to 255. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/uri-reference.md b/docs/registries/_format/uri-reference.md deleted file mode 100644 index c084005369..0000000000 --- a/docs/registries/_format/uri-reference.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: A URI reference as defined in [RFC3986](https://www.rfc-editor.org/info/rfc3986) -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-resource-identifiers ---- - -{% capture summary %} -The `{{page.slug}}` format is a URI reference as defined in RFC3986. -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/uri-template.md b/docs/registries/_format/uri-template.md deleted file mode 100644 index 1ade6d379f..0000000000 --- a/docs/registries/_format/uri-template.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: A URI Template as defined in RFC6570 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-uri-template ---- - -{% capture summary %} -The `{{page.slug}}` format is a URI Template as defined in [RFC6570](https://www.rfc-editor.org/rfc/rfc6570). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/uri.md b/docs/registries/_format/uri.md deleted file mode 100644 index 15d858434e..0000000000 --- a/docs/registries/_format/uri.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: A Uniform Resource Identifier as defined in RFC3986 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-resource-identifiers ---- - -{% capture summary %} -The `{{page.slug}}` format is a Uniform Resource Identifier as defined in [RFC3986](https://www.rfc-editor.org/rfc/rfc3986.html). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_format/uuid.md b/docs/registries/_format/uuid.md deleted file mode 100644 index ff571a098a..0000000000 --- a/docs/registries/_format/uuid.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -owner: baywet -issue: -description: A Universally Unique IDentifier as defined in RFC4122 -base_type: string -layout: default -source_label: JSON Schema -source: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-resource-identifiers ---- - -{% capture summary %} -The `{{page.slug}}` format a Universally Unique IDentifier as defined in [RFC4122](https://www.rfc-editor.org/rfc/rfc4122). -{% endcapture %} - -{% include format-entry.md summary=summary %} diff --git a/docs/registries/_namespace/ms.md b/docs/registries/_namespace/ms.md deleted file mode 100644 index 0c8abf165d..0000000000 --- a/docs/registries/_namespace/ms.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -owner: DarrelMiller -issue: -description: Extensions created and used by Microsoft -layout: default ---- - -{% capture summary %} -The `x-{{page.slug}}-` prefix is reserved for extensions created by Microsoft. These extensions are available for use by anyone. -{% endcapture %} - -{% include namespace-entry.md summary=summary %} diff --git a/docs/registries/_namespace/oas-draft.md b/docs/registries/_namespace/oas-draft.md deleted file mode 100644 index f0879c233e..0000000000 --- a/docs/registries/_namespace/oas-draft.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -owner: DarrelMiller -issue: -description: Extensions created by OAI to indicate proposed changes to the OAS specification -layout: default ---- - -{% capture summary %} -The `x-{{page.slug}}-` prefix is reserved for extensions created as part of the [draft features](https://github.com/OAI/OpenAPI-Specification/blob/main/DEVELOPMENT.md#draft-features) process. These extensions are available for use by anyone. -{% endcapture %} - -{% include namespace-entry.md summary=summary %} diff --git a/docs/registries/_namespace/sap.md b/docs/registries/_namespace/sap.md deleted file mode 100644 index 63b24412cc..0000000000 --- a/docs/registries/_namespace/sap.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -owner: ralfhandl, pavelkornev -issue: -description: Extensions created and used by SAP -layout: default ---- - -{% capture summary %} -The `x-{{page.slug}}-` prefix is reserved for extensions created by SAP. These extensions are available for use by anyone. - -The official list of supported SAP extensions can be found in [SAP/openapi-specification](https://github.com/SAP/openapi-specification) repository. -{% endcapture %} - -{% include namespace-entry.md summary=summary %} diff --git a/docs/registry/alternative-schema.md b/docs/registry/alternative-schema.md deleted file mode 100644 index 386c7b22b7..0000000000 --- a/docs/registry/alternative-schema.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Alternative Schema Registry -layout: default -permalink: /registry/alternative-schema/index.html -parent: Registry ---- - -# Alternative Schema Type Registry - -## Master Issue - -* [#1532](https://github.com/OAI/OpenAPI-Specification/issues/1532) - -## Contributing - -Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value. - -## Values - -|Value|Description|Issue| -|---|---|---| -{% for value in site.alternative-schema %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} | -{% endfor %} - diff --git a/docs/registry/draft-feature.md b/docs/registry/draft-feature.md deleted file mode 100644 index b8d59a9551..0000000000 --- a/docs/registry/draft-feature.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Draft Feature Registry -layout: default -permalink: /registry/draft-feature/index.html -parent: Registry ---- - -# Draft Features Registry - -## Master Issue - -* [#1531](https://github.com/OAI/OpenAPI-Specification/pull/1531) - -## Contributing - -Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value. - -## Values - -|Value|Description|Issue| -|---|---|---| -{% for value in site.draft-feature %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} | -{% endfor %} - diff --git a/docs/registry/extension.md b/docs/registry/extension.md deleted file mode 100644 index 226b8730e7..0000000000 --- a/docs/registry/extension.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -# title: Extensions Registry -layout: default -permalink: /registry/extension/index.html -parent: Registry ---- - -# Extensions Registry - -## Master Issue - -* [#1351](https://github.com/OAI/OpenAPI-Specification/issues/1351) - -## Contributing - -Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value. - -## Values - -|Value|Description|Issue| -|---|---|---| -{% for value in site.extension %}| {{ value.slug }} | {{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} | -{% endfor %} - diff --git a/docs/registry/format.md b/docs/registry/format.md deleted file mode 100644 index c032f95844..0000000000 --- a/docs/registry/format.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Format Registry -layout: default -permalink: /registry/format/index.html -parent: Registry ---- - -# Formats Registry - -## Considerations - -The existence of a format in this registry DOES NOT require tools to implement it. - -If tools choose to implement any format present in this registry, they SHOULD implement the format following the provided behavior. - -The registry SHOULD NOT contain two entries that have the same meaning, unless all but one have been deprecated. - - -## Contributing - -Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value. - -## Values - -|Value|Description|Type|Source|Deprecated| -|---|---|----|---|---|----| -{% for value in site.format %}| {{ value.slug }} | {{ value.description }} | {{ value.base_type | join: ', ' }} | {% if value.source %}{% if value.source_label %}{{value.source_label}}{% else %}Open{% endif %}{% endif %} | {% if value.deprecated_note %}Yes{% else %}No{% endif %} | -{% endfor %} - diff --git a/docs/registry/index.md b/docs/registry/index.md deleted file mode 100644 index 386680cf71..0000000000 --- a/docs/registry/index.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Registry -layout: default -permalink: /registry/index.html -has_children: true -children: -- title: Alternative Schema Registry -- title: Draft Features Registry -- title: Format Registry -- title: Namespace Registry -has_toc: false ---- - -## Contributing - -Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) against the `main` branch and add a new Markdown file to a folder in the `docs/registries/_{registryName}`. The name of the file is considered the registration entry, ignoring the file extension. Alternatively you can open an [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to discuss a registry value. - -### Contents - -{% for registry in site.collections %}{% unless registry.hidden %} -* {{ registry.name }}{% endunless %}{% endfor %} - -#### API access - -* [registries.json](../api/registries.json) - Registries meta-registry{% for registry in site.collections %}{% unless registry.hidden %} -* {{ registry.slug }}.json{% endunless %} {% endfor %} - -#### RSS feed - -* [feed.xml](../rss/feed.xml) - diff --git a/docs/registry/namespace.md b/docs/registry/namespace.md deleted file mode 100644 index 6b05c8c1b7..0000000000 --- a/docs/registry/namespace.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Namespace Registry -layout: default -permalink: /registry/namespace/index.html -parent: Registry ---- - -# Namespace Registry - -To allow for creators of OpenAPI descriptions to define new extensions without the risk of name collisions, a namespace registry is maintained by OAI. The namespace registry is a simple list of unique identifiers that are used as part of a prefix for extensions to ensure uniqueness. A prefix has the format `x-{namespace}-` where `{namespace}` is a unique string associated to the creator of the extensions within the namespace. Namespace identifiers MUST be registered as lowercase identifiers. - -## Contributing - -Please raise a [Pull-Request](https://github.com/OAI/OpenAPI-Specification/pulls) or [Issue](https://github.com/OAI/OpenAPI-Specification/issues) to contribute or discuss a registry value. - -## Values - -|Value|Prefix|Description|Issue| -|---|---|---|---| -{% for value in site.namespace %}| {{ value.slug }} | x-{{ value.slug }}-|{{ value.description }} | {% if value.issue %}#{{ value.issue }}{% endif %} | -{% endfor %} diff --git a/docs/rss/feed.xml b/docs/rss/feed.xml deleted file mode 100644 index f43e1043bb..0000000000 --- a/docs/rss/feed.xml +++ /dev/null @@ -1,25 +0,0 @@ ---- -layout: none ---- - - - - {{ site.title | xml_escape }} - {{ site.description | xml_escape }} - {{ site.url }}{{ site.baseurl }}/ - - {% for reg in site.collections %} - {% assign name = reg.label %} - {% for value in site.[name] %} - - {{ value.slug | xml_escape }} - {{ value.description | xml_escape }} - {{ reg.label }} - {% if value.date %}{{ value.date | date: "%a, %d %b %Y %H:%M:%S %z" }}{% else %}{{ 'now' | date: "%a, %d %b %Y %H:%M:%S %z" }}{% endif %} - {{ value.url }} - {{ value.url }} - - {% endfor %} - {% endfor %} - - diff --git a/examples/v2.0/json/api-with-examples.json b/examples/v2.0/json/api-with-examples.json deleted file mode 100644 index e1b371a070..0000000000 --- a/examples/v2.0/json/api-with-examples.json +++ /dev/null @@ -1,58 +0,0 @@ -{ - "swagger": "2.0", - "info": { - "title": "Simple API overview", - "version": "v2" - }, - "paths": { - "/": { - "get": { - "operationId": "listVersionsv2", - "summary": "List API versions", - "produces": [ - "application/json" - ], - "responses": { - "200": { - "description": "200 300 response", - "examples": { - "application/json": "{\n \"versions\": [\n {\n \"status\": \"CURRENT\",\n \"updated\": \"2011-01-21T11:33:21Z\",\n \"id\": \"v2.0\",\n \"links\": [\n {\n \"href\": \"http://127.0.0.1:8774/v2/\",\n \"rel\": \"self\"\n }\n ]\n },\n {\n \"status\": \"EXPERIMENTAL\",\n \"updated\": \"2013-07-23T11:33:21Z\",\n \"id\": \"v3.0\",\n \"links\": [\n {\n \"href\": \"http://127.0.0.1:8774/v3/\",\n \"rel\": \"self\"\n }\n ]\n }\n ]\n}" - } - }, - "300": { - "description": "200 300 response", - "examples": { - "application/json": "{\n \"versions\": [\n {\n \"status\": \"CURRENT\",\n \"updated\": \"2011-01-21T11:33:21Z\",\n \"id\": \"v2.0\",\n \"links\": [\n {\n \"href\": \"http://127.0.0.1:8774/v2/\",\n \"rel\": \"self\"\n }\n ]\n },\n {\n \"status\": \"EXPERIMENTAL\",\n \"updated\": \"2013-07-23T11:33:21Z\",\n \"id\": \"v3.0\",\n \"links\": [\n {\n \"href\": \"http://127.0.0.1:8774/v3/\",\n \"rel\": \"self\"\n }\n ]\n }\n ]\n}" - } - } - } - } - }, - "/v2": { - "get": { - "operationId": "getVersionDetailsv2", - "summary": "Show API version details", - "produces": [ - "application/json" - ], - "responses": { - "200": { - "description": "200 203 response", - "examples": { - "application/json": "{\n \"version\": {\n \"status\": \"CURRENT\",\n \"updated\": \"2011-01-21T11:33:21Z\",\n \"media-types\": [\n {\n \"base\": \"application/xml\",\n \"type\": \"application/vnd.openstack.compute+xml;version=2\"\n },\n {\n \"base\": \"application/json\",\n \"type\": \"application/vnd.openstack.compute+json;version=2\"\n }\n ],\n \"id\": \"v2.0\",\n \"links\": [\n {\n \"href\": \"http://127.0.0.1:8774/v2/\",\n \"rel\": \"self\"\n },\n {\n \"href\": \"http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf\",\n \"type\": \"application/pdf\",\n \"rel\": \"describedby\"\n },\n {\n \"href\": \"http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl\",\n \"type\": \"application/vnd.sun.wadl+xml\",\n \"rel\": \"describedby\"\n },\n {\n \"href\": \"http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl\",\n \"type\": \"application/vnd.sun.wadl+xml\",\n \"rel\": \"describedby\"\n }\n ]\n }\n}" - } - }, - "203": { - "description": "200 203 response", - "examples": { - "application/json": "{\n \"version\": {\n \"status\": \"CURRENT\",\n \"updated\": \"2011-01-21T11:33:21Z\",\n \"media-types\": [\n {\n \"base\": \"application/xml\",\n \"type\": \"application/vnd.openstack.compute+xml;version=2\"\n },\n {\n \"base\": \"application/json\",\n \"type\": \"application/vnd.openstack.compute+json;version=2\"\n }\n ],\n \"id\": \"v2.0\",\n \"links\": [\n {\n \"href\": \"http://23.253.228.211:8774/v2/\",\n \"rel\": \"self\"\n },\n {\n \"href\": \"http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf\",\n \"type\": \"application/pdf\",\n \"rel\": \"describedby\"\n },\n {\n \"href\": \"http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl\",\n \"type\": \"application/vnd.sun.wadl+xml\",\n \"rel\": \"describedby\"\n }\n ]\n }\n}" - } - } - } - } - } - }, - "consumes": [ - "application/json" - ] -} \ No newline at end of file diff --git a/examples/v2.0/json/petstore-expanded.json b/examples/v2.0/json/petstore-expanded.json deleted file mode 100644 index d5d8de8126..0000000000 --- a/examples/v2.0/json/petstore-expanded.json +++ /dev/null @@ -1,210 +0,0 @@ -{ - "swagger": "2.0", - "info": { - "version": "1.0.0", - "title": "Swagger Petstore", - "description": "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification", - "termsOfService": "http://swagger.io/terms/", - "contact": { - "name": "Swagger API Team", - "email": "apiteam@swagger.io", - "url": "http://swagger.io" - }, - "license": { - "name": "Apache 2.0", - "url": "https://www.apache.org/licenses/LICENSE-2.0.html" - } - }, - "host": "petstore.swagger.io", - "basePath": "/api", - "schemes": [ - "http" - ], - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "paths": { - "/pets": { - "get": { - "description": "Returns all pets from the system that the user has access to\nNam sed condimentum est. Maecenas tempor sagittis sapien, nec rhoncus sem sagittis sit amet. Aenean at gravida augue, ac iaculis sem. Curabitur odio lorem, ornare eget elementum nec, cursus id lectus. Duis mi turpis, pulvinar ac eros ac, tincidunt varius justo. In hac habitasse platea dictumst. Integer at adipiscing ante, a sagittis ligula. Aenean pharetra tempor ante molestie imperdiet. Vivamus id aliquam diam. Cras quis velit non tortor eleifend sagittis. Praesent at enim pharetra urna volutpat venenatis eget eget mauris. In eleifend fermentum facilisis. Praesent enim enim, gravida ac sodales sed, placerat id erat. Suspendisse lacus dolor, consectetur non augue vel, vehicula interdum libero. Morbi euismod sagittis libero sed lacinia.\n\nSed tempus felis lobortis leo pulvinar rutrum. Nam mattis velit nisl, eu condimentum ligula luctus nec. Phasellus semper velit eget aliquet faucibus. In a mattis elit. Phasellus vel urna viverra, condimentum lorem id, rhoncus nibh. Ut pellentesque posuere elementum. Sed a varius odio. Morbi rhoncus ligula libero, vel eleifend nunc tristique vitae. Fusce et sem dui. Aenean nec scelerisque tortor. Fusce malesuada accumsan magna vel tempus. Quisque mollis felis eu dolor tristique, sit amet auctor felis gravida. Sed libero lorem, molestie sed nisl in, accumsan tempor nisi. Fusce sollicitudin massa ut lacinia mattis. Sed vel eleifend lorem. Pellentesque vitae felis pretium, pulvinar elit eu, euismod sapien.\n", - "operationId": "findPets", - "parameters": [ - { - "name": "tags", - "in": "query", - "description": "tags to filter by", - "required": false, - "type": "array", - "collectionFormat": "csv", - "items": { - "type": "string" - } - }, - { - "name": "limit", - "in": "query", - "description": "maximum number of results to return", - "required": false, - "type": "integer", - "format": "int32" - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "type": "array", - "items": { - "$ref": "#/definitions/Pet" - } - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - }, - "post": { - "description": "Creates a new pet in the store. Duplicates are allowed", - "operationId": "addPet", - "parameters": [ - { - "name": "pet", - "in": "body", - "description": "Pet to add to the store", - "required": true, - "schema": { - "$ref": "#/definitions/NewPet" - } - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "$ref": "#/definitions/Pet" - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - } - }, - "/pets/{id}": { - "get": { - "description": "Returns a user based on a single ID, if the user does not have access to the pet", - "operationId": "find pet by id", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "ID of pet to fetch", - "required": true, - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "$ref": "#/definitions/Pet" - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - }, - "delete": { - "description": "deletes a single pet based on the ID supplied", - "operationId": "deletePet", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "ID of pet to delete", - "required": true, - "type": "integer", - "format": "int64" - } - ], - "responses": { - "204": { - "description": "pet deleted" - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - } - } - }, - "definitions": { - "Pet": { - "type": "object", - "allOf": [ - { - "$ref": "#/definitions/NewPet" - }, - { - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64" - } - } - } - ] - }, - "NewPet": { - "type": "object", - "required": [ - "name" - ], - "properties": { - "name": { - "type": "string" - }, - "tag": { - "type": "string" - } - } - }, - "Error": { - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - } - } - } - } -} diff --git a/examples/v2.0/json/petstore-minimal.json b/examples/v2.0/json/petstore-minimal.json deleted file mode 100644 index 0c70baed7e..0000000000 --- a/examples/v2.0/json/petstore-minimal.json +++ /dev/null @@ -1,68 +0,0 @@ -{ - "swagger": "2.0", - "info": { - "version": "1.0.0", - "title": "Swagger Petstore", - "description": "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification", - "termsOfService": "http://swagger.io/terms/", - "contact": { - "name": "Swagger API Team" - }, - "license": { - "name": "MIT" - } - }, - "host": "petstore.swagger.io", - "basePath": "/api", - "schemes": [ - "http" - ], - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "paths": { - "/pets": { - "get": { - "description": "Returns all pets from the system that the user has access to", - "produces": [ - "application/json" - ], - "responses": { - "200": { - "description": "A list of pets.", - "schema": { - "type": "array", - "items": { - "$ref": "#/definitions/Pet" - } - } - } - } - } - } - }, - "definitions": { - "Pet": { - "type": "object", - "required": [ - "id", - "name" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64" - }, - "name": { - "type": "string" - }, - "tag": { - "type": "string" - } - } - } - } -} \ No newline at end of file diff --git a/examples/v2.0/json/petstore-separate/common/Error.json b/examples/v2.0/json/petstore-separate/common/Error.json deleted file mode 100644 index dd0e65a0fa..0000000000 --- a/examples/v2.0/json/petstore-separate/common/Error.json +++ /dev/null @@ -1,16 +0,0 @@ -{ - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - } - } -} \ No newline at end of file diff --git a/examples/v2.0/json/petstore-separate/spec/NewPet.json b/examples/v2.0/json/petstore-separate/spec/NewPet.json deleted file mode 100644 index 9104f7f68a..0000000000 --- a/examples/v2.0/json/petstore-separate/spec/NewPet.json +++ /dev/null @@ -1,19 +0,0 @@ -{ - "type": "object", - "allOf": [ - { - "$ref": "Pet.json" - }, - { - "required": [ - "name" - ], - "properties": { - "description": { - "type": "integer", - "format": "int64" - } - } - } - ] -} \ No newline at end of file diff --git a/examples/v2.0/json/petstore-separate/spec/Pet.json b/examples/v2.0/json/petstore-separate/spec/Pet.json deleted file mode 100644 index c7ee9fbb05..0000000000 --- a/examples/v2.0/json/petstore-separate/spec/Pet.json +++ /dev/null @@ -1,19 +0,0 @@ -{ - "type": "object", - "required": [ - "id", - "name" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64" - }, - "name": { - "type": "string" - }, - "tag": { - "type": "string" - } - } -} \ No newline at end of file diff --git a/examples/v2.0/json/petstore-separate/spec/parameters.json b/examples/v2.0/json/petstore-separate/spec/parameters.json deleted file mode 100644 index a7c11b0a0c..0000000000 --- a/examples/v2.0/json/petstore-separate/spec/parameters.json +++ /dev/null @@ -1,21 +0,0 @@ -{ - "tagsParam": { - "name": "tags", - "in": "query", - "description": "tags to filter by", - "required": false, - "type": "array", - "collectionFormat": "csv", - "items": { - "type": "string" - } - }, - "limitsParam": { - "name": "limit", - "in": "query", - "description": "maximum number of results to return", - "required": false, - "type": "integer", - "format": "int32" - } -} \ No newline at end of file diff --git a/examples/v2.0/json/petstore-separate/spec/swagger.json b/examples/v2.0/json/petstore-separate/spec/swagger.json deleted file mode 100644 index 7276990020..0000000000 --- a/examples/v2.0/json/petstore-separate/spec/swagger.json +++ /dev/null @@ -1,146 +0,0 @@ -{ - "swagger": "2.0", - "info": { - "version": "1.0.0", - "title": "Swagger Petstore", - "description": "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification", - "termsOfService": "http://swagger.io/terms/", - "contact": { - "name": "Swagger API Team", - "email": "apiteam@swagger.io", - "url": "http://swagger.io" - }, - "license": { - "name": "Apache 2.0", - "url": "https://www.apache.org/licenses/LICENSE-2.0.html" - } - }, - "host": "petstore.swagger.io", - "basePath": "/api", - "schemes": [ - "http" - ], - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "paths": { - "/pets": { - "get": { - "description": "Returns all pets from the system that the user has access to\nNam sed condimentum est. Maecenas tempor sagittis sapien, nec rhoncus sem sagittis sit amet. Aenean at gravida augue, ac iaculis sem. Curabitur odio lorem, ornare eget elementum nec, cursus id lectus. Duis mi turpis, pulvinar ac eros ac, tincidunt varius justo. In hac habitasse platea dictumst. Integer at adipiscing ante, a sagittis ligula. Aenean pharetra tempor ante molestie imperdiet. Vivamus id aliquam diam. Cras quis velit non tortor eleifend sagittis. Praesent at enim pharetra urna volutpat venenatis eget eget mauris. In eleifend fermentum facilisis. Praesent enim enim, gravida ac sodales sed, placerat id erat. Suspendisse lacus dolor, consectetur non augue vel, vehicula interdum libero. Morbi euismod sagittis libero sed lacinia.\n\nSed tempus felis lobortis leo pulvinar rutrum. Nam mattis velit nisl, eu condimentum ligula luctus nec. Phasellus semper velit eget aliquet faucibus. In a mattis elit. Phasellus vel urna viverra, condimentum lorem id, rhoncus nibh. Ut pellentesque posuere elementum. Sed a varius odio. Morbi rhoncus ligula libero, vel eleifend nunc tristique vitae. Fusce et sem dui. Aenean nec scelerisque tortor. Fusce malesuada accumsan magna vel tempus. Quisque mollis felis eu dolor tristique, sit amet auctor felis gravida. Sed libero lorem, molestie sed nisl in, accumsan tempor nisi. Fusce sollicitudin massa ut lacinia mattis. Sed vel eleifend lorem. Pellentesque vitae felis pretium, pulvinar elit eu, euismod sapien.\n", - "operationId": "findPets", - "parameters": [ - { - "$ref": "parameters.json#/tagsParam" - }, - { - "$ref": "parameters.json#/limitsParam" - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "type": "array", - "items": { - "$ref": "Pet.json" - } - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "../common/Error.json" - } - } - } - }, - "post": { - "description": "Creates a new pet in the store. Duplicates are allowed", - "operationId": "addPet", - "parameters": [ - { - "name": "pet", - "in": "body", - "description": "Pet to add to the store", - "required": true, - "schema": { - "$ref": "NewPet.json" - } - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "$ref": "Pet.json" - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "../common/Error.json" - } - } - } - } - }, - "/pets/{id}": { - "get": { - "description": "Returns a user based on a single ID, if the user does not have access to the pet", - "operationId": "find pet by id", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "ID of pet to fetch", - "required": true, - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "$ref": "Pet.json" - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "../common/Error.json" - } - } - } - }, - "delete": { - "description": "deletes a single pet based on the ID supplied", - "operationId": "deletePet", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "ID of pet to delete", - "required": true, - "type": "integer", - "format": "int64" - } - ], - "responses": { - "204": { - "description": "pet deleted" - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "../common/Error.json" - } - } - } - } - } - } -} diff --git a/examples/v2.0/json/petstore-simple.json b/examples/v2.0/json/petstore-simple.json deleted file mode 100644 index 306dc90c9c..0000000000 --- a/examples/v2.0/json/petstore-simple.json +++ /dev/null @@ -1,222 +0,0 @@ -{ - "swagger": "2.0", - "info": { - "version": "1.0.0", - "title": "Swagger Petstore", - "description": "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification", - "termsOfService": "http://swagger.io/terms/", - "contact": { - "name": "Swagger API Team" - }, - "license": { - "name": "MIT" - } - }, - "host": "petstore.swagger.io", - "basePath": "/api", - "schemes": [ - "http" - ], - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "paths": { - "/pets": { - "get": { - "description": "Returns all pets from the system that the user has access to", - "operationId": "findPets", - "produces": [ - "application/json", - "application/xml", - "text/xml", - "text/html" - ], - "parameters": [ - { - "name": "tags", - "in": "query", - "description": "tags to filter by", - "required": false, - "type": "array", - "items": { - "type": "string" - }, - "collectionFormat": "csv" - }, - { - "name": "limit", - "in": "query", - "description": "maximum number of results to return", - "required": false, - "type": "integer", - "format": "int32" - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "type": "array", - "items": { - "$ref": "#/definitions/Pet" - } - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/ErrorModel" - } - } - } - }, - "post": { - "description": "Creates a new pet in the store. Duplicates are allowed", - "operationId": "addPet", - "produces": [ - "application/json" - ], - "parameters": [ - { - "name": "pet", - "in": "body", - "description": "Pet to add to the store", - "required": true, - "schema": { - "$ref": "#/definitions/NewPet" - } - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "$ref": "#/definitions/Pet" - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/ErrorModel" - } - } - } - } - }, - "/pets/{id}": { - "get": { - "description": "Returns a user based on a single ID, if the user does not have access to the pet", - "operationId": "findPetById", - "produces": [ - "application/json", - "application/xml", - "text/xml", - "text/html" - ], - "parameters": [ - { - "name": "id", - "in": "path", - "description": "ID of pet to fetch", - "required": true, - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "$ref": "#/definitions/Pet" - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/ErrorModel" - } - } - } - }, - "delete": { - "description": "deletes a single pet based on the ID supplied", - "operationId": "deletePet", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "ID of pet to delete", - "required": true, - "type": "integer", - "format": "int64" - } - ], - "responses": { - "204": { - "description": "pet deleted" - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/ErrorModel" - } - } - } - } - } - }, - "definitions": { - "Pet": { - "type": "object", - "allOf": [ - { - "$ref": "#/definitions/NewPet" - }, - { - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64" - } - } - } - ] - }, - "NewPet": { - "type": "object", - "required": [ - "name" - ], - "properties": { - "name": { - "type": "string" - }, - "tag": { - "type": "string" - } - } - }, - "ErrorModel": { - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - } - } - } - } -} \ No newline at end of file diff --git a/examples/v2.0/json/petstore-with-external-docs.json b/examples/v2.0/json/petstore-with-external-docs.json deleted file mode 100644 index e9d3f7765d..0000000000 --- a/examples/v2.0/json/petstore-with-external-docs.json +++ /dev/null @@ -1,233 +0,0 @@ -{ - "swagger": "2.0", - "info": { - "version": "1.0.0", - "title": "Swagger Petstore", - "description": "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification", - "termsOfService": "http://swagger.io/terms/", - "contact": { - "name": "Swagger API Team", - "email": "apiteam@swagger.io", - "url": "http://swagger.io" - }, - "license": { - "name": "Apache 2.0", - "url": "https://www.apache.org/licenses/LICENSE-2.0.html" - } - }, - "externalDocs": { - "description": "find more info here", - "url": "https://swagger.io/about" - }, - "host": "petstore.swagger.io", - "basePath": "/api", - "schemes": [ - "http" - ], - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "paths": { - "/pets": { - "get": { - "description": "Returns all pets from the system that the user has access to", - "operationId": "findPets", - "externalDocs": { - "description": "find more info here", - "url": "https://swagger.io/about" - }, - "produces": [ - "application/json", - "application/xml", - "text/xml", - "text/html" - ], - "parameters": [ - { - "name": "tags", - "in": "query", - "description": "tags to filter by", - "required": false, - "type": "array", - "items": { - "type": "string" - }, - "collectionFormat": "csv" - }, - { - "name": "limit", - "in": "query", - "description": "maximum number of results to return", - "required": false, - "type": "integer", - "format": "int32" - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "type": "array", - "items": { - "$ref": "#/definitions/Pet" - } - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/ErrorModel" - } - } - } - }, - "post": { - "description": "Creates a new pet in the store. Duplicates are allowed", - "operationId": "addPet", - "produces": [ - "application/json" - ], - "parameters": [ - { - "name": "pet", - "in": "body", - "description": "Pet to add to the store", - "required": true, - "schema": { - "$ref": "#/definitions/NewPet" - } - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "$ref": "#/definitions/Pet" - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/ErrorModel" - } - } - } - } - }, - "/pets/{id}": { - "get": { - "description": "Returns a user based on a single ID, if the user does not have access to the pet", - "operationId": "findPetById", - "produces": [ - "application/json", - "application/xml", - "text/xml", - "text/html" - ], - "parameters": [ - { - "name": "id", - "in": "path", - "description": "ID of pet to fetch", - "required": true, - "type": "integer", - "format": "int64" - } - ], - "responses": { - "200": { - "description": "pet response", - "schema": { - "$ref": "#/definitions/Pet" - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/ErrorModel" - } - } - } - }, - "delete": { - "description": "deletes a single pet based on the ID supplied", - "operationId": "deletePet", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "ID of pet to delete", - "required": true, - "type": "integer", - "format": "int64" - } - ], - "responses": { - "204": { - "description": "pet deleted" - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/ErrorModel" - } - } - } - } - } - }, - "definitions": { - "Pet": { - "type": "object", - "allOf": [ - { - "$ref": "#/definitions/NewPet" - }, - { - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64" - } - } - } - ] - }, - "NewPet": { - "type": "object", - "required": [ - "name" - ], - "properties": { - "name": { - "type": "string" - }, - "tag": { - "type": "string" - } - } - }, - "ErrorModel": { - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - } - } - } - } -} diff --git a/examples/v2.0/json/petstore.json b/examples/v2.0/json/petstore.json deleted file mode 100644 index 415eb3f9ae..0000000000 --- a/examples/v2.0/json/petstore.json +++ /dev/null @@ -1,153 +0,0 @@ -{ - "swagger": "2.0", - "info": { - "version": "1.0.0", - "title": "Swagger Petstore", - "license": { - "name": "MIT" - } - }, - "host": "petstore.swagger.io", - "basePath": "/v1", - "schemes": [ - "http" - ], - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "paths": { - "/pets": { - "get": { - "summary": "List all pets", - "operationId": "listPets", - "tags": [ - "pets" - ], - "parameters": [ - { - "name": "limit", - "in": "query", - "description": "How many items to return at one time (max 100)", - "required": false, - "type": "integer", - "format": "int32" - } - ], - "responses": { - "200": { - "description": "An paged array of pets", - "headers": { - "x-next": { - "type": "string", - "description": "A link to the next page of responses" - } - }, - "schema": { - "$ref": "#/definitions/Pets" - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - }, - "post": { - "summary": "Create a pet", - "operationId": "createPets", - "tags": [ - "pets" - ], - "responses": { - "201": { - "description": "Null response" - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - } - }, - "/pets/{petId}": { - "get": { - "summary": "Info for a specific pet", - "operationId": "showPetById", - "tags": [ - "pets" - ], - "parameters": [ - { - "name": "petId", - "in": "path", - "required": true, - "description": "The id of the pet to retrieve", - "type": "string" - } - ], - "responses": { - "200": { - "description": "Expected response to a valid request", - "schema": { - "$ref": "#/definitions/Pets" - } - }, - "default": { - "description": "unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - } - } - }, - "definitions": { - "Pet": { - "required": [ - "id", - "name" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64" - }, - "name": { - "type": "string" - }, - "tag": { - "type": "string" - } - } - }, - "Pets": { - "type": "array", - "items": { - "$ref": "#/definitions/Pet" - } - }, - "Error": { - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - } - } - } - } -} \ No newline at end of file diff --git a/examples/v2.0/json/uber.json b/examples/v2.0/json/uber.json deleted file mode 100644 index 957782897d..0000000000 --- a/examples/v2.0/json/uber.json +++ /dev/null @@ -1,370 +0,0 @@ -{ - "swagger": "2.0", - "info": { - "title": "Uber API", - "description": "Move your app forward with the Uber API", - "version": "1.0.0" - }, - "host": "api.uber.com", - "schemes": [ - "https" - ], - "basePath": "/v1", - "produces": [ - "application/json" - ], - "paths": { - "/products": { - "get": { - "summary": "Product Types", - "description": "The Products endpoint returns information about the Uber products offered at a given location. The response includes the display name and other details about each product, and lists the products in the proper display order.", - "parameters": [ - { - "name": "latitude", - "in": "query", - "description": "Latitude component of location.", - "required": true, - "type": "number", - "format": "double" - }, - { - "name": "longitude", - "in": "query", - "description": "Longitude component of location.", - "required": true, - "type": "number", - "format": "double" - } - ], - "tags": [ - "Products" - ], - "responses": { - "200": { - "description": "An array of products", - "schema": { - "type": "array", - "items": { - "$ref": "#/definitions/Product" - } - } - }, - "default": { - "description": "Unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - } - }, - "/estimates/price": { - "get": { - "summary": "Price Estimates", - "description": "The Price Estimates endpoint returns an estimated price range for each product offered at a given location. The price estimate is provided as a formatted string with the full price range and the localized currency symbol.

            The response also includes low and high estimates, and the [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217) currency code for situations requiring currency conversion. When surge is active for a particular product, its surge_multiplier will be greater than 1, but the price estimate already factors in this multiplier.", - "parameters": [ - { - "name": "start_latitude", - "in": "query", - "description": "Latitude component of start location.", - "required": true, - "type": "number", - "format": "double" - }, - { - "name": "start_longitude", - "in": "query", - "description": "Longitude component of start location.", - "required": true, - "type": "number", - "format": "double" - }, - { - "name": "end_latitude", - "in": "query", - "description": "Latitude component of end location.", - "required": true, - "type": "number", - "format": "double" - }, - { - "name": "end_longitude", - "in": "query", - "description": "Longitude component of end location.", - "required": true, - "type": "number", - "format": "double" - } - ], - "tags": [ - "Estimates" - ], - "responses": { - "200": { - "description": "An array of price estimates by product", - "schema": { - "type": "array", - "items": { - "$ref": "#/definitions/PriceEstimate" - } - } - }, - "default": { - "description": "Unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - } - }, - "/estimates/time": { - "get": { - "summary": "Time Estimates", - "description": "The Time Estimates endpoint returns ETAs for all products offered at a given location, with the responses expressed as integers in seconds. We recommend that this endpoint be called every minute to provide the most accurate, up-to-date ETAs.", - "parameters": [ - { - "name": "start_latitude", - "in": "query", - "description": "Latitude component of start location.", - "required": true, - "type": "number", - "format": "double" - }, - { - "name": "start_longitude", - "in": "query", - "description": "Longitude component of start location.", - "required": true, - "type": "number", - "format": "double" - }, - { - "name": "customer_uuid", - "in": "query", - "type": "string", - "format": "uuid", - "description": "Unique customer identifier to be used for experience customization." - }, - { - "name": "product_id", - "in": "query", - "type": "string", - "description": "Unique identifier representing a specific product for a given latitude & longitude." - } - ], - "tags": [ - "Estimates" - ], - "responses": { - "200": { - "description": "An array of products", - "schema": { - "type": "array", - "items": { - "$ref": "#/definitions/Product" - } - } - }, - "default": { - "description": "Unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - } - }, - "/me": { - "get": { - "summary": "User Profile", - "description": "The User Profile endpoint returns information about the Uber user that has authorized with the application.", - "tags": [ - "User" - ], - "responses": { - "200": { - "description": "Profile information for a user", - "schema": { - "$ref": "#/definitions/Profile" - } - }, - "default": { - "description": "Unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - } - }, - "/history": { - "get": { - "summary": "User Activity", - "description": "The User Activity endpoint returns data about a user's lifetime activity with Uber. The response will include pickup locations and times, dropoff locations and times, the distance of past requests, and information about which products were requested.

            The history array in the response will have a maximum length based on the limit parameter. The response value count may exceed limit, therefore subsequent API requests may be necessary.", - "parameters": [ - { - "name": "offset", - "in": "query", - "type": "integer", - "format": "int32", - "description": "Offset the list of returned results by this amount. Default is zero." - }, - { - "name": "limit", - "in": "query", - "type": "integer", - "format": "int32", - "description": "Number of items to retrieve. Default is 5, maximum is 100." - } - ], - "tags": [ - "User" - ], - "responses": { - "200": { - "description": "History information for the given user", - "schema": { - "$ref": "#/definitions/Activities" - } - }, - "default": { - "description": "Unexpected error", - "schema": { - "$ref": "#/definitions/Error" - } - } - } - } - } - }, - "definitions": { - "Product": { - "properties": { - "product_id": { - "type": "string", - "description": "Unique identifier representing a specific product for a given latitude & longitude. For example, uberX in San Francisco will have a different product_id than uberX in Los Angeles." - }, - "description": { - "type": "string", - "description": "Description of product." - }, - "display_name": { - "type": "string", - "description": "Display name of product." - }, - "capacity": { - "type": "string", - "description": "Capacity of product. For example, 4 people." - }, - "image": { - "type": "string", - "description": "Image URL representing the product." - } - } - }, - "PriceEstimate": { - "properties": { - "product_id": { - "type": "string", - "description": "Unique identifier representing a specific product for a given latitude & longitude. For example, uberX in San Francisco will have a different product_id than uberX in Los Angeles" - }, - "currency_code": { - "type": "string", - "description": "[ISO 4217](http://en.wikipedia.org/wiki/ISO_4217) currency code." - }, - "display_name": { - "type": "string", - "description": "Display name of product." - }, - "estimate": { - "type": "string", - "description": "Formatted string of estimate in local currency of the start location. Estimate could be a range, a single number (flat rate) or \"Metered\" for TAXI." - }, - "low_estimate": { - "type": "number", - "description": "Lower bound of the estimated price." - }, - "high_estimate": { - "type": "number", - "description": "Upper bound of the estimated price." - }, - "surge_multiplier": { - "type": "number", - "description": "Expected surge multiplier. Surge is active if surge_multiplier is greater than 1. Price estimate already factors in the surge multiplier." - } - } - }, - "Profile": { - "properties": { - "first_name": { - "type": "string", - "description": "First name of the Uber user." - }, - "last_name": { - "type": "string", - "description": "Last name of the Uber user." - }, - "email": { - "type": "string", - "description": "Email address of the Uber user" - }, - "picture": { - "type": "string", - "description": "Image URL of the Uber user." - }, - "promo_code": { - "type": "string", - "description": "Promo code of the Uber user." - } - } - }, - "Activity": { - "properties": { - "uuid": { - "type": "string", - "description": "Unique identifier for the activity" - } - } - }, - "Activities": { - "properties": { - "offset": { - "type": "integer", - "format": "int32", - "description": "Position in pagination." - }, - "limit": { - "type": "integer", - "format": "int32", - "description": "Number of items to retrieve (100 max)." - }, - "count": { - "type": "integer", - "format": "int32", - "description": "Total number of items available." - }, - "history": { - "type": "array", - "items": { - "$ref": "#/definitions/Activity" - } - } - } - }, - "Error": { - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - }, - "fields": { - "type": "string" - } - } - } - } -} \ No newline at end of file diff --git a/examples/v2.0/yaml/api-with-examples.yaml b/examples/v2.0/yaml/api-with-examples.yaml deleted file mode 100644 index 2f4a1ccf10..0000000000 --- a/examples/v2.0/yaml/api-with-examples.yaml +++ /dev/null @@ -1,164 +0,0 @@ -swagger: "2.0" -info: - title: Simple API overview - version: v2 -paths: - /: - get: - operationId: listVersionsv2 - summary: List API versions - produces: - - application/json - responses: - "200": - description: |- - 200 300 response - examples: - application/json: |- - { - "versions": [ - { - "status": "CURRENT", - "updated": "2011-01-21T11:33:21Z", - "id": "v2.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v2/", - "rel": "self" - } - ] - }, - { - "status": "EXPERIMENTAL", - "updated": "2013-07-23T11:33:21Z", - "id": "v3.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v3/", - "rel": "self" - } - ] - } - ] - } - "300": - description: |- - 200 300 response - examples: - application/json: |- - { - "versions": [ - { - "status": "CURRENT", - "updated": "2011-01-21T11:33:21Z", - "id": "v2.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v2/", - "rel": "self" - } - ] - }, - { - "status": "EXPERIMENTAL", - "updated": "2013-07-23T11:33:21Z", - "id": "v3.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v3/", - "rel": "self" - } - ] - } - ] - } - /v2: - get: - operationId: getVersionDetailsv2 - summary: Show API version details - produces: - - application/json - responses: - "200": - description: |- - 200 203 response - examples: - application/json: |- - { - "version": { - "status": "CURRENT", - "updated": "2011-01-21T11:33:21Z", - "media-types": [ - { - "base": "application/xml", - "type": "application/vnd.openstack.compute+xml;version=2" - }, - { - "base": "application/json", - "type": "application/vnd.openstack.compute+json;version=2" - } - ], - "id": "v2.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v2/", - "rel": "self" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf", - "type": "application/pdf", - "rel": "describedby" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl", - "type": "application/vnd.sun.wadl+xml", - "rel": "describedby" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl", - "type": "application/vnd.sun.wadl+xml", - "rel": "describedby" - } - ] - } - } - "203": - description: |- - 200 203 response - examples: - application/json: |- - { - "version": { - "status": "CURRENT", - "updated": "2011-01-21T11:33:21Z", - "media-types": [ - { - "base": "application/xml", - "type": "application/vnd.openstack.compute+xml;version=2" - }, - { - "base": "application/json", - "type": "application/vnd.openstack.compute+json;version=2" - } - ], - "id": "v2.0", - "links": [ - { - "href": "http://23.253.228.211:8774/v2/", - "rel": "self" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf", - "type": "application/pdf", - "rel": "describedby" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl", - "type": "application/vnd.sun.wadl+xml", - "rel": "describedby" - } - ] - } - } -consumes: -- application/json diff --git a/examples/v2.0/yaml/petstore-expanded.yaml b/examples/v2.0/yaml/petstore-expanded.yaml deleted file mode 100644 index de93377412..0000000000 --- a/examples/v2.0/yaml/petstore-expanded.yaml +++ /dev/null @@ -1,142 +0,0 @@ -swagger: "2.0" -info: - version: 1.0.0 - title: Swagger Petstore - description: A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification - termsOfService: http://swagger.io/terms/ - contact: - name: Swagger API Team - email: apiteam@swagger.io - url: http://swagger.io - license: - name: Apache 2.0 - url: https://www.apache.org/licenses/LICENSE-2.0.html -host: petstore.swagger.io -basePath: /api -schemes: - - http -consumes: - - application/json -produces: - - application/json -paths: - /pets: - get: - description: | - Returns all pets from the system that the user has access to - operationId: findPets - parameters: - - name: tags - in: query - description: tags to filter by - required: false - type: array - collectionFormat: csv - items: - type: string - - name: limit - in: query - description: maximum number of results to return - required: false - type: integer - format: int32 - responses: - "200": - description: pet response - schema: - type: array - items: - $ref: '#/definitions/Pet' - default: - description: unexpected error - schema: - $ref: '#/definitions/Error' - post: - description: Creates a new pet in the store. Duplicates are allowed - operationId: addPet - parameters: - - name: pet - in: body - description: Pet to add to the store - required: true - schema: - $ref: '#/definitions/NewPet' - responses: - "200": - description: pet response - schema: - $ref: '#/definitions/Pet' - default: - description: unexpected error - schema: - $ref: '#/definitions/Error' - /pets/{id}: - get: - description: Returns a user based on a single ID, if the user does not have access to the pet - operationId: find pet by id - parameters: - - name: id - in: path - description: ID of pet to fetch - required: true - type: integer - format: int64 - responses: - "200": - description: pet response - schema: - $ref: '#/definitions/Pet' - default: - description: unexpected error - schema: - $ref: '#/definitions/Error' - delete: - description: deletes a single pet based on the ID supplied - operationId: deletePet - parameters: - - name: id - in: path - description: ID of pet to delete - required: true - type: integer - format: int64 - responses: - "204": - description: pet deleted - default: - description: unexpected error - schema: - $ref: '#/definitions/Error' -definitions: - Pet: - allOf: - - $ref: '#/definitions/NewPet' - - required: - - id - type: "object" - properties: - id: - type: integer - format: int64 - - NewPet: - type: "object" - required: - - name - properties: - name: - type: string - tag: - type: string - - Error: - type: "object" - required: - - code - - message - properties: - code: - type: integer - format: int32 - message: - type: string diff --git a/examples/v2.0/yaml/petstore-minimal.yaml b/examples/v2.0/yaml/petstore-minimal.yaml deleted file mode 100644 index c3e06e9152..0000000000 --- a/examples/v2.0/yaml/petstore-minimal.yaml +++ /dev/null @@ -1,47 +0,0 @@ ---- - swagger: "2.0" - info: - version: "1.0.0" - title: "Swagger Petstore" - description: "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification" - termsOfService: "http://swagger.io/terms/" - contact: - name: "Swagger API Team" - license: - name: "MIT" - host: "petstore.swagger.io" - basePath: "/api" - schemes: - - "http" - consumes: - - "application/json" - produces: - - "application/json" - paths: - /pets: - get: - description: "Returns all pets from the system that the user has access to" - produces: - - "application/json" - responses: - "200": - description: "A list of pets." - schema: - type: "array" - items: - $ref: "#/definitions/Pet" - definitions: - Pet: - type: "object" - required: - - "id" - - "name" - properties: - id: - type: "integer" - format: "int64" - name: - type: "string" - tag: - type: "string" - diff --git a/examples/v2.0/yaml/petstore-separate/common/Error.yaml b/examples/v2.0/yaml/petstore-separate/common/Error.yaml deleted file mode 100644 index 2d87b744fb..0000000000 --- a/examples/v2.0/yaml/petstore-separate/common/Error.yaml +++ /dev/null @@ -1,10 +0,0 @@ -type: object -required: - - code - - message -properties: - code: - type: integer - format: int32 - message: - type: string diff --git a/examples/v2.0/yaml/petstore-separate/spec/NewPet.yaml b/examples/v2.0/yaml/petstore-separate/spec/NewPet.yaml deleted file mode 100644 index 35e67449c5..0000000000 --- a/examples/v2.0/yaml/petstore-separate/spec/NewPet.yaml +++ /dev/null @@ -1,9 +0,0 @@ -type: object -allOf: - - $ref: 'Pet.yaml' - - required: - - name - properties: - description: - type: integer - format: int64 diff --git a/examples/v2.0/yaml/petstore-separate/spec/Pet.yaml b/examples/v2.0/yaml/petstore-separate/spec/Pet.yaml deleted file mode 100644 index bb113196f1..0000000000 --- a/examples/v2.0/yaml/petstore-separate/spec/Pet.yaml +++ /dev/null @@ -1,12 +0,0 @@ -type: object -required: - - id - - name -properties: - id: - type: integer - format: int64 - name: - type: string - tag: - type: string diff --git a/examples/v2.0/yaml/petstore-separate/spec/parameters.yaml b/examples/v2.0/yaml/petstore-separate/spec/parameters.yaml deleted file mode 100644 index 18736aebd0..0000000000 --- a/examples/v2.0/yaml/petstore-separate/spec/parameters.yaml +++ /dev/null @@ -1,16 +0,0 @@ -tagsParam: - name: tags - in: query - description: tags to filter by - required: false - type: array - collectionFormat: csv - items: - type: string -limitsParam: - name: limit - in: query - description: maximum number of results to return - required: false - type: integer - format: int32 diff --git a/examples/v2.0/yaml/petstore-separate/spec/swagger.yaml b/examples/v2.0/yaml/petstore-separate/spec/swagger.yaml deleted file mode 100644 index b937b5022a..0000000000 --- a/examples/v2.0/yaml/petstore-separate/spec/swagger.yaml +++ /dev/null @@ -1,100 +0,0 @@ -swagger: "2.0" -info: - version: 1.0.0 - title: Swagger Petstore - description: A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification - termsOfService: http://swagger.io/terms/ - contact: - name: Swagger API Team - email: apiteam@swagger.io - url: http://swagger.io - license: - name: Apache 2.0 - url: https://www.apache.org/licenses/LICENSE-2.0.html -host: petstore.swagger.io -basePath: /api -schemes: - - http -consumes: - - application/json -produces: - - application/json -paths: - /pets: - get: - description: | - Returns all pets from the system that the user has access to - Nam sed condimentum est. Maecenas tempor sagittis sapien, nec rhoncus sem sagittis sit amet. Aenean at gravida augue, ac iaculis sem. Curabitur odio lorem, ornare eget elementum nec, cursus id lectus. Duis mi turpis, pulvinar ac eros ac, tincidunt varius justo. In hac habitasse platea dictumst. Integer at adipiscing ante, a sagittis ligula. Aenean pharetra tempor ante molestie imperdiet. Vivamus id aliquam diam. Cras quis velit non tortor eleifend sagittis. Praesent at enim pharetra urna volutpat venenatis eget eget mauris. In eleifend fermentum facilisis. Praesent enim enim, gravida ac sodales sed, placerat id erat. Suspendisse lacus dolor, consectetur non augue vel, vehicula interdum libero. Morbi euismod sagittis libero sed lacinia. - - Sed tempus felis lobortis leo pulvinar rutrum. Nam mattis velit nisl, eu condimentum ligula luctus nec. Phasellus semper velit eget aliquet faucibus. In a mattis elit. Phasellus vel urna viverra, condimentum lorem id, rhoncus nibh. Ut pellentesque posuere elementum. Sed a varius odio. Morbi rhoncus ligula libero, vel eleifend nunc tristique vitae. Fusce et sem dui. Aenean nec scelerisque tortor. Fusce malesuada accumsan magna vel tempus. Quisque mollis felis eu dolor tristique, sit amet auctor felis gravida. Sed libero lorem, molestie sed nisl in, accumsan tempor nisi. Fusce sollicitudin massa ut lacinia mattis. Sed vel eleifend lorem. Pellentesque vitae felis pretium, pulvinar elit eu, euismod sapien. - operationId: findPets - parameters: - - $ref: 'parameters.yaml#/tagsParam' - - $ref: 'parameters.yaml#/limitsParam' - responses: - "200": - description: pet response - schema: - type: array - items: - $ref: 'Pet.yaml' - default: - description: unexpected error - schema: - $ref: '../common/Error.yaml' - post: - description: Creates a new pet in the store. Duplicates are allowed - operationId: addPet - parameters: - - name: pet - in: body - description: Pet to add to the store - required: true - schema: - $ref: 'NewPet.yaml' - responses: - "200": - description: pet response - schema: - $ref: 'Pet.yaml' - default: - description: unexpected error - schema: - $ref: '../common/Error.yaml' - /pets/{id}: - get: - description: Returns a user based on a single ID, if the user does not have access to the pet - operationId: find pet by id - parameters: - - name: id - in: path - description: ID of pet to fetch - required: true - type: integer - format: int64 - responses: - "200": - description: pet response - schema: - $ref: 'Pet.yaml' - default: - description: unexpected error - schema: - $ref: '../common/Error.yaml' - delete: - description: deletes a single pet based on the ID supplied - operationId: deletePet - parameters: - - name: id - in: path - description: ID of pet to delete - required: true - type: integer - format: int64 - responses: - "204": - description: pet deleted - default: - description: unexpected error - schema: - $ref: '../common/Error.yaml' diff --git a/examples/v2.0/yaml/petstore-simple.yaml b/examples/v2.0/yaml/petstore-simple.yaml deleted file mode 100644 index d5fa07b428..0000000000 --- a/examples/v2.0/yaml/petstore-simple.yaml +++ /dev/null @@ -1,157 +0,0 @@ ---- - swagger: "2.0" - info: - version: "1.0.0" - title: "Swagger Petstore" - description: "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification" - termsOfService: "http://swagger.io/terms/" - contact: - name: "Swagger API Team" - license: - name: "MIT" - host: "petstore.swagger.io" - basePath: "/api" - schemes: - - "http" - consumes: - - "application/json" - produces: - - "application/json" - paths: - /pets: - get: - description: "Returns all pets from the system that the user has access to" - operationId: "findPets" - produces: - - "application/json" - - "application/xml" - - "text/xml" - - "text/html" - parameters: - - - name: "tags" - in: "query" - description: "tags to filter by" - required: false - type: "array" - items: - type: "string" - collectionFormat: "csv" - - - name: "limit" - in: "query" - description: "maximum number of results to return" - required: false - type: "integer" - format: "int32" - responses: - "200": - description: "pet response" - schema: - type: "array" - items: - $ref: "#/definitions/Pet" - default: - description: "unexpected error" - schema: - $ref: "#/definitions/ErrorModel" - post: - description: "Creates a new pet in the store. Duplicates are allowed" - operationId: "addPet" - produces: - - "application/json" - parameters: - - - name: "pet" - in: "body" - description: "Pet to add to the store" - required: true - schema: - $ref: "#/definitions/NewPet" - responses: - "200": - description: "pet response" - schema: - $ref: "#/definitions/Pet" - default: - description: "unexpected error" - schema: - $ref: "#/definitions/ErrorModel" - /pets/{id}: - get: - description: "Returns a user based on a single ID, if the user does not have access to the pet" - operationId: "findPetById" - produces: - - "application/json" - - "application/xml" - - "text/xml" - - "text/html" - parameters: - - - name: "id" - in: "path" - description: "ID of pet to fetch" - required: true - type: "integer" - format: "int64" - responses: - "200": - description: "pet response" - schema: - $ref: "#/definitions/Pet" - default: - description: "unexpected error" - schema: - $ref: "#/definitions/ErrorModel" - delete: - description: "deletes a single pet based on the ID supplied" - operationId: "deletePet" - parameters: - - - name: "id" - in: "path" - description: "ID of pet to delete" - required: true - type: "integer" - format: "int64" - responses: - "204": - description: "pet deleted" - default: - description: "unexpected error" - schema: - $ref: "#/definitions/ErrorModel" - definitions: - Pet: - type: "object" - allOf: - - - $ref: "#/definitions/NewPet" - - - required: - - "id" - properties: - id: - type: "integer" - format: "int64" - NewPet: - type: "object" - required: - - "name" - properties: - name: - type: "string" - tag: - type: "string" - ErrorModel: - type: "object" - required: - - "code" - - "message" - properties: - code: - type: "integer" - format: "int32" - message: - type: "string" - diff --git a/examples/v2.0/yaml/petstore-with-external-docs.yaml b/examples/v2.0/yaml/petstore-with-external-docs.yaml deleted file mode 100644 index 792864fca0..0000000000 --- a/examples/v2.0/yaml/petstore-with-external-docs.yaml +++ /dev/null @@ -1,166 +0,0 @@ ---- - swagger: "2.0" - info: - version: "1.0.0" - title: "Swagger Petstore" - description: "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification" - termsOfService: "http://swagger.io/terms/" - contact: - name: "Swagger API Team" - email: "apiteam@swagger.io" - url: "http://swagger.io" - license: - name: "Apache 2.0" - url: "https://www.apache.org/licenses/LICENSE-2.0.html" - externalDocs: - description: "find more info here" - url: "https://swagger.io/about" - host: "petstore.swagger.io" - basePath: "/api" - schemes: - - "http" - consumes: - - "application/json" - produces: - - "application/json" - paths: - /pets: - get: - description: "Returns all pets from the system that the user has access to" - operationId: "findPets" - externalDocs: - description: "find more info here" - url: "https://swagger.io/about" - produces: - - "application/json" - - "application/xml" - - "text/xml" - - "text/html" - parameters: - - - name: "tags" - in: "query" - description: "tags to filter by" - required: false - type: "array" - items: - type: "string" - collectionFormat: "csv" - - - name: "limit" - in: "query" - description: "maximum number of results to return" - required: false - type: "integer" - format: "int32" - responses: - "200": - description: "pet response" - schema: - type: "array" - items: - $ref: "#/definitions/Pet" - default: - description: "unexpected error" - schema: - $ref: "#/definitions/ErrorModel" - post: - description: "Creates a new pet in the store. Duplicates are allowed" - operationId: "addPet" - produces: - - "application/json" - parameters: - - - name: "pet" - in: "body" - description: "Pet to add to the store" - required: true - schema: - $ref: "#/definitions/NewPet" - responses: - "200": - description: "pet response" - schema: - $ref: "#/definitions/Pet" - default: - description: "unexpected error" - schema: - $ref: "#/definitions/ErrorModel" - /pets/{id}: - get: - description: "Returns a user based on a single ID, if the user does not have access to the pet" - operationId: "findPetById" - produces: - - "application/json" - - "application/xml" - - "text/xml" - - "text/html" - parameters: - - - name: "id" - in: "path" - description: "ID of pet to fetch" - required: true - type: "integer" - format: "int64" - responses: - "200": - description: "pet response" - schema: - $ref: "#/definitions/Pet" - default: - description: "unexpected error" - schema: - $ref: "#/definitions/ErrorModel" - delete: - description: "deletes a single pet based on the ID supplied" - operationId: "deletePet" - parameters: - - - name: "id" - in: "path" - description: "ID of pet to delete" - required: true - type: "integer" - format: "int64" - responses: - "204": - description: "pet deleted" - default: - description: "unexpected error" - schema: - $ref: "#/definitions/ErrorModel" - definitions: - Pet: - type: "object" - allOf: - - - $ref: "#/definitions/NewPet" - - - required: - - "id" - properties: - id: - type: "integer" - format: "int64" - NewPet: - type: "object" - required: - - "name" - properties: - name: - type: "string" - tag: - type: "string" - ErrorModel: - type: "object" - required: - - "code" - - "message" - properties: - code: - type: "integer" - format: "int32" - message: - type: "string" - diff --git a/examples/v2.0/yaml/petstore.yaml b/examples/v2.0/yaml/petstore.yaml deleted file mode 100644 index 5f41fe091f..0000000000 --- a/examples/v2.0/yaml/petstore.yaml +++ /dev/null @@ -1,103 +0,0 @@ -swagger: "2.0" -info: - version: 1.0.0 - title: Swagger Petstore - license: - name: MIT -host: petstore.swagger.io -basePath: /v1 -schemes: - - http -consumes: - - application/json -produces: - - application/json -paths: - /pets: - get: - summary: List all pets - operationId: listPets - tags: - - pets - parameters: - - name: limit - in: query - description: How many items to return at one time (max 100) - required: false - type: integer - format: int32 - responses: - "200": - description: A paged array of pets - headers: - x-next: - type: string - description: A link to the next page of responses - schema: - $ref: '#/definitions/Pets' - default: - description: unexpected error - schema: - $ref: '#/definitions/Error' - post: - summary: Create a pet - operationId: createPets - tags: - - pets - responses: - "201": - description: Null response - default: - description: unexpected error - schema: - $ref: '#/definitions/Error' - /pets/{petId}: - get: - summary: Info for a specific pet - operationId: showPetById - tags: - - pets - parameters: - - name: petId - in: path - required: true - description: The id of the pet to retrieve - type: string - responses: - "200": - description: Expected response to a valid request - schema: - $ref: '#/definitions/Pets' - default: - description: unexpected error - schema: - $ref: '#/definitions/Error' -definitions: - Pet: - type: "object" - required: - - id - - name - properties: - id: - type: integer - format: int64 - name: - type: string - tag: - type: string - Pets: - type: array - items: - $ref: '#/definitions/Pet' - Error: - type: "object" - required: - - code - - message - properties: - code: - type: integer - format: int32 - message: - type: string diff --git a/examples/v2.0/yaml/uber.yaml b/examples/v2.0/yaml/uber.yaml deleted file mode 100644 index 12c14b08aa..0000000000 --- a/examples/v2.0/yaml/uber.yaml +++ /dev/null @@ -1,273 +0,0 @@ -# this is an example of the Uber API -# as a demonstration of an API spec in YAML -swagger: "2.0" -info: - title: Uber API - description: Move your app forward with the Uber API - version: "1.0.0" -# the domain of the service -host: api.uber.com -# array of all schemes that your API supports -schemes: - - https -# will be prefixed to all paths -basePath: /v1 -securityDefinitions: - apikey: - type: apiKey - name: server_token - in: query -produces: - - application/json -paths: - /products: - get: - summary: Product Types - description: The Products endpoint returns information about the Uber products offered at a given location. The response includes the display name and other details about each product, and lists the products in the proper display order. - parameters: - - name: latitude - in: query - description: Latitude component of location. - required: true - type: number - format: double - - name: longitude - in: query - description: Longitude component of location. - required: true - type: number - format: double - security: - - apikey: [] - tags: - - Products - responses: - "200": - description: An array of products - schema: - type: array - items: - $ref: '#/definitions/Product' - default: - description: Unexpected error - schema: - $ref: '#/definitions/Error' - /estimates/price: - get: - summary: Price Estimates - description: The Price Estimates endpoint returns an estimated price range for each product offered at a given location. The price estimate is provided as a formatted string with the full price range and the localized currency symbol.

            The response also includes low and high estimates, and the [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217) currency code for situations requiring currency conversion. When surge is active for a particular product, its surge_multiplier will be greater than 1, but the price estimate already factors in this multiplier. - parameters: - - name: start_latitude - in: query - description: Latitude component of start location. - required: true - type: number - format: double - - name: start_longitude - in: query - description: Longitude component of start location. - required: true - type: number - format: double - - name: end_latitude - in: query - description: Latitude component of end location. - required: true - type: number - format: double - - name: end_longitude - in: query - description: Longitude component of end location. - required: true - type: number - format: double - tags: - - Estimates - responses: - "200": - description: An array of price estimates by product - schema: - type: array - items: - $ref: '#/definitions/PriceEstimate' - default: - description: Unexpected error - schema: - $ref: '#/definitions/Error' - /estimates/time: - get: - summary: Time Estimates - description: The Time Estimates endpoint returns ETAs for all products offered at a given location, with the responses expressed as integers in seconds. We recommend that this endpoint be called every minute to provide the most accurate, up-to-date ETAs. - parameters: - - name: start_latitude - in: query - description: Latitude component of start location. - required: true - type: number - format: double - - name: start_longitude - in: query - description: Longitude component of start location. - required: true - type: number - format: double - - name: customer_uuid - in: query - type: string - format: uuid - description: Unique customer identifier to be used for experience customization. - - name: product_id - in: query - type: string - description: Unique identifier representing a specific product for a given latitude & longitude. - tags: - - Estimates - responses: - "200": - description: An array of products - schema: - type: array - items: - $ref: '#/definitions/Product' - default: - description: Unexpected error - schema: - $ref: '#/definitions/Error' - /me: - get: - summary: User Profile - description: The User Profile endpoint returns information about the Uber user that has authorized with the application. - tags: - - User - responses: - "200": - description: Profile information for a user - schema: - $ref: '#/definitions/Profile' - default: - description: Unexpected error - schema: - $ref: '#/definitions/Error' - /history: - get: - summary: User Activity - description: The User Activity endpoint returns data about a user's lifetime activity with Uber. The response will include pickup locations and times, dropoff locations and times, the distance of past requests, and information about which products were requested.

            The history array in the response will have a maximum length based on the limit parameter. The response value count may exceed limit, therefore subsequent API requests may be necessary. - parameters: - - name: offset - in: query - type: integer - format: int32 - description: Offset the list of returned results by this amount. Default is zero. - - name: limit - in: query - type: integer - format: int32 - description: Number of items to retrieve. Default is 5, maximum is 100. - tags: - - User - responses: - "200": - description: History information for the given user - schema: - $ref: '#/definitions/Activities' - default: - description: Unexpected error - schema: - $ref: '#/definitions/Error' -definitions: - Product: - properties: - product_id: - type: string - description: Unique identifier representing a specific product for a given latitude & longitude. For example, uberX in San Francisco will have a different product_id than uberX in Los Angeles. - description: - type: string - description: Description of product. - display_name: - type: string - description: Display name of product. - capacity: - type: integer - description: Capacity of product. For example, 4 people. - image: - type: string - description: Image URL representing the product. - ProductList: - properties: - products: - description: Contains the list of products - type: array - items: - $ref: "#/definitions/Product" - PriceEstimate: - properties: - product_id: - type: string - description: Unique identifier representing a specific product for a given latitude & longitude. For example, uberX in San Francisco will have a different product_id than uberX in Los Angeles - currency_code: - type: string - description: "[ISO 4217](http://en.wikipedia.org/wiki/ISO_4217) currency code." - display_name: - type: string - description: Display name of product. - estimate: - type: string - description: Formatted string of estimate in local currency of the start location. Estimate could be a range, a single number (flat rate) or "Metered" for TAXI. - low_estimate: - type: number - description: Lower bound of the estimated price. - high_estimate: - type: number - description: Upper bound of the estimated price. - surge_multiplier: - type: number - description: Expected surge multiplier. Surge is active if surge_multiplier is greater than 1. Price estimate already factors in the surge multiplier. - Profile: - properties: - first_name: - type: string - description: First name of the Uber user. - last_name: - type: string - description: Last name of the Uber user. - email: - type: string - description: Email address of the Uber user - picture: - type: string - description: Image URL of the Uber user. - promo_code: - type: string - description: Promo code of the Uber user. - Activity: - properties: - uuid: - type: string - description: Unique identifier for the activity - Activities: - properties: - offset: - type: integer - format: int32 - description: Position in pagination. - limit: - type: integer - format: int32 - description: Number of items to retrieve (100 max). - count: - type: integer - format: int32 - description: Total number of items available. - history: - type: array - items: - $ref: '#/definitions/Activity' - Error: - properties: - code: - type: integer - format: int32 - message: - type: string - fields: - type: string diff --git a/examples/v3.0/api-with-examples.json b/examples/v3.0/api-with-examples.json deleted file mode 100644 index 0fd2077b3e..0000000000 --- a/examples/v3.0/api-with-examples.json +++ /dev/null @@ -1,167 +0,0 @@ -{ - "openapi": "3.0.0", - "info": { - "title": "Simple API overview", - "version": "2.0.0" - }, - "paths": { - "/": { - "get": { - "operationId": "listVersionsv2", - "summary": "List API versions", - "responses": { - "200": { - "description": "200 response", - "content": { - "application/json": { - "examples": { - "foo": { - "value": { - "versions": [ - { - "status": "CURRENT", - "updated": "2011-01-21T11:33:21Z", - "id": "v2.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v2/", - "rel": "self" - } - ] - }, - { - "status": "EXPERIMENTAL", - "updated": "2013-07-23T11:33:21Z", - "id": "v3.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v3/", - "rel": "self" - } - ] - } - ] - } - } - } - } - } - }, - "300": { - "description": "300 response", - "content": { - "application/json": { - "examples": { - "foo": { - "value": "{\n \"versions\": [\n {\n \"status\": \"CURRENT\",\n \"updated\": \"2011-01-21T11:33:21Z\",\n \"id\": \"v2.0\",\n \"links\": [\n {\n \"href\": \"http://127.0.0.1:8774/v2/\",\n \"rel\": \"self\"\n }\n ]\n },\n {\n \"status\": \"EXPERIMENTAL\",\n \"updated\": \"2013-07-23T11:33:21Z\",\n \"id\": \"v3.0\",\n \"links\": [\n {\n \"href\": \"http://127.0.0.1:8774/v3/\",\n \"rel\": \"self\"\n }\n ]\n }\n ]\n}\n" - } - } - } - } - } - } - } - }, - "/v2": { - "get": { - "operationId": "getVersionDetailsv2", - "summary": "Show API version details", - "responses": { - "200": { - "description": "200 response", - "content": { - "application/json": { - "examples": { - "foo": { - "value": { - "version": { - "status": "CURRENT", - "updated": "2011-01-21T11:33:21Z", - "media-types": [ - { - "base": "application/xml", - "type": "application/vnd.openstack.compute+xml;version=2" - }, - { - "base": "application/json", - "type": "application/vnd.openstack.compute+json;version=2" - } - ], - "id": "v2.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v2/", - "rel": "self" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf", - "type": "application/pdf", - "rel": "describedby" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl", - "type": "application/vnd.sun.wadl+xml", - "rel": "describedby" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl", - "type": "application/vnd.sun.wadl+xml", - "rel": "describedby" - } - ] - } - } - } - } - } - } - }, - "203": { - "description": "203 response", - "content": { - "application/json": { - "examples": { - "foo": { - "value": { - "version": { - "status": "CURRENT", - "updated": "2011-01-21T11:33:21Z", - "media-types": [ - { - "base": "application/xml", - "type": "application/vnd.openstack.compute+xml;version=2" - }, - { - "base": "application/json", - "type": "application/vnd.openstack.compute+json;version=2" - } - ], - "id": "v2.0", - "links": [ - { - "href": "http://23.253.228.211:8774/v2/", - "rel": "self" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf", - "type": "application/pdf", - "rel": "describedby" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl", - "type": "application/vnd.sun.wadl+xml", - "rel": "describedby" - } - ] - } - } - } - } - } - } - } - } - } - } - } -} \ No newline at end of file diff --git a/examples/v3.0/api-with-examples.yaml b/examples/v3.0/api-with-examples.yaml deleted file mode 100644 index 18726a5476..0000000000 --- a/examples/v3.0/api-with-examples.yaml +++ /dev/null @@ -1,170 +0,0 @@ -openapi: "3.0.0" -info: - title: Simple API overview - version: 2.0.0 -paths: - /: - get: - operationId: listVersionsv2 - summary: List API versions - responses: - '200': - description: |- - 200 response - content: - application/json: - examples: - foo: - value: - { - "versions": [ - { - "status": "CURRENT", - "updated": "2011-01-21T11:33:21Z", - "id": "v2.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v2/", - "rel": "self" - } - ] - }, - { - "status": "EXPERIMENTAL", - "updated": "2013-07-23T11:33:21Z", - "id": "v3.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v3/", - "rel": "self" - } - ] - } - ] - } - '300': - description: |- - 300 response - content: - application/json: - examples: - foo: - value: | - { - "versions": [ - { - "status": "CURRENT", - "updated": "2011-01-21T11:33:21Z", - "id": "v2.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v2/", - "rel": "self" - } - ] - }, - { - "status": "EXPERIMENTAL", - "updated": "2013-07-23T11:33:21Z", - "id": "v3.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v3/", - "rel": "self" - } - ] - } - ] - } - /v2: - get: - operationId: getVersionDetailsv2 - summary: Show API version details - responses: - '200': - description: |- - 200 response - content: - application/json: - examples: - foo: - value: - { - "version": { - "status": "CURRENT", - "updated": "2011-01-21T11:33:21Z", - "media-types": [ - { - "base": "application/xml", - "type": "application/vnd.openstack.compute+xml;version=2" - }, - { - "base": "application/json", - "type": "application/vnd.openstack.compute+json;version=2" - } - ], - "id": "v2.0", - "links": [ - { - "href": "http://127.0.0.1:8774/v2/", - "rel": "self" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf", - "type": "application/pdf", - "rel": "describedby" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl", - "type": "application/vnd.sun.wadl+xml", - "rel": "describedby" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl", - "type": "application/vnd.sun.wadl+xml", - "rel": "describedby" - } - ] - } - } - '203': - description: |- - 203 response - content: - application/json: - examples: - foo: - value: - { - "version": { - "status": "CURRENT", - "updated": "2011-01-21T11:33:21Z", - "media-types": [ - { - "base": "application/xml", - "type": "application/vnd.openstack.compute+xml;version=2" - }, - { - "base": "application/json", - "type": "application/vnd.openstack.compute+json;version=2" - } - ], - "id": "v2.0", - "links": [ - { - "href": "http://23.253.228.211:8774/v2/", - "rel": "self" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/os-compute-devguide-2.pdf", - "type": "application/pdf", - "rel": "describedby" - }, - { - "href": "http://docs.openstack.org/api/openstack-compute/2/wadl/os-compute-2.wadl", - "type": "application/vnd.sun.wadl+xml", - "rel": "describedby" - } - ] - } - } diff --git a/examples/v3.0/callback-example.json b/examples/v3.0/callback-example.json deleted file mode 100644 index 9a4df39b45..0000000000 --- a/examples/v3.0/callback-example.json +++ /dev/null @@ -1,84 +0,0 @@ -{ - "openapi": "3.0.0", - "info": { - "title": "Callback Example", - "version": "1.0.0" - }, - "paths": { - "/streams": { - "post": { - "description": "subscribes a client to receive out-of-band data", - "parameters": [ - { - "name": "callbackUrl", - "in": "query", - "required": true, - "description": "the location where data will be sent. Must be network accessible\nby the source server\n", - "schema": { - "type": "string", - "format": "uri", - "example": "https://tonys-server.com" - } - } - ], - "responses": { - "201": { - "description": "subscription successfully created", - "content": { - "application/json": { - "schema": { - "description": "subscription information", - "required": [ - "subscriptionId" - ], - "properties": { - "subscriptionId": { - "description": "this unique identifier allows management of the subscription", - "type": "string", - "example": "2531329f-fb09-4ef7-887e-84e648214436" - } - } - } - } - } - } - }, - "callbacks": { - "onData": { - "{$request.query.callbackUrl}/data": { - "post": { - "requestBody": { - "description": "subscription payload", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "timestamp": { - "type": "string", - "format": "date-time" - }, - "userData": { - "type": "string" - } - } - } - } - } - }, - "responses": { - "202": { - "description": "Your server implementation should return this HTTP status code\nif the data was received successfully\n" - }, - "204": { - "description": "Your server should return this HTTP status code if no longer interested\nin further updates\n" - } - } - } - } - } - } - } - } - } -} \ No newline at end of file diff --git a/examples/v3.0/callback-example.yaml b/examples/v3.0/callback-example.yaml deleted file mode 100644 index 262b8df518..0000000000 --- a/examples/v3.0/callback-example.yaml +++ /dev/null @@ -1,61 +0,0 @@ -openapi: 3.0.0 -info: - title: Callback Example - version: 1.0.0 -paths: - /streams: - post: - description: subscribes a client to receive out-of-band data - parameters: - - name: callbackUrl - in: query - required: true - description: | - the location where data will be sent. Must be network accessible - by the source server - schema: - type: string - format: uri - example: https://tonys-server.com - responses: - '201': - description: subscription successfully created - content: - application/json: - schema: - description: subscription information - required: - - subscriptionId - properties: - subscriptionId: - description: this unique identifier allows management of the subscription - type: string - example: 2531329f-fb09-4ef7-887e-84e648214436 - callbacks: - # the name `onData` is a convenience locator - onData: - # when data is sent, it will be sent to the `callbackUrl` provided - # when making the subscription PLUS the suffix `/data` - '{$request.query.callbackUrl}/data': - post: - requestBody: - description: subscription payload - content: - application/json: - schema: - type: object - properties: - timestamp: - type: string - format: date-time - userData: - type: string - responses: - '202': - description: | - Your server implementation should return this HTTP status code - if the data was received successfully - '204': - description: | - Your server should return this HTTP status code if no longer interested - in further updates diff --git a/examples/v3.0/link-example.json b/examples/v3.0/link-example.json deleted file mode 100644 index bc98e635f1..0000000000 --- a/examples/v3.0/link-example.json +++ /dev/null @@ -1,323 +0,0 @@ -{ - "openapi": "3.0.0", - "info": { - "title": "Link Example", - "version": "1.0.0" - }, - "paths": { - "/2.0/users/{username}": { - "get": { - "operationId": "getUserByName", - "parameters": [ - { - "name": "username", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "The User", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/user" - } - } - }, - "links": { - "userRepositories": { - "$ref": "#/components/links/UserRepositories" - } - } - } - } - } - }, - "/2.0/repositories/{username}": { - "get": { - "operationId": "getRepositoriesByOwner", - "parameters": [ - { - "name": "username", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "repositories owned by the supplied user", - "content": { - "application/json": { - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/repository" - } - } - } - }, - "links": { - "userRepository": { - "$ref": "#/components/links/UserRepository" - } - } - } - } - } - }, - "/2.0/repositories/{username}/{slug}": { - "get": { - "operationId": "getRepository", - "parameters": [ - { - "name": "username", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "slug", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "The repository", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/repository" - } - } - }, - "links": { - "repositoryPullRequests": { - "$ref": "#/components/links/RepositoryPullRequests" - } - } - } - } - } - }, - "/2.0/repositories/{username}/{slug}/pullrequests": { - "get": { - "operationId": "getPullRequestsByRepository", - "parameters": [ - { - "name": "username", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "slug", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "state", - "in": "query", - "schema": { - "type": "string", - "enum": [ - "open", - "merged", - "declined" - ] - } - } - ], - "responses": { - "200": { - "description": "an array of pull request objects", - "content": { - "application/json": { - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/pullrequest" - } - } - } - } - } - } - } - }, - "/2.0/repositories/{username}/{slug}/pullrequests/{pid}": { - "get": { - "operationId": "getPullRequestsById", - "parameters": [ - { - "name": "username", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "slug", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "pid", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "a pull request object", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/pullrequest" - } - } - }, - "links": { - "pullRequestMerge": { - "$ref": "#/components/links/PullRequestMerge" - } - } - } - } - } - }, - "/2.0/repositories/{username}/{slug}/pullrequests/{pid}/merge": { - "post": { - "operationId": "mergePullRequest", - "parameters": [ - { - "name": "username", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "slug", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "pid", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "responses": { - "204": { - "description": "the PR was successfully merged" - } - } - } - } - }, - "components": { - "links": { - "UserRepositories": { - "operationId": "getRepositoriesByOwner", - "parameters": { - "username": "$response.body#/username" - } - }, - "UserRepository": { - "operationId": "getRepository", - "parameters": { - "username": "$response.body#/owner/username", - "slug": "$response.body#/slug" - } - }, - "RepositoryPullRequests": { - "operationId": "getPullRequestsByRepository", - "parameters": { - "username": "$response.body#/owner/username", - "slug": "$response.body#/slug" - } - }, - "PullRequestMerge": { - "operationId": "mergePullRequest", - "parameters": { - "username": "$response.body#/author/username", - "slug": "$response.body#/repository/slug", - "pid": "$response.body#/id" - } - } - }, - "schemas": { - "user": { - "type": "object", - "properties": { - "username": { - "type": "string" - }, - "uuid": { - "type": "string" - } - } - }, - "repository": { - "type": "object", - "properties": { - "slug": { - "type": "string" - }, - "owner": { - "$ref": "#/components/schemas/user" - } - } - }, - "pullrequest": { - "type": "object", - "properties": { - "id": { - "type": "integer" - }, - "title": { - "type": "string" - }, - "repository": { - "$ref": "#/components/schemas/repository" - }, - "author": { - "$ref": "#/components/schemas/user" - } - } - } - } - } -} \ No newline at end of file diff --git a/examples/v3.0/link-example.yaml b/examples/v3.0/link-example.yaml deleted file mode 100644 index 5837d705ee..0000000000 --- a/examples/v3.0/link-example.yaml +++ /dev/null @@ -1,203 +0,0 @@ -openapi: 3.0.0 -info: - title: Link Example - version: 1.0.0 -paths: - /2.0/users/{username}: - get: - operationId: getUserByName - parameters: - - name: username - in: path - required: true - schema: - type: string - responses: - '200': - description: The User - content: - application/json: - schema: - $ref: '#/components/schemas/user' - links: - userRepositories: - $ref: '#/components/links/UserRepositories' - /2.0/repositories/{username}: - get: - operationId: getRepositoriesByOwner - parameters: - - name: username - in: path - required: true - schema: - type: string - responses: - '200': - description: repositories owned by the supplied user - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/repository' - links: - userRepository: - $ref: '#/components/links/UserRepository' - /2.0/repositories/{username}/{slug}: - get: - operationId: getRepository - parameters: - - name: username - in: path - required: true - schema: - type: string - - name: slug - in: path - required: true - schema: - type: string - responses: - '200': - description: The repository - content: - application/json: - schema: - $ref: '#/components/schemas/repository' - links: - repositoryPullRequests: - $ref: '#/components/links/RepositoryPullRequests' - /2.0/repositories/{username}/{slug}/pullrequests: - get: - operationId: getPullRequestsByRepository - parameters: - - name: username - in: path - required: true - schema: - type: string - - name: slug - in: path - required: true - schema: - type: string - - name: state - in: query - schema: - type: string - enum: - - open - - merged - - declined - responses: - '200': - description: an array of pull request objects - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/pullrequest' - /2.0/repositories/{username}/{slug}/pullrequests/{pid}: - get: - operationId: getPullRequestsById - parameters: - - name: username - in: path - required: true - schema: - type: string - - name: slug - in: path - required: true - schema: - type: string - - name: pid - in: path - required: true - schema: - type: string - responses: - '200': - description: a pull request object - content: - application/json: - schema: - $ref: '#/components/schemas/pullrequest' - links: - pullRequestMerge: - $ref: '#/components/links/PullRequestMerge' - /2.0/repositories/{username}/{slug}/pullrequests/{pid}/merge: - post: - operationId: mergePullRequest - parameters: - - name: username - in: path - required: true - schema: - type: string - - name: slug - in: path - required: true - schema: - type: string - - name: pid - in: path - required: true - schema: - type: string - responses: - '204': - description: the PR was successfully merged -components: - links: - UserRepositories: - # returns array of '#/components/schemas/repository' - operationId: getRepositoriesByOwner - parameters: - username: $response.body#/username - UserRepository: - # returns '#/components/schemas/repository' - operationId: getRepository - parameters: - username: $response.body#/owner/username - slug: $response.body#/slug - RepositoryPullRequests: - # returns '#/components/schemas/pullrequest' - operationId: getPullRequestsByRepository - parameters: - username: $response.body#/owner/username - slug: $response.body#/slug - PullRequestMerge: - # executes /2.0/repositories/{username}/{slug}/pullrequests/{pid}/merge - operationId: mergePullRequest - parameters: - username: $response.body#/author/username - slug: $response.body#/repository/slug - pid: $response.body#/id - schemas: - user: - type: object - properties: - username: - type: string - uuid: - type: string - repository: - type: object - properties: - slug: - type: string - owner: - $ref: '#/components/schemas/user' - pullrequest: - type: object - properties: - id: - type: integer - title: - type: string - repository: - $ref: '#/components/schemas/repository' - author: - $ref: '#/components/schemas/user' diff --git a/examples/v3.0/petstore-expanded.json b/examples/v3.0/petstore-expanded.json deleted file mode 100644 index 420eede6a8..0000000000 --- a/examples/v3.0/petstore-expanded.json +++ /dev/null @@ -1,242 +0,0 @@ -{ - "openapi": "3.0.0", - "info": { - "version": "1.0.0", - "title": "Swagger Petstore", - "description": "A sample API that uses a petstore as an example to demonstrate features in the OpenAPI 3.0 specification", - "termsOfService": "http://swagger.io/terms/", - "contact": { - "name": "Swagger API Team", - "email": "apiteam@swagger.io", - "url": "http://swagger.io" - }, - "license": { - "name": "Apache 2.0", - "url": "https://www.apache.org/licenses/LICENSE-2.0.html" - } - }, - "servers": [ - { - "url": "https://petstore.swagger.io/v2" - } - ], - "paths": { - "/pets": { - "get": { - "description": "Returns all pets from the system that the user has access to\nNam sed condimentum est. Maecenas tempor sagittis sapien, nec rhoncus sem sagittis sit amet. Aenean at gravida augue, ac iaculis sem. Curabitur odio lorem, ornare eget elementum nec, cursus id lectus. Duis mi turpis, pulvinar ac eros ac, tincidunt varius justo. In hac habitasse platea dictumst. Integer at adipiscing ante, a sagittis ligula. Aenean pharetra tempor ante molestie imperdiet. Vivamus id aliquam diam. Cras quis velit non tortor eleifend sagittis. Praesent at enim pharetra urna volutpat venenatis eget eget mauris. In eleifend fermentum facilisis. Praesent enim enim, gravida ac sodales sed, placerat id erat. Suspendisse lacus dolor, consectetur non augue vel, vehicula interdum libero. Morbi euismod sagittis libero sed lacinia.\n\nSed tempus felis lobortis leo pulvinar rutrum. Nam mattis velit nisl, eu condimentum ligula luctus nec. Phasellus semper velit eget aliquet faucibus. In a mattis elit. Phasellus vel urna viverra, condimentum lorem id, rhoncus nibh. Ut pellentesque posuere elementum. Sed a varius odio. Morbi rhoncus ligula libero, vel eleifend nunc tristique vitae. Fusce et sem dui. Aenean nec scelerisque tortor. Fusce malesuada accumsan magna vel tempus. Quisque mollis felis eu dolor tristique, sit amet auctor felis gravida. Sed libero lorem, molestie sed nisl in, accumsan tempor nisi. Fusce sollicitudin massa ut lacinia mattis. Sed vel eleifend lorem. Pellentesque vitae felis pretium, pulvinar elit eu, euismod sapien.\n", - "operationId": "findPets", - "parameters": [ - { - "name": "tags", - "in": "query", - "description": "tags to filter by", - "required": false, - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - } - } - }, - { - "name": "limit", - "in": "query", - "description": "maximum number of results to return", - "required": false, - "schema": { - "type": "integer", - "format": "int32" - } - } - ], - "responses": { - "200": { - "description": "pet response", - "content": { - "application/json": { - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/Pet" - } - } - } - } - }, - "default": { - "description": "unexpected error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Error" - } - } - } - } - } - }, - "post": { - "description": "Creates a new pet in the store. Duplicates are allowed", - "operationId": "addPet", - "requestBody": { - "description": "Pet to add to the store", - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/NewPet" - } - } - } - }, - "responses": { - "200": { - "description": "pet response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Pet" - } - } - } - }, - "default": { - "description": "unexpected error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Error" - } - } - } - } - } - } - }, - "/pets/{id}": { - "get": { - "description": "Returns a user based on a single ID, if the user does not have access to the pet", - "operationId": "find pet by id", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "ID of pet to fetch", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - } - ], - "responses": { - "200": { - "description": "pet response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Pet" - } - } - } - }, - "default": { - "description": "unexpected error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Error" - } - } - } - } - } - }, - "delete": { - "description": "deletes a single pet based on the ID supplied", - "operationId": "deletePet", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "ID of pet to delete", - "required": true, - "schema": { - "type": "integer", - "format": "int64" - } - } - ], - "responses": { - "204": { - "description": "pet deleted" - }, - "default": { - "description": "unexpected error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Error" - } - } - } - } - } - } - } - }, - "components": { - "schemas": { - "Pet": { - "allOf": [ - { - "$ref": "#/components/schemas/NewPet" - }, - { - "type": "object", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64" - } - } - } - ] - }, - "NewPet": { - "type": "object", - "required": [ - "name" - ], - "properties": { - "name": { - "type": "string" - }, - "tag": { - "type": "string" - } - } - }, - "Error": { - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - } - } - } - } - } -} \ No newline at end of file diff --git a/examples/v3.0/petstore-expanded.yaml b/examples/v3.0/petstore-expanded.yaml deleted file mode 100644 index 7e5bff0efa..0000000000 --- a/examples/v3.0/petstore-expanded.yaml +++ /dev/null @@ -1,158 +0,0 @@ -openapi: "3.0.0" -info: - version: 1.0.0 - title: Swagger Petstore - description: A sample API that uses a petstore as an example to demonstrate features in the OpenAPI 3.0 specification - termsOfService: http://swagger.io/terms/ - contact: - name: Swagger API Team - email: apiteam@swagger.io - url: http://swagger.io - license: - name: Apache 2.0 - url: https://www.apache.org/licenses/LICENSE-2.0.html -servers: - - url: https://petstore.swagger.io/v2 -paths: - /pets: - get: - description: | - Returns all pets from the system that the user has access to - Nam sed condimentum est. Maecenas tempor sagittis sapien, nec rhoncus sem sagittis sit amet. Aenean at gravida augue, ac iaculis sem. Curabitur odio lorem, ornare eget elementum nec, cursus id lectus. Duis mi turpis, pulvinar ac eros ac, tincidunt varius justo. In hac habitasse platea dictumst. Integer at adipiscing ante, a sagittis ligula. Aenean pharetra tempor ante molestie imperdiet. Vivamus id aliquam diam. Cras quis velit non tortor eleifend sagittis. Praesent at enim pharetra urna volutpat venenatis eget eget mauris. In eleifend fermentum facilisis. Praesent enim enim, gravida ac sodales sed, placerat id erat. Suspendisse lacus dolor, consectetur non augue vel, vehicula interdum libero. Morbi euismod sagittis libero sed lacinia. - - Sed tempus felis lobortis leo pulvinar rutrum. Nam mattis velit nisl, eu condimentum ligula luctus nec. Phasellus semper velit eget aliquet faucibus. In a mattis elit. Phasellus vel urna viverra, condimentum lorem id, rhoncus nibh. Ut pellentesque posuere elementum. Sed a varius odio. Morbi rhoncus ligula libero, vel eleifend nunc tristique vitae. Fusce et sem dui. Aenean nec scelerisque tortor. Fusce malesuada accumsan magna vel tempus. Quisque mollis felis eu dolor tristique, sit amet auctor felis gravida. Sed libero lorem, molestie sed nisl in, accumsan tempor nisi. Fusce sollicitudin massa ut lacinia mattis. Sed vel eleifend lorem. Pellentesque vitae felis pretium, pulvinar elit eu, euismod sapien. - operationId: findPets - parameters: - - name: tags - in: query - description: tags to filter by - required: false - style: form - schema: - type: array - items: - type: string - - name: limit - in: query - description: maximum number of results to return - required: false - schema: - type: integer - format: int32 - responses: - '200': - description: pet response - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/Pet' - default: - description: unexpected error - content: - application/json: - schema: - $ref: '#/components/schemas/Error' - post: - description: Creates a new pet in the store. Duplicates are allowed - operationId: addPet - requestBody: - description: Pet to add to the store - required: true - content: - application/json: - schema: - $ref: '#/components/schemas/NewPet' - responses: - '200': - description: pet response - content: - application/json: - schema: - $ref: '#/components/schemas/Pet' - default: - description: unexpected error - content: - application/json: - schema: - $ref: '#/components/schemas/Error' - /pets/{id}: - get: - description: Returns a user based on a single ID, if the user does not have access to the pet - operationId: find pet by id - parameters: - - name: id - in: path - description: ID of pet to fetch - required: true - schema: - type: integer - format: int64 - responses: - '200': - description: pet response - content: - application/json: - schema: - $ref: '#/components/schemas/Pet' - default: - description: unexpected error - content: - application/json: - schema: - $ref: '#/components/schemas/Error' - delete: - description: deletes a single pet based on the ID supplied - operationId: deletePet - parameters: - - name: id - in: path - description: ID of pet to delete - required: true - schema: - type: integer - format: int64 - responses: - '204': - description: pet deleted - default: - description: unexpected error - content: - application/json: - schema: - $ref: '#/components/schemas/Error' -components: - schemas: - Pet: - allOf: - - $ref: '#/components/schemas/NewPet' - - type: object - required: - - id - properties: - id: - type: integer - format: int64 - - NewPet: - type: object - required: - - name - properties: - name: - type: string - tag: - type: string - - Error: - type: object - required: - - code - - message - properties: - code: - type: integer - format: int32 - message: - type: string diff --git a/examples/v3.0/petstore.json b/examples/v3.0/petstore.json deleted file mode 100644 index d14eb5e6d0..0000000000 --- a/examples/v3.0/petstore.json +++ /dev/null @@ -1,189 +0,0 @@ -{ - "openapi": "3.0.0", - "info": { - "version": "1.0.0", - "title": "Swagger Petstore", - "license": { - "name": "MIT" - } - }, - "servers": [ - { - "url": "http://petstore.swagger.io/v1" - } - ], - "paths": { - "/pets": { - "get": { - "summary": "List all pets", - "operationId": "listPets", - "tags": [ - "pets" - ], - "parameters": [ - { - "name": "limit", - "in": "query", - "description": "How many items to return at one time (max 100)", - "required": false, - "schema": { - "type": "integer", - "maximum": 100, - "format": "int32" - } - } - ], - "responses": { - "200": { - "description": "A paged array of pets", - "headers": { - "x-next": { - "description": "A link to the next page of responses", - "schema": { - "type": "string" - } - } - }, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Pets" - } - } - } - }, - "default": { - "description": "unexpected error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Error" - } - } - } - } - } - }, - "post": { - "summary": "Create a pet", - "operationId": "createPets", - "tags": [ - "pets" - ], - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Pet" - } - } - }, - "required": true - }, - "responses": { - "201": { - "description": "Null response" - }, - "default": { - "description": "unexpected error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Error" - } - } - } - } - } - } - }, - "/pets/{petId}": { - "get": { - "summary": "Info for a specific pet", - "operationId": "showPetById", - "tags": [ - "pets" - ], - "parameters": [ - { - "name": "petId", - "in": "path", - "required": true, - "description": "The id of the pet to retrieve", - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "Expected response to a valid request", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Pet" - } - } - } - }, - "default": { - "description": "unexpected error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Error" - } - } - } - } - } - } - } - }, - "components": { - "schemas": { - "Pet": { - "type": "object", - "required": [ - "id", - "name" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64" - }, - "name": { - "type": "string" - }, - "tag": { - "type": "string" - } - } - }, - "Pets": { - "type": "array", - "maxItems": 100, - "items": { - "$ref": "#/components/schemas/Pet" - } - }, - "Error": { - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" - } - } - } - } - } -} \ No newline at end of file diff --git a/examples/v3.0/petstore.yaml b/examples/v3.0/petstore.yaml deleted file mode 100644 index 7ed987ff63..0000000000 --- a/examples/v3.0/petstore.yaml +++ /dev/null @@ -1,119 +0,0 @@ -openapi: "3.0.0" -info: - version: 1.0.0 - title: Swagger Petstore - license: - name: MIT -servers: - - url: http://petstore.swagger.io/v1 -paths: - /pets: - get: - summary: List all pets - operationId: listPets - tags: - - pets - parameters: - - name: limit - in: query - description: How many items to return at one time (max 100) - required: false - schema: - type: integer - maximum: 100 - format: int32 - responses: - '200': - description: A paged array of pets - headers: - x-next: - description: A link to the next page of responses - schema: - type: string - content: - application/json: - schema: - $ref: "#/components/schemas/Pets" - default: - description: unexpected error - content: - application/json: - schema: - $ref: "#/components/schemas/Error" - post: - summary: Create a pet - operationId: createPets - tags: - - pets - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/Pet' - required: true - responses: - '201': - description: Null response - default: - description: unexpected error - content: - application/json: - schema: - $ref: "#/components/schemas/Error" - /pets/{petId}: - get: - summary: Info for a specific pet - operationId: showPetById - tags: - - pets - parameters: - - name: petId - in: path - required: true - description: The id of the pet to retrieve - schema: - type: string - responses: - '200': - description: Expected response to a valid request - content: - application/json: - schema: - $ref: "#/components/schemas/Pet" - default: - description: unexpected error - content: - application/json: - schema: - $ref: "#/components/schemas/Error" -components: - schemas: - Pet: - type: object - required: - - id - - name - properties: - id: - type: integer - format: int64 - name: - type: string - tag: - type: string - Pets: - type: array - maxItems: 100 - items: - $ref: "#/components/schemas/Pet" - Error: - type: object - required: - - code - - message - properties: - code: - type: integer - format: int32 - message: - type: string diff --git a/examples/v3.0/uspto.json b/examples/v3.0/uspto.json deleted file mode 100644 index cd32f64c5f..0000000000 --- a/examples/v3.0/uspto.json +++ /dev/null @@ -1,252 +0,0 @@ -{ - "openapi": "3.0.1", - "servers": [ - { - "url": "{scheme}://developer.uspto.gov/ds-api", - "variables": { - "scheme": { - "description": "The Data Set API is accessible via https and http", - "enum": [ - "https", - "http" - ], - "default": "https" - } - } - } - ], - "info": { - "description": "The Data Set API (DSAPI) allows the public users to discover and search USPTO exported data sets. This is a generic API that allows USPTO users to make any CSV based data files searchable through API. With the help of GET call, it returns the list of data fields that are searchable. With the help of POST call, data can be fetched based on the filters on the field names. Please note that POST call is used to search the actual data. The reason for the POST call is that it allows users to specify any complex search criteria without worry about the GET size limitations as well as encoding of the input parameters.", - "version": "1.0.0", - "title": "USPTO Data Set API", - "contact": { - "name": "Open Data Portal", - "url": "https://developer.uspto.gov", - "email": "developer@uspto.gov" - } - }, - "tags": [ - { - "name": "metadata", - "description": "Find out about the data sets" - }, - { - "name": "search", - "description": "Search a data set" - } - ], - "paths": { - "/": { - "get": { - "tags": [ - "metadata" - ], - "operationId": "list-data-sets", - "summary": "List available data sets", - "responses": { - "200": { - "description": "Returns a list of data sets", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/dataSetList" - }, - "example": { - "total": 2, - "apis": [ - { - "apiKey": "oa_citations", - "apiVersionNumber": "v1", - "apiUrl": "https://developer.uspto.gov/ds-api/oa_citations/v1/fields", - "apiDocumentationUrl": "https://developer.uspto.gov/ds-api-docs/index.html?url=https://developer.uspto.gov/ds-api/swagger/docs/oa_citations.json" - }, - { - "apiKey": "cancer_moonshot", - "apiVersionNumber": "v1", - "apiUrl": "https://developer.uspto.gov/ds-api/cancer_moonshot/v1/fields", - "apiDocumentationUrl": "https://developer.uspto.gov/ds-api-docs/index.html?url=https://developer.uspto.gov/ds-api/swagger/docs/cancer_moonshot.json" - } - ] - } - } - } - } - } - } - }, - "/{dataset}/{version}/fields": { - "get": { - "tags": [ - "metadata" - ], - "summary": "Provides the general information about the API and the list of fields that can be used to query the dataset.", - "description": "This GET API returns the list of all the searchable field names that are in the oa_citations. Please see the 'fields' attribute which returns an array of field names. Each field or a combination of fields can be searched using the syntax options shown below.", - "operationId": "list-searchable-fields", - "parameters": [ - { - "name": "dataset", - "in": "path", - "description": "Name of the dataset.", - "required": true, - "example": "oa_citations", - "schema": { - "type": "string" - } - }, - { - "name": "version", - "in": "path", - "description": "Version of the dataset.", - "required": true, - "example": "v1", - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "The dataset API for the given version is found and it is accessible to consume.", - "content": { - "application/json": { - "schema": { - "type": "string" - } - } - } - }, - "404": { - "description": "The combination of dataset name and version is not found in the system or it is not published yet to be consumed by public.", - "content": { - "application/json": { - "schema": { - "type": "string" - } - } - } - } - } - } - }, - "/{dataset}/{version}/records": { - "post": { - "tags": [ - "search" - ], - "summary": "Provides search capability for the data set with the given search criteria.", - "description": "This API is based on Solr/Lucene Search. The data is indexed using SOLR. This GET API returns the list of all the searchable field names that are in the Solr Index. Please see the 'fields' attribute which returns an array of field names. Each field or a combination of fields can be searched using the Solr/Lucene Syntax. Please refer https://lucene.apache.org/core/3_6_2/queryparsersyntax.html#Overview for the query syntax. List of field names that are searchable can be determined using above GET api.", - "operationId": "perform-search", - "parameters": [ - { - "name": "version", - "in": "path", - "description": "Version of the dataset.", - "required": true, - "schema": { - "type": "string", - "default": "v1" - } - }, - { - "name": "dataset", - "in": "path", - "description": "Name of the dataset. In this case, the default value is oa_citations", - "required": true, - "schema": { - "type": "string", - "default": "oa_citations" - } - } - ], - "responses": { - "200": { - "description": "successful operation", - "content": { - "application/json": { - "schema": { - "type": "array", - "items": { - "type": "object", - "additionalProperties": { - "type": "object" - } - } - } - } - } - }, - "404": { - "description": "No matching record found for the given criteria." - } - }, - "requestBody": { - "content": { - "application/x-www-form-urlencoded": { - "schema": { - "type": "object", - "properties": { - "criteria": { - "description": "Uses Lucene Query Syntax in the format of propertyName:value, propertyName:[num1 TO num2] and date range format: propertyName:[yyyyMMdd TO yyyyMMdd]. In the response please see the 'docs' element which has the list of record objects. Each record structure would consist of all the fields and their corresponding values.", - "type": "string", - "default": "*:*" - }, - "start": { - "description": "Starting record number. Default value is 0.", - "type": "integer", - "default": 0 - }, - "rows": { - "description": "Specify number of rows to be returned. If you run the search with default values, in the response you will see 'numFound' attribute which will tell the number of records available in the dataset.", - "type": "integer", - "default": 100 - } - }, - "required": [ - "criteria" - ] - } - } - } - } - } - } - }, - "components": { - "schemas": { - "dataSetList": { - "type": "object", - "properties": { - "total": { - "type": "integer" - }, - "apis": { - "type": "array", - "items": { - "type": "object", - "properties": { - "apiKey": { - "type": "string", - "description": "To be used as a dataset parameter value" - }, - "apiVersionNumber": { - "type": "string", - "description": "To be used as a version parameter value" - }, - "apiUrl": { - "type": "string", - "format": "uriref", - "description": "The URL describing the dataset's fields" - }, - "apiDocumentationUrl": { - "type": "string", - "format": "uriref", - "description": "A URL to the API console for each API" - } - } - } - } - } - } - } - } -} \ No newline at end of file diff --git a/examples/v3.0/uspto.yaml b/examples/v3.0/uspto.yaml deleted file mode 100644 index d3011520d0..0000000000 --- a/examples/v3.0/uspto.yaml +++ /dev/null @@ -1,210 +0,0 @@ -openapi: 3.0.1 -servers: - - url: '{scheme}://developer.uspto.gov/ds-api' - variables: - scheme: - description: 'The Data Set API is accessible via https and http' - enum: - - 'https' - - 'http' - default: 'https' -info: - description: >- - The Data Set API (DSAPI) allows the public users to discover and search - USPTO exported data sets. This is a generic API that allows USPTO users to - make any CSV based data files searchable through API. With the help of GET - call, it returns the list of data fields that are searchable. With the help - of POST call, data can be fetched based on the filters on the field names. - Please note that POST call is used to search the actual data. The reason for - the POST call is that it allows users to specify any complex search criteria - without worry about the GET size limitations as well as encoding of the - input parameters. - version: 1.0.0 - title: USPTO Data Set API - contact: - name: Open Data Portal - url: 'https://developer.uspto.gov' - email: developer@uspto.gov -tags: - - name: metadata - description: Find out about the data sets - - name: search - description: Search a data set -paths: - /: - get: - tags: - - metadata - operationId: list-data-sets - summary: List available data sets - responses: - '200': - description: Returns a list of data sets - content: - application/json: - schema: - $ref: '#/components/schemas/dataSetList' - example: - { - "total": 2, - "apis": [ - { - "apiKey": "oa_citations", - "apiVersionNumber": "v1", - "apiUrl": "https://developer.uspto.gov/ds-api/oa_citations/v1/fields", - "apiDocumentationUrl": "https://developer.uspto.gov/ds-api-docs/index.html?url=https://developer.uspto.gov/ds-api/swagger/docs/oa_citations.json" - }, - { - "apiKey": "cancer_moonshot", - "apiVersionNumber": "v1", - "apiUrl": "https://developer.uspto.gov/ds-api/cancer_moonshot/v1/fields", - "apiDocumentationUrl": "https://developer.uspto.gov/ds-api-docs/index.html?url=https://developer.uspto.gov/ds-api/swagger/docs/cancer_moonshot.json" - } - ] - } - /{dataset}/{version}/fields: - get: - tags: - - metadata - summary: >- - Provides the general information about the API and the list of fields - that can be used to query the dataset. - description: >- - This GET API returns the list of all the searchable field names that are - in the oa_citations. Please see the 'fields' attribute which returns an - array of field names. Each field or a combination of fields can be - searched using the syntax options shown below. - operationId: list-searchable-fields - parameters: - - name: dataset - in: path - description: 'Name of the dataset.' - required: true - example: "oa_citations" - schema: - type: string - - name: version - in: path - description: Version of the dataset. - required: true - example: "v1" - schema: - type: string - responses: - '200': - description: >- - The dataset API for the given version is found and it is accessible - to consume. - content: - application/json: - schema: - type: string - '404': - description: >- - The combination of dataset name and version is not found in the - system or it is not published yet to be consumed by public. - content: - application/json: - schema: - type: string - /{dataset}/{version}/records: - post: - tags: - - search - summary: >- - Provides search capability for the data set with the given search - criteria. - description: >- - This API is based on Solr/Lucene Search. The data is indexed using - SOLR. This GET API returns the list of all the searchable field names - that are in the Solr Index. Please see the 'fields' attribute which - returns an array of field names. Each field or a combination of fields - can be searched using the Solr/Lucene Syntax. Please refer - https://lucene.apache.org/core/3_6_2/queryparsersyntax.html#Overview for - the query syntax. List of field names that are searchable can be - determined using above GET api. - operationId: perform-search - parameters: - - name: version - in: path - description: Version of the dataset. - required: true - schema: - type: string - default: v1 - - name: dataset - in: path - description: 'Name of the dataset. In this case, the default value is oa_citations' - required: true - schema: - type: string - default: oa_citations - responses: - '200': - description: successful operation - content: - application/json: - schema: - type: array - items: - type: object - additionalProperties: - type: object - '404': - description: No matching record found for the given criteria. - requestBody: - content: - application/x-www-form-urlencoded: - schema: - type: object - properties: - criteria: - description: >- - Uses Lucene Query Syntax in the format of - propertyName:value, propertyName:[num1 TO num2] and date - range format: propertyName:[yyyyMMdd TO yyyyMMdd]. In the - response please see the 'docs' element which has the list of - record objects. Each record structure would consist of all - the fields and their corresponding values. - type: string - default: '*:*' - start: - description: Starting record number. Default value is 0. - type: integer - default: 0 - rows: - description: >- - Specify number of rows to be returned. If you run the search - with default values, in the response you will see 'numFound' - attribute which will tell the number of records available in - the dataset. - type: integer - default: 100 - required: - - criteria -components: - schemas: - dataSetList: - type: object - properties: - total: - type: integer - apis: - type: array - items: - type: object - properties: - apiKey: - type: string - description: To be used as a dataset parameter value - apiVersionNumber: - type: string - description: To be used as a version parameter value - apiUrl: - type: string - format: uriref - description: "The URL describing the dataset's fields" - apiDocumentationUrl: - type: string - format: uriref - description: A URL to the API console for each API diff --git a/examples/v3.1/non-oauth-scopes.json b/examples/v3.1/non-oauth-scopes.json deleted file mode 100644 index b3e5990426..0000000000 --- a/examples/v3.1/non-oauth-scopes.json +++ /dev/null @@ -1,31 +0,0 @@ -{ - "openapi": "3.1.0", - "info": { - "title": "Non-oAuth Scopes example", - "version": "1.0.0" - }, - "paths": { - "/users": { - "get": { - "security": [ - { - "bearerAuth": [ - "read:users", - "public" - ] - } - ] - } - } - }, - "components": { - "securitySchemes": { - "bearerAuth": { - "type": "http", - "scheme": "bearer", - "bearerFormat": "jwt", - "description": "note: non-oauth scopes are not defined at the securityScheme level" - } - } - } -} \ No newline at end of file diff --git a/examples/v3.1/non-oauth-scopes.yaml b/examples/v3.1/non-oauth-scopes.yaml deleted file mode 100644 index e757452f38..0000000000 --- a/examples/v3.1/non-oauth-scopes.yaml +++ /dev/null @@ -1,19 +0,0 @@ -openapi: 3.1.0 -info: - title: Non-oAuth Scopes example - version: 1.0.0 -paths: - /users: - get: - security: - - bearerAuth: - - 'read:users' - - 'public' -components: - securitySchemes: - bearerAuth: - type: http - scheme: bearer - bearerFormat: jwt - description: 'note: non-oauth scopes are not defined at the securityScheme level' - diff --git a/examples/v3.1/webhook-example.json b/examples/v3.1/webhook-example.json deleted file mode 100644 index 712a42f120..0000000000 --- a/examples/v3.1/webhook-example.json +++ /dev/null @@ -1,50 +0,0 @@ -{ - "openapi": "3.1.0", - "info": { - "title": "Webhook Example", - "version": "1.0.0" - }, - "webhooks": { - "newPet": { - "post": { - "requestBody": { - "description": "Information about a new pet in the system", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Pet" - } - } - } - }, - "responses": { - "200": { - "description": "Return a 200 status to indicate that the data was received successfully" - } - } - } - } - }, - "components": { - "schemas": { - "Pet": { - "required": [ - "id", - "name" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64" - }, - "name": { - "type": "string" - }, - "tag": { - "type": "string" - } - } - } - } - } -} \ No newline at end of file diff --git a/examples/v3.1/webhook-example.yaml b/examples/v3.1/webhook-example.yaml deleted file mode 100644 index 2ac1cda985..0000000000 --- a/examples/v3.1/webhook-example.yaml +++ /dev/null @@ -1,35 +0,0 @@ -openapi: 3.1.0 -info: - title: Webhook Example - version: 1.0.0 -# Since OAS 3.1.0 the paths element isn't necessary. Now a valid OpenAPI Document can describe only paths, webhooks, or even only reusable components -webhooks: - # Each webhook needs a name - newPet: - # This is a Path Item Object, the only difference is that the request is initiated by the API provider - post: - requestBody: - description: Information about a new pet in the system - content: - application/json: - schema: - $ref: "#/components/schemas/Pet" - responses: - "200": - description: Return a 200 status to indicate that the data was received successfully - -components: - schemas: - Pet: - required: - - id - - name - properties: - id: - type: integer - format: int64 - name: - type: string - tag: - type: string - diff --git a/package-lock.json b/package-lock.json index b431f35ebd..625b01f557 100644 --- a/package-lock.json +++ b/package-lock.json @@ -15,10 +15,10 @@ "yargs": "^17.7.2" }, "devDependencies": { - "@hyperjump/json-schema": "^1.9.2", + "@hyperjump/json-schema": "^1.9.3", "mdv": "^1.3.4", "vitest": "^1.6.0", - "yaml": "^2.4.2" + "yaml": "^2.4.5" } }, "node_modules/@esbuild/aix-ppc64": { @@ -420,9 +420,9 @@ } }, "node_modules/@hyperjump/json-schema": { - "version": "1.9.2", - "resolved": "https://registry.npmjs.org/@hyperjump/json-schema/-/json-schema-1.9.2.tgz", - "integrity": "sha512-aE2C3phUTvvMXDZ6w6gXdPYohqM3e8Yxcq8unbyx93JnrJUNWiwWdlEwus97SRdO6hWAfiHjhL5imJvhkdUyYg==", + "version": "1.9.3", + "resolved": "https://registry.npmjs.org/@hyperjump/json-schema/-/json-schema-1.9.3.tgz", + "integrity": "sha512-NZyQ+PSQKUVIO0PInwqk2EOOObJD/ZqR9awzZeOddwtJyLZaxim9/xizZ6gGxGZi5ZGIdIB1mkBTM9fBu85E4A==", "dev": true, "dependencies": { "@hyperjump/json-pointer": "^1.1.0", @@ -2320,9 +2320,9 @@ } }, "node_modules/yaml": { - "version": "2.4.2", - "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.4.2.tgz", - "integrity": "sha512-B3VqDZ+JAg1nZpaEmWtTXUlBneoGx6CPM9b0TENK6aoSu5t73dItudwdgmi6tHlIZZId4dZ9skcAQ2UbcyAeVA==", + "version": "2.4.5", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.4.5.tgz", + "integrity": "sha512-aBx2bnqDzVOyNKfsysjA2ms5ZlnjSAW2eG3/L5G/CSujfjLJTJsEw1bGw8kCf04KodQWk1pxlGnZ56CRxiawmg==", "dev": true, "bin": { "yaml": "bin.mjs" diff --git a/package.json b/package.json index 62aea1a810..d6613e24ab 100644 --- a/package.json +++ b/package.json @@ -27,10 +27,10 @@ "yargs": "^17.7.2" }, "devDependencies": { - "@hyperjump/json-schema": "^1.9.2", + "@hyperjump/json-schema": "^1.9.3", "mdv": "^1.3.4", "vitest": "^1.6.0", - "yaml": "^2.4.2" + "yaml": "^2.4.5" }, "keywords": [ "OpenAPI", diff --git a/scripts/md2html/build.sh b/scripts/md2html/build.sh index ae6da89f19..e5ba804407 100755 --- a/scripts/md2html/build.sh +++ b/scripts/md2html/build.sh @@ -5,6 +5,9 @@ # run this script from the root of the repo. It is designed to be run by a GitHub workflow. # It contains bashisms +mkdir -p deploy/oas +mkdir -p deploy/js + cd scripts/md2html mkdir -p history cat > history/MAINTAINERS_v2.0.md < /dev/null +cp -p markdown/* ../../deploy/ 2> /dev/null + latest=`git describe --abbrev=0 --tags` latestCopied=none for filename in ../../versions/[23456789].*.md ; do version=$(basename "$filename" .md) - node md2html.js --respec --maintainers ./history/MAINTAINERS_v$version.md ${filename} > ../../docs/oas/v$version.html + node md2html.js --respec --maintainers ./history/MAINTAINERS_v$version.md ${filename} > ../../deploy/oas/v$version.html if [ $version = $latest ]; then if [[ ${version} != *"rc"* ]];then # version is not a Release Candidate - cp -p ../../docs/oas/v$version.html ../../docs/oas/latest.html + cp -p ../../deploy/oas/v$version.html ../../deploy/oas/latest.html latestCopied=v$version fi fi From 6805927339ac84ee14fb480c2d5022f53c9c3e87 Mon Sep 17 00:00:00 2001 From: Bellangelo Date: Sat, 15 Jun 2024 02:42:29 +0300 Subject: [PATCH 151/152] Remove outdated files --- .../workflows/convert-examples-to-json.yaml | 53 ------------------- tests/v3.0/examples.test.js | 27 ---------- tests/v3.1/examples.test.js | 27 ---------- 3 files changed, 107 deletions(-) delete mode 100644 .github/workflows/convert-examples-to-json.yaml delete mode 100644 tests/v3.0/examples.test.js delete mode 100644 tests/v3.1/examples.test.js diff --git a/.github/workflows/convert-examples-to-json.yaml b/.github/workflows/convert-examples-to-json.yaml deleted file mode 100644 index d1b9768275..0000000000 --- a/.github/workflows/convert-examples-to-json.yaml +++ /dev/null @@ -1,53 +0,0 @@ -name: convert-examples-to-json - -# author: @MikeRalphson / @cebe -# issue: https://github.com/OAI/OpenAPI-Specification/issues/1385 - -# -# This workflow updates the *.json files in the examples/v3.x directories, -# when the corresponding *.yaml files change. -# JSON example files are automatically generated from the YAML example files. -# Only the YAML files should be adjusted manually. -# - -# run this on push to main -on: - push: - branches: - - main - -jobs: - yaml2json: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 # checkout repo content - - - uses: actions/setup-node@v4 # setup Node.js - with: - node-version: '20.x' - - - name: Install dependencies - run: npm ci - - - name: convert YAML examples to JSON - run: find examples/v3* -type f -name "*.yaml" | xargs node scripts/yaml2json/yaml2json.js - - - name: git diff - run: | - git add examples/**/*.json - git --no-pager -c color.diff=always diff --staged - - - name: Create Pull Request - uses: peter-evans/create-pull-request@v5 - with: - token: ${{ secrets.GITHUB_TOKEN }} - branch: update-json-examples - title: Update JSON example files - commit-message: Update JSON example files - body: | - This pull request is automatically triggered by GitHub action `convert-examples-to-json`. - - The examples/v3.* YAML files have changed, so the JSON files are automatically being recreated. - diff --git a/tests/v3.0/examples.test.js b/tests/v3.0/examples.test.js deleted file mode 100644 index 9513cbc9e3..0000000000 --- a/tests/v3.0/examples.test.js +++ /dev/null @@ -1,27 +0,0 @@ -import { readdirSync, readFileSync } from "node:fs"; -import YAML from "yaml"; -import { validate, setMetaSchemaOutputFormat } from "@hyperjump/json-schema/openapi-3-0"; -import { BASIC } from "@hyperjump/json-schema/experimental"; -import { describe, test, expect } from "vitest"; - -const parseYamlFromFile = (filePath) => { - const schemaYaml = readFileSync(filePath, "utf8"); - return YAML.parse(schemaYaml, { prettyErrors: true }); -}; - -setMetaSchemaOutputFormat(BASIC); - -const validateOpenApi = await validate("./schemas/v3.0/schema.json"); -const folder = './examples/v3.0/'; - -describe("v3.0 - Validate examples", async () => { - readdirSync(folder, { withFileTypes: true }) - .filter((entry) => entry.isFile() && /\.yaml$/.test(entry.name)) - .forEach((entry) => { - test(entry.name, () => { - const instance = parseYamlFromFile(folder + entry.name); - const output = validateOpenApi(instance, BASIC); - expect(output.valid).to.equal(true); - }); - }); -}); diff --git a/tests/v3.1/examples.test.js b/tests/v3.1/examples.test.js deleted file mode 100644 index 49057fb537..0000000000 --- a/tests/v3.1/examples.test.js +++ /dev/null @@ -1,27 +0,0 @@ -import { readdirSync, readFileSync } from "node:fs"; -import YAML from "yaml"; -import { validate, setMetaSchemaOutputFormat } from "@hyperjump/json-schema/openapi-3-1"; -import { BASIC } from "@hyperjump/json-schema/experimental"; -import { describe, test, expect } from "vitest"; - -const parseYamlFromFile = (filePath) => { - const schemaYaml = readFileSync(filePath, "utf8"); - return YAML.parse(schemaYaml, { prettyErrors: true }); -}; - -setMetaSchemaOutputFormat(BASIC); - -const validateOpenApi = await validate("./schemas/v3.1/schema.json"); -const folder = './examples/v3.1/'; - -describe("v3.1 - Validate examples", async () => { - readdirSync(folder, { withFileTypes: true }) - .filter((entry) => entry.isFile() && /\.yaml$/.test(entry.name)) - .forEach((entry) => { - test(entry.name, () => { - const instance = parseYamlFromFile(folder + entry.name); - const output = validateOpenApi(instance, BASIC); - expect(output.valid).to.equal(true); - }); - }); -}); From e3d2d04926625cd1859aaa6d87b02a135073608a Mon Sep 17 00:00:00 2001 From: Bellangelo Date: Sat, 15 Jun 2024 02:47:37 +0300 Subject: [PATCH 152/152] Update examples urls in the specification --- versions/3.0.0.md | 2 +- versions/3.0.1.md | 2 +- versions/3.0.2.md | 2 +- versions/3.0.3.md | 2 +- versions/3.1.0.md | 4 ++-- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/versions/3.0.0.md b/versions/3.0.0.md index 84248257b4..f5ee1ecbb9 100644 --- a/versions/3.0.0.md +++ b/versions/3.0.0.md @@ -1821,7 +1821,7 @@ The key value used to identify the callback object is an expression, evaluated a ##### Patterned Fields Field Pattern | Type | Description ---|:---:|--- -{expression} | [Path Item Object](#path-item-object) | A Path Item Object used to define a callback request and expected responses. A [complete example](../examples/v3.0/callback-example.yaml) is available. +{expression} | [Path Item Object](#path-item-object) | A Path Item Object used to define a callback request and expected responses. A [complete example](https://github.com/OAI/learn.openapis.org/tree/main/examples/v3.0/callback-example.yaml) is available. This object MAY be extended with [Specification Extensions](#specification-extensions). diff --git a/versions/3.0.1.md b/versions/3.0.1.md index 2c1ba6c317..6b21b0f62d 100644 --- a/versions/3.0.1.md +++ b/versions/3.0.1.md @@ -1821,7 +1821,7 @@ The key value used to identify the callback object is an expression, evaluated a ##### Patterned Fields Field Pattern | Type | Description ---|:---:|--- -{expression} | [Path Item Object](#path-item-object) | A Path Item Object used to define a callback request and expected responses. A [complete example](../examples/v3.0/callback-example.yaml) is available. +{expression} | [Path Item Object](#path-item-object) | A Path Item Object used to define a callback request and expected responses. A [complete example](https://github.com/OAI/learn.openapis.org/tree/main/examples/v3.0/callback-example.yaml) is available. This object MAY be extended with [Specification Extensions](#specification-extensions). diff --git a/versions/3.0.2.md b/versions/3.0.2.md index ff86a527ce..e67428d1b8 100644 --- a/versions/3.0.2.md +++ b/versions/3.0.2.md @@ -1843,7 +1843,7 @@ The key value used to identify the callback object is an expression, evaluated a ##### Patterned Fields Field Pattern | Type | Description ---|:---:|--- -{expression} | [Path Item Object](#path-item-object) | A Path Item Object used to define a callback request and expected responses. A [complete example](../examples/v3.0/callback-example.yaml) is available. +{expression} | [Path Item Object](#path-item-object) | A Path Item Object used to define a callback request and expected responses. A [complete example](https://github.com/OAI/learn.openapis.org/tree/main/examples/v3.0/callback-example.yaml) is available. This object MAY be extended with [Specification Extensions](#specification-extensions). diff --git a/versions/3.0.3.md b/versions/3.0.3.md index 13a96ea657..086587c983 100644 --- a/versions/3.0.3.md +++ b/versions/3.0.3.md @@ -1847,7 +1847,7 @@ The key value used to identify the path item object is an expression, evaluated ##### Patterned Fields Field Pattern | Type | Description ---|:---:|--- -{expression} | [Path Item Object](#path-item-object) | A Path Item Object used to define a callback request and expected responses. A [complete example](../examples/v3.0/callback-example.yaml) is available. +{expression} | [Path Item Object](#path-item-object) | A Path Item Object used to define a callback request and expected responses. A [complete example](https://github.com/OAI/learn.openapis.org/tree/main/examples/v3.0/callback-example.yaml) is available. This object MAY be extended with [Specification Extensions](#specification-extensions). diff --git a/versions/3.1.0.md b/versions/3.1.0.md index 1f0830643f..3ebb206f4e 100644 --- a/versions/3.1.0.md +++ b/versions/3.1.0.md @@ -195,7 +195,7 @@ Field Name | Type | Description jsonSchemaDialect | `string` | The default value for the `$schema` keyword within [Schema Objects](#schema-object) contained within this OAS document. This MUST be in the form of a URI. servers | [[Server Object](#server-object)] | An array of Server Objects, which provide connectivity information to a target server. If the `servers` property is not provided, or is an empty array, the default value would be a [Server Object](#server-object) with a [url](#serverUrl) value of `/`. paths | [Paths Object](#paths-object) | The available paths and operations for the API. -webhooks | Map[`string`, [Path Item Object](#path-item-object) \| [Reference Object](#reference-object)] ] | The incoming webhooks that MAY be received as part of this API and that the API consumer MAY choose to implement. Closely related to the `callbacks` feature, this section describes requests initiated other than by an API call, for example by an out of band registration. The key name is a unique string to refer to each webhook, while the (optionally referenced) Path Item Object describes a request that may be initiated by the API provider and the expected responses. An [example](../examples/v3.1/webhook-example.yaml) is available. +webhooks | Map[`string`, [Path Item Object](#path-item-object) \| [Reference Object](#reference-object)] ] | The incoming webhooks that MAY be received as part of this API and that the API consumer MAY choose to implement. Closely related to the `callbacks` feature, this section describes requests initiated other than by an API call, for example by an out of band registration. The key name is a unique string to refer to each webhook, while the (optionally referenced) Path Item Object describes a request that may be initiated by the API provider and the expected responses. An [example](https://github.com/OAI/learn.openapis.org/tree/main/examples/v3.1/webhook-example.yaml) is available. components | [Components Object](#components-object) | An element to hold various schemas for the document. security | [[Security Requirement Object](#security-requirement-object)] | A declaration of which security mechanisms can be used across the API. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. Individual operations can override this definition. To make security optional, an empty security requirement (`{}`) can be included in the array. tags | [[Tag Object](#tag-object)] | A list of tags used by the document with additional metadata. The order of the tags can be used to reflect on their order by the parsing tools. Not all tags that are used by the [Operation Object](#operation-object) must be declared. The tags that are not declared MAY be organized randomly or based on the tools' logic. Each tag name in the list MUST be unique. @@ -1866,7 +1866,7 @@ To describe incoming requests from the API provider independent from another API ##### Patterned Fields Field Pattern | Type | Description ---|:---:|--- -{expression} | [Path Item Object](#path-item-object) \| [Reference Object](#reference-object) | A Path Item Object, or a reference to one, used to define a callback request and expected responses. A [complete example](../examples/v3.0/callback-example.yaml) is available. +{expression} | [Path Item Object](#path-item-object) \| [Reference Object](#reference-object) | A Path Item Object, or a reference to one, used to define a callback request and expected responses. A [complete example](https://github.com/OAI/learn.openapis.org/tree/main/examples/v3.0/callback-example.yaml) is available. This object MAY be extended with [Specification Extensions](#specification-extensions).